SSO/SAML

Enable SAML Single Sign-on (SSO) For Active Directory Federation Services (AD FS)

This article will instruct you on how to set up and enable SAML on your account so that your users can quickly and easily log in to take their KnowBe4 training using AD FS. For more information on AD FS, see Microsoft's Create a Relying Party Trust article and read each of the below three sections.

Note: Make sure the email address that your users use to authenticate with SAML is either entered into the Email field or Email Aliases field of their user profile. However, only the email address listed in the Email field will receive training notification emails. For more information about adding information to user profiles, visit our User Profile Guide.

How to Set Up SAML

To set up SAML, follow the steps below:

  1. Access your AD FS management console.
  2. Expand the Trust Relationships folder.
  3. Right-click Relying Party Trust and click Add Relying Party Trust…. When you click, the Add Relying Party Trust window will open.
  4. Click Start on the wizard’s Welcome screen.
  5. Choose Enter data about the relying party manually. Click Next.
  6. Enter a display name, such as "KnowBe4". Click Next.
  7. Leave AD FS profile selected and click Next.
  8. On the Configure Certificate screen, click Next.
  9. On the Configure URL screen, select the Enable support for the SAML 2.0 WebSSO protocol option. Stay on the Configure URL screen and move on to the next step.
  10. For this step, you'll need to obtain your unique Callback URL from your KSAT Account Settings:
    1. Log in to your KSAT account.
    2. After logging in, click your email address at the top-right corner of the page.
    3. Select Account Settings.
    4. Navigate to Account Integrations > SAML
    5. Copy your account-specific callback URL. For example, https://training.knowbe4.com/auth/saml/xxxxxxxxxxx/callback.
    6. Navigate back to the Configure URL screen of the setup wizard.
    7. Paste the link you obtained into the Relying party SAML 2.0 SSO service URL field on the Configure URL page and click Next.
  11. On the Configure Identifiers screen, enter "KnowBe4" into the Relying party trust identifier field. Click Add, then click Next.
  12. Leave the I do not want to configure multi-factor authentication settings for this relying party trust at this time option selected, then click Next.
  13. Leave the Permit all users to access this relying party option selected, then click Next.
  14. On the Ready to Add Trust screen, click Next.
  15. Leave the Open the Edit Claim Rules dialog for this relying party trust when the wizard closes check box selected and click Close.
  16. In the Edit claim rules window, click Add Rule….
  17. On the Choose Rule Type screen, leave Send LDAP Attributes as Claims selected as the template and click Next.
  18. Enter a name, then under Attribute Store choose Active Directory. Under the Mapping of LDAP attributes to outgoing claim types area, select Email Addresses for the LDAP Attribute and then choose E-mail Address for Outgoing Claim Type. Click Finish.
  19. Click Add Rule... back on the Edit Claims window again.
  20. Under Claim rule template, select Transform an Incoming Claim and click Next.
  21. Enter a name and then change the following settings:
    • Incoming claim type: Select E-Mail Address.
    • Outgoing claim type: Select Name ID.
    • Outgoing name ID format: Select Email.
    • Pass through all claim values: Select this option.
  22. Click Finish on the Configure Claim Rule page, and then click OK on the Edit Claims window to exit.
  23. Right-click the relying party trust and select Properties.
  24. Click the Advanced tab and select SHA-256 from the Secure hash algorithm drop-down menu.
  25. Click OK to exit.

How to Find the SHA1 Thumbprint

To find the SHA1 thumbprint, follow the steps below:

  1. Open AD FS Management.
  2. Select the Certificates folder under Service.
  3. Select the Token-signing certificate.
  4. Select the Details tab.
  5. Select the Thumbprint option.
  6. Copy your unique thumbprint.

How to Enable SAML

The final step is to enable SAML on your account. To learn how to enable SAML on your account, please visit our How to Set Up SAML Single Sign-on for the Security Awareness Training Platform article. For more information on the AD FS LoginToRp parameter that is part of your target or SSO URL, please see Microsoft's AD FS 2.0 RelayState article.

Note: When adding your identify provider (IdP) SSO target URL to the SAML settings in your KSAT console, it should follow this format: https://samportal.example_domain.com/adfs/ls/idpinitiatedsignon.aspx?logintoRP=KnowBe4. Your ADFS server should follow this format: samportal.example_domain.com = FQDN.

Can't find what you're looking for?

Contact Support