CyberArk Identity
CyberArk Identity connector for managing users, roles, applications, groups, organization units, policies, and directory services.
📝 Beta: This connector is in beta. It follows the service's documented API but has not yet been fully tested against the live service, so some tools may behave differently than described.
Set up
CyberArk Identity connects with credentials from your CyberArk Identity account. Have these values ready:
- Subdomain
- Username
- Password
- Go to Organization > Connectors and find CyberArk Identity.
- Click Enable and choose which tools to allow.
- Each member enters their own values the first time they use it.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
CyberArk Identity offers 34 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (20)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_application | Get one application's full configuration by its row key (use list_applications to find valid IDs). |
get_organization | Get one organization unit's details (name, description, path) by its ID. |
get_policy | Retrieve a policy set's full configuration block by its path/name, e.g. '/Policy/Default Policy'. |
get_role | Get a single role's details (ID, name, description) by its internal ID. |
get_tenant_suffixes | List the username suffixes (directory aliases) configured for the tenant. |
get_user | Get a single CyberArk Identity user's details by their internal UUID. |
get_user_attributes | Get a user's full attribute set by UUID (use list_users or get_user to find it): directory attributes, group memberships, account state, and password-policy flags, beyond the lean fields get_user returns. |
get_user_roles | List the roles (and administrative rights) assigned to a user, identified by UUID (use list_users or get_user to find it). |
list_administrative_rights | List distinct administrative rights held by roles of the connected, signed-in account. |
list_applications | List or search the web/SaaS applications configured on the tenant with pagination. |
list_auth_profiles | List the authentication (MFA) profiles configured on the tenant, each with its UUID, name, and challenge duration. |
list_devices | List the devices enrolled/managed on the tenant with pagination, each with its ID, name, and enrollment state. |
list_directories | List the directory services configured on the tenant (cloud directory, Active Directory, federated directories, etc.), each with its UUID, type, display name, and status. |
list_groups | List or search directory groups across the tenant's directory services with pagination. |
list_organizations | List the organization units (sub-organizations) configured on the tenant, each with its ID, name, path, and administrators. |
list_role_apps | List the applications assigned to a role, identified by its ID (use list_roles to find it). |
list_role_members | List the members (users, groups, and nested roles) of a role, identified by its ID. |
list_roles | List or search CyberArk Identity roles with pagination. |
list_users | List or search CyberArk Identity users with pagination. |
validate_credential | Validate CyberArk Identity credentials by signing in and calling Security/whoami. |
Write (5)
Create or send data.
| Tool | What it does |
|---|---|
add_users_to_role | Add users, groups, and/or nested roles to a role, identified by role ID (use list_roles to find it). |
assign_admin_rights_to_role | Grant administrative rights to a role, identified by role ID (use list_roles to find it). admin_rights is a list of opaque CyberArk right paths like ['ServiceRight/administrationShowTile'] (NOT friendly names) — call list_administrative_rights first to discover valid paths. |
create_role | Create a new role with a name and optional description. |
create_user | Create a new user in the tenant's cloud directory. |
invite_users | Send login/activation invitations to one or more users by UUID (use list_users to find them). |
Delete or overwrite (9)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_application | Permanently delete an application instance by its row key (use list_applications to find it). |
delete_role | Permanently delete a role by its ID (use list_roles to find it). |
delete_user | Permanently delete a user by their UUID (use list_users or get_user to find it). |
exempt_user_from_mfa | Exempt a user from multi-factor authentication, identified by UUID (use list_users or get_user to find it). |
remove_users_from_role | Remove users, groups, and/or nested roles from a role, identified by role ID (use list_roles to find it). |
reset_user_password | Set a new password for an existing user, identified by UUID (use list_users or get_user to find it). |
unassign_admin_rights_from_role | Revoke administrative rights from a CyberArk Identity role using opaque ServiceRight/* paths, not friendly names. |
update_role | Rename a role or change its description, identified by role ID (use list_roles to find it). |
update_user | Update an existing user's display name, email, or mobile number. |