Before You Begin

You will need the following:

• Access to your Microsoft Entra (formerly Azure AD) tenant with the ability to create a new registration within App registrations and the ability to generate client secrets.
• An active Maptician Account Admin user with access to your environment. This requirement applies only if you are configuring the integration yourself without Maptician assistance.

Step 1: Register the Application

From the Microsoft Entra ID home screen:

1. In the left navigation menu, select App registrations.
2. At the top of the page, click New registration.
3. In the Name field, enter: “Maptician Graph API”
4. For the Supported account types section, keep the default Accounts in this organizational directory only (Single tenant).
5. Leave the Redirect URI fields blank.
6. Click Register at the bottom.

Step 2: Remove Default API Permissions

After the app is registered:

• Go to Manage > API permissions in the left menu.
• Remove the default User.Read permission.

Step 3: Create Client Secret

In the app:

1. Go to Manage > Certificates & secrets in the left menu.
2. Under the Client secrets tab, click New client secret.
3. In the dialog:
   • Description: Enter a name to describe this client secret, for example, “Maptician Secret 20XX”.
   • Expires: Select an expiration period that fits your company's security policy. We recommend choosing 730 days (24 months) to reduce how often you need to rotate it.
4. Click Add.
5. Immediately copy the Secret Value and Secret ID from the list.
   • The Secret Value appears only once. Store both securely and privately, and DO NOT share this publicly. If needing to share this with teammates, please only share this through secure channels.

Step 4: Retrieve Application ID and Directory ID

From the app's Overview page, copy the Application (client) ID and Directory (tenant) ID.

Step 5: Configure Graph API in Maptician

1. As an Account Admin in Maptician, click the settings button (gear icon) in the top-right corner of the screen.
2. Go to the Environment tab > Office 365 Integration.
3. Click the Add button to open the configuration panel.
4. Fill in the Graph API Connection form fields:
   • Name: Unique name for the connection (no spaces allowed).
   • Application/Client ID: Paste the Application (client) ID you copied from the app Overview page.
   • Tenant ID: Paste the Directory (tenant) ID you copied from the app Overview page.
   • Secret ID: Paste the Secret ID you copied after creating the client secret.
   • Secret Value: Paste the Secret Value you copied after creating the client secret. (After saving, this field masks and hides the value permanently.)
   • Custom Scopes (optional): Enter any custom scopes separated by commas.
   • Secret Expiration (required): Enter the exact expiration date of your client secret.
   • Expiration Notification Email (optional): Enter one email address. Maptician sends a reminder 7 days before expiration so you can update the Secret ID and Secret Value to avoid connection loss.
   • Connection is for Azure Gov Cloud: Check this box only if your Entra ID tenant is in Azure Government Cloud.
5. Click Set to save and create the connection.

Confirm the Graph API connection works in Maptician

Click the Check button for the new connection.

Success!

A succesful connection will show a Confirmed dialog. Click the OK button.

 

Failure!

If the connection check fails, you will be presented with an error dialog.

If this occurs, confirm that you have entered the correct information by clicking the Update button and validating your Graph API's information. Since your Secret Value will be hidden, the only way to verify this value is by pasting back in the previously entered value.

 

Maptician Features Using the Graph API

Below are the Maptician features and their setup articles that use the Microsoft Graph API:

• Microsoft Teams Meetings
• Microsoft Entra (Azure) Calendar Sync
• Microsoft Entra (Azure) IP Presence
• Microsoft Profile Image Sync