Prerequisites for Creating a Connection
These are the prerequisites for creating a connection with the Microsoft Office 365 Calendar Adapter.
Note:
Before creating a Microsoft
Office 365 Calendar 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.
- Log in to
https://azure.microsoft.com/
with administrator access. If you do not have an account, click Free account. - In the upper right, click Portal.
- In the search field at the top, enter
app registration
, then click the Search icon. - Click New registration.
- In the Name field, enter the user-facing display name for this application.
- In the Supported account types section, select Accounts in Any Organizational Directory.
- 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
- Click Register.
- If you want to add more redirect URLs, click the link in the Redirect URIs section on the right side of the page.
- In the left navigation pane, click Certificates & secrets to generate a secret.
- In the Client secrets section, click New client secret.
- In the Description field, enter a description for the secret.
- In the Expires section, select the proper expiration time (preferably Never).
- Click Add.
- 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. - In the left navigation pane, click API permissions to add required permissions to the application.
- Click Microsoft Graph.
- In the Select permissions field, begin
entering the name of the adapter for which you are configuring permissions. For
Microsoft
Office 365 Calendar Adapter, enter
Calendar
.Available permissions are displayed. You enter these permissions in the Scope field when configuring a connection on the Connections page.
- 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. - In the left navigation pane, click Overview.
-
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.