Keycloak Login using SAML Single Sign On | SSO with Keycloak as SAML IDP

Overview

Keycloak Single Sign-On (SSO) login for WordPress can be achieved by using our SAML Single Sign-On (SSO) plugin. Our plugin is compatible with all the SAML compliant Identity Providers. Here we will go through a step-by-step guide to configure SSO login between WordPress site and Keycloak by considering Keycloak as IDP (Identity Provider) and WordPress as SP (Service Provider).
You can visit our SSO plugin for WordPress to know more about the other features we provide.

Download Plugin Pricing Plans Free Trial Expert Assistance

Pre-requisites : Download And Installation

To configure Keycloak as SAML IDP with WordPress, you will need to install the miniOrange SAML SP SSO plugin.

Select the version of Keycloak that you are using

Step 1: Setup Keycloak as IDP (Identity Provider)

Follow the following steps to Configure Keycloak as IDP:

Configure Keycloak as IDP

• In the miniOrange SAML SP SSO plugin, navigate to SP (Service Provider) Metadata tab. Here, you can find the SP metadata such as SP Entity ID and ACS (AssertionConsumerService) URL which are required to configure the keycloak as IDP (Identity Provider).

• In your Keycloak Admin console, select the realm that you want to use.
• Click on Clients from the left menu and then click on Create button to create a new client/application.

• Enter SP-EntityID / Issuer as the Client ID from the "Service Provider Metadata" Tab and select SAML as the Client Protocol.

• Now click on Save.
• Configure Keycloak by providing the required details:

Client ID	The SP-EntityID / Issuer from the plugin's Service Provider Metadata tab
Name	Provide a name for this client
Description	Provide a description
Client Signature Required	OFF
Force POST Binding	OFF
Force Name ID Format	OFF
Name ID Format	Email
Root URL	Leave empty or Provide Base URL from Service Provider Metadata tab
Valid Redirect URIs	The ACS (Assertion Consumer Service) URL from the plugin's Service Provider Metadata tab

• Under Fine Grain SAML Endpoint Configuration, Enter the following details:

Assertion Consumer Service POST Binding URL	The ACS (Assertion Consumer Service) URL from the plugin's Service Provider Metadata tab
Logout Service Redirect Binding URL (Optional)	The Single Logout URL from the plugin's Service Provider Metadata tab

• Click on Save.

• In the miniOrange SAML SP SSO plugin, navigate to SP (Service Provider) Metadata tab. Here, you can find the SP metadata such as SP Entity ID and ACS (AssertionConsumerService) URL which are required to configure the keycloak as IDP (Identity Provider).

• In your Keycloak Admin console, select the realm that you want to use.
• Click on Clients from the left menu and then click on Create Client button to create a new client/application.

• Select SAML as Client type, Enter SP-EntityID / Issuer as the Client ID from the "Service Provider Metadata" Tab,Enter Name of your application and enter Description.

• Now click on Save.
• Configure Keycloak by providing the required details:

Client ID	The SP-EntityID / Issuer from the plugin's Service Provider Metadata tab
Name	Provide a name for this client
Description	Provide a description
Client Signature Required	OFF
Force POST Binding	OFF
Force Name ID Format	OFF
Name ID Format	Email
Root URL	Leave empty or Provide Base URL from Service Provider Metadata tab
Valid Redirect URIs	The ACS (Assertion Consumer Service) URL from the plugin's Service Provider Metadata tab

• Now click on Save.
• In Advanced tab,under Fine Grain SAML Endpoint Configuration, Enter the following details:

Assertion Consumer Service POST Binding URL	The ACS (Assertion Consumer Service) URL from the plugin's Service Provider Metadata tab
Logout Service Redirect Binding URL (Optional)	The Single Logout URL from the plugin's Service Provider Metadata tab

• Click on Save.

• In the miniOrange SAML SP SSO plugin, navigate to SP (Service Provider) Metadata tab. Here, you can find the SP metadata such as SP Entity ID and ACS (AssertionConsumerService) URL which are required to configure the keycloak as IDP (Identity Provider).

• In your Keycloak Admin console, select the realm that you want to use.
• Click on Clients from the left menu and then click on Create Client button to create a new client/application.

• Select SAML as Client type, Enter SP-EntityID / Issuer as the Client ID from the Service Provider Metadata tab, enter Name of your application and enter Description.

• Click on the Next button.
• Provide the details as mentioned below:

Root URL	Leave empty or provide Base URL from Service Provider Metadata tab
Valid Redirect URIs	The ACS (Assertion Consumer Service) URL from the plugin's Service Provider Metadata tab

• Click on Save button.

• In the Settings tab under SAML capabilities section, configure Keycloak by providing the required details:

Force POST Binding	OFF
Force Name ID Format	OFF
Name ID Format	Email

• In the Keys tab, disable the Client signature required toggle.

• Click on the Save button.
• In Advanced tab, under Fine Grain SAML Endpoint Configuration, enter the following details:

Assertion Consumer Service POST Binding URL	The ACS (Assertion Consumer Service) URL from the plugin's Service Provider Metadata tab
Logout Service Redirect Binding URL (Optional)	The Single Logout URL from the plugin's Service Provider Metadata tab

• Click on Save button.

Add Mappers

• Navigate to Mappers tab and click on Add Builtin button.

• Select the checkboxes of X500 givenName, X500 surname and X500 email attributes.

• Click on Add Selected button. You will see the mappings that are added below.

• In Client scopes tab,click on your application.

• Click on Add predefined mapper.

• Select the checkboxes of X500 givenName, X500 surname and X500 email attributes.

• Click on Add button.
• You will see the mappings that are added below.

• In the Client scopes tab, click on your application.

• Click on Add predefined mapper.

• Select the checkboxes of X500 givenName, X500 surname and X500 email attributes.

• Click on the Add button.
• You will see the mappings that are added below.

Download setup file

• Navigate to Realm Settings, click on SAML 2.0 Identity Provider Metadata mentioned as Endpoints in the General Tab.

• Note the URL and keep it handy. That will provide you with the Endpoints required to configure the plugin.

• Navigate to Realm Settings, click on SAML 2.0 Identity Provider Metadata mentioned as Endpoints in the General Tab.

• Note the URL and keep it handy. That will provide you with the Endpoints required to configure the plugin.

• Navigate to Realm Settings, click on SAML 2.0 Identity Provider Metadata mentioned as Endpoints in the General tab.

• Note the URL and keep it handy. That will provide you with the Endpoints required to configure the plugin.

You have successfully configured Keycloak as SAML IDP (Identity Provider) for achieving Keycloak SSO login into your WordPress (WP) Site.

Note: If you intend to set up Attribute Mapping, Role Mapping, and other configurations on the Identity Provider's end, you can find detailed instructions in the provided setup guide, which is linked here.

You have successfully configured WordPress (WP) as SAML SP for achieving Keycloak Single Sign On.

In this Guide, you have successfully configured Keycloak SAML Single Sign-On (Keycloak SSO / Keycloak Login) choosing Keycloak as IDP and WordPress as SP using miniOrange plugin-SAML Single Sign On – SSO Login.This solution ensures that you are ready to roll out secure access to your WordPress (WP) site using Keycloak login credentials within minutes.

Additional Resources

• SSO for Keycloak Login | Keycloak SSO [SAML]
• SSO for Educational Institutes
• What is Single Sign-On (SSO)?
• WooCommerce SSO Integration with Keycloak for User Sync
• Keycloak SSO Login
• What is SAML?
• Frequently Asked Questions (FAQs)

If you are looking for anything which you cannot find, please drop us an email on samlsupport@xecurify.com