---
title: "CyberArk SAML 2.0 SSO Setup"
canonical: "https://help.agiloft.com/space/HELP/43718200/CyberArk+SAML+2.0+SSO+Setup"
format: markdown
---
This article provides instructions for setting up SAML 2.0 single sign-on (SSO) with CyberArk Workforce Identity as the Identity Provider (IdP). It also includes instructions on how to log in with SSO after the integration and make sure other users log in with SSO as well.

> Macro (include)

# Set Up SAML 2.0 SSO

> Macro (include)

## > Macro (anchor)

Create a SAML SSO Profile

> Macro (include)

## > Macro (anchor)

Configure Service Provider Details

> Macro (include)

At this point, you can't finish the setup in Agiloft until you configure your IdP. Continue to [Configure CyberArk](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718200/CyberArk+Workforce+Identity+SAML+SSO#CyberArkWorkforceIdentitySAMLSSO-configure_idp) for instructions on setting up your IdP.

## > Macro (anchor)

Configure CyberArk

Follow the steps below to integrate Agiloft as a SAML service provider in CyberArk.

> ℹ️ These are general steps for deploying a SAML web application in CyberArk. If the options you see in the Admin Portal or your practices for deploying apps differ from those described here, refer to CyberArk's [documentation](https://docs.cyberark.com/identity/latest/en/content/idaptivetrial/ssosamlapp.htm?tocpath=Administrator%7CIntegrate%20apps%7CGet%20Started%20with%20Single%20Sign-on%7C_____1) on deploying a web SAML application to complete the task.

1. First, to streamline the CyberArk setup, download the SAML Service Provider Metadata XML file from Agiloft so you can import it to CyberArk:
  1. In Agiloft, go to **Setup > Access > Configure SAML 2.0 Profiles**.
  2. Select the profile for this IdP, then click Download Metadata XML. The file includes the X.509 certificate.
2. Now, log in to your CyberArk Identity Admin Portal and go to the tenant in which you want to add an application.
3. In the sidebar, go to **Apps & Widgets > Web Apps** and click Add Web Apps.
4. On the Add Web Apps screen, go to the Custom tab.
5. Click Add next to the SAML template, then click Yes to add the application.
6. Click Close to close the dialog box and view the Settings for the new application.
7. On the Settings page, enter a Name and Category for the application, then configure any optional settings.
8. Next, click Trust in the menu. The Trust page shows the identity provider and service provider configurations.
9. Under Identity Provider Configuration, leave Metadata selected and click Download Metadata File to download the IdP metadata XML file. You use the contents of this file to configure the identity provider details in Agiloft.

> 📝 The file that you downloaded might have some outdated schema namespace attributes in the EntityDescriptor. When included, the attributes cause an "Invalid SAML Metadata version" error in Agiloft when you save the SAML configuration after supplying the Identity Provider Details. To avoid the error later, open the downloaded XML file in a text editor. If the following attributes are included in the `EntityDescriptor` tag at the beginning of the file, delete them, then save and close the file:
> 📝 
> 📝 `xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"`

10. Next, add the service provider metadata XML file from Agiloft:
  1. Under Service Provider Configuration, leave Metadata selected and click Choose File.
  2. Browse for and select the XML file you downloaded from Agiloft, then click Open.
11. Next, you might want to click Save to save your work so far. Then continue to edit the configuration as needed. Refer to CyberArk's [documentation](https://docs.cyberark.com/identity/latest/en/content/applications/appsovw/sso_optconfig.htm?tocpath=Administrator%7CIntegrate%20apps%7CIntroduction%20to%20application%20management%7CConfigure%20optional%20application%20settings%7C_____0) on configuring optional application settings.
12. If you want to create or update user records in Agiloft based on attributes from CyberArk, add attributes to send in the SAML response. For instructions, see CyberArk's [documentation](https://docs.cyberark.com/identity/latest/en/content/applications/appsovw/samlresponseconfigure.htm?tocpath=Administrator%7CIntegrate%20apps%7CIntroduction%20to%20application%20management%7CConfigure%20optional%20application%20settings%7C_____8) on configuring SAML attributes.
13. Finally, make sure you deploy the application by assigning access to the users and groups who need to log in to Agiloft with SAML. For instructions, see CyberArk's [documentation](https://docs.cyberark.com/identity/latest/en/content/applications/appsovw/allowappaccess.htm?tocpath=Administrator%7CIntegrate%20apps%7CIntroduction%20to%20application%20management%7CConfigure%20Single%20Sign-On%20(SSO)%7C_____3) on deploying applications.

Now that CyberArk is configured, return to Agiloft. If you want to configure IdP attribute to Agiloft field mappings, continue to [Configure User Group, Team, and Fields Mapping](#mapping) below. If you don't want to configure mappings, proceed to [Configure Identity Provider Details](#identity_provider).

## > Macro (anchor)

Configure User Group, Team, and Fields Mapping

> Macro (include)

### > Macro (anchor)

SAML Attribute Mapping

The following image shows attribute mappings that are configured for a SAML web application in CyberArk:

![SAML attributes in CyberArk](media://bce3f5b4-5352-4b10-a025-a9aef795a24a)

To map the attributes to fields in Agiloft, enter the Attribute Names in the relevant fields on the User Field(s) Mapping tab.

![Attribute Name mapped on the User Fields tab in Agiloft](media://9b87510e-b238-4209-91c9-c10727254a16)

Now that user, group, and team mappings are configured, proceed to [Configure Identity Provider Details](https://agiloft-public.atlassian.net/wiki/spaces/HELP/pages/43718200/CyberArk+Workforce+Identity+SAML+SSO#CyberArkWorkforceIdentitySAMLSSO-identity_provider) to complete the SAML SSO setup.

## > Macro (anchor)

Configure Identity Provider Details

> Macro (include)

# > Macro (anchor)

Log in with SAML

> Macro (include)

# Force SSO Login

> Macro (include)

# > Macro (anchor)

Generating a Key Pair

> Macro (include)

> Macro (hide-if)
> 
> > Macro (contentbylabel)