role

Manage PrivX roles

📄️ List roles

Get role definitions.

📄️ Create a role

Create a new role definition. ID, author, created & updated fields are automatically populated by the server.

📄️ Resolve roles

Resolve role names to role IDs

📄️ Find roles

Find roles with role search parameters.

📄️ Evaluate a role

Evaluate a new role definition. Returns an array of matching users for the role mapping. If too many hits, only count field is populated and users array is left empty.

📄️ Get a role

Get role object by ID.

📄️ Delete a role

Delete role by ID.

📄️ Update a role

Update a role by ID.

📄️ List role members

Get role members by role ID.

📄️ Get role AWS token

Get an AWS token for the role. Return 403 on an initial request if the AWS role has multi-factor authentication enabled. Subsequent request must contain MFA as a query parameter. Return 403 if the user does not have the role.

📄️ Get a role's principal keys

Get role's principal key objects.

📄️ Create a role principal key

Generate new principal key for role.

📄️ Import a role principal key

Import new principal key for role.

📄️ Get a role principal key

Get role's principal key object.

📄️ Delete a role principal key

Delete a role's principal key object.