Single Sign-On (SSO)
Rechat supports SAML 2.0 single sign-on (SSO) and identity provider-initiated single logout (SLO). This guide is intended for administrators who are configuring Rechat in their identity provider (IdP)
Overview
Activating SSO requires two steps. Configuring Single Logout is optional:
Add Rechat as a SAML service provider.
Provide your IdP metadata to Rechat.
Optional: Configure SAML Single Logout (SLO).
Step 1: Add Rechat as a SAML Service Provider
Add Rechat as a SAML service provider in your identity provider (IdP) using the settings below:
ACS URL
https://api.rechat.com/auth/saml
Entity ID
https://api.rechat.com/auth/saml
Signed Response
Enabled
NameID Format
Email address
Single Logout Service URL
https://api.rechat.com/auth/saml/logout
Rechat can use the following SAML attributes to populate the user’s profile:
firstName
John
lastName
Smith
phoneNumber
(555) 555-1234
timezone
America/Chicago
profileImage
https://yourwebsite.com/agents/1002.jpg
userid (primary key)
12345
Step 2: Provide Your IdP Metadata to Rechat
Provide Rechat with the following information:
SSO URL
Entity ID (issuer)
IdP signing certificate
Single Logout URL (optional)
Many IdPs provide these values in a downloadable metadata XML file. You can send that file to Rechat instead of listing each value separately.
After completing Steps 1 and 2, contact Rechat to activate SSO for your organization.
Optional: Configure SAML Single Logout
Rechat supports identity provider-initiated SAML 2.0 Single Logout (SLO) at:
https://api.rechat.com/auth/saml/logout
The endpoint supports HTTP-Redirect (GET) and HTTP-POST bindings. The IdP must send a signed LogoutRequest containing its issuer and the user’s NameID; SessionIndex and RelayState are optional.
Rechat validates the request, expires the matching SSO session, and redirects the browser to the IdP with a LogoutResponse. If no SessionIndex is provided, all sessions for that user and SSO provider are expired; other authentication tokens are unaffected.
Invalid issuers, payloads, or signatures are rejected without expiring a session.
Last updated
Was this helpful?