diff --git a/docs/docs/concepts/environment-token.mdx b/docs/docs/concepts/environment-tokens.mdx similarity index 91% rename from docs/docs/concepts/environment-token.mdx rename to docs/docs/concepts/environment-tokens.mdx index 9b243e3530..055dd90199 100644 --- a/docs/docs/concepts/environment-token.mdx +++ b/docs/docs/concepts/environment-tokens.mdx @@ -1,7 +1,7 @@ --- id: environment-tokens title: Environment Tokens -description: Environment Tokens are strings used to authenticate Tracetest CLI against an organization and environment. +description: Environment Tokens are strings used to authenticate Tracetest CLI against an environment. hide_table_of_contents: false keywords: - tracetest @@ -12,7 +12,7 @@ keywords: image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1698686403/docs/Blog_Thumbnail_14_rsvkmo.jpg --- -Environment Tokens are strings used to authenticate the Tracetest CLI against an organization and environment. +Environment Tokens are strings used to authenticate the Tracetest CLI against an environment in an organization. ![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1701296331/docs/environment-tokens_gkt9kx.png) diff --git a/docs/docs/concepts/organization-tokens.mdx b/docs/docs/concepts/organization-tokens.mdx new file mode 100644 index 0000000000..c710731cc1 --- /dev/null +++ b/docs/docs/concepts/organization-tokens.mdx @@ -0,0 +1,34 @@ +--- +id: organization-tokens +title: Organization Tokens +description: Organization Tokens are strings used to authenticate Tracetest CLI against an organization and the environments and resources within the organization. +hide_table_of_contents: false +keywords: + - tracetest + - trace-based testing + - observability + - distributed tracing + - testing +image: https://res.cloudinary.com/djwdcmwdz/image/upload/v1698686403/docs/Blog_Thumbnail_14_rsvkmo.jpg +--- + +Organization Tokens are strings used to authenticate Tracetest CLI against an organization and the environments and resources within the organization. + +![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1716818893/docs/app.tracetest.io_organizations_ttorg_e66318ba6544b856_tokens_veklnd.png) + +These tokens are used to configure environments with the Tracetest CLI. You can configure detailed environment automation with an organization token. + +Create a new token by clicking on the `Create a new token` button, choosing a name, role and expiration and then clicking on `Create`. + +![](https://res.cloudinary.com/djwdcmwdz/image/upload/v1716819703/docs/app.tracetest.io_organizations_ttorg_e66318ba6544b856_tokens_1_mx7cr1.png) + +Two roles are available: + +- **Admin** - This token will enable authenticating both the CLI and Tracetest Agent with a single token. +- **Agent** - Thsi token will only be for authenticating and running the Tracetest Agent. + +This will create a token that you can copy and use to configure Tracetest CLI with: + +```bash +tracetest configure --token {ADD_YOUR_TOKEN_HERE} +``` diff --git a/docs/sidebars.js b/docs/sidebars.js index 665bc927e6..73d886415c 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -752,6 +752,11 @@ const sidebars = { id: "concepts/roles-and-permissions", label: "Roles and Permissions", }, + { + type: "doc", + id: "concepts/organization-tokens", + label: "Organization Tokens", + }, { type: "doc", id: "concepts/environment-tokens",