Versions Compared

Old Version 1

changes.mady.by.user Universal Importer for Confluence

Saved on

compared with

New Version 2

changes.mady.by.user Phillip Hanegan

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

---title: Connecting to Azure---

Anchor
topicRow
topicRow

Anchor
topicCols
topicCols
Anchor
overview
overview

Connecting to Azure

Before connecting EmpowerID to an external directory, please review theGetting Started with Directory Systems topic. The topic walks you through the prerequisites you need to completebefore connecting to an external directory for the first time. These prerequisites include:
  • Enrolling the EmpowerID Admin for password self-service reset
  • Configuring the appropriate server roles for your EmpowerID servers
  • Reviewing the Join and Provision Rules for your environment
  • Reviewing the Join and Provision Filters for your environment
If you have already connected EmpowerID to another external directory, you can skip these prerequisites.

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.
Anchor
addcertpersonal
addcertpersonal

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.
Anchor
exportcert
exportcert

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 theCertificate Export Wizard that appears, clickNext.
  3. SelectNo, do not export the private key and clickNext.
  4. Select Base-64 encoded X.509 (.CER) and click Next.
  5. Select an export location, naming the exported certificate accordingly and clickNext.
  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----).
Anchor
addcert
addcert

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.
Anchor
createperson
createperson

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.
Anchor
mapcert
mapcert

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. 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.
  3. Search for and select the Azure certificate.
  4. Click Save.
Anchor
createconnection
createconnection

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. Image Removed Image Added 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. Image Removed Image Added 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. Image Removed Image Added

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.

Image Removed Image Added
Anchor
topicTOC
topicTOC