Detected country: US
logo
API Docs

Getting Started

  • How to get started with Cobalt

Assets

  • Assets are what we pentest
  • Asset Types
  • Create an Asset
  • Risk Advisories

Pentests

  • Pentests
  • Create a Pentest
    • Overview
    • Asset Details
    • Pentest Details
    • Scope & Test Period
    • Preparation
  • Create an Autonomous Pentest
    • Launch a Saved Autonomous Pentest
    • Review a Closed Autonomous Pentest Report
  • Pentest Process
  • Pentest States
  • Coverage Checklist
  • Pentest Expectations
  • In House Pentests
    • Complete an In-House Pentest (For Pentesters)
    • Set Up an In-House Pentest
  • Findings
    • Remediate Findings
    • Finding States
    • Severity Levels
  • Reports
    • Contents of a Pentest Report
    • Customize Your Report
    • Co-branded Reports
  • Preparation

Engagements

  • Engagements Overview
  • Digital Risk Assessment
  • Secure Code Review

Findings

  • Findings

Insights

  • Insights

Planning

  • Planning

Methodologies

  • Cobalt Methodologies Overview
  • Web Methodologies
  • Autonomous Web Methodologies
  • API Methodologies
  • External Network Methodologies
  • Internal Network Methodologies
  • Mobile Methodologies
  • Cloud Configuration Review Methodologies
  • Cloud Pentest Methodology
  • Desktop Methodologies
  • AI/LLM Methodologies
  • Digital Risk Assessment Methodology
  • Secure Code Review Methodologies

Attack Surface

  • Attack Surface Monitoring (ASM)

DAST Scanner

  • DAST Scanner Overview
  • Best Practices
  • FAQ
  • Integrations
  • Partial Scans: Reduced Scope
  • Scans
  • Sequence recorder
  • Targets
  • Target Authentication
  • Extra Hosts
  • Blackout Period

User Account

  • Account Overview
  • Account Settings
  • Password Best Practices
  • Sign In to Cobalt
  • Troubleshoot Sign-in Issues

Collaboration

  • Collaboration Overview
  • Collaborate on Pentests
  • Groups
  • Manage Pentest Collaborators
  • User Roles and Permissions
  • Manage Notifications

Organization

  • Organization Overview
  • Manage Users
  • Your Cobalt Contract
  • Configure Organization Settings
    • Configure SAML SSO
    • SAML Migration: Update Your Configuration
    • SCIM Provisioning Setup Guide

Credits

  • Cobalt PtaaS Tiers
  • Cobalt Credits
  • Track Your Credits

Integrations

  • Cobalt Integrations Overview
  • Integration Builder
    • Connect your applications
    • How to Guides
      • Create Azure DevOps Work Item for Findings
      • Create GitHub tickets for Findings
      • Create GitLab tickets for Findings
      • Send email notifications for Findings from Outlook
      • Send MS Teams notifications for Findings
      • Create Jira tickets for Findings
      • HTTP Connector
      • Import Assets from Google Sheets
      • Map Cobalt Pentest Finding Severity to Jira Issue Priority
      • Modify Jira Issue Summary to contain Pentest Title
    • Troubleshooting
  • Integrate Jira with Cobalt
    • Jira Cloud Integration
    • Jira Data Center Integration
    • Push Cobalt Findings to Jira
    • Synchronize Cobalt Severity Levels with Jira
    • Switching to a New Jira Instance
    • Troubleshoot Your Jira Integration
  • Slack
  • Microsoft Teams
  • Webhooks
  • DefectDojo
  • Kenna Security
  • Vanta
  • Carried Over Findings
  • Create Test Finding
  • Wiz

Cobalt API

  • Cobalt API Overview
  • Create a Personal Cobalt API Token
  • Get an Organization Token
  • Revoke Your Personal Cobalt API Tokens
  • Create or Modify an Asset
  • Import Findings to Google Sheets

Glossary

  • Glossary

What's New

  • May 2026
  • April 2026
  • March 2026
  • February 2026
  • January 2026
  • November 2025 
  • August 2025
  • July 2025
  • June 2025
  • May 2025
  • April 2025
  • March 2025
  • January 2025
  • December 2024
  • November 2024
  • October 2024
  • September 2024
  • August 2024
  • July 2024
  • June 2024
  • May 2024
  • April 2024
  • March 2024
  • January 2024
  • Product Updates
  • August 2026
‌
‌
‌
logo

Powered by

Assistant

Ask new question

Powered by
  • Home
  • Organization
  • Configure Organization Settings
  • SAML Migration: Update Your Configuration

SAML Migration: Update Your Configuration

23min read

Share

Learn how to update your SAML configuration from legacy to the new setup.

:::warning Our legacy SAML system will be deactivated on September 15, 2026. To avoid any disruptions to authentication, update your SAML configuration.

During the transition period, your existing SAML SSO setup will be valid. After the transition period, we'll stop supporting legacy configurations. :::

This page is for Organization Owners who have set up their SAML SSO configuration before May 10, 2023.

  • If you don’t update your SAML configuration by the end of the transition period, we’ll deprecate your legacy configuration settings. This means you will not be able to sign in to Cobalt.
  • Make sure to update configurations for each organization where you’re an Organization Owner.
  • If you don’t have a legacy setup and want to enable SAML, please visit Configure SAML SSO for instructions.

What Has Changed in the SAML Implementation

Here is a summary of updates:

  • Our Assertion Consumer Service (ACS) URL is no longer https://api.cobalt.io/users/saml/auth, but is now unique per organization. To get your unique ACS URL, go to Settings > Identity & Access > Configure SAML in the Cobalt app.

    • Example ACS URL: https://login.app.us.cobalt.io/login/callback?connection=example-org, where the string after =is the organization’s slug ( example-org). You can also see the slug in Settings > General.
  • Our Audience Restriction now contains a location subdomain.

    • Example Audience: https://api.us.cobalt.io/v2/orgs/<your-org's-slug>/saml_metadata
    • For EU data center: https://api.eu.cobalt.io/v2/orgs/test-org-api/saml_metadata
  • We no longer require a RelayState within the assertion.

  • Organization Owners can now enable or disable SSO enforcement.

How to Update Your SAML Configuration

There are two ways to migrate to the new SAML implementation:

  • Option 1: Set up a new SAML configuration and deactivate the old one.
  • Option 2: Update your existing SAML configuration between Cobalt and your IdP.

Option 1: Set up a New SAML Configuration

  1. Create a new SAML app with your preferred identity provider. For instructions, see how to configure SAML SSO.
  2. Test the new configuration.
  3. If the test is successful, assign users, and notify them of the new Cobalt SAML app or SSO URL.
  4. Deactivate the old SAML app and deprovision users.

Option 2: Update Your Existing SAML Configuration

Before updating your existing configuration, note the following:

  • To avoid disrupting anyone’s workflows, choose a time when the impact on users is minimal.

  • Turn off SAML enforcement until you’ve successfully tested the new configuration.

  • You need to copy parameters between two systems, so it’s handy to have both applications open.

  • You can refer to instructions for some popular IdPs below:

    • Azure AD
    • Duo
    • Google
    • Okta
    • OneLogin

Here’s a general workflow to update your existing SAML configuration:

  1. In your identity provider:

    • Update the ==ACS URL== with the current value from Cobalt. The name of this parameter may differ for different IdPs. To get the ACS URL, in Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure, and copy the ACS URL value.
  2. In Cobalt:

    • Go to Settings > Identity & Access.

      • Make sure that the Enforce SAML toggle is turned off. You can enforce SAML after you complete the configuration.
      • You can view your legacy configuration under Legacy SAML Configuration. It may not match your current setup in the IdP.
    • Under Configure SAML, select Configure.

    • Update the ==IdP Certificate== with the current value from your identity provider, and select Save Configuration to confirm.

  3. We no longer require a ==RelayState== within the assertion. Delete it from the configuration in your IdP.

  4. Test the configuration. You should be authenticated to Cobalt.

Azure AD

To update your existing SAML configuration with Azure AD:

  1. In Azure AD, go to your SAML application for Cobalt.

    • Reply URL (Assertion Consumer Service URL): Enter ACS URL from Cobalt.
    • Delete the Relay State value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate (Base64) from Azure AD.

If you want to set up a new application, follow this instruction.

Duo

To update your existing SAML configuration with Duo:

  1. In Duo, go to your SAML application for Cobalt.

    • Assertion Consumer Service (ACS) URL: Enter ACS URL from Cobalt.
    • Delete the Default Relay State value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate from Duo.

If you want to set up a new application, follow this instruction.

Google

We recommend creating a new SAML app with Google. For details, follow this instruction.

Okta

:::warning Customers who had previously set up SAML using Cobalt’s ‘Gallery SAML App’ must create a new non-gallery app. :::

To update your existing SAML configuration with Okta for a non-gallery SAML app:

  1. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • Copy the ACS URL.

  2. In Okta, go to your SAML application for Cobalt. On the General tab, under SAML Settings, select Edit, then select Next. If you don’t see editable SAML Settings, we suggest that you create a new non-gallery app.

    • Single sign-on URL: Enter ACS URL from Cobalt.

    • Delete the Default RelayState value.

    • Save the changes.

  3. In Okta, go to the Sign On tab, and select Edit. Under Metadata details, select More details.

    • Copy the Sign on URL.

    • Download or copy the Signing Certificate.

  4. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP SSO URL: Enter the Sign on URL from Okta.
    • IdP Certificate: Enter the Signing Certificate from Okta.
    • Select Save Configuration.

If you want to set up a new application, follow these instructions.

OneLogin

To update your existing SAML configuration with OneLogin:

  1. In OneLogin, go to your SAML application for Cobalt.

    • Recipient, ACS (Consumer) URL Validator, and ACS (Consumer) URL: Enter ACS URL from Cobalt.
    • Delete the RelayState value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter X.509 Certificate from OneLogin.

If you want to set up a new application, follow this instruction.

Troubleshooting

See our general troubleshooting tips for SAML configurations.

When updating your existing SAML setup, ensure that:

  • The ACS URL and Entity ID are correct in the IdP system.

  • The Relay State in the IdP system is blank. We no longer support it in the new SAML implementation.

  • The organization’s Slug is accurate. The slug appears after =

    in the ACS URL. You can also find the slug in Settings > General.

To get help, contact your Customer Success Manager (CSM) or support@cobalt.io.

Learn how to update your SAML configuration from legacy to the new setup.

:::warning Our legacy SAML system will be deactivated on September 15, 2026. To avoid any disruptions to authentication, update your SAML configuration.

During the transition period, your existing SAML SSO setup will be valid. After the transition period, we'll stop supporting legacy configurations. :::

This page is for Organization Owners who have set up their SAML SSO configuration before May 10, 2023.

  • If you don’t update your SAML configuration by the end of the transition period, we’ll deprecate your legacy configuration settings. This means you will not be able to sign in to Cobalt.
  • Make sure to update configurations for each organization where you’re an Organization Owner.
  • If you don’t have a legacy setup and want to enable SAML, please visit Configure SAML SSO for instructions.

What Has Changed in the SAML Implementation

Here is a summary of updates:

  • Our Assertion Consumer Service (ACS) URL is no longer https://api.cobalt.io/users/saml/auth, but is now unique per organization. To get your unique ACS URL, go to Settings > Identity & Access > Configure SAML in the Cobalt app.

    • Example ACS URL: https://login.app.us.cobalt.io/login/callback?connection=example-org, where the string after =is the organization’s slug ( example-org). You can also see the slug in Settings > General.
  • Our Audience Restriction now contains a location subdomain.

    • Example Audience: https://api.us.cobalt.io/v2/orgs/<your-org's-slug>/saml_metadata
    • For EU data center: https://api.eu.cobalt.io/v2/orgs/test-org-api/saml_metadata
  • We no longer require a RelayState within the assertion.

  • Organization Owners can now enable or disable SSO enforcement.

How to Update Your SAML Configuration

There are two ways to migrate to the new SAML implementation:

  • Option 1: Set up a new SAML configuration and deactivate the old one.
  • Option 2: Update your existing SAML configuration between Cobalt and your IdP.

Option 1: Set up a New SAML Configuration

  1. Create a new SAML app with your preferred identity provider. For instructions, see how to configure SAML SSO.
  2. Test the new configuration.
  3. If the test is successful, assign users, and notify them of the new Cobalt SAML app or SSO URL.
  4. Deactivate the old SAML app and deprovision users.

Option 2: Update Your Existing SAML Configuration

Before updating your existing configuration, note the following:

  • To avoid disrupting anyone’s workflows, choose a time when the impact on users is minimal.

  • Turn off SAML enforcement until you’ve successfully tested the new configuration.

  • You need to copy parameters between two systems, so it’s handy to have both applications open.

  • You can refer to instructions for some popular IdPs below:

    • Azure AD
    • Duo
    • Google
    • Okta
    • OneLogin

Here’s a general workflow to update your existing SAML configuration:

  1. In your identity provider:

    • Update the ==ACS URL== with the current value from Cobalt. The name of this parameter may differ for different IdPs. To get the ACS URL, in Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure, and copy the ACS URL value.
  2. In Cobalt:

    • Go to Settings > Identity & Access.

      • Make sure that the Enforce SAML toggle is turned off. You can enforce SAML after you complete the configuration.
      • You can view your legacy configuration under Legacy SAML Configuration. It may not match your current setup in the IdP.
    • Under Configure SAML, select Configure.

    • Update the ==IdP Certificate== with the current value from your identity provider, and select Save Configuration to confirm.

  3. We no longer require a ==RelayState== within the assertion. Delete it from the configuration in your IdP.

  4. Test the configuration. You should be authenticated to Cobalt.

Azure AD

To update your existing SAML configuration with Azure AD:

  1. In Azure AD, go to your SAML application for Cobalt.

    • Reply URL (Assertion Consumer Service URL): Enter ACS URL from Cobalt.
    • Delete the Relay State value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate (Base64) from Azure AD.

If you want to set up a new application, follow this instruction.

Duo

To update your existing SAML configuration with Duo:

  1. In Duo, go to your SAML application for Cobalt.

    • Assertion Consumer Service (ACS) URL: Enter ACS URL from Cobalt.
    • Delete the Default Relay State value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate from Duo.

If you want to set up a new application, follow this instruction.

Google

We recommend creating a new SAML app with Google. For details, follow this instruction.

Okta

:::warning Customers who had previously set up SAML using Cobalt’s ‘Gallery SAML App’ must create a new non-gallery app. :::

To update your existing SAML configuration with Okta for a non-gallery SAML app:

  1. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • Copy the ACS URL.

  2. In Okta, go to your SAML application for Cobalt. On the General tab, under SAML Settings, select Edit, then select Next. If you don’t see editable SAML Settings, we suggest that you create a new non-gallery app.

    • Single sign-on URL: Enter ACS URL from Cobalt.

    • Delete the Default RelayState value.

    • Save the changes.

  3. In Okta, go to the Sign On tab, and select Edit. Under Metadata details, select More details.

    • Copy the Sign on URL.

    • Download or copy the Signing Certificate.

  4. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP SSO URL: Enter the Sign on URL from Okta.
    • IdP Certificate: Enter the Signing Certificate from Okta.
    • Select Save Configuration.

If you want to set up a new application, follow these instructions.

OneLogin

To update your existing SAML configuration with OneLogin:

  1. In OneLogin, go to your SAML application for Cobalt.

    • Recipient, ACS (Consumer) URL Validator, and ACS (Consumer) URL: Enter ACS URL from Cobalt.
    • Delete the RelayState value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter X.509 Certificate from OneLogin.

If you want to set up a new application, follow this instruction.

Troubleshooting

See our general troubleshooting tips for SAML configurations.

When updating your existing SAML setup, ensure that:

  • The ACS URL and Entity ID are correct in the IdP system.

  • The Relay State in the IdP system is blank. We no longer support it in the new SAML implementation.

  • The organization’s Slug is accurate. The slug appears after =

    in the ACS URL. You can also find the slug in Settings > General.

To get help, contact your Customer Success Manager (CSM) or support@cobalt.io.

Learn how to update your SAML configuration from legacy to the new setup.

:::warning Our legacy SAML system will be deactivated on September 15, 2026. To avoid any disruptions to authentication, update your SAML configuration.

During the transition period, your existing SAML SSO setup will be valid. After the transition period, we'll stop supporting legacy configurations. :::

This page is for Organization Owners who have set up their SAML SSO configuration before May 10, 2023.

  • If you don’t update your SAML configuration by the end of the transition period, we’ll deprecate your legacy configuration settings. This means you will not be able to sign in to Cobalt.

  • Make sure to update configurations for each organization where you’re an Organization Owner.

  • If you don’t have a legacy setup and want to enable SAML, please visit Configure SAML SSO for instructions.

What Has Changed in the SAML Implementation

Here is a summary of updates:

  • Our Assertion Consumer Service (ACS) URL is no longer https://api.cobalt.io/users/saml/auth, but is now unique per organization. To get your unique ACS URL, go to Settings > Identity & Access > Configure SAML in the Cobalt app.

    • Example ACS URL: https://login.app.us.cobalt.io/login/callback?connection=example-org, where the string after =is the organization’s slug ( example-org). You can also see the slug in Settings > General.
  • Our Audience Restriction now contains a location subdomain.

    • Example Audience: https://api.us.cobalt.io/v2/orgs/<your-org's-slug>/saml_metadata

    • For EU data center: https://api.eu.cobalt.io/v2/orgs/test-org-api/saml_metadata

  • We no longer require a RelayState within the assertion.

  • Organization Owners can now enable or disable SSO enforcement.

How to Update Your SAML Configuration

There are two ways to migrate to the new SAML implementation:

  • Option 1: Set up a new SAML configuration and deactivate the old one.

  • Option 2: Update your existing SAML configuration between Cobalt and your IdP.

Option 1: Set up a New SAML Configuration

  1. Create a new SAML app with your preferred identity provider. For instructions, see how to configure SAML SSO.
  2. Test the new configuration.
  3. If the test is successful, assign users, and notify them of the new Cobalt SAML app or SSO URL.
  4. Deactivate the old SAML app and deprovision users.

Option 2: Update Your Existing SAML Configuration

Before updating your existing configuration, note the following:

  • To avoid disrupting anyone’s workflows, choose a time when the impact on users is minimal.

  • Turn off SAML enforcement until you’ve successfully tested the new configuration.

  • You need to copy parameters between two systems, so it’s handy to have both applications open.

  • You can refer to instructions for some popular IdPs below:

    • Azure AD

    • Duo

    • Google

    • Okta

    • OneLogin

Here’s a general workflow to update your existing SAML configuration:

  1. In your identity provider:

    • Update the ==ACS URL== with the current value from Cobalt. The name of this parameter may differ for different IdPs. To get the ACS URL, in Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure, and copy the ACS URL value.
  2. In Cobalt:

    • Go to Settings > Identity & Access.

      • Make sure that the Enforce SAML toggle is turned off. You can enforce SAML after you complete the configuration.

      • You can view your legacy configuration under Legacy SAML Configuration. It may not match your current setup in the IdP.

    • Under Configure SAML, select Configure.

    • Update the ==IdP Certificate== with the current value from your identity provider, and select Save Configuration to confirm.

  3. We no longer require a ==RelayState== within the assertion. Delete it from the configuration in your IdP.

  4. Test the configuration. You should be authenticated to Cobalt.

Azure AD

To update your existing SAML configuration with Azure AD:

  1. In Azure AD, go to your SAML application for Cobalt.

    • Reply URL (Assertion Consumer Service URL): Enter ACS URL from Cobalt.

    • Delete the Relay State value.

  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate (Base64) from Azure AD.

If you want to set up a new application, follow this instruction.

Duo

To update your existing SAML configuration with Duo:

  1. In Duo, go to your SAML application for Cobalt.

    • Assertion Consumer Service (ACS) URL: Enter ACS URL from Cobalt.

    • Delete the Default Relay State value.

  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate from Duo.

If you want to set up a new application, follow this instruction.

Google

We recommend creating a new SAML app with Google. For details, follow this instruction.

Okta

:::warning Customers who had previously set up SAML using Cobalt’s ‘Gallery SAML App’ must create a new non-gallery app. :::

To update your existing SAML configuration with Okta for a non-gallery SAML app:

  1. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • Copy the ACS URL.

  2. In Okta, go to your SAML application for Cobalt. On the General tab, under SAML Settings, select Edit, then select Next. If you don’t see editable SAML Settings, we suggest that you create a new non-gallery app.

    • Single sign-on URL: Enter ACS URL from Cobalt.

    • Delete the Default RelayState value.

    • Save the changes.

  3. In Okta, go to the Sign On tab, and select Edit. Under Metadata details, select More details.

    • Copy the Sign on URL.

    • Download or copy the Signing Certificate.

  4. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP SSO URL: Enter the Sign on URL from Okta.

    • IdP Certificate: Enter the Signing Certificate from Okta.

    • Select Save Configuration.

If you want to set up a new application, follow these instructions.

OneLogin

To update your existing SAML configuration with OneLogin:

  1. In OneLogin, go to your SAML application for Cobalt.

    • Recipient, ACS (Consumer) URL Validator, and ACS (Consumer) URL: Enter ACS URL from Cobalt.

    • Delete the RelayState value.

  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter X.509 Certificate from OneLogin.

If you want to set up a new application, follow this instruction.

Troubleshooting

See our general troubleshooting tips for SAML configurations.

When updating your existing SAML setup, ensure that:

  • The ACS URL and Entity ID are correct in the IdP system.

  • The Relay State in the IdP system is blank. We no longer support it in the new SAML implementation.

  • The organization’s Slug is accurate. The slug appears after =

    in the ACS URL. You can also find the slug in Settings > General.

To get help, contact your Customer Success Manager (CSM) or support@cobalt.io.

Learn how to update your SAML configuration from legacy to the new setup.

:::warning Our legacy SAML system will be deactivated on September 15, 2026. To avoid any disruptions to authentication, update your SAML configuration.

During the transition period, your existing SAML SSO setup will be valid. After the transition period, we'll stop supporting legacy configurations. :::

This page is for Organization Owners who have set up their SAML SSO configuration before May 10, 2023.

  • If you don’t update your SAML configuration by the end of the transition period, we’ll deprecate your legacy configuration settings. This means you will not be able to sign in to Cobalt.
  • Make sure to update configurations for each organization where you’re an Organization Owner.
  • If you don’t have a legacy setup and want to enable SAML, please visit Configure SAML SSO for instructions.

What Has Changed in the SAML Implementation

Here is a summary of updates:

  • Our Assertion Consumer Service (ACS) URL is no longer https://api.cobalt.io/users/saml/auth, but is now unique per organization. To get your unique ACS URL, go to Settings > Identity & Access > Configure SAML in the Cobalt app.

    • Example ACS URL: https://login.app.us.cobalt.io/login/callback?connection=example-org, where the string after =is the organization’s slug ( example-org). You can also see the slug in Settings > General.
  • Our Audience Restriction now contains a location subdomain.

    • Example Audience: https://api.us.cobalt.io/v2/orgs/<your-org's-slug>/saml_metadata
    • For EU data center: https://api.eu.cobalt.io/v2/orgs/test-org-api/saml_metadata
  • We no longer require a RelayState within the assertion.

  • Organization Owners can now enable or disable SSO enforcement.

How to Update Your SAML Configuration

There are two ways to migrate to the new SAML implementation:

  • Option 1: Set up a new SAML configuration and deactivate the old one.
  • Option 2: Update your existing SAML configuration between Cobalt and your IdP.

Option 1: Set up a New SAML Configuration

  1. Create a new SAML app with your preferred identity provider. For instructions, see how to configure SAML SSO.
  2. Test the new configuration.
  3. If the test is successful, assign users, and notify them of the new Cobalt SAML app or SSO URL.
  4. Deactivate the old SAML app and deprovision users.

Option 2: Update Your Existing SAML Configuration

Before updating your existing configuration, note the following:

  • To avoid disrupting anyone’s workflows, choose a time when the impact on users is minimal.

  • Turn off SAML enforcement until you’ve successfully tested the new configuration.

  • You need to copy parameters between two systems, so it’s handy to have both applications open.

  • You can refer to instructions for some popular IdPs below:

    • Azure AD
    • Duo
    • Google
    • Okta
    • OneLogin

Here’s a general workflow to update your existing SAML configuration:

  1. In your identity provider:

    • Update the ==ACS URL== with the current value from Cobalt. The name of this parameter may differ for different IdPs. To get the ACS URL, in Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure, and copy the ACS URL value.
  2. In Cobalt:

    • Go to Settings > Identity & Access.

      • Make sure that the Enforce SAML toggle is turned off. You can enforce SAML after you complete the configuration.
      • You can view your legacy configuration under Legacy SAML Configuration. It may not match your current setup in the IdP.
    • Under Configure SAML, select Configure.

    • Update the ==IdP Certificate== with the current value from your identity provider, and select Save Configuration to confirm.

  3. We no longer require a ==RelayState== within the assertion. Delete it from the configuration in your IdP.

  4. Test the configuration. You should be authenticated to Cobalt.

Azure AD

To update your existing SAML configuration with Azure AD:

  1. In Azure AD, go to your SAML application for Cobalt.

    • Reply URL (Assertion Consumer Service URL): Enter ACS URL from Cobalt.
    • Delete the Relay State value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate (Base64) from Azure AD.

If you want to set up a new application, follow this instruction.

Duo

To update your existing SAML configuration with Duo:

  1. In Duo, go to your SAML application for Cobalt.

    • Assertion Consumer Service (ACS) URL: Enter ACS URL from Cobalt.
    • Delete the Default Relay State value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter Certificate from Duo.

If you want to set up a new application, follow this instruction.

Google

We recommend creating a new SAML app with Google. For details, follow this instruction.

Okta

:::warning Customers who had previously set up SAML using Cobalt’s ‘Gallery SAML App’ must create a new non-gallery app. :::

To update your existing SAML configuration with Okta for a non-gallery SAML app:

  1. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • Copy the ACS URL.

  2. In Okta, go to your SAML application for Cobalt. On the General tab, under SAML Settings, select Edit, then select Next. If you don’t see editable SAML Settings, we suggest that you create a new non-gallery app.

    • Single sign-on URL: Enter ACS URL from Cobalt.

    • Delete the Default RelayState value.

    • Save the changes.

  3. In Okta, go to the Sign On tab, and select Edit. Under Metadata details, select More details.

    • Copy the Sign on URL.

    • Download or copy the Signing Certificate.

  4. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP SSO URL: Enter the Sign on URL from Okta.
    • IdP Certificate: Enter the Signing Certificate from Okta.
    • Select Save Configuration.

If you want to set up a new application, follow these instructions.

OneLogin

To update your existing SAML configuration with OneLogin:

  1. In OneLogin, go to your SAML application for Cobalt.

    • Recipient, ACS (Consumer) URL Validator, and ACS (Consumer) URL: Enter ACS URL from Cobalt.
    • Delete the RelayState value.
  2. In Cobalt, go to Settings > Identity & Access. Under Configure SAML, select Configure.

    • IdP Certificate: Enter X.509 Certificate from OneLogin.

If you want to set up a new application, follow this instruction.

Troubleshooting

See our general troubleshooting tips for SAML configurations.

When updating your existing SAML setup, ensure that:

  • The ACS URL and Entity ID are correct in the IdP system.

  • The Relay State in the IdP system is blank. We no longer support it in the new SAML implementation.

  • The organization’s Slug is accurate. The slug appears after =

    in the ACS URL. You can also find the slug in Settings > General.

To get help, contact your Customer Success Manager (CSM) or support@cobalt.io.

Share