diff --git a/docs/docs/guides/integrate/identity-providers/mocksaml.mdx b/docs/docs/guides/integrate/identity-providers/mocksaml.mdx new file mode 100644 index 000000000..8b9bd426f --- /dev/null +++ b/docs/docs/guides/integrate/identity-providers/mocksaml.mdx @@ -0,0 +1,65 @@ +--- +title: Configure MockSAML as an Identity Provider in ZITADEL +sidebar_label: MockSAML +id: mocksaml +--- + +import GeneralConfigDescription from './_general_config_description.mdx'; +import Intro from './_intro.mdx'; +import CustomLoginPolicy from './_custom_login_policy.mdx'; +import IDPsOverview from './_idps_overview.mdx'; +import Activate from './_activate.mdx'; +import TestSetup from './_test_setup.mdx'; + + + +:::warning +MockSAML is not intended for any production environment, only for test purposes +::: + +## MockSAML + +### Download metadata + +You can either download the metadata under [https://mocksaml.com/api/saml/metadata?download=true](https://mocksaml.com/api/saml/metadata?download=true) or skip this step and +fill in the URL when creating the SAML SP in ZITADEL. + +## ZITADEL configuration + +### Add custom login policy + + + +### Go to the IdP providers overview + + + +### Create a new SAML ServiceProvider + +The SAML SP provider template has everything you need preconfigured. +Add the metadata.xml or the URL to the metadata which are accessible by you ZITADEL instance. +All the necessary configuration is contained in the metadata which has to be exchanged by the ServiceProvider and the IdentityProvider. + + + +![SAML SP Provider](/img/guides/zitadel_saml_create_provider.png) + +### Download metadata + +Normally, you would need to download the ServiceProvider metadata from ZITADEL to upload to the IdentityProvider. +They are available under [https://{CUSTOMDOMAIN}/idps/{ID of the provider in ZITADEL}/saml/metadata], but this step can be skipped due to the fact that MockSAML is only for testing purposes. + +### Activate IdP + + + +![Activate the SAML SP Provider](/img/guides/zitadel_activate_saml.png) + +## Test the setup + + + + +![SAML SP Button](/img/guides/zitadel_login_saml.png) + +![SAML SP Login](/img/guides/mocksaml_login.png) diff --git a/docs/sidebars.js b/docs/sidebars.js index 5e9c5ea27..1cc318d6b 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -293,6 +293,7 @@ module.exports = { "guides/integrate/identity-providers/migrate", "guides/integrate/identity-providers/okta", "guides/integrate/identity-providers/keycloak", + "guides/integrate/identity-providers/mocksaml", "guides/integrate/identity-providers/additional-information", ], }, diff --git a/docs/static/img/guides/mocksaml_login.png b/docs/static/img/guides/mocksaml_login.png new file mode 100644 index 000000000..364d01820 Binary files /dev/null and b/docs/static/img/guides/mocksaml_login.png differ diff --git a/docs/static/img/guides/zitadel_activate_saml.png b/docs/static/img/guides/zitadel_activate_saml.png new file mode 100644 index 000000000..a7019e40a Binary files /dev/null and b/docs/static/img/guides/zitadel_activate_saml.png differ diff --git a/docs/static/img/guides/zitadel_login_saml.png b/docs/static/img/guides/zitadel_login_saml.png new file mode 100644 index 000000000..70399ae89 Binary files /dev/null and b/docs/static/img/guides/zitadel_login_saml.png differ diff --git a/docs/static/img/guides/zitadel_saml_create_provider.png b/docs/static/img/guides/zitadel_saml_create_provider.png new file mode 100644 index 000000000..1a6ec312d Binary files /dev/null and b/docs/static/img/guides/zitadel_saml_create_provider.png differ