Oracle® Fusion Middleware

Oracle Cloud Adapterのインストール後の構成ガイド

12.1.3

E67368-01(原本部品番号:E63651-01)

2015年5月

Oracle Fusion Middleware Oracle Cloudアダプタ・インストール後の構成ガイド12.1.3

E67368-01

Copyright (C) 2015, Oracle and/or its affiliates.All rights reserved.

原本著者: Mark Kennedy

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

このドキュメントはリリース前のものであり、デモおよび暫定使用のみを目的としています。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントの使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

このドキュメントの情報は、情報共有の目的のみに使用され、顧客諮問委員会の会員の立場で考慮されるか、ベータ・トライアル版契約のみに準じる必要があります。資料、規約または機能性を配信する義務はなく、購買決定に依存すべきではないものとします。このドキュメントに記載されている開発、リリース、およびすべての機能または機能性の時期は、オラクル社の独自の判断に従うものとします。

このドキュメントは、ソフトウェアまたは印刷物などの形式にかかわらず、オラクル社の独占的な財産である機密情報を含みます。この機密資料へのアクセスと使用は、オラクル社との間で締結され遵守に同意したOracle Master Agreement、Oracle License and Services Agreement、Oracle PartnerNetwork Agreement、オラクル販売契約、あるいはその他のライセンス契約の条件にしたがうものとします。オラクル社の文書による事前承諾なしに、このドキュメントおよびここに含まれる情報を開示、コピー、再生、またはオラクル社外部の他者に配布することはできません。このドキュメントは使用許諾契約の一部ではなく、オラクル社の子会社またはアフィリエイトとの契約上の合意に組み込まれません。

目次

タイトルおよび著作権情報
はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連リソース

- 表記規則

1 Oracle Cloud Adapter EARファイルのデプロイとCSF設定の構成

- Oracle WebLogic Server管理コンソールからのcloudsdk.earファイルのデプロイ

- 資格証明ストアにアクセスするための権限の付与

- Oracle Enterprise Manager Fusion Middleware ControlでのCSFマップの作成

- Oracle Enterprise Manager Fusion Middleware ControlでのEloqua Cloud Adapter用のCSFキーの作成

- Oracle Enterprise Manager Fusion Middleware Controlでのその他のクラウド・アダプタ用のCSFキーの作成

2 証明書とプロキシ設定の構成

- Oracle JDeveloperでのプロキシ・サーバーの設計時構成

- クライアント証明書のトラスト・ストア(DemoTrust.jks)へのインポート

- プロキシ・サーバーの実行時用の構成

3 インバウンドWSDL URLパターンの指定

- Oracle SOA SuiteおよびOracle Service BusのインバウンドWSDL URLパターンの指定

はじめに

トピック:

『Oracle Cloudアダプタ・インストール後の構成ガイド』には、パッチ・インストールの完了後にOracle Cloudアダプタを構成する方法が説明されています。

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連リソース

- 表記規則

対象読者

『Oracle Cloudアダプタ・インストール後の構成ガイド』は、パッチ・インストールの完了後にOracle Cloudアダプタを構成する必要があるユーザーを対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティへの取り組みについては、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)にアクセスしてください。

Oracleサポートへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info、聴覚に障害があるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連リソース

詳細は、次のOracleドキュメントを参照してください。

- Oracle RightNow Cloud Adapterの使用方法

- Oracle Sales Cloud Adapterの使用方法

- Oracle Eloqua Cloud Adapterの使用方法

- Oracle HCM Cloud Adapterの使用方法

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Oracle Cloud Adapter EARファイルのデプロイとCSF設定の構成

次のOracle Cloud Adapter EARファイルのデプロイと、CSFマップおよびCSFキーの構成タスクを実行します。

トピック

- Oracle WebLogic Server管理コンソールからのcloudsdk.earファイルのデプロイ

- 資格証明ストアにアクセスするための権限の付与

- Oracle Enterprise Manager Fusion Middleware ControlでのCSFマップの作成

- Oracle Enterprise Manager Fusion Middleware ControlでのEloqua Cloud Adapter用のCSFキーの作成

- Oracle Enterprise Manager Fusion Middleware Controlでのその他のクラウド・アダプタ用のCSFキーの作成

Oracle WebLogic Server管理コンソールからのcloudsdk.earファイルのデプロイ

cloudsdk.earファイルは、クラウド・アダプタ・パッチをインストールした後にデプロイする必要があります。

1. cloudsdk.earファイルを見つけます。アダプタ・パッチのインストール後は、Oracleホーム・ディレクトリ構造内にあります。

2. Oracle WebLogic Server管理コンソールにログインします。

3. 「ドメイン構造」の下で、「デプロイメント」を選択します。

4. 「インストール」をクリックし、デプロイするcloudsdk.earファイルを参照して、選択します。

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

6. 「次へ」をもう一度クリックして、ターゲット・サーバーを選択します。

7. 「終了」をクリックします。

8. サーバーを再起動します。

資格証明ストアにアクセスするための権限の付与

資格証明ストアにアクセスするための権限を付与する必要があります。このタスクは、任意のOracle Weblogic Serverドメインに対して、一度だけ実行する必要があります。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータで、「WebLogicドメイン」を開きます。

3. 変更するドメインを右クリックし、「セキュリティ」→「システム・ポリシー」を選択して「システム・ポリシー」ページを表示します。

4. 「検索」を展開します。

5. 「タイプ」で、「コードベース」を選択します。

6. 「名前に次を含む」に、jcaを入力して、「検索」ボタンをクリックします。

7. 表示された結果からjca-binding-api.jarを選択し、「編集」をクリックします。

8. 「システム権限の編集」ページで、「追加」をクリックします。

9. 「権限の追加」ページで、「新しい権限の詳細を入力するにはここを選択します」をクリックして、新しい権限に関する次の情報を入力します。

- 権限クラス: oracle.security.jps.service.credstore.CredentialAccessPermission

- リソース名: context=SYSTEM,mapName=oracle.wsm.security,keyName=*

- 権限アクション: *

10. 「OK」をクリックして新しいパーミッションを保存します。

Oracle Enterprise Manager Fusion Middleware ControlでのCSFマップの作成

実行時アプリケーションでアダプタを管理および監視するには、その前に、Oracle Enterprise Manager Fusion Middleware Controlで、CSFマップを作成し、CSFキーを構成する必要があります。SOAコンポジット・アプリケーションまたはOracle Service Busビジネス・サービスをデプロイするOracle Weblogic Serverドメインの資格証明ストアで、アダプタ構成ウィザードで設計時に指定したのと同じCSFキー構成の詳細を指定する必要があります。

1. Oracle Enterprise Manager Fusion Middleware Controlにログインします。

2. ナビゲータで、「WebLogicドメイン」フォルダを開きます。

3. デプロイメントに使用する管理対象サーバーを右クリックして、「セキュリティ」→「資格証明」と操作します。

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

5. oracle.wsm.securityと入力し、「OK」をクリックします。
これで、資格証明リストにマップが作成されます。

Oracle Enterprise Manager Fusion Middleware ControlでのEloqua Cloud Adapter用のCSFキーの作成

次の詳細を指定して、Oracle Enterprise Manager Fusion Middleware Controlで、Oracle Eloqua Cloudアダプタ用のCSFキーを作成します。

1. 「Oracle Enterprise Manager Fusion Middleware ControlでのCSFマップの構成」の手順に従って、「資格証明ストア」ページにアクセスします。

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

3. 次の詳細を入力し、「OK」をクリックします。入力する値は、Oracle JDeveloperのアダプタ構成ウィザードでのCSF認証キーの作成時に入力したものと同じである必要があります。

フィールド

説明

マップの選択

oracle.wsm.securityを選択します。

キー

キー値(たとえば、eloqua-key)を入力します。

型

「汎用」を選択します。Oracle Eloqua Cloudアダプタは、companyという名前の追加のプロパティを必要とします。ダイアログがリフレッシュされ、特定のプロパティ名と値を作成するよう求めてきます。

a. 説明を入力します(オプション)。

b. 「プロパティ名と値のペアのマップを入力」をクリックします。

c. 「行の追加」をクリックして、初期プロパティ名と値の行を追加します。

d. 「プロパティ名」列に、usernameを入力します。

e. 「値」と「値の確認」列に、usernameの値を指定します。

f. 前述の手順を繰り返して、companyとpasswordの行に入力します。完了すると、Oracle Eloqua Cloudアダプタの場合、ダイアログは次のようになります:

g. 「OK」をクリックします。

Oracle Enterprise Manager Fusion Middleware Controlでのその他のクラウド・アダプタ用のCSFキーの作成

次の詳細を指定して、Oracle Enterprise Manager Fusion Middleware Controlで、Oracle Sales Cloud、Oracle RightNow Cloud、Oracle HCM CloudおよびSalesforce Cloudの各アダプタ用のCSFキーを作成します。

1. 「Oracle Enterprise Manager Fusion Middleware ControlでのCSFマップの作成」の手順に従って、「資格証明ストア」ページにアクセスします。

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

3. 次の詳細を入力し、「OK」をクリックします。入力する値は、Oracle JDeveloperのアダプタ構成ウィザードでのCSF認証キーの作成時に入力したものと同じである必要があります。

フィールド

説明

マップの選択

oracle.wsm.securityを選択します。

キー

キー値を入力します(たとえば、Oracle RightNow Cloudアダプタを構成する場合、rightnow-key)。

型

「パスワード」を選択します。

ユーザー名

ユーザー名を入力します。

パスワード

パスワードを入力します。

パスワードの確認

同じパスワードをもう一度入力します。

説明

オプションで、一意の説明も入力します。

作成されたキーは、資格証明リストのマップ名(oracle.wsm.security)の下に表示されます。

2 証明書とプロキシ設定の構成

次のOracle Cloud Adapter証明書およびプロキシ設定のタスクを実行します。

トピック

- Oracle JDeveloperでのプロキシ・サーバーの設計時構成

- クライアント証明書のトラスト・ストアへのインポート

- プロキシ・サーバーの実行時用の構成

Oracle JDeveloperでのプロキシ・サーバーの設計時構成

Oracle JDeveloperでプロキシ・サーバーを構成します。

1. Oracle JDeveloperで、「ツール」→「設定」→「Webブラウザとプロキシ」の順に選択します。

2. 「Webブラウザとプロキシ」の「プロキシ設定」タブを選択します。

3. 「手動プロキシ設定」で、次の設定を構成します。

- 「ホスト」をwww-proxy.us.company_name.comと設定します。

- 「プロキシ使用なし」をlocalhost|*.us.company_name.com|127.0.0.1|10.*.*.*|*.foo.com|etcと設定します 。
ここで、company_nameは貴社名です。

4. 「プロキシのテスト」をクリックして、プロキシをテストします。

5. 「OK」をクリックして終了します。

クライアント証明書のトラスト・ストア(DemoTrust.jks)へのインポート

アプリケーションWSDLが認証局(CA)で認定されている場合、次のようにして、FMW_HOME/user_projects/domains/WLS_SOA/bin/setDomainEnv.shを更新する必要があります。

1. FMW_HOME/user_projects/domains/WLS_SOA/bin/setDomainEnv.shを開きます。

2. EXTRA_JAVA_PROPERTIESで:

次の文字列を

- -Djavax.net.ssl.trustStore=%WL_HOME%\server\lib\DemoTrust.jks

次に置換します。

- -Djavax.net.ssl.trustStore=kss://system/trust -Djavax.net.ssl.trustStoreType=kss

プロキシ・サーバーの実行時用の構成

プロキシ・サーバーを実行時に使用するために構成する必要があります。

1. FMW_HOME/user_projects/domains/WLS_SOA/bin/setDomainEnv.shを開きます。

2. EXTRA_JAVA_PROPERTIESに次の行を追加します。
-Dhttp.proxyHost=www-proxy.us.company_name.com -Dhttp.proxyPort=80 -Dhttp.nonProxyHosts=localhost|*.us.company_name.com|127.0.0.1|10.*.*.*|*.foo.com|etc -Dhttps.proxyHost=www-proxy.us.company_name.com -Dhttps.proxyPort=80"
ここで、company_nameは貴社名です。

3 インバウンドWSDL URLパターンの指定

Oracle SOA SuiteとOracle Service BusのインバウンドWSDL URLは、この項で説明する規則に準拠する必要があります。

トピック

- Oracle SOA SuiteおよびOracle Service BusのインバウンドWSDL URLパターンの指定

Oracle SOA SuiteおよびOracle Service BusのインバウンドWSDL URLパターンの指定

Oracle Sales Cloud、Oracle RightNow CloudおよびOracle HCM Cloudアダプタに、Oracle SOA SuiteおよびOracle Service BusのインバウンドWSDL URLを指定する場合、次の規則を使用します。

パターン

URL形式

例

Oracle SOA Suite

https://hostname:ssl_port/integration/flowsvc/adapter/partition_name/composite_name/service_name/version?wsdl

ここで、adapterは:

- rightnow

- hcm

- osc

https://abc123.us.company.com:20117/integration/flowsvc/rightnow/default/RNOW-OSC-SYNC/RightnowService/v1.0/?wsdl

Oracle Service Bus

https://hostname:ssl_port/integration/flowsvc/adapter/application_name/proxy_name?wsdl

ここで、adapterは:

- rightnow

- hcm

- osc

https://abc123.us.company.com:7002/integration/flowsvc/hcm/HCM-HCM/HcmService/?wsdl

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。