Fix documentation. (databricks#116)

Update setup instructions for AWS, Azure, and GCP

Author: marco-ferraro-db

docs/setup/aws.md

@@ -22,10 +22,11 @@ The first step is to create a Service Principal in Databricks. This will allow S
 - Go to the [Account Console](https://accounts.cloud.databricks.com)
 - On the left side bar menu, click on `User management`
 - Select `Service Principal` and then `Add service principal`
+- Type a new name for the service principal.
 - The Service Principal must be granted the `Account Admin` role. This role provides the ability to manage account-level settings and permissions.
 - Assign the Workspace Admin Role: The Service Principal must be assigned the `Workspace Admin` role for each workspace it will manage. This role provides the ability to manage workspace-level settings and permissions.
 - Add to the Metastore Admin Group: The Service Principal must be added to the `Metastore Admin` group or role. This role provides the ability to manage metastore-level settings and permissions.
-- Type a new name for the service principal and then create a new OAuth Secret.
+- Create a new OAuth Secret.
 - Save the `Secret` and `Client ID`
 - To deploy SAT in a workspace, you must add the Service Principal to the workspace.
 
@@ -50,6 +51,8 @@ To execute SAT follow this steps:
     git clone https://github.com/databricks-industry-solutions/security-analysis-tool.git
    ```
 
+> Remember that the target workspace should have a [profile](https://docs.gcp.databricks.com/en/dev-tools/cli/profiles.html) in [Databricks CLI](https://docs.gcp.databricks.com/en/dev-tools/cli/tutorial.html)
+
 - Run the `install.sh` script on your terminal.
 
 > To ensure that the install.sh script is executable, you need to modify its permissions using the chmod command.
@@ -61,8 +64,6 @@ To execute SAT follow this steps:
 
 ![](../gif/terminal-aws.gif)
 
-> Remember that the target workspace should have a [profile](https://docs.databricks.com/en/dev-tools/cli/profiles.html) in [Databricks CLI](https://docs.databricks.com/en/dev-tools/cli/index.html)
-
 Congratulations! 🎉 You are now ready to start using SAT. Please click [here](../setup.md#usage) for a detailed description on how to run and use it.
 
 ## Troubleshooting

docs/setup/azure.md

@@ -46,7 +46,8 @@ After creating the App Registration and client secret, you will need to add the
 - Go to the [Account Console](https://accounts.azuredatabricks.net/)
 - On the left side bar menu, click on `User management`
 - Select `Service Principal` and then `Add service principal`
-- Paste the App Client ID and App Client Secret in the respective fields.
+- Select `Microsoft Entra ID Managed Application` as the service principal type.
+- Paste the App Client ID and create a new name for the service principal.
 - Click Add.
 - The Service Principal must be granted the `Account Admin` role. This role provides the ability to manage account-level settings and permissions.
 - Assign the Workspace Admin Role: The Service Principal must be assigned the `Workspace Admin` role for each workspace it will manage. This role provides the ability to manage workspace-level settings and permissions.
@@ -78,6 +79,8 @@ To execute SAT follow this steps:
     git clone https://github.com/databricks-industry-solutions/security-analysis-tool.git
    ```
 
+> Remember that the target workspace should have a [profile](https://docs.gcp.databricks.com/en/dev-tools/cli/profiles.html) in [Databricks CLI](https://docs.gcp.databricks.com/en/dev-tools/cli/tutorial.html)
+
 - Run the `install.sh` script on your terminal.
 
 > To ensure that the install.sh script is executable, you need to modify its permissions using the chmod command.
@@ -88,8 +91,6 @@ To execute SAT follow this steps:
 
 ![](../gif/terminal-azure.gif)
 
-> Remember the target workspace should have a [profile](https://learn.microsoft.com/en-us/azure/databricks/dev-tools/cli/profiles) in [Databricks CLI](https://learn.microsoft.com/en-us/azure/databricks/dev-tools/cli/)
-
 Congratulations! 🎉 You are now ready to start using SAT. Please click [here](../setup.md#usage) for a detailed description on how to run and use it.
 
 

docs/setup/gcp.md

@@ -31,7 +31,8 @@ The first step is to create a Service Principal in GCP. This will allow SAT to a
 
 ### Credentials Needed
 
-To setup SAT on Azure, you will need the following credentials:
+To setup SAT on GCP, you will need the following credentials:
+
 - Databricks Account ID
 - Service Account email
 - gsutil URI from GCS Bucket
@@ -52,18 +53,15 @@ To execute SAT follow this steps:
 > chmod +x install.sh
 >```
 
+> Remember that the target workspace should have a [profile](https://docs.gcp.databricks.com/en/dev-tools/cli/profiles.html) in [Databricks CLI](https://docs.gcp.databricks.com/en/dev-tools/cli/tutorial.html)
 
 - Run the `install.sh` script on your terminal.
 
-
-
 ![](../gif/terminal-gcp.gif)
 
-> Remember that the target workspace should have a [profile](https://docs.gcp.databricks.com/en/dev-tools/cli/profiles.html) in [Databricks CLI](https://docs.gcp.databricks.com/en/dev-tools/cli/tutorial.html)
-
 Congratulations! 🎉 You are now ready to start using SAT. Please click [here](../setup.md#usage) for a detailed description on how to run and use it.
 
 
 ## Troubleshooting
 Please review the FAQs and Troubleshooting resources documented [here](./faqs_and_troubleshooting.md) including a notebook to help diagnose your SAT setup.
-If any issues arise during the installation process, please check your credentials and ensure that you have the appropriate permissions in your Azure cloud account. If you are still facing issues, please send your feedback and comments to <[email protected]>.
+If any issues arise during the installation process, please check your credentials and ensure that you have the appropriate permissions in your GCP cloud account. If you are still facing issues, please send your feedback and comments to <[email protected]>.