Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

document databricks secret scopes and update screenshots

DimitrisStaratzise6dabd8b44cb
diff --git a/docs/images/app-connections/databricks/service-principal-ids.png b/docs/images/app-connections/databricks/service-principal-ids.png
index 2748c13e86..9788b8d931 100644
Binary files a/docs/images/app-connections/databricks/service-principal-ids.png and b/docs/images/app-connections/databricks/service-principal-ids.png differ
diff --git a/docs/images/app-connections/databricks/service-principal-secrets.png b/docs/images/app-connections/databricks/service-principal-secrets.png
index e1e0b053e4..782b05eeb0 100644
Binary files a/docs/images/app-connections/databricks/service-principal-secrets.png and b/docs/images/app-connections/databricks/service-principal-secrets.png differ
diff --git a/docs/snippets/app-connections/databricks/configure-service-principal-for-rotation.mdx b/docs/snippets/app-connections/databricks/configure-service-principal-for-rotation.mdx
index a0864b656c..d9501bc397 100644
--- a/docs/snippets/app-connections/databricks/configure-service-principal-for-rotation.mdx
+++ b/docs/snippets/app-connections/databricks/configure-service-principal-for-rotation.mdx
@@ -16,10 +16,18 @@
![Create Service Principal](/images/app-connections/databricks/create-service-principal.png)
</Step>
<Step title="Generate a secret" titleSize="h3">
- Open the new service principal, select the **Secrets** tab, and select **Generate Secret**. Save the **Client ID** and **Secret** for the Infisical form.
+ Open the new service principal, select the **Secrets** tab, and select **Generate secret**. In the dialog:
+
+ 1. Set **Lifetime (days)** to how long Infisical can use the secret (up to 730 days)
+ 2. Under **Scope**, select **Other APIs**, then use **Add scope** to add `authentication` and `scim`
+ 3. Select **Generate**, then save the **Client ID** and **Secret** for the Infisical form
![Generate Secret](/images/app-connections/databricks/service-principal-secrets.png)
![Copy IDs](/images/app-connections/databricks/service-principal-ids.png)
+
+ <Note>
+ You can't change a secret's scopes after you generate it. To use other scopes, or before the secret expires, generate a new secret and update the connection's **Client Secret** and **Scopes**.
+ </Note>
</Step>
<Step title="Grant rotation permissions" titleSize="h3">
The Infisical service principal needs to manage the secrets of every service principal whose secrets you want to rotate.
diff --git a/docs/snippets/app-connections/databricks/configure-service-principal.mdx b/docs/snippets/app-connections/databricks/configure-service-principal.mdx
index 24b9950948..5b64556eb2 100644
--- a/docs/snippets/app-connections/databricks/configure-service-principal.mdx
+++ b/docs/snippets/app-connections/databricks/configure-service-principal.mdx
@@ -16,9 +16,19 @@
![Create Service Principal](/images/app-connections/databricks/create-service-principal.png)
</Step>
<Step title="Generate a secret" titleSize="h3">
- Open the new service principal, select the **Secrets** tab, and select **Generate Secret**. Save the **Client ID** and **Secret** for the Infisical form.
+ Open the new service principal, select the **Secrets** tab, and select **Generate secret**. In the dialog:
+
+ 1. Set **Lifetime (days)** to how long Infisical can use the secret (up to 730 days)
+ 2. Under **Scope**, select **Other APIs**, then use **Add scope** to add the scopes for the features you plan to use:
+ - `secrets` for secret syncs
+ - `authentication` and `scim` for secret rotations
+ 3. Select **Generate**, then save the **Client ID** and **Secret** for the Infisical form
![Generate Secret](/images/app-connections/databricks/service-principal-secrets.png)
![Copy IDs](/images/app-connections/databricks/service-principal-ids.png)
+
+ <Note>
+ You can't change a secret's scopes after you generate it. To use other scopes, or before the secret expires, generate a new secret and update the connection's **Client Secret** and **Scopes**.
+ </Note>
</Step>
</Steps>
diff --git a/docs/snippets/app-connections/databricks/form-fields.mdx b/docs/snippets/app-connections/databricks/form-fields.mdx
index 8646355397..20c8c21c75 100644
--- a/docs/snippets/app-connections/databricks/form-fields.mdx
+++ b/docs/snippets/app-connections/databricks/form-fields.mdx
@@ -3,4 +3,4 @@
- **Workspace URL**: The URL of your Databricks workspace.
- **Client ID**: The Client ID of the Databricks service principal created for Infisical.
- **Client Secret**: The [secret generated](#generate-a-secret) for that service principal.
-- **Scopes** (optional): The OAuth scopes assigned to that secret: `secrets` for secret syncs, and `authentication` and `scim` for secret rotations (defaults to `all-apis`)
+- **Scopes** (optional): The scopes you [selected for that secret](#generate-a-secret) (leave empty if the secret has the `all-apis` scope or no scopes)