Creating automation principals

You can create an automation principal, which defines a user credential that can be used for accessing external systems. Automation Principals are used primarily by agents to map access using a specific credential, most commonly a user name and password, on an endpoint, instead of using the traditional impersonation method.

You can define an automation principal to access a server running any supported operating system. Some common uses for automation principals are:

  • Microsoft Windows user mapping — Map one or more RBAC roles to a local or domain user on a managed server.
  • Agent installation — Access servers where you want to run agent installations.
  • Atrium Orchestrator — Integrate Workflow Jobs with BMC Atrium Orchestrator.
  • LDAP server access — Access an LDAP server such as an Active Directory server.

If your principal is used to map to an Active Directory account, the managed host must be a member of the appropriate Active Directory domain. Non-AD Automation Principals can use local authentication.

This procedure lets you map multiple roles to an automation principal. Alternatively, you can map a particular role to an automation principal (see Role - Agent ACL). Rather than mapping automation principals to roles, you can accomplish the same mapping on a server-by-server basis using server properties. For information, see Using server properties to map automation principals for Windows user mapping.

You might need to create an automation principal that provides credentials for a superuser on UNIX systems. A superuser automation principal is the same as any other automation principal. It simply includes credentials for a superuser.


Only servers running BMC Server Automation version 8.0 or later can recognize automation principals. Only Windows servers running BMC Server Automation version 8.0 or later can recognize automation principals used for Windows user mapping.

Automation principals cannot be used with repeaters.

For information about modifying automation principals, see Modifying automation principals. For more general information about automation principals, see Considerations for automation principals and Windows user mapping.

Before you begin

If you intend to use an Automation Principal for Windows user mapping, your Application Server must be configured to use a NSH Proxy server in order for jobs to use the Automation Principal when communicating with target servers.  For a detailed description of that configuration, see Setting up a Network Shell proxy server.

To create an automation principal

  1. Log on to BMC Server Automation Console using your RBAC Admin credentials.
    For more information, see RBACAdmin and BLAdmin users.

  2. In the RBAC Manager folder, select Automation Principals.
  3. Create a new automation principal by right-clicking and selecting New > Automation Principal from the pop-up menu. The Automation Principal Creation wizard appears.
  4. Provide information for the automation principal as described in the following topics:
  5. To close the wizard and save your changes, click Finish at any time.


Alternatively, you can create a new automation principal by copying an existing automation principal and pasting it into the Automation Principals node. The password of the original automation principal is not copied into the new automation principal, so you must set the password while editing the new automation principal.

Where to go next

Automation principal - General

Was this page helpful? Yes No Submitting... Thank you