Okta

How to Configure SAML 2.0 for HappyFox Chat

Contents


Supported Features

The Okta/HappyFox Chat SAML integration currently supports the following features:

For more information on the listed features, visit the Okta Glossary.


Configuration Steps

  1. Login to the HappyFox Chat application as an administrator.

  2. Navigate to Manage > Security, and enter the following:

    • Set the Enable single sign on slider to ON/enabled.

    • Choose your identity provider: Select okta.

    • Take a look at the ACS URL value, it contains your SSO Account token value which you will need in Okta later. Your SSO Account token is the part of the ACS URL value that is between /sso/ and /acs/okta.

      For example, if your ACS URL is https://happyfoxchat.com/api/v1/sso/1a2b3c4d/acs/okta, then your SSO Account token is 1a2b3c4d.

    • Okta metadata: Copy and paste the following:

      Sign in to Okta Admin app to have this variable generated for you.
    • Click Save.

    happychat1.png

  3. In Okta, select the Sign On tab for the HappyFox Chat app, then click Edit.

    • Enter your SSO Account token you made a copy of in step 2 into the corresponding field.

    • Click Save:

    happyfox_new1.png

  4. Done!


Notes

The following SAML attributes are supported:


SP-initiated SSO

  1. Open the following URL: https://happyfoxchat.com/a/sso-login.

  2. Enter your Email address.

  3. Click Login:

  4. happychat3.png