diff --git a/website/docs/docs/cloud-integrations/about-snowflake-native-app.md b/website/docs/docs/cloud-integrations/about-snowflake-native-app.md index fa1c54ca5a6..c83604faead 100644 --- a/website/docs/docs/cloud-integrations/about-snowflake-native-app.md +++ b/website/docs/docs/cloud-integrations/about-snowflake-native-app.md @@ -34,7 +34,12 @@ The following diagram provides an illustration of the architecture: ## Access -You can log in to the dbt Snowflake Native App using your regular Snowflake login authentication method. During this [Preview](/docs/dbt-versions/product-lifecycles#dbt-cloud), you do not need dbt Cloud credentials (a dbt Cloud seat) to access the application but this is subject to change. + +Log in to the dbt Snowflake Native App using your regular Snowflake login authentication method. The Snowflake user must have a corresponding dbt Cloud user with a _[developer license](/docs/cloud/manage-access/seats-and-users)_. Previously, this wasn't a requirement during the feature [Preview](/docs/dbt-versions/product-lifecycles#dbt-cloud). + +If your Snowflake Native App is already configured, you will be prompted to [link credentials](#link-credentials) the next time you access dbt Cloud from the app. This is a one-time process. If you don't have a dbt Cloud account associated with a developer license, you will be denied access to the dbt Cloud environment and will need an admin to assist. + +_Users with IT or read-only licenses will be denied access to dbt Cloud via the Snowflake Native App._ App users are able to access all information that's available to the API service token. @@ -47,4 +52,18 @@ If you're interested, please [contact us](matilto:sales_snowflake_marketplace@db If you have any questions about the dbt Snowflake Native App, you may [contact our Support team](mailto:dbt-snowflake-marketplace@dbtlabs.com) for help. Please provide information about your installation of the Native App, including your dbt Cloud account ID and Snowflake account identifier. ## Limitations -- The Native app does not support dbt Cloud accounts with [IP Restrictions](/docs/cloud/secure/ip-restrictions] enabled. +- The Native app does not support dbt Cloud accounts with [IP Restrictions](/docs/cloud/secure/ip-restrictions) enabled. + +## Link credentials + +During the early stages of the Snowflake Native App preview, users were only required to exist in the Snowflake platform and could access dbt Cloud via the app without having a corresponding user. This is no longer the case, and every Snowflake user must also have dbt Cloud account access with a [developer license](/docs/cloud/manage-access/seats-and-users). + +For existing accounts with the Snowflake Native App configured, users will be prompted to authenticate with dbt Cloud the next time they log in. This is a one-time process if they have a user in dbt Cloud. If they don’t have a dbt Cloud user, they will be denied access, and an admin will need to [create one](/docs/cloud/manage-access/invite-users). + +1. When you attempt to access the dbt Cloud platform from the Snowflake Native App, you will be prompted to link your account. + + + +2. Click **Link account** and you will be prompted for your dbt Cloud credentials. + + diff --git a/website/static/img/docs/dbt-cloud/snowflake-link-account-prompt.png b/website/static/img/docs/dbt-cloud/snowflake-link-account-prompt.png new file mode 100644 index 00000000000..888010401e7 Binary files /dev/null and b/website/static/img/docs/dbt-cloud/snowflake-link-account-prompt.png differ diff --git a/website/static/img/docs/dbt-cloud/snowflake-link-dbt-cloud.png b/website/static/img/docs/dbt-cloud/snowflake-link-dbt-cloud.png new file mode 100644 index 00000000000..903748a8dca Binary files /dev/null and b/website/static/img/docs/dbt-cloud/snowflake-link-dbt-cloud.png differ