fix(docs): add SAML SSO test instructions (#2020)

* fix(docs): create testing flex saml sso doc

Signed-off-by: ossdhaval <[email protected]>

* fix(docs): add images to the doc

Signed-off-by: ossdhaval <[email protected]>

* fix(docs): proofreading

Signed-off-by: ossdhaval <[email protected]>

---------

Signed-off-by: ossdhaval <[email protected]>

Author: ossdhaval

docs/admin/recipes/testing-flex-saml-sso-sptest.md

@@ -0,0 +1,83 @@
+---
+tags:
+  - administration
+  - test
+  - SAML
+  - SSO
+---
+
+
+# Test SAML SSO with Flex
+
+This guide shows how to test Flex for SAML SSO. We will be using 
+[sptest](https://sptest.iamshowcase.com/) test service provider 
+to complete our test.
+
+## Installing SAML IDP in the Flex Server
+
+During installation the [Flex Server](../../../../), make sure you have 
+selected the [Jans KC](https://docs.jans.io/head/janssen-server/keycloak/) 
+module to be installed.
+
+![image](../../assets/flex-install-janskc.png)
+
+## Configure IDP in Flex Server
+
+Follow the steps below to create a 
+TR and apply them in [Flex Server](../../../../):
+
+* Download the SP metadata using the following command:
+```bash title="Command"
+wget https://sptest.iamshowcase.com/testsp_metadata.xml
+```
+* Open the Flex Admin UI and navigate to `SAML > Configuration`.
+* Select `Keycloak` as the IDP.
+![image](../../assets/flex-select-idp.png)
+
+* Then navigate to `Website SSO` > `Add Service Provider`
+![image](../../assets/flex-website-sso.png)
+
+* Release the required attributes (e.g., `username`, `inum`).
+![image](../../assets/flex-release-attribute.png)
+
+* Finally, click Apply.
+
+## Configure SP in Iamshowcase
+
+
+After configuring the IDP in Flex Server, it's time to connect the service 
+provider (SP) with the IDP:
+
+* Download the IDP metadata from the following URL:
+```
+https://<your-janssen-server>/kc/realms/jans/protocol/saml/descriptor
+```
+* Go to: `https://sptest.iamshowcase.com/instructions#spinit` 
+and upload the IDP metadata.
+* After the metadata is uploaded, it will provide you with an 
+SP link to test the SAML SSO flow.
+![image](../../assets/flex-sp-link.png)
+
+
+## Test SSO
+
+* Copy that link and open it in a browser. You can open it in 
+incognito mode to avoid session issue.
+
+* This will redirect you to the Janssen login page. Once you log in with 
+your user credentials, you will be redirected back to the SP’s protected page, 
+which will display the user session details.
+
+Refer to the Janssen Server [SAML SSO](https://docs.jans.io/head/janssen-server/keycloak/keycloak-saml-sso/) documentation for further details.
+
+## FAQ
+
+Check KC scheduler log for any TR issue 
+```
+/opt/kc-scheduler/logs/scheduler.log
+```
+Also check file directory inside 
+```
+/opt/idp/configs/keycloak/sp/metadata
+```
+

docs/assets/flex-install-janskc.png

@@ -153,6 +153,7 @@ nav:
     - 'Flex Recipes':
         - 'admin/recipes/README.md'
         - 'Getting Started with Rancher': 'admin/recipes/getting-started-rancher.md'
+        - 'Testing Flex SAML SSO with sptest': 'admin/recipes/testing-flex-saml-sso-sptest.md'
     -  'Migrating from Gluu4': 'admin/gluu-migration.md'
 
 - 'Reference':