必要なアクション: OIC統合の起動に使用されるOracleプロビジョニング済クライアント資格証明の置換 (2026/08/18)
必要なアクション: OIC統合の起動に使用されるOracleプロビジョニング済クライアント資格証明の置換 (2026/08/18)
投稿者:Ravi Pinto | Director, Product Management, Oracle Integration
Oracle Cloud ServicesアプリケーションからOracleのクライアントIDとクライアントシークレットを使用してOracle Integration(OIC)フローを呼び出しているお客様は、お客様自身が作成した機密アプリケーションに移行する必要があります。
OCI は、Oracle がプロビジョニングした Oracle Cloud Services アプリケーションのクライアント シークレットを表示しなくなりました。以前に取得したシークレットはローテーションされ、使用できなくなります。呼び出し元のアプリケーションがこれらの認証情報のいずれかをまだ使用している場合、OAuth アクセス トークンを取得できなくなり、OIC の呼び出しが失敗する可能性があります。
影響を受けるのは誰ですか?影響を受けるOC1 IDドメインの管理者で、外部アプリケーション、スクリプト、APIゲートウェイ、またはCI/CDジョブがOracleがプロビジョニングしたアプリケーションの認証情報を使用している場合です。これらのアプリケーションを内部的に使用するOracleサービス、および顧客が既に作成しているアプリケーションは影響を受けません。
Oracle Integrationのオーケストレーションにとって、これがなぜ重要なのか?
OIC RESTトリガーはOAuthで保護できます。サービス間呼び出し元は通常、OAuth 2.0クライアント認証情報付与を使用します。つまり、クライアントIDとクライアントシークレットをアイデンティティドメイントークンエンドポイントに提示し、アクセストークンを受け取って、そのトークンをOICエンドポイントに送信します。
クライアントシークレットがOracleがプロビジョニングしたOracle Cloud Servicesアプリケーションから取得された場合、シークレットローテーションによってその認証情報が無効になります。呼び出し元はトークンを取得できないため、OICリクエストは成功しません。これは呼び出し元の認証情報に関する問題であり、OICエンドポイントの変更によるものではありません。
あなたがすべきこと
Oracle Cloud Serviceアプリケーションのクライアントシークレットを漏洩してしまった場合は、以下の手順を実行してください。
- 影響を受ける呼び出し元を特定します。クライアントIDとクライアントシークレットを使用してOICアクセストークンを要求するアプリケーション、スクリプト、APIゲートウェイ、およびCI/CDジョブを一覧表示します。各認証情報がOracleがプロビジョニングしたアプリケーションから生成されたものか、顧客が作成した統合アプリケーションから生成されたものかを確認します。
- 顧客所有のクライアント アプリケーションを作成します。OCIコンソールで、該当する ID ドメインを開き、[統合アプリケーション]を選択してから、[アプリケーションの追加]、[機密アプリケーション]を選択します。環境固有の明確な名前を使用します
oic-invoker-prod。 - OAuth を設定します。アプリケーションをクライアントとして設定し、サービス間呼び出し元に対してクライアント資格情報を有効にし、クライアントタイプが機密であることを確認します。
- OICスコープを追加します。トークン発行ポリシーで、対象インスタンスのOracle Integrationアプリケーションを承認済みリソースとして追加します。
urn:opc:resource:consumer::allと を選択しますic/api/。 - ServiceInvokerロールを割り当てます。Oracleクラウドサービスで、対象のOracle Integrationアプリケーションを開き、新しい機密アプリケーションをそのServiceInvokerアプリケーションロールに割り当てます。
- 認証情報を有効化して保護します。機密アプリケーションを有効化し、クライアントIDとクライアントシークレットを取得します。シークレットは、組織が承認したシークレット管理ソリューションにのみ保存し、ソースコード管理やログには絶対に保存しないでください。
- 各呼び出し元を更新してテストしてください。新しい認証情報を使用して、アイデンティティドメイントークンエンドポイントからトークンを要求し、本番環境への切り替えを完了する前に、各環境で代表的なOICエンドポイント呼び出しをテストしてください。
移行チェックリスト
| チェック | 期待される結果 |
|---|---|
| 認証情報ソースを確認済み | 既存の認証情報は、Oracleによって提供されたものか、顧客によって作成されたものかが識別されます。 |
| 代替アプリが作成されました | 発信者および環境専用の機密アプリケーションが存在します。 |
| OAuth設定済み | クライアント認証情報と機密クライアントタイプは、必要に応じて有効化されます。 |
| OICスコープが追加されました | urn:opc:resource:consumer::allそして、ic/api/対象となるOICアプリケーション向けに選定されます。 |
| 割り当てられたロール | 機密扱いの申請書には、OIC(責任者)のServiceInvoker役割が記載されています。 |
| リークレットは安全に保管されています | クライアントシークレットは承認されたシークレットストアに保管され、コードやログには公開されません。 |
| エンドツーエンドテストに合格しました | 呼び出し元はアクセストークンを取得し、目的のOICエンドポイントを呼び出す。 |
| 本番切り替え完了 | 本番環境の呼び出し元は新しい認証情報を使用するため、プロビジョニングされたシークレットを参照しなくなります。 |
実装に関する注意事項
- 開発、テスト、本番環境では、それぞれ別の機密アプリケーションと機密情報を使用してください。
- 呼び出し元に一致するOAuthグラントを選択してください。クライアント資格情報は、機密性の高い非対話型サービスクライアント向けです。Oracleでは、その他のユースケース向けに別のグラントも提供しています。
- 呼び出しに必要なスコープとロールのみを適用してください。
- 切り替え前に、機密情報の所有権、保管方法、およびローテーションに関する計画を立ててください。
- トークン要求は、OICエンドポイントとは別にテストしてください。ローテーションされたシークレットまたは無効なシークレットを使用すると、OICエンドポイントに到達する前にトークンが発行されません。
Oracleのドキュメント
Oracle Cloud ServicesアプリケーションからOracleのクライアントIDとクライアントシークレットを使用してOracle Integration(OIC)フローを呼び出しているお客様は、お客様自身が作成した機密アプリケーションに移行する必要があります。
コメント
コメントを投稿