接続の作成

機械翻訳について

接続の作成

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

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

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

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

接続プロパティの構成

アプリケーションがリクエストを処理するための接続情報を入力します。

「接続プロパティ」セクションに移動します。
直接接続を使用するように接続を構成した場合(つまり、接続エージェントを使用していない場合):
1. 「ホスト」フィールドに、ホストを指定します。
2. 「サービス名」フィールドに、データベース・サービス名を指定します。 lowプロファイルをデータベース・サービス名として使用することをお薦めします。データベース・サービス名が、「セキュリティ」セクションで指定したデータベース・サービス・ユーザー名と同じではありません。
  
  ノート:
  サービス名は、ウォレットのtnsnames.oraファイル内のものと同じである必要があります。ただし、接続のテスト時にエラーが発生した場合は、名前が長すぎる可能性があります。「接続ページで指定されたサービス名が長すぎます」を参照してください。
接続を構成して接続エージェントを使用する場合:
1. 「ホスト」フィールドに、ホストを指定します。
2. 「ポート」フィールドに、SQL*Netポートを指定します。
3. SIDフィールドに、データベースSIDを指定します。
4. 「サービス名」フィールドに、データベース・サービス名を指定します。 lowプロファイルをデータベース・サービス名として使用することをお薦めします。データベース・サービス名が、「セキュリティ」セクションで指定したデータベース・サービス・ユーザー名と同じではありません。
  
  ノート:
  SIDまたはサービス名の値を指定する必要があります。両方のフィールドに値を指定しないでください。

接続セキュリティの構成

セキュリティ・ポリシーを選択し、ログイン資格証明を設定して、データベース接続のセキュリティを構成します。データベース接続は、パブリックにアクセスできるデータベースにのみ許可されます。

「セキュリティ」セクションに移動します。
セキュリティ・ポリシーを選択します。
JDBC Basic認証を選択した場合:

ノート:
ユーザー名パスワード・トークン・セキュリティ・ポリシーを使用すると、データベースがOracle Integrationインスタンスと同じプライベート・ネットワークに存在する場合に、接続エージェントなしでデータベースへの接続を作成して正常にテストできます。データベースが同じプライベート・ネットワーク内にない場合は、接続エージェントなしで接続することはお薦めしません。これは、接続が保護されないためです。
1. Oracle Autonomous Transaction Processingデータベースに接続するためのデータベース・サービスのユーザー名とパスワードを入力します。データベース・サービス・ユーザー名は、ユーザーがデータベースにログインするためのスキーマ・ユーザー名です。データベース・サービスのユーザー名が、「接続プロパティ」セクションで指定したデータベース・サービス名と同じではありません。
2. パスワードを2回目に再入力してください。
SSL経由のJDBCを選択した場合:

ノート:
「Oracle Autonomous Transaction Processingアダプタ」は、ウォレットの使用時に接続性エージェントを介して接続できます。接続エージェントが接続で使用されている場合にのみ、トリガー接続として使用できます。ただし、(「SQL文を実行」、「ストアド・プロシージャを起動する」、「表に対して操作を実行」などの「基本情報」ページで選択するすべての操作は、(接続性エージェントなしで)直接接続を使用するようにアダプタを構成する際にサポートされます。
1. 「ウォレット」フィールドでチェック・ボックスを選択し、「アップロード」をクリックして、ウォレット・ファイルをアップロードします。
2. ウォレット・パスワードを入力し、確認のためもう一度再入力します。
3. Oracle Autonomous Transaction Processingデータベースに接続するためのデータベース・サービスのユーザー名とパスワードを入力します。データベース・サービス・ユーザー名は、ユーザーがデータベースにログインするためのスキーマ・ユーザー名です。データベース・サービスのユーザー名が、「接続プロパティ」セクションで指定したデータベース・サービス名と同じではありません。
4. データベースのパスワードをもう一度入力して確認してください。
JDBCとOCIシグネチャを選択した場合:

ノート:
このオプションは一括データ・インポート操作を使用するために必要で、直接接続を使用する場合(つまり、接続エージェントを使用していない場合)にのみサポートされます。
1. 「ウォレット」フィールドでチェック・ボックスを選択し、「アップロード」をクリックして、ウォレット・ファイルをアップロードします。
2. ウォレット・パスワードを入力し、確認のためもう一度再入力します。
3. Oracle Autonomous Transaction Processingに接続するためのデータベース・サービスのユーザー名およびパスワードを入力 - 共有(ATP-S)データベース。データベース・サービス・ユーザー名は、ユーザーがデータベースにログインするためのスキーマ・ユーザー名です。データベース・サービスのユーザー名が、「接続プロパティ」セクションで指定したデータベース・サービス名と同じではありません。
4. データベースのパスワードをもう一度入力して確認してください。
5. 「オブジェクト・ストレージ・リージョン」フィールドで、オブジェクト・ストレージが存在するリージョンを指定します(たとえば、us-ashburn-1)。
6. 「オブジェクト・ストレージ・テナンシOCID」フィールドで、Oracle Cloud Infrastructureコンソールからコピーした値を指定します(たとえば、ocid1.tenancy.oc1.alphanumeric.value)。「接続作成の前提条件」を参照してください。
7. 「オブジェクト・ストレージ・コンパートメントOCID」フィールドで、Oracle Cloud Infrastructureコンソールからコピーした値を指定します(たとえば、ocid1.compartment.oc1.alphanumeric.value)。
8. 「オブジェクト・ストレージ・ユーザーOCID」フィールドで、Oracle Cloud Infrastructureコンソールからコピーした値を指定します(たとえば、ocid1.user.oc1.alphanumeric.value)。
9. 「秘密キー」フィールドで、「アップロード」をクリックして、作成したキーを選択します。キーがRSA (PKCS1)形式であることを確認します。
  
  ノート:
  パス・フレーズ/パスワードがサポートされるのは、秘密キーwithoutのみです。
10. 「フィンガ・プリント」フィールドに、Oracle Cloud Infrastructureコンソールでキーを作成したときに生成されたフィンガ・プリントを入力します。

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

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

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

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

接続のテスト

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

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

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

接続の場合...

結果

WSDLを使用しない

テストが自動的に開始され、接続に指定した入力が検証されます。

WSDLの使用

実行する接続テストのタイプを選択するダイアログが表示されます:

検証とテスト: インポートされたスキーマおよびWSDLの処理など、WSDLの完全な検証を実行します。インポートされたスキーマおよびWSDLの数によっては、完全な検証に数分かかる場合があります。 WSDLで公開されている操作に送信されたリクエストはありません。
テスト: WSDL URLに接続し、WSDLに対して構文チェックを実行します。 WSDLで公開されている操作に送信されたリクエストはありません。

接続テストの結果に関するメッセージを待機します。
- テストに成功した場合、接続は適切に構成されています。
- テストが失敗した場合は、入力した構成詳細を編集します。入力ミスがないかチェックし、URLと資格証明を検証して、診断ログで追加の詳細をダウンロードします。接続が成功するまでテストを続けます。
- OCIシグネチャ付きJDBCセキュリティ・ポリシーを使用する場合、接続テスト中にコンパートメントID検証は行われません。アダプタ・エンドポイント構成ウィザードは、コンパートメントOCIDの検証および認可の問題を処理します。
完了したら「保存」をクリックします。