> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring a SAML application on Okta

> Instructions on how to configure a SAML SSO application with Okta.

<Steps>
  <Step title="Access Okta Applications">
    Log in to Okta, go to the admin dashboard, and select "Applications" in the navigation panel.
  </Step>

  <Step title="Create New App Integration">
    Select "Create App Integration".

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-1.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=d1b809a90c3c8a204ac6bb20875947d6" width="2066" height="977" data-path="img/IdentityProviders/okta-1.png" />
    </Frame>
  </Step>

  <Step title="Choose SAML 2.0 Integration Type">
    Select "SAML 2.0" and click 'Next'.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-2.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=0998ec5b9aa71b5e14edfc148a54bca2" width="1634" height="966" data-path="img/IdentityProviders/okta-2.png" />
    </Frame>
  </Step>

  <Step title="Choose SAML 2.0 Integration Type">
    Enter an "App Name" and click Next.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-3.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=1a8f6946bf9a9f96eec844c910521e0e" width="2054" height="1252" data-path="img/IdentityProviders/okta-3.png" />
    </Frame>

    <Note>
      Please note that the **IdP-Initiated Login URL**, **Service Provider ID (SP Entity ID)**, **Service Provider Login URL (SSO URL)** and **Service Provider Logout URL (SLO URL)** can be located within the SAML tab under the Account Management Settings section within the Blink Platform.

      **IdP-Initiated Login URL** : Please look in the Account Management Settings section within the Blink Platform to find your unique **IdP-Initiated Login URL**.

      **Service Provider ID (SP Entity ID)** : urn:amazon:cognito:sp:us-east-1\_Nu63sypSS

      **Service Provider Login URL (SSO URL)** : `https://cognito.blinkops.com/saml2/idpresponse`

      **Service Provider Logout URL (SLO URL)** : `https://cognito.blinkops.com/saml2/logout`

      <Frame>
        <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-13.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=7054fa88b9901aca5c2810c8b8202541" width="683" height="341" data-path="img/IdentityProviders/okta-13.png" />
      </Frame>

      <Info> **Please Note** users who use on-premise deployment, please **do not** use the above values to complete the **Create SAML Integration** section of the Okta application, instead you should login to your **own** on-premise deployment app and use the unique values provided in the **SAML** tab under the **Account Management Settings**.</Info>
    </Note>
  </Step>

  <Step title="Enter Blink SAML URLs and Identifiers">
    Using the unique **IdP-Initiated Login URL** available in the SAML tab under the Account Management Settings section within the Blink Platform, proceed to the **Create SAML Integration** section of the application and copy and paste the URL value in the **Single Sign-On URL** text field. Then copy and paste the **Service Provider Login URL (SSO URL)** value in **both** the **Recipient URL** text field and the **Destination URL** text field. Lastly copy and paste the **Service Provider ID (SP Entity ID)** value in the **Audience URI (SP Entity ID)** text field.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/okta-4.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=d99d62175044a684b434f5ad4a15cfc4" width="1146" height="878" data-path="img/IdentityProviders/okta-4.png" />
    </Frame>
  </Step>

  <Step title="Configure Attribute Statements">
    Scroll down to the “Attribute Statements” section and add the following key-value pairs, and then click Next.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/okta-5.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=f47ffa39b9ceb52af70084bbe172e361" width="1353" height="661" data-path="img/IdentityProviders/okta-5.png" />
    </Frame>
  </Step>

  <Step title="Add Group Attribute Statement">
    Then scroll down to the "Group Attribute Statement" section and fill out the following fields like portrayed in the following image:

    <Accordion title="Resolving SAML Group Mapping Errors with AWS Cognito" icon="lightbulb" color="green">
      The error message in the image indicates: **"Invalid SAML response received: The value of the attribute custom:groups must have a length less than or equal to 2048 characters."**

      <Frame>
        <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/SAMLError.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=d636e335896a6300a0b8e5116bcf9f76" width="474" height="630" data-path="img/IdentityProviders/SAMLError.png" />
      </Frame>

      ### Cause of the Error:

      This error occurs because the **SAML response from the client's Identity Provider (IdP)** includes a `custom:groups` attribute whose **total character length exceeds AWS Cognito's 2048-character limit** for string attributes.

      In this specific case:

      * The client configured **group mapping using a wildcard**, which sends **all the user's group memberships** via SAML.
      * As a result, Cognito receives a very long string of group names combined, pushing the total value over the 2048-character limit.
      * Cognito then **rejects the login attempt**, since it cannot store or process that oversized attribute.

      ***

      ### Recommended Solution:

      To fix this, **stop using wildcard group mapping** and instead implement **manual group mapping** in the IdP SAML configuration.

      #### What to do:

      * The client should **explicitly map only the relevant groups** required by Blink, such as:

        * `Blink Builders`
        * `Blink Users`
        * `Blink Admins`
      * This will **limit the number and size** of the groups included in the SAML assertion, ensuring the `custom:groups` attribute stays within Cognito’s size constraints.

      <Warning> Using wildcards (e.g., `*`) sends **all** group memberships, including unrelated or nested ones. This makes it unpredictable and highly prone to exceeding limits,especially in large organizations. This change needs to be made **in the client’s IdP application settings**, not in Blink or Cognito itself. </Warning>
    </Accordion>

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-14.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=1fe346ed8107d2f6cfa2fbdc1b6925bd" width="900" height="271" data-path="img/IdentityProviders/okta-14.png" />
    </Frame>
  </Step>

  <Step title="Map Roles in Blink Platform">
    Then head to the **SAML** tab under the **Account Management Settings** section within the Blink Platform and click the [Role Mapping](/docs/blink-platform/account-management/identity-providers/identity-providers#role-mapping) section and select the applicable values.

    When a user belongs to multiple Okta groups, Blink resolves role assignment in SAML SSO using a **top-down priority order** based on the `Group:Role` mapping table. The first matching group in the list determines the assigned role.

    <Warning>
      Please note that in the **Mapping** section, at least one mapping role must be designated as an **admin** with administrative privileges. Additionally, the user configuring the group must be a part of the group mapped to the **Admin** role. Otherwise you won't be able to operate as an administrator in your account or access and edit the role mapping again.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-12.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=b5669312112cb3942744339938dfa0d9" width="1247" height="805" data-path="img/IdentityProviders/okta-12.png" />
    </Frame>
  </Step>

  <Step title="Finish SAML App Setup in Okta">
    Select “I’m an Okta customer adding an internal app” from the options menu, and then click Finish.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/okta-6.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=d0ae03d516884993480adb3ef2ca3a5b" width="2066" height="1270" data-path="img/IdentityProviders/okta-6.png" />
    </Frame>
  </Step>

  <Step title="Assign Users or Groups to the SAML App">
    To give users permission to authenticate via this SAML app, you will need to assign users or groups.
  </Step>

  <Step title="Go to Assignments Tab">
    Click on the "Assignments" tab and assign the users or groups you require.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/okta-7.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=fd008f4e3ccab57586114dde1d5c7e96" width="2060" height="1250" data-path="img/IdentityProviders/okta-7.png" />
    </Frame>
  </Step>

  <Step title="Open Sign On Tab and Locate Certificates">
    Click on the "Sign On" tab and scroll down to the "SAML Signing Certificates".

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/okta-8.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=1afcf7c9188f1ba9e2d7ca4cc9dae023" width="2060" height="1256" data-path="img/IdentityProviders/okta-8.png" />
    </Frame>
  </Step>

  <Step title="View SAML Setup Instructions">
    Click on "View SAML setup instructions".

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/okta-9.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=305c89ef506584ee06c67bca9dd68a0f" width="2054" height="1262" data-path="img/IdentityProviders/okta-9.png" />
    </Frame>
  </Step>

  <Step title="Copy IDP Metadata Values">
    Next, under the **Optional** section at the bottom, copy the **IDP metadata** values.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/ZeD68GD0apWa12JT/img/IdentityProviders/okta-10.png?fit=max&auto=format&n=ZeD68GD0apWa12JT&q=85&s=270e15305b36cdf9c500aabf011a0210" width="968" height="999" data-path="img/IdentityProviders/okta-10.png" />
    </Frame>
  </Step>

  <Step title="Paste Metadata in Blink Platform">
    Next, navigate to the **SAML** section found within the SAML tab in the Account Management Settings. Paste the **IDP metadata** values into the designated text field labeled 'Metadata File'.

    <Frame>
      <img src="https://mintcdn.com/blinkops-2/VXKzhvwYkcutAgt0/img/IdentityProviders/saml-metadata-2.png?fit=max&auto=format&n=VXKzhvwYkcutAgt0&q=85&s=138e95f889724d78952c9e153dfa55a5" width="1726" height="1076" data-path="img/IdentityProviders/saml-metadata-2.png" />
    </Frame>
  </Step>
</Steps>
