move refresh tokens to oidc

coder · EdwardAngert · Jun 16, 2025 · Jun 11, 2025 · Jun 11, 2025 · Jun 12, 2025
commit cc0e46fc9822876fd7b2cf3a0cd24c74e6727e9d
diff --git a/docs/admin/setup/appearance.md b/docs/admin/setup/appearance.md
@@ -41,7 +41,7 @@ users of which network their Coder deployment is on.
 
 ## OIDC Login Button Customization
 
-[Use environment variables to customize](../users/oidc-auth.md#oidc-login-customization)
+[Use environment variables to customize](../users/oidc-auth/index.md#oidc-login-customization)
 the text and icon on the OIDC button on the Sign In page.
 
 ## Support Links

diff --git a/docs/admin/users/index.md b/docs/admin/users/index.md
@@ -7,7 +7,7 @@ enforces MFA correctly.
 
 ## Configuring SSO
 
-- [OpenID Connect](./oidc-auth.md) (e.g. Okta, KeyCloak, PingFederate, Azure AD)
+- [OpenID Connect](./oidc-auth/index.md) (e.g. Okta, KeyCloak, PingFederate, Azure AD)
 - [GitHub](./github-auth.md) (or GitHub Enterprise)
 
 ## Groups

diff --git a/docs/admin/users/oidc-auth.md → docs/admin/users/oidc-auth/index.md b/docs/admin/users/oidc-auth.md → docs/admin/users/oidc-auth/index.md
diff --git a/docs/admin/external-auth/refresh-tokens.md → docs/admin/users/oidc-auth/refresh-tokens.md b/docs/admin/external-auth/refresh-tokens.md → docs/admin/users/oidc-auth/refresh-tokens.md
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -395,7 +395,14 @@
 						{
 							"title": "OIDC Authentication",
 							"description": "Configure OpenID Connect authentication with identity providers like Okta or Active Directory",
-							"path": "./admin/users/oidc-auth.md"
+							"path": "./admin/users/oidc-auth/index.md",
+							"children": [
+								{
+									"title": "Configure OIDC refresh tokens",
+									"description": "How to configure OIDC refresh tokens",
+									"path": "./admin/users/oidc-auth/refresh-tokens.md"
+								}
+							]
 						},
 						{
 							"title": "GitHub Authentication",
@@ -640,14 +647,7 @@
 					"title": "External Authentication",
 					"description": "Learn how to configure external authentication",
 					"path": "./admin/external-auth/index.md",
-					"icon_path": "./images/icons/plug.svg",
-					"children": [
-						{
-							"title": "Configure OIDC refresh tokens",
-							"description": "How to configure OIDC refresh tokens",
-							"path": "./admin/external-auth/refresh-tokens.md"
-						}
-					]
+					"icon_path": "./images/icons/plug.svg"
 				},
 				{
 					"title": "Integrations",

diff --git a/docs/tutorials/best-practices/security-best-practices.md b/docs/tutorials/best-practices/security-best-practices.md
@@ -25,7 +25,7 @@ credentials are stolen.
 
 ### User authentication
 
-Configure [OIDC authentication](../../admin/users/oidc-auth.md) against your
+Configure [OIDC authentication](../../admin/users/oidc-auth/index.md) against your
 organization’s Identity Provider (IdP), such as Okta, to allow single-sign on.
 
 1. Enable and require two-factor authentication in your identity provider.

diff --git a/docs/tutorials/configuring-okta.md b/docs/tutorials/configuring-okta.md
@@ -15,7 +15,7 @@ Sign On (SSO) on Coder.
 
 To configure custom claims in Okta to support syncing roles and groups with
 Coder, you must first have setup an Okta application with
-[OIDC working with Coder](../admin/users/oidc-auth.md).
+[OIDC working with Coder](../admin/users/oidc-auth/index.md).
 From here, we will add additional claims for Coder to use for syncing groups and
 roles.