Enabling the Okta Single Sign-on (SSO) Integration

The Okta Single Sign-On Integration allows a secure authentication method that leverages managed Okta account credentials. When enabling this integration, it enforces and requires all user logins to the Addigy console from an Okta app interface.

Note: If you are editing your existing configuration, you must disable the integration to be able to edit.

Table of Contents

• Prerequisites
• Setting up the Integration
• General Settings
• Configure SAML
  • Required SAML Integration Settings
  • (Optional) Auto Assignment of Addigy User Roles
  • Finding User Role ID in Addigy
• Feedback
• Addigy Setup

Prerequisites

1. Okta is required.
2. Okta Admin access is required to configure the integration.
3. The Create and EditIntegration privileges are required in Addigy to configure the Okta Single Sign-on integration.
4. Please ensure that you are using the same email address that's associated with your Addigy account.

Setting up the Integration

1. The first step is to set up an Application within Okta. Start by clicking on the Applications tab in the navigation bar.
   
2. On the Applications page, click Create App Integration.
   
3. On the Application creation modal, you'll want to configure the App with the following settings:
   • Sign on method set to SAML 2.0:
4. Click Next.

General Settings

Now we begin the three step process of configuring our SAML Applications.

1. Let's begin by adding in an App Name and an App logo, then click Next.
   Note: Feel free to use this Addigy logo for your Application Integration, here is a link to the logo ( The logo image is also attached to the bottom of this article): https://addigy.com/wp-content/uploads/2020/11/201125_Addigy_Iso_Transparent_420x240.png
   

Configure SAML

1. To get the URL and URI for the application's SAML settings, navigate to Account >> Integrations in your Addigy Console.
2. Under Login Options click on the Okta tile.
   

Required SAML Integration Settings

1. Copy the Addigy Entity ID to the Okta Audience URI (SP Entity ID) field.
2. Copy the Addigy Assertion Consumer Service to the Okta Single sign-on URL field. 
   
   
3. Set the Name ID Format and Application Username to EmailAddress and Email, respectively.
   
4. Scroll down and apply the following Attribute mappings for First Name, Last Name, and Email.
   Note: Values are case sensitive and should be formatted in the following fashion:
   user.firstName
   user.lastName
   user.email

(Optional) Auto Assignment of Addigy User Roles

If you are looking to automatically assign roles upon creation, you can make a Role attribute and tie it to a user attribute in Okta that holds an Addigy Role ID.

Note: Omitting a role attribute or specified role id in Okta will default the user role to "user" role in Addigy.

The Attribute mappings with a role attribute should look similar to this:

Finding User Role ID in Addigy

You can find the role ID of any role by navigating to Account >> Users then scrolling down the roles table. 

Clicking on the role ID will open a window with role details. Clicking on the Copy will copy the roleID to your clipboard.

Feedback

Select a feedback option and click Finish.

Addigy Setup

1. You'll be redirected to your app's Sign On Settings page; click View SAML Setup Instructions.
2. Copy over the Identity Provider Single Sign-on URL back to the Addigy Okta SSO URL and the Okta Identity Provider Issuer value back to the Addigy Entity ID URL in the integration panel.
3. Download the certificate from Okta and upload it into the Addigy Integration.

Now it's time to enable the integration on the Addigy Console using the toggle on the top right.

After assigning the application to a user, they will be able to see the application in their Okta Apps Console.

Note: Sign-in will need to be via the application in Okta Apps Console.