Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ErikSierra authored Jun 17, 2024
1 parent 412bba1 commit d1059c4
Showing 1 changed file with 25 additions and 0 deletions.
25 changes: 25 additions & 0 deletions FalconTests/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
## Falcon Tests

These files are used only for testing the functionality of the FalconContainment process. Each .py tests different parts of the process in order to minimize errors during official use.

### APIconnectionTest.py

This script is designed to test the connection to the Crowdstrike API and to read hosts provided in the computers.txt file.

#### Usage

1. Install the necessary packages by running the following prompt in your terminal
pip install -r requirements.txt


2. Use the config.yaml file and insert your API credentials and the file path to the computers.txt file. The file should be structured as follows:
api: client_id: YOUR_CLIENT_ID client_secret: YOUR_CLIENT_SECRET file_path: computers.txt


3. Run the script by navigating to the directory where the file is located and running the following prompt in your terminal
python APIconnectionTest.py


*** Please note that this script is for testing purposes only and should not be used for any official API containment within Crowdstrike Falcon or related resources. Use 'Containment.py' for Crowdstrike API containment. Refer to the GitHub repository for instructions.***

For details on the functions within the script, please refer to the comments within the code.

0 comments on commit d1059c4

Please sign in to comment.