Skip to main content

Power2CM Azure App Registration

Raise a support ticket

OVERVIEW​

To use Power2CM you are required to register two applications on Azure Active Directory. One Azure app will be used to protect the Power2CM application installed on the web server, and the other will be used to allow the Power2CM Connector (inside power automate) to authenticate with the Power2CM application.

POWER2CM APP REGISTRATION​

  1. Sign in to the Azure web portal by clicking here

  2. Once signed in, click on the Azure Active Directory button

    image.png

  3. Click on the App Registrations option from the left menu

    image.png

  4. Click on the New Registration button

    image.png

  5. Enter Power2CM into the name input field

    2023-03-01_14-06-11.png

  6. Under Supported account types section enabled Accounts in this organizational directory only option

    image.png

  7. Select Single-page application (SPA) from the drop-down menu and type in the domain base URL configured for Power2CM followed by /Power2CM/

    Note

    The URI is case sensitive, the route must match exactly the pattern below where the only variable that needs to be replaced is the hostname. Please include the trailing slash in the URL. Example: https://hostname/Power2CM/

    2023-03-01_13-43-57.png  

  8. Click on the Register button

    2022-10-14_17-00-13.png

API PERMISSIONS​

The application will only require the User.Read Microsoft Graph permission. This permission is added by default when creating a new Azure App registration.

  1. Click on API permissions from the left menu

    image.png

  2. Ensure the User.Read delegated permission is in the list of permissions

    2023-03-01_13-54-06.png

EXPOSE THE API​

Applying a custom scope to the registration will prevent unauthorized access to the Power2CM API endpoints.

  1. In the Left Menu, click on Expose an API

    2022-08-04_11-11-50.png

  2. Next to the Application ID URI click on the Set option

    2022-08-04_11-13-18.png

  3. Click on the Save button

    Note

    Do not Change the Application ID URI. It must be in the following format: api://{client id}

    2022-08-04_11-14-32.png

  4. Click on the Add a scope button

    2022-08-04_11-17-32.png

  5. Specify the values below in the Add a scope window, then click on Add scope

    Note

    The scope must be named Grant.Access

    FieldValue
    Scope NameGrant.Access
    Who can consent?Admins and users
    Admin consent display nameGrant Access to Power2CM
    Admin consent descriptionGrant Access to Power2CM
    User consent display nameGrant Access to Power2CM
    User consent descriptionGrant Access to Power2CM
    StateEnabled

    2023-03-01_13-58-39.png

  6. Once the scope has been added, click on API permissions

    2022-08-04_11-30-18.png

  7. Click on the Add a permission option

    image.png

  8. Click My APIs

    image.png

  9. Click on the previously created Power2CM permission

    2023-03-01_14-00-22.png

  10. Click on the Grant.Access scope and then click Add permissions at the bottom of the screen

    2023-03-01_14-02-44.png

  11. Click on Grant admin consent

    2023-03-01_14-04-58.png

GATHERING APP DETAILS​

Please follow the steps below to retrieve the Application ID, Tenant ID and Redirect URL on the Azure portal. These values are required for the installation.

  1. Once signed into the Azure portal click on Azure Active Directory

    image.png

  2. Click on App registrations

    image.png

  3. Click on the required application (Power2CM created previously)

    image.png

  4. Click on Overview

    image.png

  5. Copy the Application (client) ID and Directory (tenant) ID and note them down

    image.png

  6. Click on Redirect URIs from the overview page

    image.png

  7. And then copy and note down the Redirect URI value

2023-03-01_14-10-55.png

VALUES REQUIRED FOR INSTALLATION​

The following values will be required for the installation of 365|2CM. Please ensure that the person responsible for the installation has these values.

  • Redirect URI
  • Application ID
  • Tenant ID
NameDescription
Redirect URIThe URI where Azure will send the authentication payload upon successful authentication.
Application IDApplication's unique identifier on AzureAD.
Tenant IDThe organization tenant's unique identifier on AzureAD.

POWER2CM CONNECTOR APP REGISTRATION​

  1. Sign in to the Azure web portal using the link below https://azure.microsoft.com/en-gb/features/azure-portal/

  2. Once signed in, click on the Azure Active Directory button

    image.png

  3. Click on the App Registrations option from the left menu

    image.png

  4. Click on the New Registration button

    image.png

  5. Enter Power2CM Connector into the name input field

    2023-03-01_14-15-32.png

  6. Under Supported account types section enabled Accounts in this organizational directory option

    image.png

  7. Select Web from the drop-down menu and leave the URL value blank for now

    2023-03-01_14-18-21.png

  8. Click on the Register button

    2022-10-14_17-00-13.png

API PERMISSIONS​

  1. Click on the API permissions option from the left menu

    image.png

  2. Click on Add a permission option

    image.png

  3. Click My APIs

    image.png

  4. Click on the previously created Power2CM Azure app registration. This is the registration you created first at the start of this guide

    2023-03-01_14-00-22.png

  5. Click on the Grant.Access scope and then click Add permissions at the bottom of the screen

    2023-03-01_14-02-44.png

  6. Click on the Grant admin consent option

    2023-03-01_14-04-58.png

  7. Your configured permissions should appear as shown below:

    2023-03-01_14-24-40.png

CONFIGURE CLIENT SECRET​

  1. Click on Certificates and Secrets from the left-side menu

    image.png

  2. Click on the Client secrets tab and click New client secret

    image.png

  3. Provide a unique description and select an expiry period for your secret

    2023-03-01_14-29-51.png

  4. Ensure to copy the Value to somewhere secure. Once you navigate away from this page you will be unable to access the secret value again

    2023-03-01_14-30-56.png

VALUES REQUIRED FOR POWER AUTOMATE SETUP​

The following values will be required when configuring the Power2CM Connector in Power Automate:

  • Application ID
  • Client Secret
NameDescription
Application IDApplication's unique identifier on AzureAD.
Client SecretThe client secret value.