機械翻訳について

接続の作成

統合を構築する前に、データを共有するアプリケーションへの接続を作成する必要があります。

Oracle Integrationで接続を作成するには:

1. 左側のナビゲーション・ペインで、「ホーム」→「統合」→「接続」をクリックします。

2. 「作成」をクリックします。

   ノート:

   また、以下の統合キャンバスで接続を作成することもできます:

   • オーケストレートされた統合(「インバウンド・トリガーおよびアウトバウンド起動の定義」を参照)。

   • 基本的なルーティング統合(「トリガー(ソース)接続の追加」を参照)

3. 接続の作成 - 「アダプタの選択」ダイアログ。この接続に使用するアダプタを選択します。 アダプタを検索するには、リストをスクロールするか、「検索」フィールドに名前の一部または全部を入力して「検索」をクリックします。

4. 「接続の作成」ダイアログで、この接続を説明する情報を入力します。

   1. 他のユーザーが自分で統合の作成を始める場合にこの接続を見つけやすいように、わかりやすい名前を入力します。 入力した名前は、自動的に大文字で「Identifier」フィールドに追加されます。 識別子名を変更する場合は、空白を含めないでください(例: SALES OPPORTUNITY)。
   2. オプションのキーワード(タグ)を入力します。 接続ページで接続キーワードを検索できます。
   3. この接続を使用するロール(命令)を選択します(トリガー、呼出し、または両方)。 アダプタでサポートされるロールのみが選択のために表示されます。 ロールを選択すると、そのロールに適切な接続プロパティおよびセキュリティ・ポリシーのみが「Connections」ページに表示されます。 起動とトリガーの両方がサポートされるアダプタを選択し、いずれかのロールのみを選択した場合、選択しなかったセクションにアダプタをドラッグしようとするとエラーが発生します。 たとえば、invokeのみとして「Oracle Service Cloud (RightNow)アダプタ」の接続を構成するとします。 統合でアダプタをtriggerセクションにドラッグすると、エラーが発生します。
   4. 接続の説明を入力します(オプション)。

5. 「作成」をクリックします。

   接続が作成されました。 接続プロパティ、セキュリティ・ポリシー、接続ログイン資格証明、(特定の接続の場合)エージェント・グループなどの接続詳細を構成する準備ができました。

接続プロパティの構成

「Oracle Utilitiesアダプタ」でOUAFによって提供されるSOAPベースのカタログまたはREST webサービス・カタログを使用できます。

1. 「接続プロパティ」セクションに移動します。
2. OUAFアプリケーションによって公開されたSOAPベースのカタログまたはREST webサービス・カタログURLを「カタログURL」フィールドに入力し、OKをクリックします。
   構成されたREST webサービス・カタログは、RESTのインバウンド/アウトバウンド・サービスのリストのみを返す必要があります:

   • インバウンド・サービスはREST Integrated Web Services (IWS)で構成されます。
   • アウトバウンド・サービスは外部システムで構成されます: リアルタイムHTTPまたはJSON送信者のアウトバウンド・メッセージのタイプ。

   構成されたSOAPベースのカタログは、SOAPインバウンド/アウトバウンド・サービスのリストのみを返す必要があります:

   • インバウンド・サービスは、SOAP統合Webサービス(IWS)で構成されます。
   • アウトバウンド・サービスは外部システムで構成されます: リアルタイムHTTPまたはJSON送信者のアウトバウンド・メッセージのタイプ。

接続セキュリティの構成

セキュリティ・ポリシーを選択して、「Oracle Utilitiesアダプタ」接続のセキュリティを構成します。

1. 「セキュリティ」セクションに移動します。
2. セキュリティ・ポリシーを選択し、フィールドに入力します。 必要なフィールドを設定するために、すでにクライアント・アプリケーションの作成を終えている必要があります。
   接続ページでトリガーおよび呼出しロールを使用してユーティリティ・アダプタ接続を構成する場合、次のセキュリティ・ポリシー制限が適用されます:

   • 基本認証を選択すると、トリガーと起動として使用できます。
   • エージェント構成は、トリガー・ロールが設定された接続に対して適用できません。
   • OAuthリソース所有者セキュリティ・ポリシーを選択した場合、起動としてのみ使用できます。 接続をトリガー領域にドラッグすると、例外エラーが表示されます。 OAuthリソース所有者は、クラウド上のアプリケーションでのみサポートされます。
   • 既存の統合の場合、アダプタ・エンドポイント構成ウィザードでユーティリティ・アダプタを編集するときに、前述の制限は適用されません。
   • OAuthセキュリティ・ポリシーは、接続プロパティがサポートされているため、OUAF以外のアプリケーションではサポートされていません。

   要素	説明
   Basic認証	次の情報を入力します。 ユーザー名 パスワード
   OAuthリソース所有者のパスワード資格証明 ノート: このセキュリティ・ポリシーの使用時には、接続エージェントを構成しないでください。	このポリシーは、OAuth 2.0のトークン・ベース認証で保護されているカタログのためのものです。 これにより、OAuth 2.0トークン・ベース認証で保護されたSwagger 2.0またはOpenAPI 3.0 APIを使用できます。 このポリシーは、基本認証セキュリティ・ポリシーが十分でない場合に役立ちます。 アクセス・トークンURI: アクセス・トークンの取得元のOAuthサーバーURL。 通常、Oracle Identity Cloud Serviceサーバーによって、アプリケーションが登録されている場所(https://idcs_hostname/oauth2/v1/token)など)を識別します。 クライアントID: Oracle Identity Cloud Serviceサーバーでのアプリケーションの登録プロセス中にクライアントに発行されるクライアント識別子。 クライアント・シークレット: Oracle Identity Cloud Serviceサーバーでのアプリケーションの登録プロセス中にクライアントに発行されるクライアント・シークレット。 スコープ: リクエストにアクセスするスコープ。 このスコープでは、必要なアクセス・タイプを指定できます。 スコープによって、OAuthトークンに対するアクセスが制限されます。 すでに所有している権限(たとえば、http:hostname:port/*)以外には、追加の権限は付与されません。 認可されたリクエスト・メディア・タイプ: 受信するデータの形式(例: application/x-www-form-urlencoded;charset=UTF-8)。 これは、空白のままにしておくことができるオプションのパラメータです。 ユーザー名: リソース所有者のユーザー名(アプリケーション・ユーザー名)。 パスワード: リソース所有者のパスワード(アプリケーション・ユーザーのパスワード)。 クライアント認証: リクエストでクライアント資格証明を送信する方法を指定します。 ドロップダウン・リストには、次の2つのオプションがあります: クライアント資格証明をBasic認証ヘッダーとして送信 クライアント資格証明を本文で送信 これはオプションのパラメータで、空白のままにすると「クライアント資格証明を基本認証ヘッダーとして送信」のデフォルト値が使用されます。
   ユーザー名パスワード・トークン ノート: ユーザー名パスワード・トークン・セキュリティは、RESTベースの接続では使用できません。 「テスト」をクリックして接続をテストすると、エラーが表示されます。	このポリシーは、SOAPベースのカタログ接続でのみサポートされます。 ユーザー名 パスワード
   OAuthクライアント資格証明	Access Token URI - アクセス・トークンの取得元のURL。 Client Id - 登録プロセス中にクライアントに発行されたクライアント識別子。 Client Secret - クライアント・シークレット。 Scope - アクセス・リクエストのスコープ。 スコープによって、必要なアクセスのタイプを指定できます。 スコープによって、OAuthトークンに対するアクセスが制限されます。 ユーザーがすでに保持している以上の追加権限が付与されることはありません。 Auth Request Media Type - 希望するデータの受信形式。 これは、空白のままにしておくことができるオプションのパラメータです。 たとえば、Twitter APIを呼び出す場合、タイプを選択する必要はありません。 「クライアント認証」 - オプションで、クライアント認証を使用してOAuthフローを構成できます。 これは、クライアント認証を構成するPostmanユーザー・インタフェース機能に似ています。 クライアント資格証明を基本認証ヘッダーとして送信: basic認証としてヘッダーにクライアントIDとクライアント・シークレットを渡します。 本文にクライアント資格証明を送信: 本文のクライアントIDとクライアント・シークレットをフォーム・フィールドとして渡します。

エージェント・グループの構成

ファイアウォールの背後にある敷地内でホストされているサービスにアクセスするためのエージェント・グループを構成します。

1. 「Configure Agents」をクリックします。
   Select an Agent Groupページが表示されます。
2. エージェント・グループの名前をクリックします。
3. 「Use」をクリックします。

エージェント・グループを構成するには、オンプレミス接続エージェントをダウンロードしてインストールする必要があります。 「Oracle Integration Generation 2での統合の使用」の「接続性エージェント・インストーラのダウンロードおよび実行」と「オンプレミス・アプリケーションとOracle Integration間の接続エージェントおよび統合について」を参照してください。

接続のテスト

接続をテストして、接続が正常に構成されていることを確認します。

1. ページ・タイトル・バーで、「テスト」をクリックします。 次に起こることは、アダプタ接続でWeb Services Description Language (WSDL)ファイルを使用するかどうかによって異なります。 一部のアダプタ接続のみがWSDLを使用します。

   接続の場合...	結果
   WSDLを使用しない	テストが自動的に開始され、接続に指定した入力が検証されます。
   WSDLの使用	実行する接続テストのタイプを選択するダイアログが表示されます: 検証とテスト: インポートされたスキーマおよびWSDLの処理を含む、WSDLの完全な検証を実行します。 インポートされたスキーマとWSDLの数によっては、完全な検証に数分かかることがあります。 WSDLに公開されている操作にはリクエストは送信されません。 テスト: WSDL URLに接続し、WSDLの構文チェックを実行します。 WSDLに公開されている操作にはリクエストは送信されません。

2. 接続テストの結果に関するメッセージを待機します。
   • テストに成功した場合、接続は適切に構成されています。
   • テストが失敗した場合は、入力した構成詳細を編集します。 入力ミスがないかチェックし、URLと資格証明を検証して、診断ログで追加の詳細をダウンロードします。 接続が成功するまでテストを続けます。
3. 完了したら「保存」をクリックします。