AddressBook Integration at Rest

AddressBook integration allows taking advantage of the REST APIs for both Office 365 and on-premises mailboxes.

Use the following configurations to integrate the AddressBook and WebApps Client.

  • Application registration in Azure Application Portal

  • Grant Application Permission

  • Integrate AddressBook and WebApps Client

Application registration in Azure Application Portal

To register the application in the Azure application portal

  1. Sign into the Microsoft App Registration Portal.

  2. Choose Add an app.

  3. Specify Name and choose Create Application.

  4. Note down the application ID(unique identifier for your app).

  5. Generate a New Password and note down the password.

  6. Select Add Platform and select Native Application.

  7. Add two Redirect URLs to the native platform that ends in //permissions and //auth.

  8. Under Microsoft Graph Permissions, add Application Permissions.

  9. Select the Application Permissions below.

    • Contacts.Read

    • Group.Read.All

    • People.Read.All

    • User.Read.All

  10. Click OK.

  11. Click Save to save all the changes.

Note: There are many permissions that user/Admin can consent.

Grant Application Permission

The following steps must be carried out by the Server Administrator using an account with the administrative privileges.

To grant application permission

  1. Launch Server Administrator.

  2. Navigate to WebApps node under Configuration.

  3. Double click on the profile to open the Profile Properties.

  4. Navigate to Features tab.

  5. Click on Add and choose OutlookAddressBook.

  6. Enter the required information obtained from the application registration portal.

    • Client ID: ID generated on App Registration Portal

    • Client Secret:  Password generated on App Registration Portal

    • Redirect URI: msal<YourClientID>://auth

    • Permissions URI: msal<YourClientID>://permissions

  7. Click Grant Admin Consent.

  8. When prompted, sign into Azure with an Administrative account.

  9. When prompted, authorize the registered application.

  10. Once permission is granted, the Status is updated.

  11. Click OK, OutlookAddressBook feature will be added.

  12. Click OK to close the Profile Properties.

Integrate AddressBook and WebApps Client

Once permission is granted in the WebApps client, the user will see auto-complete suggestions as they type in the Destinations field of the Create Distribution App and Email Destination field of the Create Distribution Recipient Properties dialog.

 

Note: The filtered list displayed is based on what was keyed in the text field and only works for email recipients.

See also

About WebApps

MyFiles

WorkSite Web Extensions

Customizing WebApps Help Link