diff --git a/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/agent-tokens.md b/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/agent-tokens.md index e777a568a9f9f..4e2f0d21c78fc 100644 --- a/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/agent-tokens.md +++ b/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/agent-tokens.md @@ -4,4 +4,51 @@ sidebar_position: 200 unlisted: true --- -{/* TODO move agent token content from https://docs.dagster.io/dagster-plus/account/managing-user-agent-tokens */} +# Managing agent tokens in Dagster+ + +:::note +This guide is applicable to Dagster+. +::: + +In this guide, we'll walk you through creating and revoking agent tokens in Dagster+. + +## Managing agent tokens +:::note +{/* /dagster-plus/account/managing-users */} +To manage agent tokens, you need to be an [Organization Admin](/todo.md) in +Dagster+. +::: + +{/* /dagster-plus/deployment/agents */} +Agent tokens are used to authenticate [Hybrid agents](/todo.md) with the Dagster+ Agents API. + +### Creating agent tokens + +1. Sign in to your Dagster+ account. +2. Click the **user menu (your icon) > Organization Settings**. +3. Click the **Tokens** tab. +4. Click **+ Create agent token**. + +After the token is created: + +- **To view a token**, click **Reveal token**. Clicking on the token value will copy it to the clipboard. +- **To edit a token's description**, click the **pencil icon**. + +### Assigning agent token permissions + +1. Sign in to your Dagster+ account. +2. Click the **user menu (your icon) > Organization Settings**. +3. Click the **Tokens** tab. +4. Click **Edit** next to the agent token you'd like to change. + +The permissions dialog allows you to edit a token's ability to access certain deployments. By default, agent tokens have permission to access any deployment in the organization including branch deployments. This is called **Org Agent** and is set using the toggle in the top right of the dialog. To edit individual deployment permissions, **Org Agent** has to first be toggled off. + +### Revoking agent tokens + +To revoke a token: + +1. Sign in to your Dagster+ account. +2. Click the **user menu (your icon) > Organization Settings**. +3. Click the **Tokens** tab. +4. Click **Edit** next to the agent token you'd like to change. +5. Click **Revoke** in the bottom left of the permissions dialog. When prompted, confirm to proceed with revoking the token. \ No newline at end of file diff --git a/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/user-tokens.md b/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/user-tokens.md index 130e274d49ab7..7aa264c704de2 100644 --- a/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/user-tokens.md +++ b/docs/docs-beta/docs/dagster-plus/deployment/management/tokens/user-tokens.md @@ -1,7 +1,41 @@ --- -title: User tokens +title: 'User tokens' sidebar_position: 100 unlisted: true --- -{/* TODO move user token content from https://docs.dagster.io/dagster-plus/account/managing-user-agent-tokens */} \ No newline at end of file +import ThemedImage from '@theme/ThemedImage'; + +# Managing user tokens in Dagster+ + +:::note +This guide is applicable to Dagster+. +::: + +In this guide, we'll walk you through creating user tokens in Dagster+. + +## Managing user tokens +1. Sign in to your Dagster+ account. +2. Click the **user menu (your icon) > Organization Settings**. +3. Click the **Tokens** tab. +4. Click **+ Create user token**. + +After the token is created: + +- **To edit a token's description**, click the **pencil icon**. +- **To view a token**, click **Reveal token**. Clicking on the token value will copy it to the clipboard. +- **To revoke a token**, click **Revoke**. + +To manage tokens for another user, select the user from the **Manage tokens for** dropdown: + + + +:::note +**Organization Admin** permissions are required to manage another user's tokens. +::: \ No newline at end of file diff --git a/docs/docs-beta/static/images/dagster-plus/user-token-management/manage-user-tokens-for.png b/docs/docs-beta/static/images/dagster-plus/user-token-management/manage-user-tokens-for.png new file mode 100644 index 0000000000000..961a694516ebd Binary files /dev/null and b/docs/docs-beta/static/images/dagster-plus/user-token-management/manage-user-tokens-for.png differ