Cloudflare Docs
Area 1 Email Security
Area 1 Email Security
Visit Area 1 Email Security on GitHub
Set theme to dark (⇧+D)

Okta integration guide

In this tutorial you will learn how to connect your Area 1 account to Okta. When single sign-on (SSO) is correctly configured, your authorized employees can connect to the Area 1 dashboard using a familiar user name and password.

​​ 1. Create an Area 1 app in Okta

You will need to manually create an app for Area 1 in Okta.

  1. Log in to Okta as an administrator.

  2. In the Admin console, go to Applications > Applications.

    Go to Applications in your Okta Admin console

  3. Select Create App Integration > SAML 2.0, and select Next.

    Choose SAML 2.0 as the new app integration type

  4. Enter a descriptive name for your app, such as Area 1, and select Next.

  5. Enter the following settings for SAML Settings:

    Single sing on URLhttps://horizon.area1security.com/api/users/saml
    Audience URI (SP Entity ID)https://horizon.area1security.com/api/users/saml
    Name ID formatSelect EmailAddress from the drop-down menu.
    Application usernameSelect Email from the drop-down menu.
    ResponseSigned
    Assertion signatureUnsigned
    Signature AlgorithmRSA-SHA1
    Digest AlgorithmSHA1
    Attribute statements (optional)
    NameEnter email addresses for your users. Should match users already added to Area 1 dashboard.
    Name formatSelect Unspecified from the drop-down menu.
    ValueSelect user.email from the drop-down menu.

    Input the correct settings in SAML settings

  6. Select Next.

  7. Under Are you a customer or a partner?, select I’m an Okta customer adding an internal app.

  8. In App type, select This is an internal app that we have created.

  9. Select Finish.

  10. Okta should display the app you have just created. If not, go to Applications > Applications, and select it.

  11. In the Sign On tab, go to View SAML setup instructions and select it to retrieve the SAML provider information.

    Find the View SAML setup instructions button

  12. Copy and save the link in Identity Provider Single Sign-On URL. You will need it later to use in the Area 1 dashboard.

    Copy and save the SSO URL to use later in the Area 1 dashboard

  13. Scroll down to Optional. You might need to enlarge the text box to copy and save all the XML data. You will need this information to finish configuration in the Area 1 dashboard. The start of the metadata should be similar to the following:

    <?xml version="1.0" encoding="utf-8"?><EntityDescriptor ID="_<YOUR_DESCRIPTIOR_ID>" entityID="https://<YOUR_ENTITY_ID> " xmlns="urn:oasis:names:tc:SAML:2.0:metadata">...

    Copy and save the XML metadata to use later in the Area 1 dashboard

​​ 2. Configure Area 1 to connect to Okta

  1. Log in to the Area 1 dashboard.

  2. Go to Settings (the gear icon).

  3. In Users and Actions > Users and Permissions add the email addresses of all your authorized administrators.

    Fill out your authorized administrators

  4. Go to SSO Settings and enable Single Sign On switch.

    Enable SSO

  5. In SSO Enforcement, choose one of the settings according to your specific needs:

    • None: This setting allows each user to choose SSO, or username and password plus 2FA (this is the recommended setting while testing SSO).
    • Admin: This setting will force only the administrator account to use SSO. The user that enables this setting will still be able to log in using username and password plus 2FA. This is a backup, so that your organization does not get locked out of the portal in emergencies.
    • Non-Admin Only: This option will require that all Read only and Read & Write users use SSO to access the portal. Admins will still have the option to use either SSO or username and password plus 2FA.
  6. In SAML SSO Domain enter the domain you saved from step 13. For example, area1security-examplecorp.okta.com.

  7. In Metadata XML paste the XML metadata you saved from step 14.

  8. Select Update Settings to save your configuration.

Log out of any customer portal sessions. Your Okta account should now show a tile for Area 1.