PUT Security Roles ID Identities

The PUT /Security/Roles{id}/Identities method is used to update security identities assigned to a security role in Keyfactor Command. This method returns HTTP 200 OK on a success with the details of the security identities actively assigned to the security role.

Tip:  The following permissions (see Security Overview) are required to use this feature:

SecuritySettings: Modify

Table 472: PUT Security Roles {id} Identities Input Parameters

Name

In

 Description
id Path Required. The Keyfactor Command reference ID of the security role for which to update identities.

Use the GET /Security/Roles method (see GET Security Roles) to retrieve a list of all the security roles to determine the role's ID.
identities Body

An array in which you provide a complete list of the identities that are associated with an Security Role Id.

Use the GET /Security/Identities method (see GET Security Identities) to retrieve a list of all the security identities to determine the identity ID(s).

Table 473: PUT Security Roles {id} Identities Response Data

Name Description
 

An array containing information about the security identities assigned to the security role. ClosedShow identity details.
Tip:  For code examples, see the Keyfactor API Endpoint Utility. To find the embedded web copy of this utility, click the help icon () at the top of the Keyfactor Command Management Portal page next to the Log Out button.