Microsoft ADFS SSO

Enable Microsoft ADFS Single Sign On (SSO) for your Squadcast organisation

Squadcast supports SAML 2.0 based Single Sign On (SSO) login for Microsoft Active Directory users and you can set it for your organisation by following this integration guide.

Pre-requisites

  1. Account Owner / Administrator account in Squadcast
  2. A valid Squadcast subscription (Pro & Enterprise)

Points To Note

  1. Only an Administrator / Account owner can enable and configure Microsoft ADFS SSO for an organisation in Squadcast.
  2. Once enabled, only the Account owner can use email-password based login by default although it can be configured to enable email based login for Administrators as well.

Setup Instructions

  1. Go to the Integrations tab from your Squadcast account sidebar and click on Integrate under SSO card.
  1. In the opened modal, select the Custom SAML 2.0 tab and click Show configuration guide for Custom SAML 2.0.
  1. As given in the displayed guide, copy the ACS url . Then log in to your server and go to Server Manager.
  1. Go to Tools -> ADFS Management
  1. Click on Add Relying Party Trust.
  1. Select Claims Aware and click Start.

  2. Select Enter data about the relying party manually and click Next

  1. Enter the Display name. Click Next.
  1. Select Configure Certificate and click Next.
  1. Select Enable Support for the SAML 2.0 Web SSO protocol. Enter the ACS url you copied from Squadcast. Click Next.
  1. Paste the ACS url in Relying party trust identifier. Click Add. Then click Next.
  1. Select Access Control Policy. Click Next.
  1. In Ready to Add Trust. Click Next. Then Click Close.
  1. Click Edit Claim Insurance Policy.
  1. Click Add Rule.

  2. Select Send LDAP Attributes as Claims. Click Next.

  3. Give a name. Select Attribute Store as Active Directory. And map LDAP attributes to Outgoing Claim Type as shown below. Map E-Mail-Addresses to E-Mail Address, Given-Name to Given Name and Surname to Surname Click Ok.

  1. Then Click Add Rule. Select Send Claims using Custom Rule. Click Next.

  2. Give a Claim rule name. And enter the following Custom rule. Click Ok.

c:[Type == "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname"]
 => issue(Type = "last_name", Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer, Value = c.Value, ValueType = c.ValueType);
  1. Repeat the Above step and add two more custom rules. Following are the two rules.
c:[Type == "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname"]
 => issue(Type = "first_name", Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer, Value = c.Value, ValueType = c.ValueType);
c:[Type == "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"]
 => issue(Type = "email", Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer, Value = c.Value, ValueType = c.ValueType);

Point To Note

Make Sure the user accounts to be used for SSO have first name, last name and email configured.

  1. Click Apply.

  2. In your ADFS management dashboard.Go to Services->Certificates. Select Token Signing Certificate and Click View Certificate. Go to Details->Copy to File and and export the Der encoded binary X.509 certificate.

  1. Now convert the .cer file to a .pem file using the following command in Powershell.
openssl x509 -inform der -in certificatename.cer -out certificatename.pem
  1. Open the .pem file in text editor. Copy the contents and paste it in Squadcast under X.509 Certificate. Then enter the Saml 2.0 Endpoint as https://<Your Domain Name >/adfs/ls
  1. Enable SSO and click Save.

  2. ADFS SSO is now configured. To test it you can go to https://<Your Domain Name>/adfs/ls/idpinitiatedsignon. Select Your application and sign in with your user account. You will be logged in to Squadcast and an user will be created.

Updated about a month ago

Microsoft ADFS SSO


Enable Microsoft ADFS Single Sign On (SSO) for your Squadcast organisation

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.