Oracle Integrationを使用してこれらの外部システムに正常に接続し、アラートを作成するには、AtlassianインスタンスおよびMicrosoft Teamsインスタンスで次の構成タスクを実行する必要があります。
「Jira」の構成
Oracle Integrationから「Jira」にアクセスするには、次の構成タスクを実行する必要があります:
- アプリケーションを作成し、OAuth 2.0認可コードを構成し、スコープを割り当てます。 「Oracle Integration 3でのJiraアダプタの使用」の「認可コード資格証明セキュリティ・ポリシーを使用するための前提条件」を参照してください。
- 「コールバックURL」フィールドで、次の形式でコールバックURLを指定:
https://{OIC_Hostname}:443/icsapis/agent/oauth/callback
- 次のスコープを追加してください:
read:jira-work manage:jira-project write:jira-work manage:jira-configuration read:jira-user
- webフックを作成します。 Atlassian Developerのドキュメントの「Jira管理コンソールを使用したwebフックの登録」を参照してください。
- 「URL」フィールドに、Oracle IntegrationエンドポイントURLを入力します。 たとえば、
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]です。
- 「イベント」フィールドで、「問題の作成」を選択します。
Microsoft Teamsの構成
Microsoft Teamsインスタンス内の特定の構成タスクを完了して、Oracle Integrationから正常に接続します。
- 管理者アクセス権で
https://azure.microsoft.com/にログインします。
- 右上のユーザー・アイコンをクリックし、Azure Portalを選択します。
- 結果ページの検索フィールドにアプリケーション登録を入力し、検索結果から「アプリ登録」を選択します。
または、ページのAzureサービス・セクションまでスクロールし、「アプリ登録」をクリックします。
- アプリケーション登録ページで、「新規登録」をクリックします。
- 「名前」フィールドに、アプリケーションのユーザー向けの表示名を入力します。 たとえば、
Jira-MicrosoftTeamsです。
- サポートされているアカウント・タイプ・セクションで、このアプリケーションを使用できるユーザーを選択するか、このAPIにアクセスできるユーザーを選択します。
- 「リダイレクトURI (オプション)」セクションで、ドロップダウン・フィールドからウェブを選択し、リダイレクトURLを入力:
https://instance_URL/icsapis/agent/oauth/callback。
- 「登録」をクリックします。
- クライアントIDを取得します。
- 左側にあるナビゲーション・ペインで、「概要」をクリックします。
- 「アプリケーション(クライアント) ID」フィールドに値をコピーします。
Oracle IntegrationからのMicrosoft Teams接続の構成時に必要になるため、値を書き留めます。
- クライアント・シークレットを取得します。
- 左側にあるナビゲーション・ペインで、「証明書&シークレット」をクリックします。
- クライアント・シークレット・セクションで、「新規クライアント・シークレット」をクリックします。
- 「クライアント・シークレットの追加」ダイアログで:
- 「説明」フィールドに説明を入力します。
- 「有効期限」フィールドで使用可能なオプションから、アプリケーションの有効期限を選択します。
- 「追加」をクリックします。
- 表示されるページのクライアント・シークレット・セクションで、「値」列のクライアント・シークレット値をコピーします。
Oracle IntegrationからのMicrosoft Teams接続の構成時に必要になるため、値を書き留めます。
- アプリケーションの権限およびスコープを設定します。
- 左側のナビゲーション・ペインで、「API権限」をクリックし、「Microsoftグラフ」を選択します。
- API権限ページで、「委任された権限」を選択します。 「権限の追加」をクリックし、次のAPI権限をアプリケーションに追加します。
ChannelMessage.Send
Chat.ReadWrite
ChatMessage.Send
Group.ReadWrite.All
- 「概要」ページにナビゲートし、「エンドポイント」をクリックします。 OAuth2.0認可endpoint(v2)およびOAuth 2.0トークンendpoint(v2)に注意してください。