diff --git a/README.md b/README.md index de05ab7426..b39a3ca2d0 100644 --- a/README.md +++ b/README.md @@ -58,10 +58,10 @@ Find your preferred SDK in [our list of official SDKs](#unleash-sdks) and import If you use the docker compose file from the previous step, here's the configuration details you'll need to get going: -- For front-end SDKs, use: +- For frontend SDKs, use: - URL: `http://localhost:4242/api/frontend/` - `clientKey`: `default:development.unleash-insecure-frontend-api-token` -- For server-side SDKs, use: +- For backend SDKs, use: - Unleash API URL: `http://localhost:4242/api/` - API token: `default:development.unleash-insecure-api-token` @@ -145,7 +145,7 @@ Check out [the CONTRIBUTING.md file](./CONTRIBUTING.md) for contribution guideli - Out-of-the-box integrations with popular tools ([Slack](https://docs.getunleash.io/addons/slack), [Microsoft Teams](https://docs.getunleash.io/addons/teams), [Datadog](https://docs.getunleash.io/addons/datadog)) + integrate with anything with [webhooks](https://docs.getunleash.io/addons/webhook) - [Insights for managing technical debt](https://docs.getunleash.io/reference/technical-debt) and [stale flags](https://docs.getunleash.io/reference/technical-debt#stale-and-potentially-stale-flags) - API-first: _everything_ can be automated. No exceptions. -- [12 official client SDKs](https://docs.getunleash.io/reference/sdks#official-sdks), and 10 [community-contributed client SDKs](https://docs.getunleash.io/reference/sdks#community-sdks) +- [12 official SDKs](https://docs.getunleash.io/reference/sdks#official-sdks), and 10 [community-contributed SDKs](https://docs.getunleash.io/reference/sdks#community-sdks) - Run it via Docker with the [official Docker image](https://hub.docker.com/r/unleashorg/unleash-server) or as a pure Node.js application ### Security and performance @@ -154,7 +154,7 @@ Check out [the CONTRIBUTING.md file](./CONTRIBUTING.md) for contribution guideli - [Audit logs](https://docs.getunleash.io/advanced/audit_log) - Enforce [OWASP's secure headers](https://owasp.org/www-project-secure-headers/) via the strict HTTPS-only mode - Flexible hosting options: host it on premise or in the cloud (_any_ cloud) -- Scale with [Unleash Edge](https://docs.getunleash.io/reference/unleash-edge) independently of the Unleash server to support any number of front-end clients without overloading your Unleash instance +- Scale with [Unleash Edge](https://docs.getunleash.io/reference/unleash-edge) independently of the Unleash server to support any number of frontend clients without overloading your Unleash instance ### Looking for more features? @@ -183,7 +183,7 @@ Read more in the [_system overview_ section of the Unleash documentation](https: To connect your application to Unleash you'll need to use a client SDK for your programming language. -**Official server-side SDKs:** +**Official backend SDKs:** - [Go SDK](https://docs.getunleash.io/reference/sdks/go) - [Java SDK](https://docs.getunleash.io/reference/sdks/java) @@ -194,9 +194,9 @@ To connect your application to Unleash you'll need to use a client SDK for your - [Rust SDK](https://github.com/unleash/unleash-client-rust) - [.NET SDK](https://docs.getunleash.io/reference/sdks/dotnet) -**Official front-end SDKs:** +**Official frontend SDKs:** -The front-end SDKs connect via [Unleash Edge](https://docs.getunleash.io/reference/unleash-edge) in order to ensure privacy, scalability and security. +The frontend SDKs connect via [Unleash Edge](https://docs.getunleash.io/reference/unleash-edge) in order to ensure privacy, scalability and security. - [Android Proxy SDK](https://docs.getunleash.io/reference/sdks/android-proxy) - [Flutter Proxy SDK](https://docs.getunleash.io/reference/sdks/flutter) diff --git a/frontend/src/component/admin/apiToken/ApiTokenForm/useApiTokenForm.ts b/frontend/src/component/admin/apiToken/ApiTokenForm/useApiTokenForm.ts index d1fba049cc..0c00f45fc6 100644 --- a/frontend/src/component/admin/apiToken/ApiTokenForm/useApiTokenForm.ts +++ b/frontend/src/component/admin/apiToken/ApiTokenForm/useApiTokenForm.ts @@ -23,16 +23,16 @@ export const useApiTokenForm = (project?: string) => { const apiTokenTypes: SelectOption[] = [ { key: TokenType.CLIENT, - label: `Server-side SDK (${TokenType.CLIENT})`, - title: 'Connect server-side SDK or Unleash Proxy/Edge', + label: 'Backend SDK', + title: 'Creates a backend token to connect a backend SDK or Unleash Edge', enabled: useHasRootAccess(CREATE_CLIENT_API_TOKEN) || hasCreateProjectTokenPermission, }, { key: TokenType.FRONTEND, - label: `Client-side SDK (${TokenType.FRONTEND})`, - title: 'Connect web and mobile SDK directly to Unleash', + label: 'Frontend SDK', + title: 'Creates a frontend token to connect a frontend SDK', enabled: useHasRootAccess(CREATE_FRONTEND_API_TOKEN) || hasCreateProjectTokenPermission, diff --git a/frontend/src/component/admin/apiToken/CreateApiToken/CreateApiToken.tsx b/frontend/src/component/admin/apiToken/CreateApiToken/CreateApiToken.tsx index 272fa32bdf..8958c584dc 100644 --- a/frontend/src/component/admin/apiToken/CreateApiToken/CreateApiToken.tsx +++ b/frontend/src/component/admin/apiToken/CreateApiToken/CreateApiToken.tsx @@ -125,7 +125,7 @@ export const CreateApiToken = ({ modal = false }: ICreateApiTokenProps) => { loading={loadingCreateToken} title={pageTitle} modal={modal} - description="Unleash SDKs use API tokens to authenticate to the Unleash API. Client SDKs need a token with 'client privileges', which allows them to fetch feature flag configurations and post usage metrics." + description='Unleash SDKs use API tokens to authenticate with the Unleash API. An SDK must be configured with a token of the corresponding type, so they can fetch feature flags and post usage metrics.' documentationLink='https://docs.getunleash.io/reference/api-tokens-and-client-keys' documentationLinkLabel='API tokens documentation' formatApiCode={formatApiCode} diff --git a/frontend/src/component/common/ApiTokenTable/useApiTokenTable.tsx b/frontend/src/component/common/ApiTokenTable/useApiTokenTable.tsx index 8cdc3dc628..0267784412 100644 --- a/frontend/src/component/common/ApiTokenTable/useApiTokenTable.tsx +++ b/frontend/src/component/common/ApiTokenTable/useApiTokenTable.tsx @@ -142,12 +142,12 @@ const tokenDescriptions: { [index: string]: { label: string; title: string }; } = { client: { - label: 'CLIENT', - title: 'Connect server-side SDK or Unleash Proxy/Edge', + label: 'BACKEND', + title: 'Connect backend SDK or Unleash Edge', }, frontend: { label: 'FRONTEND', - title: 'Connect web and mobile SDK', + title: 'Connect frontend SDK', }, admin: { label: 'ADMIN', diff --git a/frontend/src/component/environments/EnvironmentTable/EnvironmentActionCell/EnvironmentCloneModal/EnvironmentCloneModal.tsx b/frontend/src/component/environments/EnvironmentTable/EnvironmentActionCell/EnvironmentCloneModal/EnvironmentCloneModal.tsx index d988a50673..d07bd1db80 100644 --- a/frontend/src/component/environments/EnvironmentTable/EnvironmentActionCell/EnvironmentCloneModal/EnvironmentCloneModal.tsx +++ b/frontend/src/component/environments/EnvironmentTable/EnvironmentActionCell/EnvironmentCloneModal/EnvironmentCloneModal.tsx @@ -334,10 +334,9 @@ export const EnvironmentCloneModal = ({ - A new Server-side SDK (CLIENT) API token - will be generated for the cloned - environment, so you can get started right - away. + A new backend API token will be generated + for the cloned environment, so you can get + started right away. = ({ - Server-side SDKs + Backend SDKs - Server-side clients run on your server and + Backend clients run on your server and communicate directly with your Unleash instance. @@ -208,10 +208,10 @@ export const AvailableIntegrations: VFC = ({ - Client-side SDKs + Frontend SDKs - Client-side SDKs can connect to the{' '} + Frontend SDKs can connect to the{' '} = ({ target='_blank' rel='noopener noreferrer' > - Unleash front-end API + Unleash Frontend API - , but not to the regular Unleash client API. + , but not to the regular Unleash Client API. diff --git a/src/lib/openapi/spec/bulk-registration-schema.ts b/src/lib/openapi/spec/bulk-registration-schema.ts index 84c94af375..676f2864bf 100644 --- a/src/lib/openapi/spec/bulk-registration-schema.ts +++ b/src/lib/openapi/spec/bulk-registration-schema.ts @@ -5,7 +5,7 @@ export const bulkRegistrationSchema = { $id: '#/components/schemas/bulkRegistrationSchema', type: 'object', required: ['appName', 'instanceId', 'environment'], - description: `An application registration. Defines the format POSTed by our server-side SDKs when they're starting up`, + description: `An application registration. Defines the format POSTed by our backend SDKs when they're starting up`, properties: { connectVia: { type: 'array', diff --git a/src/lib/openapi/spec/client-features-schema.ts b/src/lib/openapi/spec/client-features-schema.ts index e4e8d11c0f..e3f3c20962 100644 --- a/src/lib/openapi/spec/client-features-schema.ts +++ b/src/lib/openapi/spec/client-features-schema.ts @@ -16,7 +16,7 @@ export const clientFeaturesSchema = { type: 'object', required: ['version', 'features'], description: - 'Configuration data for server-side SDKs for evaluating feature flags.', + 'Configuration data for backend SDKs for evaluating feature flags.', properties: { version: { type: 'number', diff --git a/src/lib/openapi/spec/resource-limits-schema.ts b/src/lib/openapi/spec/resource-limits-schema.ts index 9eefc3042d..0b8445caa7 100644 --- a/src/lib/openapi/spec/resource-limits-schema.ts +++ b/src/lib/openapi/spec/resource-limits-schema.ts @@ -98,7 +98,7 @@ export const resourceLimitsSchema = { minimum: 0, example: 2000, description: - 'The maximum number of SDK and admin API tokens you can have at the same time. This limit applies only to server-side and client-side SDK tokens and to admin tokens. Personal access tokens are not subject to this limit. The limit applies to the total number of tokens across all projects in your organization.', + 'The maximum number of SDK and admin API tokens you can have at the same time. This limit applies only to backend and frontend SDK tokens and to admin tokens. Personal access tokens are not subject to this limit. The limit applies to the total number of tokens across all projects in your organization.', }, projects: { type: 'integer', diff --git a/src/lib/openapi/util/openapi-tags.ts b/src/lib/openapi/util/openapi-tags.ts index 16b7f0ae5a..1e111c3a65 100644 --- a/src/lib/openapi/util/openapi-tags.ts +++ b/src/lib/openapi/util/openapi-tags.ts @@ -37,7 +37,7 @@ const OPENAPI_TAGS = [ { name: 'Client', description: - 'Endpoints for [Unleash server-side clients](https://docs.getunleash.io/reference/sdks).', + 'Endpoints for [Unleash backend clients](https://docs.getunleash.io/reference/sdks).', }, { name: 'Context',