From 11c4e7147e10586cd5efdec13287bcf89279a5fb Mon Sep 17 00:00:00 2001 From: Gax Date: Tue, 9 Apr 2024 10:27:44 -0400 Subject: [PATCH] Update README.md --- powershell/install/README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/powershell/install/README.md b/powershell/install/README.md index 554868d..5b79ac2 100644 --- a/powershell/install/README.md +++ b/powershell/install/README.md @@ -17,6 +17,33 @@ Ensure the following API scopes are enabled: ## Configuration +### Setting up Authentication + +#### Using Client ID and Client Secret + +Provide the required parameters: + +```powershell +.\falcon_windows_install.ps1 -FalconClientId -FalconClientSecret +``` + +#### Using an Access Token + +You can also specify a Falcon access token if doing a batch install across multiple machines to prevent the need to call the token endpoint multiple times. If using an access token to authenticate, you ***MUST*** also provide `FALCON_CLOUD`: + +```powershell +.\falcon_windows_install.ps1 -FalconCloud us-2 -FalconAccessToken +``` + +> [!NOTE] +> If you need to retrieve an access token, run the script with the `GET_ACCESS_TOKEN` parameter set to `true`. The Falcon sensor will NOT be installed while this parameteris provided. +> +> ```powershell +> .\falcon_windows_install.ps1 -FalconClientId -FalconClientSecret -GetAccessToken True +> ``` +> +> The script will output the access token to the console. + ### Install Uses the CrowdStrike Falcon APIs to check the sensor version assigned to a ***Windows Sensor Update policy***,