Skip to main content
Sign in to Flashduty through Keycloak using the SAML2.0 or OIDC protocol.
This article does not cover deployment or explanation of Keycloak. For more information, see the official documentation.

Protocol configuration

1. Get ACS URL

Login to Flashduty console and obtain the ACS URL (needed in subsequent steps).Path: Platform → Organization → SSO → Flashcat service provider information → Assertion Consumer Service URL (select SAML 2.0 under Protocol & connection)Get ACS URL

2. Create client

Login to Keycloak console, path: Clients → Create client
  • Client Type: Select SAML protocol
  • Client ID: Enter flashcat.cloud (fixed value, cannot be changed)
Create ClientValid redirect URIs: Enter the ACS URL obtained from FlashdutyConfigure redirect

3. Configure client information

Change Name ID format to email type:Name ID formatSet Client signature required to disabled:Disable signature
Keycloak ships OpenID Connect email and phone scopes with the same names as the SAML scopes below. Delete them in Client scopes before you create the new ones.
Create client scopes: In Client scopes → Create client scope, create three scopes named email, phone, and username. For each, set Protocol to SAML, enter the scope name in Name, keep the other settings at their defaults, and save.Create scopeCompleted result:Scope resultAdd the three scopes to the client: Go to Clients → your client → Client scopes → Add client scope, select email, phone, and username, then click Add → Default.Add scope 1Add scope 2Configure a mapper for each scope: Open the scope, go to Mappers → Configure a new mapper, select User Attribute as the Mapper type, and fill in the fields below. The table uses email; configure phone and username the same way.Mapper 1Mapper 2Mapper 3

4. Download XML file

The downloaded file is a compressed package. After extracting locally, there will be two xml files; only the idp-metadata.xml file is needed.
Download locally from Client → Action:Download XMLUpload the XML file to Flashduty’s single sign-on configuration:

5. Create user and test login

Create user (must bind an email address):Create userLogin test: Visit console.flashcat.cloud and select SSO login. The SSO sign-in page defaults to business email: enter it, and Flashduty finds your organization and starts its authentication flow. If you only know the company domain, click Sign in with company domain and enter your organization’s login domain. You set this domain under Platform → Organization → Organization → Organization profile. You can also initiate single sign-on directly at {domain}.sso.flashcat.cloud.Test login