Updated documentation.

README.md

@@ -61,17 +61,23 @@ Deploying the resources via CLI is the recommended approach. This method allows
 
 Follow this [tutorial](https://azure.github.io/osdu-developer/tutorial_cli/) for a quick overview of doing this from the Azure Cloud Shell.
 
+> **NOTE:** If you are using a pre-existing Entra App, you will need to set the feature flag `AZURE_CLIENT_ID` and `AZURE_CLIENT_SECRET` with the values from your app (See [Feature Flags](https://azure.github.io/osdu-developer/feature_flags/#custom-infrastructure) for more information on feature flags).
+
 ```bash
 # Authentication
-az login
+az login --scope https://graph.microsoft.com//.default
 az account set --subscription <your_subscription_id>
 azd auth login
 
+# Prepare Environment
+azd init -e dev # This if first environment
+azd env new dev # This if adding a new environment
+azd env set <feature_flag> <value> # Set any necessary feature flags
+
 # Provisioning
-azd init -e dev
 azd provision
 
-# Settings
+# Configure Settings for Integrations
 azd env set AUTH_CODE <your_auth_code>
 azd hooks run settings
 

docs/src/feature_flags.md

@@ -2,6 +2,17 @@
 
 Feature flags can be set prior to running provision with the command `azd env set <FLAG> <VALUE>`
 
+## Reusable Entra App
+
+Entra App configurations are by default automatically created but one can be reused or created manually as well.
+
+| Feature Flag              | Description                                                                 |
+|---------------------------|-----------------------------------------------------------------------------|
+| AZURE_CLIENT_ID           | Use an existing Azure AD App Client ID                                      |
+| AZURE_CLIENT_SECRET       | Use an existing Azure AD Client Secret and don't reset it.                  |
+| AZURE_CLIENT_PRINCIPAL_OID| Skip Principal ID lookup and use provided.                                  |
+| AZURE_TENANT_ID           | Skip Tenant ID lookup and use provided.                                     |
+
 ## Custom Infrastructure
 
 Infrastructure customizations can be managed and modified using the following feature flags.