REST API Reference

Back Next

Getting SAML group mapping details

You can get the details for all the group mappings for an organization or use a filter to get group mapping details for a particular

Informatica Intelligent Cloud Services

role or SAML group.

GET request

To get details for group mappings, use the following URI:

public/core/v3/Orgs/<organization ID>/SAMLConfig/groupMappings?<query parameters>

To get all the group mapping details for the organization, omit the query parameters.

To get details for a particular role or SAML group, you can include the following query parameters in the URI:

Parameter	Type	Description
q	String	Query filter string. You can filter using one of the following fields: roleId roleName samlGroupNames
limit	Int	Maximum number of mappings to return. Default is 200.
skip	Int	Number of mappings to skip in the results. For example, a value of 4 excludes the first four mappings. Default is 0.

You can use the following fields to define the query filter:

Field	Type	Operators	Description
roleId	String	==	ID of the Informatica Intelligent Cloud Services role.
roleName	String	==	Name of the Informatica Intelligent Cloud Services role.
samlGroupNames	String	==	Name of the SAML group.

GET request example

To get the group mapping details for a particular

Informatica Intelligent Cloud Services

role ID, you might use the following request:

GET <baseApiUrl>/public/core/v3/Orgs/<organization ID>/SAMLConfig/groupMappings?q=roleId=="94207429"
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: <SessionId>

GET response

Returns the group mapping details. Returns an error if errors occur.

If the

Map SAML Groups and Roles

option is enabled but no mappings exist, the response is empty.

If successful, returns a count of the available group mappings and the following information for each group mapping:

Field	Type	Description
count	String	Number of group mappings available.
groupMappings	-	Contains mapping information for each group mapping.
roleId	String	ID of the Informatica Intelligent Cloud Services role.
roleName	String	Name of the Informatica Intelligent Cloud Services role.
samlGroupNames	String	Names of the SAML groups.

GET response example

If successful, you might receive a response similar to the following example:

{
    "count": 2,
    "groupMappings": [
        {
            "roleId":"94207429",
            "roleName:"Admin",
            "samlGroupNames": [
                "Security", "Dev-Managers"
            ]
        },
        {
            "roleId":"149021",
            "roleName:"Monitor",
            "samlGroupNames": "Developers"
        }
    ]
}

SAML group and role mapping

Download Guide

Watch

Comments

Cloud Data Integration Homepage