Contents x
    Okta (SAML)
    • 12 Sep 2023
    • 2 Minutes to read
    • Contributors
      Contents

      Okta (SAML)

      • Updated on 12 Sep 2023
      • 2 Minutes to read
      • Contributors
        Article Summary

        Introduction

        This guide offers insights into configuring Okta with SAML.

        By integrating with Okta, Perimeter 81 can authenticate users through the Security Assertion Markup Language (SAML) protocol, ensuring a secure and streamlined login process.

        Steps

        1. Log in to your Okta account.
        2. In the general Okta dashboard, select Applications.
        3. Using the list of shortcuts on the left-hand side of the screen, select Browse App Catalog and search for "Perimeter81", select our application and click Add.
        4. Leave everything in its default settings and click Done.
        5. Once the application has been created, click on the Sign On tab and then select the option to View Setup Instructions.

        6. You must copy and save your Sign In URL and X509 Signing Certificate for later.
        7.  Go back to the initial Okta tab with the Perimeter 81 application, click the Sign On tab Under the Settings section, click "Edit". Finally, you will add your Workspace name under the Workspace tab and select save.
        Workspace Name
        Your Workspace name is the subdomain of your Perimeter81 sign-in URL. For instance, if your sign-in URL is acme.perimeter81.com, your workspace will be "acme." It's important to note that this is case-sensitive.
        OPTIONAL: Group Support
        If you would like a group membership that exists on your Okta to sync over to Perimeter 81, you'll want to make sure the Groups portion has the following Syntax:
        • Groups: "Matches Regex" .* (Please note, this is a dot + asterisk)
        • You will also want to create the group on Perimeter 81 manually for this to work.

        Configuring the SAML 2.0 Application on Perimeter 81

        1. Log in to your Perimeter 81 Management Platform, and navigate to Settings, and then Identity Providers.
          360008600320addprovider11.png
        2. Select + Add Provider.
        3. Select Okta.
        4. Fill in the Sign In URL and X.509 Signing Certificate you previously copied.
        5. Add your organization's domain.
        6. Select Done.

        Assigning the App

        1. In Okta, navigate to Applications and select your SAML 2.0 Application 
        2. Click Assignments
        3. Assign the People or Groups you would like to get synchronized with Perimeter81
        4. Fill in any additional information, click Save and Go Back, Then click Done.


        Recommendations

        • To use Okta with SCIM integration (recommended), use the following document.
        • Ensure you have admin access in both Okta and Perimeter 81 platforms for a successful integration.
        • Always replace placeholders, such as YOUR_WORKSPACE, with the appropriate values during the setup.
        • Save your Sign In URL and X509 Signing Certificate from Okta for later use in Perimeter 81.
        • Periodically review your Okta configuration settings to ensure they align with any updates or changes made within the Perimeter 81 platform.

        Troubleshooting

        If you encounter issues during or after the setup, try reviewing your settings to ensure everything matches the instructions. In particular, check the IP addresses and other details you entered during setup. If issues persist, please consult our dedicated support.

        Support Contacts

        If you have any difficulties or questions, don't hesitate to contact Perimeter 81's support team. We offer 24/7 chat support on our website at Perimeter81.com, or you can email us at support@perimeter81.com. We're here to assist you and ensure your VPN tunnel setup is a success



        Was this article helpful?
        What's Next