Signed-off-by: Claudius <opensource@amenthes.de>
2.4 KiB
Authentication guide - SAML (OneLogin)
Note: This guide was written before the renaming. Just replace HackMD
with CodiMD
in your mind 😄 thanks!
-
Sign-in or sign-up for an OneLogin account. (available free trial for 2 weeks)
-
Go to the administration page.
-
Find "SAML Test Connector (SP)" for template of settings and select it.
-
Edit display name and icons for OneLogin dashboard as you want, and click SAVE.
-
After that other tabs will appear, click the Configuration, and fill out the below items, and click SAVE.
-
The registration is completed. Next, click SSO and copy or download the items below.
-
In your CodiMD server, create IdP certificate file from (A)
-
Add the IdP URL (B) and the Idp certificate file path to your config.json file or pass them as environment variables.
config.json
:{ "production": { "saml": { "idpSsoUrl": "https://*******.onelogin.com/trust/saml2/http-post/sso/******", "idpCert": "/path/to/idp_cert.pem" } } }
- environment variables
CMD_SAML_IDPSSOURL=https://*******.onelogin.com/trust/saml2/http-post/sso/****** CMD_SAML_IDPCERT=/path/to/idp_cert.pem
-
Try sign-in with SAML from your CodiMD sign-in button or OneLogin dashboard (like the screenshot below).