Merge pull request #502 from kinde-oss/Fix/Folder-level-redirects

clairekinde11 · web-flow · commit b8ed2176ddcc · 2025-07-23T09:57:23.000+10:00
Fix/folder level redirects
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -60,7 +60,205 @@ export default defineConfig({
     "/design/pages/set-language-for-pages/":
       "/design/content-customization/set-language-for-pages/",
     "/design/pages/internationalization/":
-      "/design/content-customization/set-language-for-pages/"
+      "/design/content-customization/set-language-for-pages/",
+    
+    // Section-level redirects to prevent 404s when users truncate URLs
+    "/authenticate/":
+      "/authenticate/about-auth/about-authentication/",
+    "/billing/":
+      "/billing/about-billing/about-billing/",
+    "/build/":
+      "/build/applications/about-applications/",
+    "/contribute/":
+      "/contribute/",
+    "/design/":
+      "/design/brand/global-brand-defaults/",
+    "/developer-tools/":
+      "/developer-tools/about/our-sdks/",
+    "/get-started/":
+      "/get-started/apis-and-sdks/about-kinde-apis/",
+    "/integrate/":
+      "/integrate/connected-apps/add-connected-apps/",
+    "/machine-to-machine-applications/":
+      "/machine-to-machine-applications/about-m2m/authenticate-with-m2m/",
+    "/manage-your-account/":
+      "/manage-your-account/business-information/update-your-details/",
+    "/manage-users/":
+      "/manage-users/about/manage-users-across-organizations/",
+    "/properties/":
+      "/properties/about-properties/application-properties/",
+    "/releases/":
+      "/releases/about/about-feature-flags/",
+    "/trust-center/":
+      "/trust-center/agreements/terms-of-service/",
+    "/workflows/":
+      "/workflows/about-workflows/",
+    
+    // Authenticate section subfolder redirects
+    "/authenticate/about-auth/":
+      "/authenticate/about-auth/about-authentication/",
+    "/authenticate/auth-guides/":
+      "/authenticate/auth-guides/enterprise-connections-identity/",
+    "/authenticate/authentication-methods/":
+      "/authenticate/authentication-methods/email-authentication/",
+    "/authenticate/custom-configurations/":
+      "/authenticate/custom-configurations/authentication-experience/",
+    "/authenticate/enterprise-connections/":
+      "/authenticate/enterprise-connections/about-enterprise-connections/",
+    "/authenticate/manage-authentication/":
+      "/authenticate/manage-authentication/authenticated-sessions-across-multiple-applications/",
+    "/authenticate/multi-factor-auth/":
+      "/authenticate/multi-factor-auth/about-multi-factor-authentication/",
+    "/authenticate/social-sign-in/":
+      "/authenticate/social-sign-in/add-social-sign-in/",
+    
+    // Billing section subfolder redirects
+    "/billing/about-billing/":
+      "/billing/about-billing/about-billing/",
+    "/billing/billing-user-experience/":
+      "/billing/billing-user-experience/add-pricing-table/",
+    "/billing/get-started/":
+      "/billing/get-started/add-billing-role/",
+    "/billing/manage-plans/":
+      "/billing/manage-plans/about-plans/",
+    "/billing/manage-subscribers/":
+      "/billing/manage-subscribers/add-metered-usage/",
+    "/billing/payment-management/":
+      "/billing/payment-management/manage-stripe-connection/",
+    "/billing/pricing/":
+      "/billing/pricing/pricing-models/",
+    
+    // Build section subfolder redirects
+    "/build/applications/":
+      "/build/applications/about-applications/",
+    "/build/domains/":
+      "/build/domains/pointing-your-domain/",
+    "/build/env-variables/":
+      "/build/env-variables/add-manage-env-variables/",
+    "/build/environments/":
+      "/build/environments/environments/",
+    "/build/organizations/":
+      "/build/organizations/add-and-manage-organizations/",
+    "/build/set-up-options/":
+      "/build/set-up-options/access-policies/",
+    "/build/tokens/":
+      "/build/tokens/about-access-tokens/",
+    
+    // Design section subfolder redirects
+    "/design/brand/":
+      "/design/brand/global-brand-defaults/",
+    "/design/content-customization/":
+      "/design/content-customization/how-content-is-managed/",
+    "/design/customize-with-code/":
+      "/design/customize-with-code/connect-repo/",
+    "/design/pages/":
+      "/design/pages/page-layout/",
+    
+    // Developer tools section subfolder redirects
+    "/developer-tools/about/":
+      "/developer-tools/about/our-sdks/",
+    "/developer-tools/account-api/":
+      "/developer-tools/account-api/about-account-api/",
+    "/developer-tools/guides/":
+      "/developer-tools/guides/code-sync-errors/",
+    "/developer-tools/kinde-api/":
+      "/developer-tools/kinde-api/about-m2m-scopes/",
+    "/developer-tools/sdks/backend/":
+      "/developer-tools/sdks/backend/apollo-graphql/",
+    "/developer-tools/sdks/frontend/":
+      "/developer-tools/sdks/frontend/javascript-sdk/",
+    "/developer-tools/sdks/native/":
+      "/developer-tools/sdks/native/android-sdk/",
+    "/developer-tools/your-apis/":
+      "/developer-tools/your-apis/access-to-your-api/",
+    
+    // Get started section subfolder redirects
+    "/get-started/apis-and-sdks/":
+      "/get-started/apis-and-sdks/about-kinde-apis/",
+    "/get-started/connect/":
+      "/get-started/connect/callback-urls/",
+    "/get-started/guides/":
+      "/get-started/guides/byo-code/",
+    "/get-started/learn-about-kinde/":
+      "/get-started/learn-about-kinde/kinde-product-security/",
+    "/get-started/switch-to-kinde/":
+      "/get-started/switch-to-kinde/auth0-to-kinde/",
+    "/get-started/team-and-account/":
+      "/get-started/team-and-account/add-team-members/",
+    
+    // Integrate section subfolder redirects
+    "/integrate/connected-apps/":
+      "/integrate/connected-apps/add-connected-apps/",
+    "/integrate/third-party-tools/":
+      "/integrate/third-party-tools/cloudflare-zero-trust/",
+    "/integrate/webhooks/":
+      "/integrate/webhooks/about-webhooks/",
+    
+    // Machine-to-machine applications section subfolder redirects
+    "/machine-to-machine-applications/m2m-application-setup/":
+      "/machine-to-machine-applications/m2m-application-setup/add-feature-flags-to-m2m-applications/",
+    "/machine-to-machine-applications/m2m-token-customization/":
+      "/machine-to-machine-applications/m2m-token-customization/customize-m2m-tokens/",
+    "/machine-to-machine-applications/m2m-workflow-automation/":
+      "/machine-to-machine-applications/m2m-workflow-automation/m2m-workflow/",
+    "/machine-to-machine-applications/organization-scoped-m2m-apps/":
+      "/machine-to-machine-applications/organization-scoped-m2m-apps/enforce-org-m2m-access-in-your-api/",
+    "/machine-to-machine-applications/troubleshooting-m2m/":
+      "/machine-to-machine-applications/troubleshooting-m2m/troubleshoot-m2m-token-errors/",
+    
+    // Manage your account section subfolder redirects
+    "/manage-your-account/business-information/":
+      "/manage-your-account/business-information/change-your-business-time-zone/",
+    "/manage-your-account/profile-and-plan/":
+      "/manage-your-account/profile-and-plan/change-kinde-plan/",
+    "/manage-your-account/your-data/":
+      "/manage-your-account/your-data/check-your-mau/",
+    
+    // Manage users section subfolder redirects
+    "/manage-users/access-control/":
+      "/manage-users/access-control/accept-policies-signup/",
+    "/manage-users/add-and-edit/":
+      "/manage-users/add-and-edit/add-and-edit-users/",
+    "/manage-users/roles-and-permissions/":
+      "/manage-users/roles-and-permissions/apply-roles-and-permissions-to-users/",
+    "/manage-users/view-activity/":
+      "/manage-users/view-activity/hotjar/",
+    
+    // Properties section subfolder redirects
+    "/properties/work-with-properties/":
+      "/properties/work-with-properties/manage-properties/",
+    
+    // Releases section subfolder redirects
+    "/releases/about/":
+      "/releases/about/about-feature-flags/",
+    "/releases/feature-flags/":
+      "/releases/feature-flags/add-feature-flag/",
+    "/releases/guides/":
+      "/releases/guides/guide-to-app-store-approvals/",
+    
+    // Trust center section subfolder redirects
+    "/trust-center/agreements/":
+      "/trust-center/agreements/end-user-licence-agreement/",
+    "/trust-center/kinde-performance/":
+      "/trust-center/kinde-performance/service-status/",
+    "/trust-center/privacy-and-compliance/":
+      "/trust-center/privacy-and-compliance/compliance/",
+    "/trust-center/security/":
+      "/trust-center/security/security-at-kinde/",
+    
+    // Workflows section subfolder redirects
+    "/workflows/bindings/":
+      "/workflows/bindings/access-token-binding/",
+    "/workflows/configuration/":
+      "/workflows/configuration/bindings/",
+    "/workflows/example-workflows/":
+      "/workflows/example-workflows/existing-password-provided-workflow/",
+    "/workflows/getting-started/":
+      "/workflows/getting-started/connect-repo-for-workflows/",
+    "/workflows/manage-workflows/":
+      "/workflows/manage-workflows/create-workflow/",
+    "/workflows/observability/":
+      "/workflows/observability/workflow-build-logs/",
   },
   markdown: {
     rehypePlugins: [
diff --git a/scripts/validate-links.js b/scripts/validate-links.js
@@ -9,6 +9,48 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 const distFolder = path.join(__dirname, "../dist");
+const astroConfigPath = path.join(__dirname, "../astro.config.mjs");
+
+// Function to extract redirect destinations from astro.config.mjs
+function getRedirectDestinations() {
+  try {
+    const configContent = fs.readFileSync(astroConfigPath, "utf-8");
+    
+    // Extract the redirects object using regex
+    const redirectsMatch = configContent.match(/redirects:\s*{([^}]+)}/s);
+    if (!redirectsMatch) {
+      console.log(chalk.yellow("No redirects found in astro.config.mjs"));
+      return [];
+    }
+    
+    const redirectsSection = redirectsMatch[1];
+    
+    // Extract all destination URLs (the values after the colons)
+    const destinationMatches = redirectsSection.match(/:\s*"([^"]+)"/g);
+    if (!destinationMatches) {
+      console.log(chalk.yellow("No redirect destinations found in astro.config.mjs"));
+      return [];
+    }
+    
+    // Clean up the matches to get just the URLs
+    const destinations = destinationMatches.map(match => {
+      // Remove the ': "' prefix and '"' suffix
+      return match.replace(/:\s*"/, '').replace(/"$/, '');
+    });
+    
+    console.log(chalk.blue(`Found ${destinations.length} redirect destinations`));
+    return destinations;
+    
+  } catch (error) {
+    console.error(chalk.red(`Error reading astro.config.mjs: ${error.message}`));
+    return [];
+  }
+}
+
+// Function to check if a URL is a redirect destination
+function isRedirectDestination(url, redirectDestinations) {
+  return redirectDestinations.includes(url);
+}
 
 // Function to read all HTML files from a directory
 function readHtmlFiles(dir) {
@@ -63,7 +105,7 @@ function anchorExists(html, anchor) {
 }
 
 // Function to validate links
-function validateLinks(htmlFiles) {
+function validateLinks(htmlFiles, redirectDestinations) {
   let invalidLinks = [];
 
   htmlFiles.forEach((file) => {
@@ -74,6 +116,13 @@ function validateLinks(htmlFiles) {
       // Split by the first occurrence of `#` to allow fragments with slashes
       const [pathWithoutHash, ...hashParts] = link.split("#");
       const hash = hashParts.length ? hashParts.join("#") : null;
+      
+      // Check if this is a redirect destination - if so, skip validation
+      if (isRedirectDestination(pathWithoutHash, redirectDestinations)) {
+        console.log(chalk.yellow(`Skipping redirect destination: ${pathWithoutHash}`));
+        return;
+      }
+      
       const resolvedPath = path.join(distFolder, pathWithoutHash);
       const normalizedPath = path.normalize(resolvedPath);
       const ext = path.extname(normalizedPath);
@@ -109,6 +158,9 @@ function validateLinks(htmlFiles) {
 
 // Main function
 function main() {
+  // Get redirect destinations from astro.config.mjs
+  const redirectDestinations = getRedirectDestinations();
+  
   const htmlFiles = readHtmlFiles(distFolder);
   const allLinks = new Set();
 
@@ -118,7 +170,7 @@ function main() {
     links.forEach((link) => allLinks.add(link));
   });
 
-  const invalidLinks = validateLinks(htmlFiles);
+  const invalidLinks = validateLinks(htmlFiles, redirectDestinations);
 
   if (invalidLinks.length > 0) {
     console.log(chalk.red("Invalid Links:"));
diff --git a/src/content/docs/authenticate/about-auth/identity-and-verification.mdx b/src/content/docs/authenticate/about-auth/identity-and-verification.mdx
@@ -98,15 +98,15 @@ When you set up an enterprise connection or a social connection, you can select
 
 If a social provider gives us a new first name, last name or picture for a user, Kinde updates these fields in the user profile to match those supplied to us.
 
-This is on by default, but you can turn it off if you wish to keep a static profile. [About profile sync](/manage-users/about/#user-profiles-are-synced-to-kinde).
+This is on by default, but you can turn it off if you wish to keep a static profile. [About profile sync](/manage-users/about/).
 
 If you have syncing off at an environment level but turned on at a social connection level we will honor the request for the social connection to sync.
 
 ### Enterprise connection syncing
 
 If an enterprise provider gives us a new first name, last name, or picture for a user, Kinde updates these fields in the user profile to match those supplied to us.
 
-This is on by default, but you can turn it off if you wish to keep a static profile. [About profile sync](/manage-users/about/#user-profiles-are-synced-to-kinde).
+This is on by default, but you can turn it off if you wish to keep a static profile. [About profile sync](/manage-users/about/).
 
 If you have syncing off at an environment level but turned on at an enterprise connection level we will honor the request for the enterprise connection to sync.
 
diff --git a/src/content/docs/authenticate/manage-authentication/session-management-per-organization.mdx b/src/content/docs/authenticate/manage-authentication/session-management-per-organization.mdx
@@ -7,6 +7,9 @@ relatedArticles:
   - 76e2d2d3-830a-43b0-8b7b-8d0b0316b776
   - 5a248c6f-c1ae-480a-95c3-d3c69c81598d
   - 4ed081b0-7853-49be-b5fd-22a84a86bdad
+app_context:
+  - m: organization_details
+  - s: sessions
 description: Guide to managing Kinde authenticated sessions at the organization level including session persistence and inactivity timeouts for enterprise customers.
 metadata:
   topics: [authenticate]
