docs: move sso how to guides to the how-to folder (#2323)

We're in the process of moving how-to guides into the how-to folder,
where they belong. This continues that work and shifts the how to guides
for SSO to the correct place and gives them appropriate names

Co-authored-by: Thomas Heartman <thomas@getunleash.ai>

website/docs/advanced/sso.md

@@ -18,7 +18,7 @@ In order to configure Single-Sign-On you will need to log in to the Unleash inst
 
 Unleash enterprise supports multiple authentication providers.
 
-- [OpenID Connect with Okta](./sso-open-id-connect.md)
+- [OpenID Connect with Okta](../how-to/how-to-add-sso-open-id-connect.md)
-- [SAML 2.0 with Okta](./sso-saml.md)
+- [SAML 2.0 with Okta](../how-to/how-to-add-sso-saml.md)
-- [SAML 2.0 with Keycloak](./sso-saml-keycloak.md)
+- [SAML 2.0 with Keycloak](../how-to/how-to-add-sso-saml-keycloak.md)
-- [Google Authentication](./sso-google.md) (deprecated)
+- [Google Authentication](../how-to/how-to-add-sso-google.md) (deprecated)

website/docs/how-to/how-to-add-sso-google.md

@@ -1,13 +1,16 @@
 ---
-id: sso-google
 title: '[Deprecated] How to add SSO with Google'
 ---
 
-> Single Sign-on via the Google Authenticator provider is deprecated. We recommend using [OpenID Connect](./sso-open-id-connect.md) instead.
+:::caution Deprecation notice
+
+Single Sign-on via the Google Authenticator provider is deprecated. We recommend using [OpenID Connect](./how-to-add-sso-open-id-connect.md) instead.
+
+:::
 
 ## Introduction {#introduction}
 
-In this guide we will do a deep dive on the Single-Sign-On (SSO) using Google Authentication. Unleash supports other identity providers and protocols, have a look at [all available Single-Sign-On options](./sso.md)
+In this guide we will do a deep dive on the Single-Sign-On (SSO) using Google Authentication. Unleash supports other identity providers and protocols, have a look at [all available Single-Sign-On options](../advanced/sso.md)
 
 ## Basic configuration
 

website/docs/how-to/how-to-add-sso-open-id-connect.md

@@ -1,13 +1,16 @@
 ---
-id: sso-open-id-connect
 title: How to add SSO with OpenID Connect
 ---
 
-> The **Single-Sign-On capability** is only available for customers on the Enterprise subscription. Check out the [Unleash plans](https://www.getunleash.io/plans) for details.
+:::note Availability
+
+The **Single-Sign-On capability** is only available for customers on the Enterprise subscription. Check out the [Unleash plans](https://www.getunleash.io/plans) for details.
+
+:::
 
 ## Introduction {#introduction}
 
-In this guide we will do a deep dive on the Single-Sign-On (SSO) using the OpenID Connect protocol and connect it with Okta as IdP. Unleash supports other identity providers and protocols, have a look at [all available Single-Sign-On options](./sso.md)
+In this guide we will do a deep dive on the Single-Sign-On (SSO) using the OpenID Connect protocol and connect it with Okta as IdP. Unleash supports other identity providers and protocols, have a look at [all available Single-Sign-On options](../advanced/sso.md)
 
 ## Basic configuration
 

website/docs/how-to/how-to-add-sso-saml-keycloak.md

@@ -1,13 +1,16 @@
 ---
-id: sso-saml-keycloak
 title: How to add SSO with SAML 2.0 Keycloak
 ---
 
-> The **Single-Sign-On capability** is only available for customers on the Enterprise subscription. Check out the [Unleash plans](https://www.getunleash.io/plans) for details.
+:::note Availability
+
+The **Single-Sign-On capability** is only available for customers on the Enterprise subscription. Check out the [Unleash plans](https://www.getunleash.io/plans) for details.
+
+:::
 
 ## Introduction {#introduction}
 
-In this guide we will do a deep dive on the Single-Sign-On (SSO) integration with SAML 2.0 and connect it with Keycloak as IdP. Unleash supports other identity providers and protocols, have a look at [all available Single-Sign-On options](./sso.md)
+In this guide we will do a deep dive on the Single-Sign-On (SSO) integration with SAML 2.0 and connect it with Keycloak as IdP. Unleash supports other identity providers and protocols, have a look at [all available Single-Sign-On options](../advanced/sso.md)
 
 ## Basic configuration
 

website/docs/how-to/how-to-add-sso-saml.md

@@ -1,13 +1,16 @@
 ---
-id: sso-saml
 title: How to add SSO with SAML 2.0 Okta
 ---
 
-> The **Single-Sign-On capability** is only available for customers on the Enterprise subscription. Check out the [Unleash plans](https://www.getunleash.io/plans) for details.
+:::note Availability
+
+The **Single-Sign-On capability** is only available for customers on the Enterprise subscription. Check out the [Unleash plans](https://www.getunleash.io/plans) for details.
+
+:::
 
 ## Introduction {#introduction}
 
-In this guide we will do a deep dive on the Single-Sign-On (SSO) integration with SAML 2.0 and connect it with Okta as IdP. Unleash support other identity providers and protocols, have a look at [all available Single-Sign-On options](./sso.md)
+In this guide we will do a deep dive on the Single-Sign-On (SSO) integration with SAML 2.0 and connect it with Okta as IdP. Unleash support other identity providers and protocols, have a look at [all available Single-Sign-On options](../advanced/sso.md)
 
 ## Basic configuration
 

website/docusaurus.config.js

@@ -189,6 +189,22 @@ module.exports = {
                         from: '/api/open_api',
                         to: '/reference/api/unleash',
                     },
+                    {
+                        from: '/advanced/sso-google',
+                        to: '/how-to/how-to-add-sso-google',
+                    },
+                    {
+                        from: '/advanced/sso-open-id-connect',
+                        to: '/how-to/how-to-add-sso-open-id-connect',
+                    },
+                    {
+                        from: '/advanced/sso-saml-keycloak',
+                        to: '/how-to/how-to-add-sso-saml-keycloak',
+                    },
+                    {
+                        from: '/advanced/sso-saml',
+                        to: '/how-to/how-to-add-sso-saml',
+                    },
                 ],
                 createRedirects: function (toPath) {
                     if (

website/sidebars.js

@@ -132,10 +132,10 @@ module.exports = {
                 {
                     label: 'Single Sign-On (SSO)',
                     items: [
-                        'advanced/sso-open-id-connect',
+                        'how-to/how-to-add-sso-open-id-connect',
-                        'advanced/sso-saml',
+                        'how-to/how-to-add-sso-saml',
-                        'advanced/sso-saml-keycloak',
+                        'how-to/how-to-add-sso-saml-keycloak',
-                        'advanced/sso-google',
+                        'how-to/how-to-add-sso-google',
                         'how-to/how-to-setup-sso-keycloak-group-sync',
                     ],
                     type: 'category',