Skip to main content

Okta SAML integration

Multi-Factor Authentication (MFA) is an extra layer of security used when logging into websites or apps. Individuals are authenticated through more than one required security and validation procedure that only they know or have access to.

Security Assertion Markup Language (SAML) is a protocol for authenticating to web applications. SAML allows federated apps and organizations to communicate and trust one another’s users.

Arculix integrates with Okta via its SAML solution and provides single sign-on (SSO) MFA to ensure the convenience of cloud SSO without its potential security risks.

Watch a video about this integration in 5 minutes.

Prerequisites

  • Configured Arculix instance and user account with administrative privileges for Arculix.

  • Configured Arculix LDAP Agent.

    For more information, see the Arculix LDAP Agent deployment guide.

  • User account with administrative privileges for the Okta panel.

Okta Identity Providers configuration

In this section, you'll configure Okta as a service provider (SP).

  1. Download the SAML metadata and certificate for your organization from Arculix.

    Metadata download: https://sso.acceptto.com/<myorganization>/saml/download/metadata

    View metadata: https://sso.acceptto.com/<myorganization>/saml/metadata

    Certificate download: https://sso.acceptto.com/<myorganization>/saml/download/cert

  2. Log in to your Okta instance with a user with administrative privileges. Go to Security > Identity Providers.

    okta-idp.png
  3. Click Add Identity Provider and select Add SAML 2.0.

    okta_idp_dropdown.png
  4. In the Edit Identity Provider section, set the following:

    Name

    Enter a unique name.

    For example, Arculix.

    Protocol

    Set to SAML2.

    IdP Username

    Set to idpuser.subjectNameId.

    Match against

    Set to Okta Username.

    Account Link Policy

    Set to Automatic.

    Auto-Link Restrictions

    Set to None.

    If no match is found

    Select the check box for Redirect to Okta sign-in page.

    okta_saml_edit_idp.png
  5. Click Update Identity Provider.

  6. Click Show Advanced Settings .

  7. Set Request Binding to HTTPS POST, then click Update Identity Provider.

    okta_saml_advance_settings.png
  8. Set the Account Link Policy to Automatic.

    okta_saml_acct_link_policy.png
  9. After Identity Provider is created, click on the instance name and save that information for the next section.

    okta_saml_idp_settings.png

Arculix SAML configuration as an Identity Provider (IdP)

In this section, you'll add an application for Okta and set the SAML configuration settings. This will be the Identity Provider (IdP) side of the configuration.

  1. Log in to Arculix with an administrative account and go to Applications.

  2. Click Create New Application.

    Create new application
  3. In the New Application form, on the General tab, set the following configurations:

    Name

    Set the name of the application. This is the name to display for push notifications, in the Admin panel, Application portal, and audit logs.

    For example, Okta.

    Type

    Set to SAML Service Provider.

    Out of Band Methods

    Select the allowed methods end users can choose to approve MFA requests.

    For example, Arculix Mobile app (push notifications), SMS, or Security Key.

    Message for MFA Requests

    Optional. Type a message displayed to end users when sending an MFA request via push notification, SMS, or email.

    arculix_new_app_okta.png
  4. Select the SAML Service Provider Configuration tab, and set the following configurations:

    Issuer or Entity ID 

    Enter the Audience URL provided by Okta.

    Log in URL 

    Enter the URL used by users to access Okta.

    For example, https://example.oktapreview.com.

    Metadata URL

    Enter the Metadata URL provided by Okta.

    NameID Format 

    Set to Email Address.

    Name Identifier 

    Set to Email.

    ACS URL 

    Enter the ACS URL provided by Okta.

    arculix_okta_saml_settings.png
  5. Save your changes.

Set Arculix as default Identity Provider

  1. On the Okta admin page, go to Security > Identity Provider and click Routing Rules.

    okta_saml_routing.png
  2. Click Add Routing Rule .

  3. On the Add Rule page, set THEN: Use this identity provider to Arculix.

    okta_saml_add_rule.png
  4. Click Create Rule.

Test your application integration

  1. Go to your Okta instance.

    You will be redirected to the Arculix SSO page.

    Application login page with email
  2. After successful authentication, select your preferred MFA method to approve access to the Okta application.

    Select MFA method
  3. Pass the verification stage on the Arculix Mobile app.

  4. You are now authenticated with Arculix SSO-MFA and will be redirected to your Okta page.

    okta_dashboard.png

Disclaimer

All product names, trademarks, and registered trademarks are the property of their respective owners.

All company, product, and service names used in this document are for identification purposes only. The use of these names, trademarks, and brands do not constitute an endorsement by the SecureAuth Corporation.

Okta is either registered trademarks or trademarks of Okta, Inc. and/or one or more of its subsidiaries in the United States and/or other countries.

Microsoft and 'Active Directory' are either registered trademarks or trademarks of Microsoft and/or one or more of its subsidiaries in the United States and/or other countries.