• Documentation

Create and manage credentials for a data share

Create credentials

You need to create credentials to connect your data share to your environment or third-party tool if it supports Databricks Delta Sharing.

When you create credentials, you’ll be prompted to download a JSON file that includes an endpoint URL and bearer token, which you’ll provide to your environment or third-party tool. As a best practice, we recommend you create a set of credentials for each tool that you plan to connect this data share to.

To create new credentials:

You must be an organization admin to create credentials for a data share.

  1. Select Data from the global navigation.

  2. Select Data shares from the sidebar.

  3. Select the data share you’d like to create credentials for. This will take you to the credentials settings.

  4. Select Create credentials.

  5. Enter a label for the new credentials then select Create.

  6. Select Download credentials file to get the new credentials file.

You can only download the credentials file once, so make sure to store this information in a secure location before navigating away. Once you have a set of credentials, you can connect this data share to your tools. Read how to connect your data share to your third-party tools.

Revoke credentials

You can revoke individual credentials or all credentials at once for a particular data share. When you revoke credentials, any connections to the data share that use those credentials will no longer work.

You must be an organization admin to revoke credentials for a data share.

To revoke individual credentials:

  1. Select Data from the global navigation.

  2. Select Data shares from the sidebar.

  3. Select the data share. This will take you to the credentials settings.

  4. Select Revoke for the credentials you’d like to revoke.

"Revoke" action for credentials named "BI tool 1".

To revoke all credentials at once:

  1. Select Data from the global navigation.

  2. Select Data shares from the sidebar.

  3. Select the data share. This will take you to the credentials settings.

  4. Select Revoke all credentials.

Highlighted "Revoke all credentials" button for a data share named "All Atlassian data".

Best practices for credentials

For security reasons, we recommend the following:

  • Create a set of credentials for each tool that you plan to connect the data share to.

  • Rotate credentials every 60 days.

To rotate credentials:

  1. Select Data from the global navigation.

  2. Select Data shares from the sidebar.

  3. Select the data share with the credentials you’d like to rotate. This will take you to the credentials settings.

  4. Select Create credentials.

  5. Enter a label for the new credentials then select Create.

  6. Select Download credentials file to get the new credentials file.

  7. Update your tools that use the old credentials so they use the new credentials.

  8. After you verify that the connections to the data share still work, go back to your data share’s credentials settings and select Revoke next to the old credentials to invalidate them.

Still need help?

The Atlassian Community is here for you.