From 279f592d803e884064c54694c1e9da80f8a8c4d9 Mon Sep 17 00:00:00 2001 From: Florian Forster Date: Mon, 16 Mar 2026 16:03:11 -0700 Subject: [PATCH] docs: tweaking titles for better SEO appeal (#11852) Just updating some title and descriptions for better SEO discovery --------- Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .../guides/integrate/login/oidc/login-users.mdx | 10 +++++----- apps/docs/content/guides/integrate/token-exchange.mdx | 4 ++-- .../self-hosting/manage/configure/configure.mdx | 4 ++-- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/apps/docs/content/guides/integrate/login/oidc/login-users.mdx b/apps/docs/content/guides/integrate/login/oidc/login-users.mdx index 7cda997eb..326f509ab 100644 --- a/apps/docs/content/guides/integrate/login/oidc/login-users.mdx +++ b/apps/docs/content/guides/integrate/login/oidc/login-users.mdx @@ -1,7 +1,7 @@ --- -title: Authenticate users with OpenID Connect -description: "Authenticate users with OpenID Connect using ZITADEL's authorization code flow and Proof Key for Code Exchange (PKCE)" -sidebar_label: OIDC Code Flow + PKCE +title: "OpenID Connect (OIDC) Authentication: Authorization Code Flow & PKCE guide" +description: "Step-by-step guide to authenticating users in your application using OpenID Connect (OIDC). Learn how to implement the Authorization Code flow with PKCE for maximum security." +sidebar_label: OIDC Authorization Code Flow + PKCE --- import AuthMethods from "./_authmethods.mdx"; @@ -24,7 +24,7 @@ But regardless of the app type we recommend using Proof Key for Code Exchange (P Please read the following guide about the [different-client-profiles](./oauth-recommended-flows#different-client-profiles) and why to use PKCE. -### Code Flow +### Authorization Code Flow For a basic understanding of OAuth and its flows, we'll briefly describe the most important flow: **Authorization Code**. @@ -65,7 +65,7 @@ This will start a wizard asking you for an application name and a type. #### Authentication method After selecting WEB, you'll next have to choose an authentication method. As mentioned before we recommend using PKCE. -For even better security you could switch to JWT or just rely on the standard Code Flow. For security reasons we don't +For even better security you could switch to JWT or just rely on the standard Authorization Code Flow. For security reasons we don't recommend using POST and will not cover it in this guide. Please change the authentication method here as well, if you did so in the wizard, so we can better guide you through the process: diff --git a/apps/docs/content/guides/integrate/token-exchange.mdx b/apps/docs/content/guides/integrate/token-exchange.mdx index 800ff6ddb..2f6c02a5e 100644 --- a/apps/docs/content/guides/integrate/token-exchange.mdx +++ b/apps/docs/content/guides/integrate/token-exchange.mdx @@ -1,6 +1,6 @@ --- -title: Impersonation and delegation using Token Exchange -description: "Exchange tokens with different scopes, audiences, or subjects using RFC 8693 OAuth 2.0 Token Exchange grant and ZITADEL" +title: "OAuth 2.0 Token Exchange (RFC 8693): Impersonation & Delegation" +description: "Learn how to implement OAuth 2.0 Token Exchange (RFC 8693) in ZITADEL to securely exchange tokens for different scopes, audiences, or to impersonate users." sidebar_label: Token Exchange --- diff --git a/apps/docs/content/self-hosting/manage/configure/configure.mdx b/apps/docs/content/self-hosting/manage/configure/configure.mdx index 01fb9286d..80439dd36 100644 --- a/apps/docs/content/self-hosting/manage/configure/configure.mdx +++ b/apps/docs/content/self-hosting/manage/configure/configure.mdx @@ -1,6 +1,6 @@ --- -title: Configuration Options in ZITADEL -description: "Detailed guide to configuring ZITADEL using runtime files, database initialization settings, and environment variables." +title: "Self-Hosted ZITADEL Configuration: Runtime Settings & Environment Variables" +description: "Complete guide to configuring your self-hosted ZITADEL environment using the defaults.yaml runtime file, database initialization steps, and environment variables." sidebar_label: Configuration ---