機械翻訳について

接続の作成

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

ノート:

統合キャンバスで接続を作成することもできます。 「インバウンド・トリガーとアウトバウンド起動、処理の定義」を参照してください。

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

  1. 開始する場所を決定します:
    • プロジェクトでの作業(「プロジェクトの使用をお薦めします」の理由を参照)。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「接続」セクションで、現在接続が存在しない場合は「追加」をクリックし、接続が存在する場合は+をクリックします。 接続の作成パネルが開きます。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「接続」の順にクリックします。
      2. 「作成」をクリックします。 接続の作成パネルが開きます。

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

  3. この接続について説明する情報を入力します。
    要素 説明
    名前

    他のユーザーが自分で統合の作成を始める場合にこの接続を見つけやすいように、わかりやすい名前を入力します。

    識別子

    名前は、「名前」フィールドに入力した大文字で自動的に表示されます。 識別子名を変更する場合は、空白を含めないでください(例: SALES OPPORTUNITY)。

    ロール

    この接続を使用するロール(方向)を選択します。

    ノート: 選択したアダプタでサポートされているロールのみが選択のために表示されます。 一部のアダプタでは、すべてのロールの組合せ(トリガー、呼出しまたはトリガーと呼出し)がサポートされます。 他のアダプタでは、サポートするロールの組合せが少なくなります。

    ロールを選択すると、そのロールに適切な接続プロパティおよびセキュリティ・ポリシーのみが「Connections」ページに表示されます。 起動とトリガーの両方がサポートされるアダプタを選択し、いずれかのロールのみを選択した場合、選択しなかったセクションにアダプタをドラッグしようとするとエラーが発生します。

    たとえば、「Oracle Service Cloud (RightNow)アダプタ」の接続をinvokeのみとして構成するとします。 統合でアダプタをtriggerセクションにドラッグすると、エラーが発生します。

    キーワード

    オプションのキーワード(タグ)を入力します。 接続ページで接続キーワードを検索できます。

    説明

    接続の説明を入力します(オプション)。
    他のプロジェクトと共有

    ノート: このフィールドは、プロジェクトで接続を作成している場合にのみ表示されます。

    この接続を他のプロジェクトで公開する場合に選択します。 接続共有により、異なるプロジェクトで個別の接続を作成および維持する必要がなくなります。

    別のプロジェクトでアダプタ接続を構成すると、「接続」ページの上部に「共有接続の使用」フィールドが表示されます。 構成している接続が、パブリックに使用可能な接続と同じタイプおよびロールと一致する場合は、その接続を選択してそのリソースを参照(継承)できます。

    「プロジェクト間での接続の追加および共有」を参照してください。

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

    接続が作成されました。 これで、接続プロパティ、セキュリティ・ポリシーおよび(一部の接続に対して)アクセス・タイプを構成する準備ができました。

  5. ステップに従って接続を構成します。

    接続プロパティおよび接続セキュリティの値は、各アダプタに固有です。 接続には、プライベート・エンドポイントやエージェント・グループなどのアクセス・タイプを使用した構成が必要な場合もあります。

  6. 接続をテストします。

接続プロパティの構成

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

  1. 「プロパティ」セクションに移動します。
  2. 「接続タイプ」フィールドで、この統合で使用するURLタイプを選択します。 このフィールドは、invokeロールまたはtriggerおよびinvokeロールを持つ接続で使用できます。

    ノート:

    「Oracle CPQアダプタ」を統合のトリガー接続として使用する場合は、SOAP WSDL URLを指定する必要があります。 RESTのカタログURLを指定すると、統合でトリガーとして接続を追加するときにエラーが発生します。
    • SOAP WSDL URL
    • RESTカタログURL
  3. 「接続URL」フィールドで、この統合で使用するURLを指定します。 URLを取得するには、「接続を作成するための前提条件」を参照してください。

接続セキュリティの構成

セキュリティ・ポリシーとログイン資格証明を選択して、「Oracle CPQアダプタ」接続のセキュリティを構成します。

Oracle Fusion Applications CPQを使用している場合は、JWTユーザー・アサーション・セキュリティ・ポリシーを使用してのみOAuthに接続できます。 ビッグ・マシン(BM) CPQを使用している場合は、ユーザー名パスワード・トークンまたはJWTユーザー・アサーション・セキュリティ・ポリシーを使用してOAuthで接続できます。

  1. 「セキュリティ」セクションに移動します。
  2. 使用するセキュリティ・ポリシーを「セキュリティ・ポリシー」リストから選択します:
    • ユーザー名パスワード・トークン
    • JWTユーザー・アサーションを使用したOAuth
  3. ユーザー名パスワード・トークンを選択した場合:
    1. ログイン資格証明を入力します。 唯一の要件は、Oracle CPQでAPIアクセスを持つ必要があることです。 それを満たしている場合、構成されているユーザーの種類は問題ではありません。 ログイン資格証明を取得するには、「接続を作成するための前提条件」を参照してください。
  4. 「JWTユーザー・アサーションを使用したOAuth」を選択した場合:
    1. 次の詳細を入力します
      要素 説明
      アクセス・トークンURI アクセス・トークンを取得するリクエストを送信するURLを入力します。 たとえば: 
      https://accounts.google.com/o/oauth2/token
      JSON形式のJWTヘッダー JWT header.jsonファイルをアップロードします。 たとえば: 
      { 
    "kid": "externalClientAppVivek1",
    "typ": "JWT",
    "alg": "RS256"
}
      説明:
      • kid: Oracle Cloud Infrastructure Identity and Access Managementでクライアント・アプリケーションを作成するときにアップロードするパブリック証明書の別名。
      • typ: JWTのタイプ。
      • alg: 使用するアルゴリズム。

      OAuth「JWTユーザー・アサーション・セキュリティ・ポリシーの前提条件の使用」を参照してください。

      JSON形式のJWTペイロード JWT payload.jsonファイルをアップロードします。 たとえば: 
      {
  "sub": "joe.smith@mycompany.com",
  "aud": "https://identity.oraclecloud.com/",
  "iss": "1234adafghvdscscsdfe",
  "exp": 1740475177,
  "iat": 1739870304
}
      説明:
      • sub: Oracle CPQ APIにアクセスできるユーザー名。
      • aud: アイデンティティ・ドメイン・オーディエンスhttps://identity.oracle.com/。 署名アルゴリズムはRS256である必要があります。
      • iss: Oracle Cloud Infrastructure Identity and Access Managementで作成されたクライアント・アプリケーションのクライアントID。
      • exp: 有効期限。
      • iat: トークンの発行時間。

      OAuth「JWTユーザー・アサーション・セキュリティ・ポリシーの前提条件の使用」を参照してください。

      JWT秘密キー別名 JWT秘密キー別名を入力します。 これは、証明書ページで署名キー証明書をアップロードするときに指定した別名です。 「外部サービスに接続するための証明書のアップロード」を参照してください。
      スコープ (オプション)スコープを入力します。
      Oracle_CPQ_site_URL/api
      アクセス・トークン・リクエスト (オプション)アクセス・トークンを取得するリクエストを入力します。 指定する形式は、サービス・プロバイダによって異なります。

エンドポイント・アクセス・タイプの構成

エンドポイントへのアクセスを構成します。 構成しているアダプタの機能によっては、パブリック・インターネット、プライベート・エンドポイント、またはファイアウォールでホストされているオンプレミス・サービスへのアクセスの構成オプションが表示される場合があります。

エンドポイント・アクセス・タイプの選択

  1. 「アクセス・タイプ」セクションに移動します。
  2. エンドポイントにアクセスするためのオプションを選択します。
    オプション アダプタがサポートしている場合、このオプションが表示されます...
    パブリック・ゲートウェイ パブリック・インターネットを使用したエンドポイントへの接続。
    プライベート・エンドポイント プライベート仮想クラウド・ネットワーク(VCN)を使用したエンドポイントへの接続。

    ノート: プライベート・エンドポイントに接続するには、Oracle Cloudコンソールで前提条件タスクを完了する必要があります。 そうしないと、接続のテスト時にエラーが発生します。 「Oracle Integration 3のプロビジョニングと管理」の「プライベート・リソースへの接続」および「Oracle Integration 3での統合の使用」の「プライベート・エンドポイントのトラブルシューティング」を参照してください。

    ノート: Oracle CPQアダプタは、プライベート・エンドポイントとのRESTベースの接続のみをサポートします。

プライベート・エンドポイント構成が成功したことの確認

  • プライベート・エンドポイントに接続するには、Oracle Cloudコンソールで前提条件タスクを完了する必要があります。 そうしないと、接続のテスト時にエラーが発生します。 「Oracle Integration 3のプロビジョニングと管理」の「プライベート・リソースへの接続」を参照してください。
  • プライベート・ネットワークを使用してエンドポイントに接続するように接続ページでアダプタを構成する場合は、IPアドレスではなく、完全修飾ドメイン名(FQDN)を指定します。 IPアドレスを入力すると、「テスト」をクリックすると検証が失敗します。

接続のテスト

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

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

    WSDLを使用しない

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

    WSDLの使用

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

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

    • テスト: WSDL URLに接続し、WSDLに対して構文チェックを実行します。 WSDLで公開されている操作に送信されたリクエストはありません。

  2. 接続テストの結果に関するメッセージを待機します。
    • テストに成功した場合、接続は適切に構成されています。
    • テストが失敗した場合は、入力した構成詳細を編集します。 入力ミスを確認し、URLおよび資格証明を確認してください。 接続が成功するまでテストを続けます。
  3. 完了したら「保存」をクリックします。