REST API Reference

Back Next

Adding SAML group mappings

Add SAML group mappings that map SAML groups to

Informatica Intelligent Cloud Services

roles.

You cannot map a SAML group or role that contains one of the following characters in the name:

Pipe ( | )

Semicolon ( ; )

Comma ( , )

PUT request

To add a mapping between an

Informatica Intelligent Cloud Services

role and SAML groups, use the following URI:

/public/core/v3/Orgs/<organization ID>/addSamlGroupMappings

If you map a SAML group that doesn't exist in

Informatica Intelligent Cloud Services

creates the group. If a group with the same name exists in

Informatica Intelligent Cloud Services

, you can specify whether to reuse the group or create a new group. By default,

Informatica Intelligent Cloud Services

creates a new group with _EXT appended to the name.

Include the following information:

Field	Type	Required	Description
groupMappings	Array	yes	Object that defines the Informatica Intelligent Cloud Services role and SAML group mappings.
roleName	String	yes	Include in the groupMappings object. Name of the Informatica Intelligent Cloud Services role.
samlGroupNames	String	yes	Include in the groupMappings object Names of the SAML groups to map to the Informatica Intelligent Cloud Services role.
reuseGroup	Boolean	--	Whether to use the existing Informatica Intelligent Cloud Services group if the group name is the same as the SAML group name. If false, Informatica Intelligent Cloud Services creates a new group. Default is false.

Returns the 204 response code if successful. Returns an error object if errors occurs.

PUT examples

To map the

Informatica Intelligent Cloud Services

Admin role to the Security and Dev-Managers SAML groups, and map the

Informatica Intelligent Cloud Services

Designer role to the Developers SAML group, you might send a request similar to the following example:

PUT <baseApiUrl>/public/core/v3/Orgs/6MRgiMIfvdRfCCLITrLCcI/addSamlGroupMappings
Accept: application/json
INFA-SESSION-ID: 9KA11tLGqxVcGeul8SQBK3
{
    "groupMappings": [
        {
            "roleName": "Admin",
            "samlGroupNames": ["Security","Dev-Managers"]
        },
        {
            "roleName": "Designer",
            "samlGroupNames": "Developers"
        }    
     ],
     "reuseGroup": "true"

}

To add another group mapping to map the

Informatica Intelligent Cloud Services

Admin role to the Administrators SAML group, you might send a request similar to the following example:

PUT <baseApiUrl>/public/core/v3/Orgs/6MRgiMIfvdRfCCLITrLCcI/addSamlGroupMappings
Accept: application/json
INFA-SESSION-ID: 9KA11tLGqxVcGeul8SQBK3
{
    "groupMappings": [
        {
            "roleName": "Admin",
            "samlGroupNames": "Administrators"
        }
    ],
     "reuseGroup": "true"
}

Now the

Informatica Intelligent Cloud Services

Admin role is mapped to the Security, Dev-Managers, and Administrators SAML groups.

SAML group and role mapping

Download Guide

Watch

Comments

Cloud Data Integration Homepage