OAuth 2.0への変換の準備

ただし、アップグレード前に、エージェント・ネットワークからOracle Integrationの設計時およびランタイムへのエグレス、およびOracle Identity Cloud Serviceまたはアイデンティティ・ドメインへのエグレスを許可して、この変換を準備する必要があります(許可リストの更新を参照)。

また、アップグレード後、新しい認証方法の結果として、ファイアウォールへの追加のトラフィックが表示されます。この追加のトラフィックが発生するのは、接続エージェントが新しいトークンを取得するためにサーバーと通信する必要があるためです。

Oracle Integration 3でのOAuth 2.0サポートの詳細は、Oracle Integration 3での基本認証のサポート状況を参照してください。

許可リスト設定の更新

アップグレード・ウィンドウが近づいたら、「許可リストの更新」で説明されているタスクを実行します。

アップグレード中にオフラインになっているエージェント、またはアップグレード要件を満たしていないエージェントはアップグレードされません。その場合は、アップグレード後のステップを実行して接続を再取得する必要があります。

プロキシ・サーバーの「キャッシュ」プロパティの設定

たとえば、プロキシ・サーバーでCache-ExpiresDefaultプロパティを使用する場合は、nowに設定します。

Oracle Cloud Infrastructureコンソールでのアクティビティ・ストリームの取得の開始

理由は、アクティビティ・ストリームが移行されないためです。ただし、Oracle Cloud Infrastructureコンソールでこのデータを取得しても、履歴データにアクセスできます。Oracle Cloud Infrastructureコンソールでのアクティビティ・ストリームの取得を参照してください。

完全なネットワーク・ルール構成

いずれかの統合接続で、Oracle Cloud Infrastructure Object StorageやOracle Autonomous Databaseなど、ネットワーク・ルールをサポートするOracle Cloud Infrastructureサービスをターゲットとしていて、それらのルールを有効にしている場合は、Oracle Integration Service VCNをルールに追加するなど、ネットワーク・ルールの構成を完了する必要があります。

Ensure Connectivityを参照してください。

キーストアのすべてのB2Bパスワードが一致していることを確認します。

最後にアップロードされたキーストア・ファイルがない場合は、ファイルを再作成します。

証明書をアップロードする場合:

• 「タイプ」で、「X.509 (SSLトランスポート)」を選択します。
• 「カテゴリ」で、「アイデンティティ」を選択します。

Oracle Integration Generation 2での統合の使用のSSL証明書のアップロードを参照してください。

障害が発生したインスタンスの処理方法の決定

• 失敗した非同期インスタンス- リカバリ可能

  失敗したインスタンスを再送信し、キューをクリアします。失敗したメッセージの再送信を参照してください。

  インスタンスのアップグレード時に失敗した非同期インスタンスがある場合、Oracle Integration 3では失敗したインスタンスを再送信できません。少なくともすぐには送信できません。エラーやすべてのアクティビティ・ストリーム・データなどのランタイム・データがアップグレードの一部としてOracle Integration 3に移行されていないため、再送信できません。ただし、アップグレードの完了後、Oracle Integration 3で統合を実行し、エラー・データを収集してから再送信できます。

• 失敗した同期インスタンス- リカバリ不可

  同期統合インスタンスは再送信できないため、リカバリできません。

非同期メッセージの処理方法を決定

理由は、ダウンタイム中に、Oracle Integrationによってすべての受信リクエストが拒否されるためです。準備するには、次のオプションがあります:

• アップグレードを開始する前に、クライアント側のすべての非同期メッセージを一時停止します。

  このアプローチでは、クライアントはメッセージを送信せず、Oracle Integrationはメッセージを拒否しません。

  このオプションを選択する場合は、アップグレードの開始時間と終了時間がわかっていることを確認してください。

• アップグレードが終了したら、拒否されたメッセージに対して適切な次のステップを決定します。

Oracle Integration組込みAPIコールを基本認証からOAuthに変更します

Oracle Integration Generation 2では、基本認証を使用してOracle Integration REST APIおよびファイル・サーバーREST APIを使用できます。Oracle Integration 3では、OAuthを使用する必要があります。OAuthを使用して接続するには、Oracle Integration REST APIまたはファイル・サーバー REST APIを使用するクライアント、スクリプト、統合およびコマンドを更新する必要があります。認証方法のサポートの詳細は、「Oracle Integration 3で基本認証がサポートされるタイミング」を参照してください。Oracle Integration REST APIでのOAuthの使用の詳細は、セキュリティ、認証および認可、またはファイル・サーバーREST APIでの使用の詳細は、セキュリティ、認証および認可を参照してください。

廃止されたMicrosoftアダプタの使用を停止

• Microsoft Office 365 Calendarアダプタ

  Oracle Integration 3でのMicrosoft Office 365 Calendarアダプタの使用の「操作の起動」ページを参照してください。

• Microsoft Office 365 Peopleアダプタ

  Oracle Integration 3でのMicrosoft Office 365 Peopleアダプタの使用の「操作の起動」ページを参照してください。

• Microsoft Office 365 Outlookアダプタ

  Microsoft Office 365 OutlookアダプタとOracle Integration 3の使用の「操作の起動」ページを参照してください。

1. アップグレードのためにSSL証明書シークレットへのアクセスを許可するには、次のポリシーを追加し、MySecretCompartmentをSSL証明書シークレットを含むコンパートメントに置き換えます:

   allow service vb-vbprod to manage secrets in compartment MySecretCompartment
   allow service vb-vbprod to manage keys in compartment MySecretCompartment
   allow service vb-vbprod to manage vaults in compartment MySecretCompartment
   allow service vb-vbprod to read secret-bundle in compartment MySecretCompartment

2. カスタム・エンドポイントではなく元のOracle Integration Generation 2 URLを指すように、Visual Builderテナントとアプリケーション設定、および統合アプリケーションを更新します。アップグレード中、カスタム・エンドポイントはVisual Builderで構成されるため、アップグレード後、カスタム・エンドポイントを介してアクセスできるのはVisual Builderアプリケーションのみです。

アップグレード用のVisual Builderの準備