Skip to main content

Integrating Your SSO Okta account with Archie

Setting the SSO integration using Okta

Camilo avatar
Written by Camilo
Updated over a week ago

In this guide, we’ll walk through the steps needed to connect your Okta account with Archie for single sign-on (SSO) integration. This integration will allow your employees to log in Archie using their current account. Before beginning, ensure you have admin access to both your Okta and Archie accounts.

Step 1: Start Configuring SAML Settings in Okta

  1. Log into your Okta account and go to Applications

  2. Click on Create App Integration , select SAML 2.0 and click Next

  3. Set the app name to 'Archie' and click Next.

  4. Add the values for Single Sign-on URL and SP Entity ID as stated below.

    1. https://archieapp.co/saml/acs

    2. https://archieapp.co

  5. Set the Attribute Statements with the below values.

    1. Name: FirstName ; Value: user.firstName

    2. Name: LastName ; Value: user.lastName

  6. Click Next and then Click Finish

  7. Go to the Sign On tab, copy the values for the Sign On URL , Issuer, and certificate fields into a notepad, we will be using these values later in Archie.
    ​

  8. Leave this tab open, we’ll be switching to Archie in a different tab, but we’ll be coming back to this one shortly

Step 2: Complete Configuration in Archie

  1. In Archie, go to "Settings > Integrations > App Marketplace" , locate the SSO SAML integration, and click View integration.

  2. Click Connect identity provider

  3. Fill the information needed

    1. Provider: Select Okta

    2. Provider name: Set the name that you would like to use to identify this integration

      1. Note: It's best to leave the Provider Name blank unless you have multiple SSO clients, like two Okta accounts for different user groups, where naming helps distinguish them.

    3. SSO URL: Enter the Sign on URL obtained in Step 1.7

    4. Entity ID: Enter the Issuer value obtained in Step 1.7

    5. Copy/paste certificate: Add the signing certificate copied in Step 1.7.

      1. Note:

        1. Copy paste the certificate itself and not a URL or download link

        2. When pasting the certificate, ensure no spaces or line breaks were added, as copying from Notepad can introduce breaks that cause issues—double-check before pasting

  4. Save your changes and copy the generated Relay State value into a notepad, you’ll need it later.

  5. Switch back to the Okta tab we were on before.

Step 3: Complete configuration in Okta

  1. Edit the Archie application you just created

  2. Under the SAML Settings paste the Relay State value copied in Step 2.4 into the Default RelayState field and save the changes

  3. Go to the Assignments tab

  4. Start adding the Users/Groups that you want to grant access to Archie

You’re All Set!

Your Okta account is now integrated with Archie. Users can now log in to Archie with their SSO credentials.

Did this answer your question?