Configuring service principals

For security reasons, a service principal is used instead of a user identity to run automated tasks in HYCU for Azure. The service principal is a service account that has access to a predefined set of Azure resources and is always used to run automated tasks instead of your own account.

You can define as many service principals as your business requires. Take into account that HYCU for Azure automatically creates a service principal for you in Azure, adds it to HYCU for Azure as the default service principal, and sets it as the active service principal. The default service principal is represented by the icon and the active service principal is represented by the icon.

Prerequisites

  • Only if you plan to use a service principal other than the default one. You have created a service principal in Azure.
  • The service principal—the default one or the one you have created yourself—must have the Contributor role assigned at the subscription level. For instructions on how to assign a role to a service principal, see Azure documentation.

To access the Service Principals dialog box, click on the toolbar, and then select Service Principals.

Adding a service principal

Procedure

  1. In the Service Principals dialog box, click  Add.

  2. In the Name field, enter a name for your service principal.

    n Note  It is recommended that you enter the same name for the service principal as the one that you used when registering the application and creating the service principal.

  3. In the Tenant ID field, enter your tenant ID.
  4. In the Application ID field, enter the ID of the application's registration in your Azure Active Directory.

  5. In the Application secret field, enter the secret that is associated with the application ID.

  6. Click Save.

Setting the active service principal

Consideration

The default service principal is the one that is used to run automated tasks unless you set another service principal as the active service principal.

Procedure

  1. In the Service Principals dialog box, select the service principal that you want to set as the active service principal.
  2. Click Set Active.

The icon appears next to the service principal indicating that you have successfully set it as the active service principal.

Editing a service principal

Procedure

  1. In the Service Principals dialog box, select the service principal that you want to edit, and then click  Edit.

  2. Edit the selected service principal as required.

  3. Click Save.

Deleting a service principal

You can at any time delete a service principal that you no longer need from HYCU for Azure. Deleting the service principal from HYCU for Azure does not remove it from Azure.

Considerations

  • The default service principal that is automatically created and added to HYCU for Azure cannot be deleted.
  • Only if a service principal other than the default one is set as the active service principal. If you delete the active service principal, the default service principal is automatically set as the active service principal.

Procedure

  1. In the Service Principals dialog box, select the service principal that you want to delete, and then click  Delete.

  2. Click Yes to confirm that you want to delete the selected service principal.