「Oracle Utilitiesアダプタ」の機能
「Oracle Utilitiesアダプタ」では、Oracle Utilitiesアプリケーション・スイートを、Oracle Enterprise Resource Planning (ERP)やOracle Field Service (OFS)などの他のOracleアプリケーションと統合できます。
「Oracle Utilitiesアダプタ」には、次の機能があります:
-
トリガー(インバウンド)および呼出し(アウトバウンド)のサポートを提供します。 この機能により、他のアプリケーションは、Oracle Integrationで統合をトリガーしたり、Oracle Integrationのwebサービスを使用してOracle Utilitiesアプリケーションを起動できます。
-
Oracle Utilitiesサービス・カタログを使用して、インバウンド・サービスとアウトバウンド・サービスの両方を表示します。 このカタログは、ユーティリティ・アプリケーションのインバウンドおよびアウトバウンドwebサービスを公開しながら、設計時にデータ・マッピングを作成するための簡易ユーザー・エクスペリエンスを提供します。
-
SOAPベースのWSDLまたはREST OpenAPI URLベースの接続を使用して、すべてのインバウンドおよびアウトバウンド・サービス構造を公開します。
-
オンプレミス接続エージェントを使用して、オンプレミスのOracle Utilitiesアプリケーションと統合します。
-
プライベート・エンドポイントを使用した仮想クラウド・ネットワーク(VCN)内のプライベート・リソースへの接続をサポートします。 「Oracle Integration 3のプロビジョニングと管理」と「エンドポイント・アクセス・タイプの構成」の「プライベート・リソースへの接続」を参照してください。
-
呼出しおよびトリガー接続用のSOAPエンドポイントとRESTエンドポイントの両方のプライベート・エンドポイントをサポートします。
-
インバウンドSOAPおよびインバウンドRESTエンドポイントに次のメッセージ交換パターンを実装できます:
- 同期リクエスト/レスポンス
- 一方向リクエスト
SOAPおよびセキュアなWSDLのサポート
Oracle UtilitiesアダプタではセキュアなWSDLサポートが提供されています。 OUAFアプリケーションによって公開されるインバウンド/アウトバウンド・サービスのSOAPカタログを使用して、「Oracle Utilitiesアダプタ」を使用してSOAPベースの統合を作成できます。
- 「Oracle Utilitiesアダプタ」は、SOAPプロキシを使用してクラウド内のOracle Utilitiesアプリケーション・フレームワーク(OUAF)に公開されているSOAPカタログと連携します。
- 次の重要な変更を除いて、クラウドのSOAPプロキシおよびOUAFの変更により、SOAPカタログの動作がオンプレミス環境と同様になるように変更されました:
- カタログを取得するWSDLは、デフォルトで保護されています。 そのため、WSDLを取得するには資格証明を渡す必要があります。
- SOAPカタログによって公開されるすべてのサービスの個々のwsdlはデフォルトで保護されています。 そのため、WSDLを取得するには資格証明を渡す必要があります。
- カタログを取得するために使用するWSDLリンクと個々のWSDLが異なります。 SOAPプロキシ・サーバーを指しています。 たとえば:
https://host:port/soap/api/iws/ServiceCatalog?WSDL - Wsdl内のエンドポイントもSOAPプロキシを指しています。 たとえば:
https://host:port/soap/api/iws/ServiceCatalog
- 「Oracle Utilitiesアダプタ」は、SOAPに対する次のセキュリティ・ポリシーの使用をサポートしています:
- ユーザー名パスワード・トークン
- Basic認証
- OAuthクライアント資格証明(クラウドおよびオンプレミス)
- JWTユーザー・アサーションを使用したOAuth (非エージェント接続の場合のみ)
- JWTクライアント・アサーションを使用したOAuthクライアント資格証明(非エージェント接続の場合のみ)
クラウド環境から保護された/保護されたWSDLを使用する場合は常に、SOAPベースの統合のセキュリティ・ポリシーがBasic認証またはOAuthクライアント資格証明のいずれかであることを確認してください。
「接続セキュリティの構成」を参照してください。
RESTサポート
- 「Oracle Utilitiesアダプタ」を統合の呼出し接続として使用すると、インバウンドOUAFまたは非OUAF (NMS) REST webサービスが呼び出されます。
- 「Oracle Utilitiesアダプタ」を統合のトリガー接続として使用すると、OUAFまたは非OUAF (NMS)アプリケーションからのアウトバウンド・メッセージが消費されます。
- 「Oracle Utilitiesアダプタ」は、OUAFおよび非OUAF (NMS)アプリケーションによって提供されるOpenAPI URLの一部として利用可能なインバウンドおよびアウトバウンドのRESTベースのサービスを消費します。
- 「Oracle Utilitiesアダプタ」は、インバウンドwebサービスのRESTサービス・バージョン1.0および2.0をサポートしています。
- 「Oracle Utilitiesアダプタ」は、RESTに対する次のセキュリティ・ポリシーの使用をサポートしています:
- Basic認証
- OAuthリソース所有者(呼出しベースおよび非エージェント・ベースの接続のみ)
- OAuthクライアント資格証明
- JSONペイロードのみがサポートされています。 XMLペイロードはサポートされていません。
- HTTPメソッドGET、PUT、POSTおよびPATCHのサポートが提供されています。
ノート:
「Oracle Utilitiesアダプタ」は、Oracle Utilities Application Framework (OUAF)バージョン4.5以上のRESTサービスをサポートします。Swagger 2.0のサポートは、「Oracle Utilitiesアダプタ」バージョン24.04.0以上で削除されます。 接続には、OpenAPI 3.xカタログを使用します。 「Oracle Utilitiesアダプタ・バージョン24.04.0以上のSwagger 2.0 RESTカタログの使用」を参照してください。
- OUAFアプリケーションのカタログ形式。
https://host:port/ouaf/rest/ouaf/openapi/iws/catalogまたは
https://host:port/../../../rest/openapi/iws/catalog - 非OUAF (NMS)アプリケーションのカタログ形式。
https://host:port/nms-application_code/rest/v1/catalog説明:
###application_code is code for application. Please refer to non-OUAF application documentation for the application code.
OAuth 2.0サポート
「Oracle Utilitiesアダプタ」は、RESTベースおよびSOAPベースの接続に対してオープン認可(OAuth 2.0)セキュリティ・ポリシーをサポートします。
ノート:
OAuthリソース所有者のパスワード資格証明ポリシーは、REST非エージェント・ベースの接続でのみサポートされます。「接続セキュリティの構成」を参照してください。
JWTクライアントおよびユーザー・アサーションのサポート
- JWTクライアント・アサーション・セキュリティ・ポリシーを使用したOAuthクライアント資格証明
- JWTユーザー・アサーション・セキュリティ・ポリシーを使用したOAuth
JWTアサーションを使用すると、OAuthクライアント・シークレットをセキュアとみなさないサービス・プロバイダを起動できます。 信頼は、クライアント・シークレットではなくキー・ペア交換によって確立されます。
Oracle Utilitiesアダプタは、Oracle Integrationの統合でトリガーまたは呼出し接続として構成できます。 Oracle Utilitiesアダプタは、Oracle Integrationに含まれる多くの事前定義済アダプタの1つです。 Oracle Help Centerの「アダプタ」ページを参照してください。