Integrate Ampler with Microsoft Azure AD / Entra ID

Ampler can optionally communicate with Microsoft Graph to retrieve the current user’s profile from Entra ID. This data can be used in Dynamic Fields in PowerPoint/Word to automatically populate presentations and documents with the user’s name, job title, department, office location, etc. It can also be used to automatically create E-mail Signatures in Outlook.

To allow Ampler to communicate with Microsoft Graph, please follow these steps:

1. Navigate to https://portal.azure.com > Microsoft Entra ID
2. Go to ‘App registrations’ (NB: not ‘Enterprise applications’)
3. Click ‘New registration’ and fill out the form like this:
• Name: Ampler
• Supported account types: Single tenant (you can select Multitenant if your company is using multiple tenants in Azure)
• Redirect URI: Select ‘Public client/native (mobile & desktop)’ in the dropdown and leave the URI field next to the dropdown blank.
4. Click ‘Register’
5. In the newly created App Registration, select the ‘Authentication’ tab in the left menu
6. Click on ‘Add a platform’ and fill out the following:
• Select ‘Mobile and desktop applications’
• Put a checkmark next to the checkbox labelled: ‘https://login.microsoftonline.com/common/oauth2/nativeclient’ (it should be the first checkbox in the list)
• Click ‘Configure’ to add the platform
7. While still on the ‘Authentication’ tab, please make sure that the setting ‘Enable the following mobile and desktop flows’ is set to ‘Yes’
8. Then click ‘Save’
9. Now go to the ‘API Permissions’ tab in the left menu, and make sure to add these 8 Microsoft Graph permissions. You should add them as Delegated Permissions, which means that Ampler will access the Microsoft Graph API on behalf of the signed-in user:
• email
• MailboxSettings.ReadWrite
• offline_access
• openid
• Presence.Read.All
• profile
• User.Read
• User.Read.All
10. Then click on ‘Grant admin consent’. This will ensure that consent has been given on behalf of all users. Users will still need to authenticate with Microsoft Entra ID to allow Ampler to read their user profile
11. While still on the Ampler App Registration, please go to the ‘Overview’ tab, and copy the ‘Directory (tenant) ID’ and ‘Application (client) ID’
12. In either PowerPoint, Word or Outlook, go to Ampler > Settings > Company Settings > Integrations. Then fill in the Application and Tenant ID and click on ‘Publish settings’