diff --git a/src/lib/openapi/spec/edge-token-schema.ts b/src/lib/openapi/spec/edge-token-schema.ts index 3852493415..444fd66c24 100644 --- a/src/lib/openapi/spec/edge-token-schema.ts +++ b/src/lib/openapi/spec/edge-token-schema.ts @@ -7,7 +7,7 @@ export const edgeTokenSchema = { additionalProperties: false, required: ['token', 'projects', 'type'], description: - 'A representation of a client token, limiting access to [CLIENT](https://docs.getunleash.io/reference/api-tokens-and-client-keys#client-tokens) (used by serverside SDKs) or [FRONTEND](https://docs.getunleash.io/reference/api-tokens-and-client-keys#frontend-tokens) (used by proxy SDKs)', + 'A representation of a client token, limiting access to [CLIENT](https://docs.getunleash.io/reference/api-tokens-and-client-keys#backend-tokens) (used by serverside SDKs) or [FRONTEND](https://docs.getunleash.io/reference/api-tokens-and-client-keys#frontend-tokens) (used by proxy SDKs)', properties: { projects: { description: @@ -19,7 +19,7 @@ export const edgeTokenSchema = { example: ['developerexperience', 'enterprisegrowth'], }, type: { - description: `The [API token](https://docs.getunleash.io/reference/api-tokens-and-client-keys)'s **type**. Unleash supports three different types of API tokens ([ADMIN](https://docs.getunleash.io/reference/api-tokens-and-client-keys#admin-tokens), [CLIENT](https://docs.getunleash.io/reference/api-tokens-and-client-keys#client-tokens), [FRONTEND](https://docs.getunleash.io/reference/api-tokens-and-client-keys#frontend-tokens)). They all have varying access, so when validating a token it's important to know what kind you're dealing with`, + description: `The [API token](https://docs.getunleash.io/reference/api-tokens-and-client-keys)'s **type**. Unleash supports three different types of API tokens ([ADMIN](https://docs.getunleash.io/reference/api-tokens-and-client-keys#admin-tokens), [CLIENT](https://docs.getunleash.io/reference/api-tokens-and-client-keys#backend-tokens), [FRONTEND](https://docs.getunleash.io/reference/api-tokens-and-client-keys#frontend-tokens)). They all have varying access, so when validating a token it's important to know what kind you're dealing with`, type: 'string', enum: Object.values(ApiTokenType), example: 'client', diff --git a/website/docs/feature-flag-tutorials/java/implementing-feature-flags.mdx b/website/docs/feature-flag-tutorials/java/implementing-feature-flags.mdx index b65a1cf500..d7086a4767 100644 --- a/website/docs/feature-flag-tutorials/java/implementing-feature-flags.mdx +++ b/website/docs/feature-flag-tutorials/java/implementing-feature-flags.mdx @@ -157,7 +157,7 @@ In the main function of that file on line 21, set up the Unleash Client configur Unleash unleash = new DefaultUnleash(config); ``` -Read more on our [configuration examples in our Java SDK documentation](/reference/sdks/java#example-configurations). +Read more on our [configuration examples in our Java SDK documentation](https://docs.getunleash.io/reference/sdks/java#example-configurations). The `unleashAPI` will point your app to your local Unleash instance. @@ -165,7 +165,7 @@ Replace the `` string in the configuration’s apiKey with the API toke While the app is running, it will log the enabled status of the endpoint flag we created in our Unleash instance. -You can check our [API token and client keys documentation](/reference/api-tokens-and-client-keys) for more specifics and see additional use cases in our [Backend SDK with Java](/reference/sdks/java) documentation. +You can check our [API token and client keys documentation](https://docs.getunleash.io/reference/api-tokens-and-client-keys) for more specifics and see additional use cases in our [Backend SDK with Java](https://docs.getunleash.io/reference/sdks/java) documentation. To run the app, use the following command: diff --git a/website/docs/feature-flag-tutorials/java/spring-boot-implementing-feature-flags.mdx b/website/docs/feature-flag-tutorials/java/spring-boot-implementing-feature-flags.mdx index 932ab8755c..796e2c83ea 100644 --- a/website/docs/feature-flag-tutorials/java/spring-boot-implementing-feature-flags.mdx +++ b/website/docs/feature-flag-tutorials/java/spring-boot-implementing-feature-flags.mdx @@ -104,7 +104,7 @@ Select the ‘New API token’ button. ![Create a new API token in the API Access view for your Spring Boot application.](/img/tutorial-create-api-token.png) -Name the API token and select the “Backend SDK” token type since we’ll be doing our flag evaluation on the server using the Spring Boot SDK. You can read more about [Unleash API tokens](/reference/api-tokens-and-client-keys#client-tokens). +Name the API token and select the “Backend SDK” token type since we’ll be doing our flag evaluation on the server using the Spring Boot SDK. You can read more about [Unleash API tokens](/reference/api-tokens-and-client-keys#backend-tokens). The token should have access to the “development” environment, as shown in the platform screenshot below. diff --git a/website/docs/feature-flag-tutorials/javascript/implementing-feature-flags-js.md b/website/docs/feature-flag-tutorials/javascript/implementing-feature-flags-js.md index b23824bc55..de0fdf37e4 100644 --- a/website/docs/feature-flag-tutorials/javascript/implementing-feature-flags-js.md +++ b/website/docs/feature-flag-tutorials/javascript/implementing-feature-flags-js.md @@ -163,7 +163,7 @@ Now, let's connect our project to Unleash so that you can toggle a feature flag You'll need two things: - The URL of your Unleash instance's API. It's `http://localhost:4242/api/` for your local version. -- A [client API token](/reference/api-tokens-and-client-keys#client-tokens). You can create one inside a project in **Settings > API access**. +- A [client API token](/reference/api-tokens-and-client-keys#backend-tokens). You can create one inside a project in **Settings > API access**. You can now initialize your Unleash client as follows: diff --git a/website/docs/how-to/how-to-run-the-unleash-proxy.mdx b/website/docs/how-to/how-to-run-the-unleash-proxy.mdx index d65a942c62..a805db0bd0 100644 --- a/website/docs/how-to/how-to-run-the-unleash-proxy.mdx +++ b/website/docs/how-to/how-to-run-the-unleash-proxy.mdx @@ -30,7 +30,7 @@ If you're using a hosted version of Unleash, we can also run the proxy for you. This is what you need before you can run the proxy: - A running Unleash server to connect to. You'll need its API path (e.g. `https://app.unleash-hosted.com/demo/api`) to connect the proxy to it. -- A [client API token](../reference/api-tokens-and-client-keys#client-tokens) for the proxy to use. +- A [client API token](../reference/api-tokens-and-client-keys#backend-tokens) for the proxy to use. - If you're running the Proxy via Docker: [the `docker` command line tool](https://www.docker.com/). - If you're running the Proxy as a Node.js app: [Node.js and its command line tools](https://nodejs.org/). - A [Proxy client key](../reference/api-tokens-and-client-keys#proxy-client-keys). This can be any arbitrary string (for instance: `proxy-client-key`). Use this key when connecting a client SDK to the Proxy. diff --git a/website/docs/quickstart.mdx b/website/docs/quickstart.mdx index a2e4bfac8d..74bc95f6dd 100644 --- a/website/docs/quickstart.mdx +++ b/website/docs/quickstart.mdx @@ -88,7 +88,7 @@ unleash.on("synchronized", () => { 1. **Create an API token** - In the Unleash Admin UI, create a [client API token](/reference/api-tokens-and-client-keys#client-tokens) in **Admin settings > Access control > API access**. + In the Unleash Admin UI, create a [client API token](/reference/api-tokens-and-client-keys#backend-tokens) in **Admin settings > Access control > API access**. 2. **Get your Unleash API URL** Find the base URL of your Unleash Cloud instance (for example, `https://us.app.unleash-hosted.com/some-instance-id`). Your API URL is this base URL with `/api` appended to it. diff --git a/website/docs/reference/rbac.md b/website/docs/reference/rbac.md index 3bc66427ca..dab04f7898 100644 --- a/website/docs/reference/rbac.md +++ b/website/docs/reference/rbac.md @@ -79,7 +79,7 @@ You can assign the following root permissions: | Create frontend API tokens | Create frontend API tokens. | | Update frontend API tokens | Update frontend API tokens. | | Delete frontend API tokens | Delete frontend API tokens. | -| Read client API tokens | View [client API tokens](./api-tokens-and-client-keys#client-tokens). | +| Read client API tokens | View [client API tokens](./api-tokens-and-client-keys#backend-tokens). | | Create client API tokens | Create client API tokens. | | Update client API tokens | Update client API tokens. | | Delete client API tokens | Delete client API tokens. | diff --git a/website/docs/reference/sdks/index.mdx b/website/docs/reference/sdks/index.mdx index a786c14f43..80dd843687 100644 --- a/website/docs/reference/sdks/index.mdx +++ b/website/docs/reference/sdks/index.mdx @@ -16,7 +16,7 @@ Unleash provides official SDKs for a number of programming languages. Our commun ### Backend SDKs -Backend SDKs run in backend services. They communicate with Unleash or [Unleash Edge](./unleash-edge) using the [Client API](../understanding-unleash/unleash-overview#client-api) and require a [client token](./api-tokens-and-client-keys#client-tokens). +Backend SDKs run in backend services. They communicate with Unleash or [Unleash Edge](./unleash-edge) using the [Client API](../understanding-unleash/unleash-overview#client-api) and require a [client token](./api-tokens-and-client-keys#backend-tokens). Backend SDKs perform the flag evaluation locally, meaning all user data is retained within the SDK. Unleash offers the following backend SDKs: diff --git a/website/docs/using-unleash/deploy/configuring-unleash.mdx b/website/docs/using-unleash/deploy/configuring-unleash.mdx index 38e4be8742..58dd636dc2 100644 --- a/website/docs/using-unleash/deploy/configuring-unleash.mdx +++ b/website/docs/using-unleash/deploy/configuring-unleash.mdx @@ -185,7 +185,7 @@ If emails fail to send or contain errors: | :--------------------------------- | :-------------- | :--------------------------------------------------------------------------------------------------------- | | `UNLEASH_DEFAULT_ADMIN_USERNAME` | `admin` | Sets the username for the initial admin user created on first startup. | | `UNLEASH_DEFAULT_ADMIN_PASSWORD` | `unleash4all` | Sets the password for the initial admin user. **Change this for any non-local setup.** | -| `INIT_CLIENT_API_TOKENS` | N/A | Comma-separated list of [Client tokens](/reference/api-tokens-and-client-keys#client-tokens) to create on first startup (if no tokens exist in the database). | +| `INIT_CLIENT_API_TOKENS` | N/A | Comma-separated list of [Client tokens](/reference/api-tokens-and-client-keys#backend-tokens) to create on first startup (if no tokens exist in the database). | | `INIT_FRONTEND_API_TOKENS` | N/A | Comma-separated list of [Frontend tokens](/reference/api-tokens-and-client-keys#frontend-tokens) to create on first startup (if no tokens exist in the database). | ### Server behavior diff --git a/website/remote-content/sdks.js b/website/remote-content/sdks.js index 448e1d3b49..043cd49f38 100644 --- a/website/remote-content/sdks.js +++ b/website/remote-content/sdks.js @@ -102,7 +102,7 @@ const SDKS = (() => { const getAdmonitions = (sdk) => { const admonitions = { [CLIENT_SIDE_SDK]: `To connect to Unleash from a frontend application, you'll need to use the [Unleash front-end API](/reference/front-end-api) ([how do I create an API token?](/how-to/how-to-create-api-tokens.mdx)) or the [Unleash proxy](/reference/unleash-proxy) ([how do I create client keys?](/reference/api-tokens-and-client-keys#proxy-client-keys)).`, - [SERVER_SIDE_SDK]: `To connect to Unleash, you'll need your Unleash API url (e.g. \`https:///api\`) and a [backend API token](/reference/api-tokens-and-client-keys.mdx#client-tokens) ([how do I create an API token?](/how-to/how-to-create-api-tokens.mdx)).`, + [SERVER_SIDE_SDK]: `To connect to Unleash, you'll need your Unleash API url (e.g. \`https:///api\`) and a [backend API token](/reference/api-tokens-and-client-keys.mdx#backend-tokens) ([how do I create an API token?](/how-to/how-to-create-api-tokens.mdx)).`, }; const wrap = (text) => `:::tip\n${text}\n:::`;