Connecting to Azure

EmpowerID Azure connector allows organizations to bring the instances in their Azure subscription to EmpowerID, where they can be managed as computer objects, giving authorized users the ability to start, stop and delete Azure instances from EmpowerID. To connect EmpowerID to Azure in this way involves doing the following procedures:


Prerequisites: In order to connect EmpowerID to Azure, you need to have an Azure subscription with a management certificate and provide to EmpowerID the following information
  • Your Azure Subscription ID
  • The user name and password of an Azure administrator. EmpowerID securely stores these credentials in the EmpowerID Identity Warehouse.
  • The public key for the management certificate in Base-64 encoded format. This is needed for EmpowerID to access the Azure API on your behalf. The key will be mapped to a generic EmpowerID Person.
For instructions on creating the management certificate for Azure, see Microsoft's article at https://azure.microsoft.com/en-us/documentation/articles/cloud-services-certs-create.

To add your Azure certificate to the Personal certificate store

  1. On your EmpowerID Web server, open MMC.
  2. From MMC, add the Certificates snap-in for the local computer if needed.
  3. Expand the Certificates node, right-click Personal, point to All Tasks and click Import.
  4. In the Certificate Import Wizard that appears, click Next.
  5. Click Browse and locate your certificates.
  6. In the Open window that appears, select one of your certificates and click Open.
  7. Continue through the Certificate Import Wizard, until completed.
  8. Next, export the certificate to a location on your server in base64-encoding format as demonstrated below. You will need this when creating the Azure connection in EmpowerID.

To export the Azure Certificate using Base-64 Encoding

Next, do the following to export the certificate to a location on your server in base64-encoding format. You will need this when creating the Azure connection in EmpowerID.

  1. From the Personal store, right-click the Azure certificate you just imported and select All Tasks > Export from the context menu.
  2. In the Certificate Export Wizard that appears, click Next.
  3. Select No, do not export the private key and click Next.
  4. Select Base-64 encoded X.509 (.CER) and click Next.
  5. Select an export location, naming the exported certificate accordingly and click Next.
  6. Click Finish to complete the export.
  7. Open the exported certificate in a text editor and remove the first and last lines (----BEGIN CERTIFICATE---- and ----END CERTIFICATE----).

To add the Azure certificate to the EmpowerID certificate store

  1. On the EmpowerID server, log in to the EmpowerID Management Console as an administrative user.
  2. From the EmpowerID Management Console, click the EmpowerID icon and select Configuration Manager from the application menu.
  3. In Configuration Manager, expand the EmpowerID Servers and Role node in the application navigation tree and then click the Manage Certificates node.
  4. Click the Add New button located above the Certificates grid and select From File from the context menu.
  5. In the Open File dialog that appears, locate and select the Azure certificate you just exported and then click Open.
  6. Click No when asked if the certificate requires a password.

To create an EmpowerID Person account for the Azure connection

  1. Log in to the EmpowerID Web application as an administrator.
  2. From the Navigation Sidebar, navigate to the Person management page by expanding Identities and clicking People.
  3. From the Person management page, click Create Person Simple Mode underneath the Actions pane.
  4. Enter a first name and a last name for the Person account in the First Name and Last Name fields, respectively. As this Person account serves as an identity for the Azure connection, you should name it accordingly. In our example, we are naming the Person "Azure Proxy."
  5. Underneath Primary Business Role and Location, click Select a Role and Location.
  6. In the Business Role pane of the Business Role and Location selector that appears, type Temp, press ENTER and then click Temporary Role to select it.
  7. Click the Location tab to open the Location pane and then type Temp, press ENTER and click Temporary Role to select it.
  8. Click Select to select the Business Role and Location for the Person account and close the Business Role and Location.
  9. Click Save to create the EmpowerID Person.

To map the Azure certificate to the EmpowerID Person

  1. From the Navigation Sidebar, search for the person you just created and click the tile for that person.
  2. When searching for people, be sure to select the Person filter on the search field; otherwise, your search won't return the person. The below image shows the Person filter.

    This directs you to the View page for the person. View pages allow you to view and manage information related to the specific resource being viewed.

  3. From the View page for the person, expand the Editable Multivalued Fields accordion (located near the bottom of the page) and then click the Edit link in the Mapped Login Certificates pane.
  4. Search for and select the Azure certificate.
  5. Click Save.
  6. Certificates can only be mapped to one person. If you decide at a later point in time to use another Person account for the Azure connection, you must remove the certificate mapping from the first EmpowerID Person before you can map it to the new person.

To create the Azure connection in EmpowerID

  • On your EmpowerID server, log in to the EmpowerID Management Console as an administrator.
  • From the EmpowerID Management Console, click the EmpowerID icon and select Configuration Manager from the menu.
  • In Configuration Manager, expand the User Directories node and then click Account Stores.

  • Click the Add New button above the grid.
  • In the Add New Security Boundary window that opens, select the Microsoft Azure Subscription Security Boundary type from the drop-down list and then click OK.

  • In the Account Store Details window that appears, do the following:
    1. Type a name for the connector in the Name field.
    2. Type your Azure Subscription ID in the SubscriptionID field.
    3. Type the user id of an Azure administrator in the Client User ID field. This account is the proxy account that EmpowerID uses to inventory the Azure instances.
    4. Type the password for the above Azure administrator in the Password field.
    5. Paste the Base-64 encoded format of your Azure certificate in the Certificate field.
    6. Click Save.
  • Back in the main screen of Configuration Manager, search for the account store you just created and then double-click it or right-click it and select Edit from the context menu.
  • In the Azure Account Store Details screen that appears, scroll to the Inventory pane and toggle the red sphere to the left of Enable Inventory so that it becomes a green check box.