How to Create SAML Configuration in Okta

MCS from version 1.3.0

Table of Contents

Create SAML Configuration Application in Okta

Sign In to Okta

To configure SAML in Okta, you need to sign in:

1. Go to the Okta website.

2. Create an account if you don’t have one. Follow Okta’s instructions on their website.

3. Log in to your Okta account. Follow Okta’s instructions for signing in.

Steps to Create the SAML Configuration Application in Okta

1. Sign in to your Okta account.

2. Navigate to Applications → Applications in the left sidebar.

   

3. Click the Create App Integration button.

   

4. Select SAML 2.0 and click Next.

   

5. Provide an App Name and click Next.

   

6. Configure the SAML settings in the Configure SAML tab:

   • Single Sign-On URL: Enter the MCS Login URL Route prefixed with https://{MCS IP}/.
     Example:

     https://{MCS IP}/api/5.0/auth/saml/login/callback

   • Audience URI (SP Entity ID): Enter a unique ID. (This must match the Entity ID in MCS).

   • Name ID Format: Select Persistent.

   • 

7. Fill in the Feedback tab:

   • In the App Type field, enable This is an internal app that we have created.

     

8. Click Finish.

Create Groups and Users in the SAML Configuration Application

Steps to Create Groups in Okta

1. Sign in to your Okta account.

2. Navigate to Directory → Groups in the left sidebar.

   

3. Click Add Group.

   

4. Provide a Name and an optional Description for the group.

5. Refresh the page to view the new group.

6. Repeat for additional groups if needed.

Assign Group Attribute Statements in the SAML Configuration Application

1. Navigate to Applications → Applications.

   

2. Find the SAML Configuration Application you previously created in Okta.

3. Click the name of your SAML Configuration Application.

   

4. Navigate to the General tab in the SAML Configuration Application.

   

5. Scroll to the SAML Settings section and click Edit.

   

6. In the Edit SAML Integration, in the General Settings tab:

   1. Click on the Next button to get to the Configure SAML tab.

   2. Scroll down in the SAML Settings to the Group Attribute Statements (optional).

   3. Enter group in the Name field. (This must be spelled exactly as "group").

   4. Leave Name Format as Unspecified.

   5. Choose a filter (e.g., Equals or Starts With) and provide the appropriate value based on your group's name.

      

Example:

• If using the Equals filter, type the exact group name.

• If using the Starts With filter, type the group name prefix.

Note:

You cannot click Add Another to assign multiple groups because, in version 1.3.0, MCS expects only one group attribute statement with the name group, and Okta allows only a single group attribute statement with that name.

If you want to use the Equals filter, you can only configure one group with the group attribute statement named group. To associate multiple groups with MCS for different roles, you must use other filters, such as Starts with, and ensure all your groups have names that share a common prefix.

For example, the following is an invalid configuration:

4. Click Next and finish the configuration.

Assign Users to Groups in Okta

1. Navigate to Directory → Groups.

   

2. Click on a group’s name to open its configuration.

3. Click Assign People to assign users to the group.

   

4. Search for the desired user in the table or use the search bar.

   

5. Click on the + (Add) button next to the user’s name.

   

Assign Groups to the SAML Configuration Application

1. Navigate to Applications → Applications.

   

2. Find the SAML Configuration Application you previously created in Okta.

3. Click the name of your SAML Configuration Application.

   

4. Navigate to the Assignments tab in the SAML Configuration Application.

   

5. Click Assign → Assign to Groups.

   

6. Assign the relevant groups to the SAML Configuration Application.

7. Click on Done to save the changes.

Create SAML Configuration in MCS for Okta

Steps to Configure SAML in MCS

1. Sign in to your Okta account.

2. Navigate to Applications → Applications.

   

3. Find the SAML Configuration Application you previously created in Okta.

4. Click the name of your SAML Configuration Application.

   

5. Go to the Sign On tab at the top of the page.

   

6. Click the View SAML Setup Instructions button on the right side of the page, located under SAML Setup.

   

7. Copy the Identity Provider Single Sign-On URL field for later use.

8. Copy the X.509 Certificate field for later use. (Use the value between BEGIN CERTIFICATE and END CERTIFICATE).

9. Log in to MCS.

10. Click on the menu icon.

    

    1. A display of all the available widgets will open.

11. Navigate to Management → Identity Providers.

    

12. Fill in the required fields:

    • Entity ID / Issuer: Use the Audience URI (SP Entity ID) field you configured when setting up the SAML Configuration Application in Okta.

      

    • Entrypoint / IDP URL: Paste the Identity Provider Single Sign-On URL field you copied in step 7.

      

    • Certificate: Paste the X.509 Certificate field you copied in step 8.

      

13. Click Save to complete the configuration.

14. You and your users can now log in to MCS using Okta via SAML, in addition to the basic login method.