Manage external-role-mapping entries
Map external identity provider roles to ONTAP roles using this API to manage access controls effectively. Use these endpoints to create and retrieve role mappings, ensuring seamless integration between external providers and ONTAP roles.
Overview
This API is used to map external identity provider roles to ONTAP roles. The POST request creates an external role to ONTAP role mapping. Various responses are shown in the examples below.
Examples
Creating an external role to ONTAP role mapping entry
The following output shows how to create an external role to ONTAP role mapping entry.
# The API
/api/security/external-role-mappings
# The call:
curl -X POST "https://<mgmt-ip>/api/security/external-role-mappings" -d '{ "external_role": "Administrator", "ontap_role": { "name": "admin" }, "provider": "adfs", "comment": "Admin role" }'
Retrieving all external role to ONTAP role mapping entries
The following output shows all external role to ONTAP role mapping entries.
# The API
/api/security/external-role-mappings
# The call:
curl -X GET "https://<mgmt-ip>/api/security/external-role-mappings"
# The response:
{
"records": [
{
"external_role": "Administrator",
"provider": "adfs"
}
],
"num_records": 1
}