Skip to main content
All CollectionsManage Your AccountAccount Setup
Configure Single Sign-On (SSO) with Okta
Configure Single Sign-On (SSO) with Okta

Learn how to configure SSO with Okta

Sara Sorenson avatar
Written by Sara Sorenson
Updated over 3 months ago

Configure Single Sign-On (SSO) with Okta

banner, decorative

This article will cover how to set up single sign-on (SSO) using SAML 2.0 in Okta for your Muck Rack instance. SSO will allow your licensed Muck Rack users to access the Muck Rack application securely using their Okta credentials.

Supported SAML Features

The Muck Rack app that is part of the Okta Integration Network (OIN) currently supports

the following features:

  • SP-initiated SSO

Requirements

To set up SSO for your Muck Rack instance, you will need:

  • Approval from your Muck Rack account executive or your Muck Rack customer success manager
    ​

  • An Okta account with an Application Administrator or a Super Administrator role assigned.
    ​

  • You must use the same email address for both your Okta account and your Muck Rack account
    ​

Installing the Muck Rack OIN App

  1. In a new browser window, sign in to your Okta Admin dashboard using an Okta account that has Super Administrator or Application Administrator privileges.
    ​

  2. Navigate to your Okta Admin sidebar and select Applications > Applications.
    ​

    Shows the Applications page with the 'Browse App Catalog' button circled in red


    ​

  3. Next, select the Browse App Catalog button in the Applications window.
    ​

  4. In the search bar, search for “Muck Rack” and select the Muck Rack app from the search results and then select the Add Integration button in the top right corner of the app description window.
    ​

  5. Because Muck Rack does not support IdP-initiated SSO, check the box that says:
    ​
    ​Do not display application icon to users; this will help minimize login errors by preventing users from signing in via their Okta dashboard.
    ​

  6. Select the Done button to continue to the SAML configuration.
    ​

    Shows the General Settings with the checkbox for 'Application Visibility' checked and the 'Done' button in the bottom right corner


    ​

Configuring SAML Settings

  1. Contact the Muck Rack support team at support@muckrack.com and request that they enable SAML 2.0 for your account.
    ​

  2. Once you receive a SAML Setup Instructions email from Muck Rack Support with your connection name, navigate to the Sign On tab of your Muck Rack app.
    ​​

  3. Select Edit to the right of the Settings heading and navigate to the SAML 2.0 section.
    ​

  4. Select Attributes (Optional) to expand the section.
    ​

  5. Add the following SAML claims to the Attribute statements (Optional) section:

    1. Email

      1. Attribute name: email

      2. Attribute value: user.email

      3. Name format: Unspecified

    2. First name

      1. Attribute name: given_name

      2. Attribute value: user.firstName

      3. Name format: Unspecified

    3. Last name

      1. Attribute name: family_name

      2. Attribute value: user.lastName

      3. Name format: Unspecified
        ​

        Shows the 'Attributes' section with names filled in

  6. Navigate down to the Advanced Sign-on Settings section.
    ​

  7. Add the connection name provided to you in your SAML Setup Instructions email to

    the Connection name field.
    ​
    ​Note: This is typically the subdomain for your Muck Rack instance, e.g. your org

    name in https://[org-name].muckrack.com
    ​
    ​

    Shows the 'Advanced Sign-on Settings' and 'Credentials Details' sections with 'Connection name' and 'Application username format' options circled in red


    ​

  8. Select Email from the Application username format drop-down menu.
    ​

  9. Select the Save button to save your SAML settings.

Setting up SSO to Test

  1. Navigate to the Assignments tab of your Muck Rack app and add the users

    that will need access to Muck Rack; you will use these users to test SSO.
    ​

  2. Then, navigate to the Sign on methods section of your Muck Rack app and

    copy the Metadata URL.
    ​

    Shows the 'Sign on methods' section with 'Metadata details' circled in red and an arrow pointing to the 'Copy' button


    ​

  3. Reply to the SAML Setup Instructions email that Muck Rack Support sent and

    paste the metadata URL in the message.
    ​

  4. Once you receive an email from Muck Rack Support confirming that your

    connection is ready to test, open an incognito or a private browser window and

    go to: https://muckrack.com/login/sso
    ​

  5. Enter the email address you use for Okta and select the Log In button.
    ​

  6. You will be redirected to your Okta sign-on page.
    ​

  7. Enter your Okta login credentials and authenticate using MFA (if applicable).
    ​

  8. You should now be logged in to your Muck Rack account; if you run into an

    issue signing in, please contact support@muckrack.com for assistance.
    ​

  9. Once you’ve successfully completed testing, please send a reply in your thread

    with Muck Rack Support confirming that you’d like SSO hard-enabled.
    ​

  10. All of your active Muck Rack users will be force logged-out of the Muck Rack

    app and be asked to sign in with SSO on their next visit.

Get Help

For additional help, contact support by choosing the chat icon in the bottom right-hand corner of the screen and selecting Messages > Send us a message.

💬 Was this article helpful?

Share your feedback and let us know how to improve our Help Center content.

Related Articles
Email Logging
Configure Single Sign-On (SSO) with Microsoft Entra ID (formerly Azure AD)
Logging Into Muck Rack
An Overview of Data in Muck Rack
Privacy in Muck Rack for Journalists
Did this answer your question?