REST API Reference

Back Next

Getting SAML role mapping details

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

Informatica Intelligent Cloud Services

role or SAML role.

GET request

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

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

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

To get details for a particular role or SAML role, 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 samlRoleNames
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.
samlRoleNames	String	==	Name of the SAML role.

GET request example

To get the role mapping details for a particular

Informatica Intelligent Cloud Services

role ID, you might use the following request:

GET <baseApiUrl>/public/core/v3/Orgs/03kEYNeduIJkVv0Qvq8NgY/SAMLConfig/roleMappings?q=roleId=="94247429"

GET response

Returns the role 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 role mappings and the following information for each role mapping:

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

GET response example

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

{
    "count": 2,
    "roleMappings": [
        {
            "roleId":"94247429",
            "roleName:"Developer",
            "samlRoleNames": [
                "Data Designer", "MS Deployer"
            ]
        },
        {
            "roleId":"142321",
            "roleName:"Admin",
            "samlRoleNames": "Operator"
        }
    ]
}

SAML group and role mapping

Download Guide

Watch

Comments

Cloud Data Integration Homepage