2 Before You Install the Recipe

You must perform the following configuration tasks on your Atlassian and Microsoft Teams instances in order to successfully connect to these external systems using Oracle Integration and and create alerts.

Configure Jira

To access Jira from Oracle Integration, you must perform the following configuration tasks:

1. Create an app, configure the OAuth 2.0 authorization code, and assign the scopes. See Prerequisites to Use the Authorization Code Credentials Security Policy.
   • In the Callback URL field, specify the callback URL in the following format: https://{OIC_Hostname}:443/icsapis/agent/oauth/callback
   • Ensure that you add the following scopes: read:jira-work manage:jira-project write:jira-work manage:jira-configuration read:jira-user
2. Create a webhook. See Registering a webhook via the Jira administration console.
   • In the URL field, enter your Oracle Integration endpoint URL. For example, https://<encodedUsername>:<encodedPassword>@<host>/ic/api/integration/v2/flows/jira/project/ORCL-R-JIRA_MSTEAMS_ISSUE_ALERT/JIRA_MS_TEAMS_ISSUE_ALERT/1.0/Inbound/issue_created?user_id=[user_id-value]&user_key=[user_key-value].
   • In the Events field, select Issue Created.

Configure Microsoft Teams

Complete certain configuration tasks in your Microsoft Teams instance to successfully connect to it from Oracle Integration.

1. Log in to https://azure.microsoft.com/ with administrator access.
2. In the upper right, click the user icon and select Azure Portal.
3. In the search field of the resulting page, enter app registration, and then select App registrations from the search results.
   Alternatively, scroll to the Azure services section in the page, and click App registrations.
4. In the App registrations page, click New registration.
5. In the Name field enter the user-facing display name for the application. For example, Jira-MicrosoftTeams.
6. In the Supported account types section, select who can use this application or access this API.
7. In the Redirect URI (optional) section, select Web from the drop-down field, and enter the redirect URL: https://instance_URL/icsapis/agent/oauth/callback.
8. Click Register.
9. Get the Client ID.
   1. In the left navigation pane, click Overview.
   2. Copy the value in the Application (client) ID field.
      Note down the value as it will be required while configuring the Microsoft Teams connection from Oracle Integration.
10. Get the Client secret.
    1. In the left navigation pane, click Certificates & secrets.
    2. In the Client secrets section, click New client secret.
    3. In the Add a client secret dialog:
       • Enter a description in the Description field.
       • Select the expiration time of the app from the options available in the Expires field.
       • Click Add.
    4. In the resulting page, under the Client secrets section, copy the client secret value in the Value column.
    Note down the value as it will be required while configuring the Microsoft Teams connection from Oracle Integration.
11. Set the permissions and scopes for the application.
    1. In the left navigation pane, click API permissions, and select Microsoft Graph.
    2. In the API permissions page, select delegated permissions. Click Add a permission, and add the following API permissions to the application.
       • ChannelMessage.Send
       • Chat.ReadWrite
       • ChatMessage.Send
       • Group.ReadWrite.All
12. Navigate to the Overview page and click Endpoints. Note the OAuth2.0 authorization endpoint(v2) and OAuth 2.0 token endpoint(v2).