Benutzerdefiniert

Casdoor unterstützt die Konfiguration von SAML Custom Providern, und Sie können Casdoor als Service Provider (SP) verwenden, um eine Verbindung mit jedem Identity Provider (IDP) herzustellen, der das SAML 2.0 Protokoll unterstützt.

Schritt 1. Configure your Identity Provider

When setting up your Identity Provider (such as Google Workspace, Azure AD, Okta, or any other SAML 2.0 compatible IdP), you'll need to provide the following Casdoor SP information:

• ACS URL (Assertion Consumer Service URL): https://<your-casdoor-domain>/api/acs

  • Example: https://door.example.com/api/acs
  • This endpoint only accepts POST requests

• Entity ID (SP Entity ID): https://<your-casdoor-domain>/api/acs

  • Use the same URL as your ACS URL

Replace <your-casdoor-domain> with your actual Casdoor domain. For example, if your Casdoor instance is running at http://localhost:8000, use http://localhost:8000/api/acs for both values.

Schritt 2. Holen Sie sich die Metadaten des IDP

After configuring your IdP, obtain the metadata, which is an XML document that describes the configuration information of the services provided by the IdP. Es muss Informationen wie EntityID, SSO Endpoint usw. enthalten.

Einige IDPs, wie Keycloak, benötigen SP-Informationen, um Metadaten bereitzustellen. You can refer to the document Keycloak.

Step3. Konfigurieren Sie SAML Custom Provider

After obtaining the metadata from your IdP, create a SAML Custom Provider in Casdoor and fill in the necessary information.

Feld	Beschreibung
Category	Wählen Sie SAML
Type	Wählen Sie Custom
Favicon.URL	Die URL des IDP-Logos
Metadata	Die Metadaten des IDP

Then click Parse button, and fields Endpoint, IdP, Issuer URL, SP ACS URL and SP Entity ID will be automatically parsed.

Finally, add the SAML Custom Provider to Providers of the application.