1. Using the Microsoft Office 365 People Adapter with Oracle Integration 3
  2. Create a Microsoft Office 365 People Adapter Connection
  3. Prerequisites for Creating a Connection

Prerequisites for Creating a Connection

These are the prerequisites for creating a connection with the Microsoft Office 365 People Adapter.

Note:

Before creating a Microsoft Office 365 People Adapter connection, you must upload the trusted public certificate to Oracle Integration. The public certificate is created when you create the private key. Rename the public certificate file extension to .crt. To upload the certificate, see Upload a Certificate to Connect with External Services.

  1. Log in to https://azure.microsoft.com/ with administrator access. If you do not have an account, click Free account.
  2. In the upper right, click Portal.
  3. In the search field at the top, enter app registration, then click the Search icon.
  4. Click New registration.
  5. In the Name field, enter the user-facing display name for this application.
  6. In the Supported account types section, select Accounts in Any Organizational Directory.
  7. In the Redirect URI (optional) section, select Web, then enter the redirect URL.

    Note:

    If you don't know the following information, check with your administrator:

    • If your instance is new or upgraded from Oracle Integration Generation 2 to Oracle Integration 3.
    • The complete instance URL with the region included (required for new instances).
    For Connections… Include the Region as Part of the Redirect URL? Example of Redirect URL to Specify…
    Created on new Oracle Integration 3 instances Yes. 
    https://OIC_instance_URL.region.ocp.oraclecloud.com/icsapis/agent/oauth/callback

    Created on instances upgraded from Oracle Integration Generation 2 to Oracle Integration 3

    		 No.

    This applies to both:

    • New connections created after the upgrade
    • Existing connections that were part of the upgrade
    		 
    https://OIC_instance_URL.ocp.oraclecloud.com/icsapis/agent/oauth/callback
  8. Click Register.
  9. If you want to add more redirect URLs, click the link in the Redirect URIs section on the right side of the page.
  10. In the left navigation pane, click Certificates & secrets to generate a secret.
  11. In the Client secrets section, click New client secret.
  12. In the Description field, enter a description for the secret.
  13. In the Expires section, select the proper expiration time (preferably Never).
  14. Click Add.
  15. In the Client secrets section at the bottom, copy the client secret value in the Value column. This value is required when configuring the connection on the Connections page.

    Note:

    The client secret value cannot be displayed again once you exit the Microsoft Azure page. Ensure that you copy this value.
  16. In the left navigation pane, click API permissions to add required permissions to the application.
  17. Click Microsoft Graph.
  18. In the Select permissions field, begin entering the name of the adapter for which you are configuring permissions. For the Microsoft Office 365 People Adapter, enter Contact.

    Available permissions are displayed. You enter these permissions in the Scope field when configuring a connection on the Connections page.

  19. Select the necessary permissions, and click Update Permissions. The offline_access scope is required. This scope is needed to get a refresh token, which is then used to get new access tokens. See Scopes and permissions in the Microsoft identity platform.
  20. In the left navigation pane, click Overview.

  21. Copy the value shown in the Application (client) ID field. This value is required when configuring the connection on the Connections page.

Microsoft also provides an example of how to create this application. See Quickstart: Configure a client application to access web APIs.