Configuring SAML for HappyFox

REQUIRED ACCOUNT/PERMISSION LEVEL

Bitium: All account levels; must be an admin to set up

HappyFox: Must be an admin to set up

In Bitium:

  1. Go to “Manage Apps.”

  2. Select “HappyFox” from the list of installed apps.

  3. Select the “Single Sign-On” tab.

  4. From the dropdown, select “SAML Authentication.”

    Select SAML Authentication

Leave your Bitium window open and continue in a new tab.

In HappyFox:

  1. While logged into HappyFox as an admin, navigate to Manage > Integrations. Under “External,” find “SAML Integration” and click “Configure.”
  2. Under “SAML Configuration,” set the “Choose SSO Provider” drop down to “Custom SAML Provider.”
  3. In Bitium, copy the Login URL. Paste into the “SSO Target URL” field in HappyFox.
  4. In Bitium, copy the X.509 Certificate. Paste into the “IdP Signature” field in HappyFox.
  5. Set the “Authenticate helpdesk staff using SAML” dropdown to “Yes.”
  6. Set the “Authenticate end users using SAML” drop down to “No” since your end users will not be members of your Bitium organization. If this is not your use-case, please contact us to consult on the appropriate setup.
  7. Under “Basic SAML Settings” in HappyFox, make sure the dropdown “SAML Integration active” is set to “Yes.”
  8. Save Settings in HappyFox and click “Save Changes” in Bitium.
This app does support JIT provisioning. You’ll be able to assign users the app in Bitium, and new user accounts will be created when they authenticate in via SAML. However, before they can fully access their account, an admin in HappyFox will have to manage them under HappyFox Manage Users, and assign them the appropriate permissions. After these are no longer ‘pending SSO accounts’ the users will have full and regular access.
SAML Enabled will be illuminated in green once completed.