Oracle® Fusion Middleware

Oracle API Catalog管理者ガイド

12cリリース1 (12.1.3.0)

E59448-03(原本部品番号:E55977-03)

2015年10月

Oracle API Catalogのインフラストラクチャ、ライフサイクル、セキュリティ管理タスクについて説明する、管理者向けのドキュメントです。

Oracle Fusion Middleware Oracle API Catalog管理者ガイド, 12c リリース1 (12.1.3.0)

E59448-03

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

原本著者: Oracle Corporation

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

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

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

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社およびその関連会社は一切の責任を負いかねます。

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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

第I部 Oracle API Catalogの基本的な管理の概要

1 Oracle API Catalogの管理タスクの概要

- 1.1 インフラストラクチャ管理タスクの概要

- 1.2 アセットのライフサイクル管理タスクの概要

- 1.3 セキュリティ管理タスクの概要

第II部 インフラストラクチャの管理

2 基本構成

- 2.1 概要

- 2.2 部署

- 2.2.1 新規部署の作成

- 2.2.2 部署情報の編集

- 2.2.3 部署の削除

- 2.3 ロール

- 2.4 ユーザー

- 2.4.1 新しいユーザーの作成

- 2.4.2 ユーザー情報の表示

- 2.4.3 ユーザーの検索

- 2.4.4 ユーザー情報の編集

- 2.4.5 ユーザーの削除

- 2.5 セッション

- 2.5.1 セッションの表示

- 2.5.2 単一セッションの削除

- 2.5.3 複数セッションの削除

- 2.6 Oracle API Catalogの診断ページへのアクセス

- 2.7 Java Web Startのインストール

- 2.7.1 Java Web Startのダウンロードとインストール

- 2.7.2 Java Web Startのトラブルシューティング

- 2.7.3 Linux上でのJava Web Startの構成

3 システム設定の概要

- 3.1 システム設定へのアクセス

- 3.2 システム設定の検索

- 3.3 設定のデータベースへの移動

- 3.4 Oracle API Catalogのシステム設定

- 3.4.1 機能設定

- 3.4.1.1 検索

- 3.4.1.2 PDF経由でのアセット詳細の印刷

- 3.4.2 サーバー設定

- 3.4.2.1 一般

- 3.4.3 エンタープライズ認証設定

- 3.4.3.1 一般

- 3.4.3.2 プラグイン・ログイン設定

- 3.4.3.3 LDAPおよびActive Directoryの設定

- 3.4.3.4 コンテナ・ログイン設定

- 3.4.4 インポート/エクスポートおよびイントロスペクション設定

- 3.4.4.1 インポート/エクスポート

4 インポート・エクスポート・ツール

- 4.1 概要

- 4.2 インポート/エクスポート・ツールの使用

- 4.2.1 概要

- 4.2.2 parameter.propertiesファイル

- 4.2.2.1 parameter.propertiesファイルのサポート対象パラメータ

- 4.2.2.2 parameter.propertiesサンプル・ファイル

- 4.3 インポート/エクスポート・ツールの起動

- 4.3.1 Oracle API Catalogからの起動

- 4.3.2 Oracle API Catalogの外部からの起動

- 4.3.3 初期起動

- 4.4 Oracle API Catalogからの項目のエクスポート

- 4.5 Oracle API Catalogへの項目のインポート

第III部 アセット・ライフサイクルの管理

5 自動収集の構成および使用

- 5.1 ハーベスタのスタートガイド

- 5.1.1 前提条件

- 5.1.2 ハーベスタの機能

- 5.1.3 アーティファクト/製品とバージョンのマトリックス

- 5.2 ハーベスタの構成

- 5.2.1 ハーベスタの入手

- 5.2.2 コマンド行でのハーベスタの構成

- 5.2.2.1 コマンド行でのリポジトリ接続情報の設定

- 5.2.2.2 コマンド行での収集用にアーティファクトを選択する

- 5.2.3 Repository.Submit Antタスクを使用したハーベスタの起動

- 5.2.3.1 repository.Submit Antタスクのパラメータを指定する

- 5.2.3.2 ネストされた要素としてのパラメータの指定

- 5.2.3.3 Antからのハーベスタの実行

- 5.2.3.4 サード・パーティ・タスクの使用

- 5.2.4 WLSTからのハーベスタの起動

- 5.2.5 ランタイム収集の詳細

- 5.2.5.1 Oracle SOA Suiteサーバーから収集する

- 5.2.5.2 WebLogicサーバーからWebサービスを収集する

- 5.2.5.3 Oracle Service BusからWebサービスを収集する

- 5.2.5.4 デプロイ済サービスの収集

- 5.2.6 オプションのハーベスタ構成の実行

- 5.2.7 ハーベスタのためのロギングの構成

- 5.2.8 ハーベスタ内のトランザクション処理

- 5.3 ハーベスタの追加情報の理解

- 5.3.1 ハーベスタで作成されたアセットのプレビュー

- 5.3.2 ベスト・プラクティス

- 5.3.2.1 推奨される収集の権限

- 5.3.2.2 ネームスペースのパラメータをオーバーライドしない

- 5.3.2.3 WSDLファイル内のネームスペース

- 5.3.3 既知の問題

- 5.3.3.1 サポートされているリモート・サーバーのタイプ

- 5.3.3.2 アセットのバージョニング

- 5.3.3.3 不正な暗号化パスワードの使用

- 5.3.3.4 リポジトリ・オプションでの表示

6 Oracle API CatalogでのAPIアセットのメタデータの編集

- 6.1 APIアセットのメタデータの編集

- 6.2 APIアセットの公開

- 6.3 EasyLinkの使用

- 6.4 アセットの削除

第IV部 Oracle API Catalogの保護

7 外部の認証ツールを使用するOracle API Catalogの構成

- 7.1 概要

- 7.1.1 LDAP/Active Directory

- 7.1.2 LDAP統合システム・プロパティの有効化

- 7.1.3 LDAP/Active Directoryのプロパティの変更

- 7.1.4 セキュリティに関する考慮事項

- 7.1.4.1 ユース・ケースのサンプル・シナリオ

- 7.1.5 LDAPプロパティの例

8 パスワードの暗号化

- 8.1 暗号化パスワードの生成

- 8.1.1 Oracle API Catalogのデプロイで使用される暗号化パスワード

- 8.1.2 その他のパスワード

- 8.2 構成ファイルのパスワードの暗号化

- 8.2.1 ハーベスタの構成ファイル

索引

はじめに

『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』は、Oracle API Catalogの3種類の管理タスクである、インフラストラクチャ管理、アセットのライフサイクル管理およびセキュリティ管理を完了するために必要な情報を提供します。

対象読者

このドキュメントは、Oracle API Catalogのインストールの管理、またはAPIアセットのライフサイクル・プロセスをキュレートしている個人を対象としています。

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

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracle Supportへのアクセス

サポートをご購入の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 API Catalog 12cドキュメンテーション・セットの次のドキュメントを参照してください。

- Oracle Fusion Middleware Oracle API Catalogコンセプト・ガイド

- Oracle Fusion Middleware Oracle API Catalogインストレーション・ガイド

- Oracle Fusion Middleware Oracle API Catalog開発者ガイド

表記規則

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

規則

意味

太字

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

イタリック体

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

モノスペース

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

第I部

Oracle API Catalogの基本的な管理の概要

この部では、Oracle API Catalogの管理についての入門的な情報を説明します。

この部は、次の章で構成されています。

- 第1章「Oracle API Catalogの管理タスクの概要」

1 Oracle API Catalogの管理タスクの概要

この章では、Oracle API Catalogの管理タスクの種類について説明します。

Oracle API Catalogの管理は次の3つの領域に分類されます: カタログのインフラストラクチャの設定とメンテナンス、アセットのライフサイクルの管理、およびセキュリティの管理です。

この章では次の項について説明します。

- 1.1項「インフラストラクチャ管理タスクの概要」

- 1.2項「アセットのライフサイクル管理タスクの概要」

- 1.3項「セキュリティ管理タスクの概要」

1.1 インフラストラクチャ管理タスクの概要

リポジトリのインフラストラクチャのメンテナンスには、製品の設定、およびユーザー認証、部署、システム設定といった領域の構成が含まれます。通常、これらのタスクは、APIの移入の前、OACの初期設定の間に実行され、必要に応じて定期的に更新されます。

OACではオプションですが、最初のタスクは部署の設定です。部署は、ユーザーを組織的にグループ化するために使用できます。それは、組織内の部署やグループを反映でき、OACへのアクセスを必要とするパートナまたはその他のサード・パーティを表すこともできます。OACには、あらかじめ「デフォルトの部署」という名前の部署が1つ含まれています。ユーザーを必ず部署に割り当てる必要はありません。部署の作成はオプションです。

部署の設定の詳細は、2.2項「部署」を参照してください。

ユーザーがOACにアクセスできるようにするための次のタスクはユーザー認証の設定です。ユーザーを設定するプロセスの中で、OACに含まれている3つのロールのうちのいずれか1つがユーザーに割り当てられ、このロールによりユーザーがアクセスできるOACの機能が決定します。OACで使用可能なロールの詳細は、『Oracle Fusion Middleware Oracle API Catalogコンセプト・ガイド』のOracle API Catalogのユーザー・ロールの理解に関する項を参照してください。

ユーザーを作成するための次の2つのオプションがあります。

- 既存のLDAP実装と統合します。外部の認証方式を使用するOACの構成の詳細は、第7章「外部の認証ツールを使用するOracle API Catalogの構成」を参照してください。

- OACでユーザーを作成するには、管理機能を使用します。ユーザーの作成の詳細は、2.4.1項「新規ユーザーの作成」を参照してください。

デプロイメントで必要とする場合は、オプションとして、第I部「インフラストラクチャの管理」のその他の管理タスクを実行できます。

これらのタスクが完了した後、1.2項「アセットのライフサイクル管理タスクの概要」で説明されているタスクを完了する必要があります。

1.2 アセットのライフサイクル管理タスクの概要

アセットのライフサイクル管理は、Oracle API Catalog内のアセットの作成、メンテナンスおよび使用を中心に説明します。

アセットのライフサイクルにおける最初の作業は、APIをOACに収集することです。キュレータは、ハーベスタを使用してSOA SuiteおよびService Bus、または他のデプロイ済サービスからAPIアセットをOACに移入します。ハーベスタはコマンド行から実行するか、または、ビルド・プロセスに統合してビルド時に自動的に収集を実行できます。ハーベスタにより、OACを検索する開発者に検出されない「ドラフト」状態でAPIアセットが作成されます。APIの収集の詳細は、第5章「自動収集の構成と使用」を参照してください。

収集後、キュレータは簡易なエディタを使用してAPIアセットを編集します。APIの検出と理解を容易にするため、更新された名前、完全でわかりやすい説明、キーワードおよびドキュメントへの参照などのメタデータをAPIに追加する必要があります。APIのメタデータ編集の詳細は、6.1項「APIアセットのメタデータの編集」を参照してください。

APIのメタデータの編集が完了した後、キュレータは、開発者がOACでそれを検出できるように、APIを公開します。APIアセットの公開の詳細は、6.2項「APIアセットの公開」を参照してください。

公開されたAPIは、開発者が検出できるようにJDeveloperおよびOACコンソールに表示されます。開発者は、使用するAPIを見つけるためにOACを検索したり、APIの詳細を理解するためにAPIのメタデータを調べることができ、個人的な「マイAPI」リストを追加して、そのAPIについての評価やレビューを提供できます。開発者ロールを持つユーザーがOACを使用する方法の詳細は、『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』を参照してください。

最後にAPIは、キュレータによってポップアップのAPIエディタを使用して「リタイア」されます。APIがリタイアした後は、OACを検索しても開発者には見えなくなります。APIは、6.1項「APIアセットのメタデータの編集」の説明に従って、「アクティブ・ステータス」リストから「リタイア」を選択することでリタイアされます。

1.3 セキュリティ管理タスクの概要

Oracle API Catalogのセキュリティ管理では、主として、認証と認可を使用してのコンテンツへのアクセス制御を中心に説明します。

OACでは、認証に次の2つの方法が使用されます。

- OACを組織のLDAPサーバーと統合します。詳細は、第7章「外部の認証ツールを使用するOracle API Catalogの構成」を参照してください。

- 組織は、OAC内に直接ユーザーを作成することもできます。ユーザーの作成については、2.4.1項「新規ユーザーの作成」を参照してください。

ユーザーには、OACの事前定義済のロールである、管理者、キュレータまたは開発者のうちのいずれか1つが割り当てられます。このロールにより、そのユーザーがOACのどの機能の使用を許可されているかが決定します。OACで使用可能なロールの詳細は、『Oracle Fusion Middleware Oracle API Catalogコンセプト・ガイド』のOracle API Catalogのユーザー・ロールの理解に関する項を参照してください。

第II部

インフラストラクチャの管理

この部では、Oracle API Catalogのインフラストラクチャの基本的な管理タスクについて説明します。

この部は、次の章で構成されています。

- 第2章「基本構成」

- 第3章「システム設定の概要」

- 第4章「インポート・エクスポート・ツール」

2 基本構成

この章では、Oracle API Catalog管理者にとっての専門用語および一般的なタスクを紹介し、Oracle API Catalogの構成方法の基本を説明します。

この章には、次のセクションがあります。

- 2.1項「概要」

- 2.2項「部署」

- 2.3項「ロール」

- 2.4項「ユーザー」

- 2.5項「セッション」

- 2.6項「Oracle API Catalogの診断ページへのアクセス」

- 2.7項「Java Web Startのインストール」

2.1 概要

Oracle Enterprise Repositoryでは、すべてのユーザーにロールが割り当てられます。ロールは、各ユーザーが使用できるOracle Enterprise Repositoryの機能を定義します。ユーザーは部署に割り当てられます。組織は、特定の部署における再利用可能なアセットの生産および消費を追跡でき、レポートの作成に便利です。

2.2 部署

ユーザーやプロジェクトを作成する前に、部署の設定または作成が必要です。この項には次のトピックが含まれます:

- 2.2.1項「新規部署の作成」

- 2.2.2項「部署情報の編集」

- 2.2.3項「部署の削除」

2.2.1 新規部署の作成

新規部署を作成するには、Oracle API Catalogの「管理」画面から次の手順を実行します。

1. 左側のパネルで、「部署」をクリックします。

2. 図2-1に示すように、新規部署の作成アイコンをクリックします。

図2-1 新規部署の作成アイコン

3. 「名前」および「説明」フィールドに適切な情報を入力します。

4. 終了したら、「保存」をクリックします。

2.2.2 部署情報の編集

部署情報を編集するには、Oracle API Catalogの「管理」画面から次の手順を実行します。

1. 左側のパネルで、「部署」をクリックします。

2. 右側のパネルのリストから編集する部署を選択します。部署の詳細ページが表示されます。

3. 「編集」アイコンをクリックします。部署の編集ダイアログが表示されます。

4. 必要に応じて、「名前」および「説明」フィールドを更新します。

5. 終了したら、「保存」をクリックします。

2.2.3 部署の削除

Oracle API Catalogで部署を削除するには、Oracle API Catalogの「管理」画面から次の手順を実行します。

1. 左側のパネルで、「部署」をクリックします。

2. 部署を削除するには:

- 「検索結果」画面から部署を削除するには、削除する各部署の横のチェック・ボックスを選択し、「削除」をクリックします。この方法を使用して、一度に複数の部署を削除できます。

- 詳細ページから部署を削除するには、削除する部署の詳細ページを開き、「削除」をクリックします。

2.3 ロール

Oracle Enterprise Repositoryのアクセス設定は各ロールに対して設定され、各ユーザーは組織内における各自の役割に基づいて特定のロールが割り当てられます。

Oracle Enterprise Repositoryでロールの追加、編集または削除はできません。ユーザーに割り当てることができるのは、デフォルトのロールのみです。デフォルトのロールについては、『Oracle Fusion Middleware Oracle Enterprise Repositoryコンセプト・ガイド』のロール・ベースの機能に関する項を参照してください。

ロールはユーザーごとに変更できます。ユーザーのロール編集の詳細は、2.4.4項「ユーザー情報の編集」を参照してください。

2.4 ユーザー

この節では、以下のトピックについて説明します。

- 2.4.1項「新しいユーザーの作成」

- 2.4.2項「ユーザー情報の表示」

- 2.4.3項「ユーザーの検索」

- 2.4.4項「ユーザー情報の編集」

- 2.4.5項「ユーザーの削除」

2.4.1 新規ユーザーの作成

新規ユーザーを作成するには、Oracle API Catalogの「管理」画面から次の手順を実行します。

1. 左側のパネルで、「ユーザー」をクリックします。

2. 図2-2に示すように、新規ユーザーの作成アイコンをクリックします。「新規ユーザーの作成」ページが表示されます。

図2-2 新規ユーザーの作成アイコン

3. 図2-3に示すように、「概要」セクションの各テキスト・フィールドに適切な情報を入力します。

注意:
アスタリスクで示されている必須の各フィールドに値を指定していることを確認してください。

図2-3 「概要」セクション

4. 「ステータス」リストから「アクティブ」を選択します。

5. 「ロール」セクションで、矢印ボタンを使用して「使用可能なロール」列から「選択したロール」列に項目を移動し、新規ユーザーにロールを割り当てます。

6. 「部署」セクションで、矢印ボタンを使用して使用可能な部署列から選択した部署列に項目を移動し、新規ユーザーに部署を割り当てます。

7. 終了したら、「保存」をクリックします。

2.4.2 ユーザー情報の表示

ユーザー情報を表示するには、Oracle API Catalogの「管理」画面から次の手順を実行します。

1. 左側のパネルで、「ユーザー」をクリックします。

2. 「検索」を使用して、表示するユーザーを検索します。

3. リストからユーザーを選択します。新規タブにユーザーの情報が表示されます。

2.4.3 ユーザーの検索

この手順は、Oracle API Catalogの「管理」画面で実行します。

1. 左側のパネルで、「ユーザー」をクリックします。

2. 名前フィールドに適切な情報を入力します。

3. 必要に応じて、「部署」、「ロール」および「ステータス」のリストを使用して検索範囲を絞り込みます。

4. 「検索」ボタンをクリックします。検索結果がメイン・ペインのリストに表示されます。

2.4.4 ユーザー情報の編集

この手順は、Oracle API Catalogの「管理」画面で実行します。

1. 左側のパネルで、「ユーザー」をクリックします。

2. 「検索」を使用して、編集するユーザーを検索します。ユーザーのリストがメイン・ペインに表示されます。

3. リストからユーザーを選択します。新規タブにユーザーの情報が表示されます。

4. 「編集」アイコンをクリックします。「ユーザーの編集」ダイアログが表示されます。

5. 必要に応じて、「概要」、「ロール」および「部署」セクションで変更を実行します。

6. 終了したら、「保存」をクリックします。

2.4.5 ユーザーの削除

Oracle API Catalogでユーザーを削除するには、Oracle API Catalogの「管理」画面から次の手順を実行します。

1. 左側のパネルで、「ユーザー」をクリックします。

2. 「検索」を使用して、削除するユーザーを検索します。ユーザーのリストがメイン・ペインに表示されます。

3. ユーザーを削除するには:

- 「検索結果」画面からユーザーを削除するには、削除する各ユーザーの横のチェック・ボックスを選択し、「削除」をクリックします。この方法を使用して、一度に複数のユーザーを削除できます。

- 詳細ページからユーザーを削除するには、削除するユーザーの詳細ページを開き、「削除」をクリックします。

2.5 セッション

管理者は、セッションによりOracle API Catalogにログインしてしているユーザーを確認でき、必要に応じてユーザーのセッションを停止できます。

- 2.5.1項「セッションの表示」

- 2.5.2項「単一セッションの削除」

- 2.5.3項「複数セッションの削除」

2.5.1 セッションの表示

この手順は、Oracle API Catalogの「管理」画面で実行します。

1. 左側のパネルで、「セッション」をクリックします。セッションのリストがメイン・ペインに表示されます。

2.5.2 単一セッションの削除

1. メイン・ペインのリストから削除するセッションを選択します。新しいタブでセッションの詳細が開きます。

2. セッションの詳細で、「削除」ボタンをクリックします。確認ダイアログが表示されます。

3. 「OK」をクリックします。セッションが削除されます。

2.5.3 複数セッションの削除

1. メイン・ペインのセッションのリストで、削除する各セッションを選択します。

ヒント:
リストされたセッションのすべてを選択するには、列の一番上にあるチェック・ボックスを選択します。

2. 表のヘッダーで、「削除」ボタンをクリックします。確認ダイアログが表示されます。

3. 「OK」をクリックします。セッションが削除されます。

2.6 Oracle API Catalogの診断ページへのアクセス

Oracle API Catalogのデフォルトでは、「診断」ページは無効化されています。http://host_name:port/application_name/diag/index.jspに移動します(host_nameは適切な場所に置き換えます)。

「診断」ページをデフォルト・モードで開くと、次のメッセージが表示されます。

現在、診断ページは無効化されています。Oracle API Catalogの管理者に問い合わせてください。

「診断」ページを有効にするには、次の手順を実行します。

1. ORACLE_HOME/user_projects/domains/DOMAIN_NAME/bin/に移動します。

2. Oracle API Catalogサーバーを起動する前に、setStartupEnv.shまたはsetStartupEnv.cmdを編集します。

3. ファイル内のEXTRA_JAVA_PROPERITES="${EXTRA_JAVA_PROPERTIES}行に、-DdiagPagesEnabled=trueを追加します。

4. Oracle API Catalogサーバーを再起動します。

必要なときのみ有効にし、システムが問題なく稼働するようになったら無効にすることをお薦めします。

2.7 Java Web Startのインストール

Java Web Startは、拡張子がJNLPのファイルを実行するブラウザ・プラグインです。Oracle API Catalogのインポート/エクスポート・ユーティリティを使用するため、クライアント上でJava Web Startが使用可能である必要があります。

- 2.7.1項「Java Web Startのダウンロードとインストール」

- 2.7.2項「Java Web Startのトラブルシューティング」

- 2.7.3項「Linux上でのJava Web Startの構成」

2.7.1 Java Web Startのダウンロードとインストール

Java Web Startは、JDKの最新バージョンに含まれています。

このドキュメントが公開された時点では、Oracle Fusion Middleware製品にはJDK 7.0 Update 55以降が必要です。ただし、動作保証情報を確認して、必要なJDKのバージョンを常に確認してください。必要なJDKをダウンロードするには、ブラウザで次のURLに移動し、Java SE JDKをダウンロードします。

http://www.oracle.com/technetwork/java/javase/downloads/index.html

2.7.2 Java Web Startのトラブルシューティング

ブラウザで不明な拡張子を持つファイルが検出された場合、通常、アプリケーションの最初に、開くかまたは保存するように要求されます。JNLPファイル・タイプのこのアクションを実行するには、「Open」オプションを選択し、$JAVA_HOME/jre/bin/javawsファイルを参照して、適切なオプションを選択します。新しいJREを必要とする場合は、2.7.1項「Java Web Startのダウンロードとインストール」の指示に従い、最新のJREをダウンロードします。

2.7.3 Linux上でのJava Web Startの構成

Linuxオペレーティング・システムでは、使用する前にJava WebStartの構成が必要です。

Java WebStartを構成する手順は、次のとおりです。

注意:
Linuxの場合、ブラウザにはいくつかのオプションのみが用意されており、LinuxインストールのデフォルトのブラウザはMozilla Firefoxです。

1. Mozilla Firefoxを閉じます。

2. コンピュータ上でmozillaディレクトリ(例: /usr/lib/mozilla-1.4または/home/<user>/.mozilla)を探します。

3. コマンド・プロンプトを開き、次のコマンドを使用してコンピュータ上のmozillaディレクトリに移動します。

cd home/<user>/.mozilla

4. pluginsディレクトリが存在しない場合は、次のコマンドを使用して作成します。

mkdir plugins

5. 次のように、Mozillaインストール・ディレクトリの下のpluginsサブディレクトリに移動します。

cd plugins

6. 現在のディレクトリで、Java ns7/libjavaplugin_oji.soファイル・タイプへのシンボリック・リンクを作成します。
ln -s /oracle/soa/mwhome_gov/jdk7/jre/plugin/i386/ns7/libjavaplugin_oji.so

7. Mozilla Firefoxを開き、次のリンクをテストします。
http://www.java.com/en/download/help/testvm.xml

8. Mozilla Firefoxで、「Edit」メニューをクリックし、「Preferences」を選択します。「Preferences」ダイアログが表示されます。

9. 「Applications」をクリックします。「Application」ページが表示されます。

10. 「Search」フィールドに、「JNLP」と入力します。JNLPが表示されます。

11. 表示されたJNLPを選択します。「Action」リストがアクティブになります。

12. 「Action」リストをクリックして、インストールされている正しいjavaws(例: WLS JDKとともにインストールされたものなど)を指すようにします。

注意:
ただし、64ビットのLinuxでは、WLSにはJRockitのみが付属しています。プラグインにアクセスするには、64ビットのJDKを手動でダウンロードする必要があります。

注意:
Java Web Startアプリケーションは、アプリケーションをローカルに保存して実行することもでき、その場合は、<JAVA_HOME>/jre/binにあるjavaws実行可能ファイルを使用します。次に例を示します。

<JAVA_HOME>/jre/bin/javaws -verbose /path_to_file/impexp.jnlp

3 システム設定の概要

この章では、管理者が基本的な操作および特定の機能の構成に使用するOracle API Catalogのシステム設定について説明します。

この章には、次のセクションがあります。

- 3.1項「システム設定へのアクセス」

- 3.2項「システム設定の検索」

- 3.3項「設定のデータベースへの移動」

- 3.4項「Oracle API Catalogのシステム設定」

3.1 システム設定へのアクセス

システム設定にアクセスするには、次の手順を実行します。

1. 「管理」ボタンをクリックし、Oracle API Catalogの「管理」ページを開きます。

2. 「管理」ページのサイドバーにある「システム設定」をクリックします。
「システム設定」画面が表示されます。システム設定は、複数のカテゴリに編成されています。各カテゴリは、さらに機能グループに分割されています。

3. プラスのアイコンをクリックし、任意のカテゴリまたは機能グループの表示を拡張します。

4. マイナスのアイコンをクリックし、表示を縮小します。

3.2 システム設定の検索

特定の機能のためのシステム設定は、「システム設定」の「検索」を使用して検索できます。

1. 「検索」フィールドに検索語を入力します。関連するカテゴリのセクションが拡張し、関連するシステム設定が表示されます。

2. 「取消」をクリックし、検索結果をクリアします。

3.3 設定のデータベースへの移動

注意:
このオプションを実行すると、プロパティ・ファイルに格納されているすべてのシステム設定がデータベースに移動します。このアクションは、元に戻すことはできません。

設定をデータベースに移動するをクリックします。すべてのシステム設定がデータベースに保存されます。これは、クラスタ環境のためのものです。これにより、クラスタ環境内のすべてのサーバーがシステム設定の1つのソースを持つことになります。

3.4 Oracle API Catalogのシステム設定

この項では、Oracle API Catalogで使用可能なすべてのシステム設定について説明します。

この項には次のトピックが含まれます:

- 3.4.1項「機能設定」

- 3.4.2項「サーバー設定」

- 3.4.3項「エンタープライズ認証設定」

- 3.4.4項「インポート/エクスポートおよびイントロスペクション設定」

3.4.1 機能設定

この項には次のトピックが含まれます:

- 3.4.1.1項「検索」

- 3.4.1.2項「PDF経由でのアセット詳細の印刷」

3.4.1.1 検索

プロパティ

- アセット検索結果の最大数

- cmee.search.assets.maxresults

- テキスト・ボックスに入力された数値により、検索によって戻されるアセットの最大数が決まります。0を入力すると、無制限に戻されます。

- 特定のフィールドを検索

- cmee.search.specific.field

- TrueとFalseのオプションにより、標準の検索時に「キーワード」テキスト・ボックス内の検索対象フィールドを識別して、特定のフィールドを検索する機能を切り替えます。

3.4.1.2 PDF経由でのアセット詳細の印刷

プロパティ

- アセット・タイプにデフォルトのXSLTを使用

- cmee.asset.pdf.xslt.default

- TrueとFalseのオプションにより、PDFにアセットをエクスポートするとき、デフォルトのアセット・タイプを使用することを指定します。それが存在しない場合は、エラーが表示されます。

- PDFアセットのエクスポート先

- cmee.asset.xml.paths.export-destination

- テキスト・ボックスに入力したテキストにより、PDFアセットのエクスポート先が識別されます。

- PDFアセットのエクスポート先URL

- cmee.asset.xml.paths.export-destination-url

- テキスト・ボックスに入力したテキストにより、PDFアセットのエクスポート先URLが識別されます。

- PDFアセットのXSLディレクトリ

- cmee.asset.xml.paths.xsl-source

- テキスト・ボックスに入力したテキストにより、PDFアセットのXSLディレクトリが識別されます。

- PDFアセットの生成されたPDFの宛先

- cmee.asset.xml.paths.out-destination

- テキスト・ボックスに入力したテキストにより、PDFアセットの生成されたPDFの宛先が識別されます。

- PDFアセットの生成されたPDFの宛先URL

- cmee.asset.xml.paths.out-destination-url

- テキスト・ボックスに入力したテキストにより、PDFアセットの生成されたPDFの宛先URLが識別されます。

- PDFアセットのエクスポートWebApp URL

- cmee.asset.xml.paths.webapp-url

- テキスト・ボックスに入力したテキストにより、PDFアセットのエクスポートWebApp URLが識別されます。

3.4.2 サーバー設定

この項には次のトピックが含まれます:

- 3.4.2.1項「一般」

3.4.2.1 一般

- アセット・エディタは、アセットの説明に埋め込まれたHTMLを有効にします。

- cmee.asseteditor.enable-embedded-html-asset-description

- Trueにすると、APIの説明に埋込みHTMLを入力できるようになります。

3.4.3 エンタープライズ認証設定

この項には次のトピックが含まれます:

- 3.4.3.1項「一般」

- 3.4.3.2項「プラグイン・ログイン設定」

- 3.4.3.3項「LDAPおよびActive Directoryの設定」

- 3.4.3.4項「コンテナ・ログイン設定」

3.4.3.1 一般

プロパティ

- 未承認ユーザーのログイン

- enterprise.security.unapproveduser.allowlogin

- TrueとFalseのオプションにより、承認されていないユーザーのシステムへのログインの可または不可を切り替えます。これは、LDAP認証またはコンテナ管理認証を使用する場合に役立ちます。

- LDAPログインの有効化

- enterprise.authentication.ldap.enabled

- 認証用のLDAPログイン・モジュールを有効にします。

3.4.3.2 プラグイン・ログイン設定

プロパティ

- プラグイン・ログイン・モジュールのクラス名

- enterprise.loginmodules.pluggableloginmodule.classname

- テキスト・ボックスに入力したテキストにより、プラグイン・ログイン・モジュールのクラス名が識別されます。
必要に応じて、「+追加」をクリックして、追加するプラグイン・ログイン・モジュールのクラス名を追加します。

3.4.3.3 LDAPおよびActive Directoryの設定

プロパティ

- LDAPサーバーのホスト名

- ldap.host

- LDAPサーバーのホスト名を入力します。これは必須フィールドです。

- LDAPサーバーのポート番号

- ldap.port

- LDAPサーバー・ポート番号を入力します。デフォルトは389です。これはオプションのフィールドです。

- LDAPマスク

- ldap.mask

- 認証バインドまたは検索基準のいずれかのLDAPマスクを入力します。これは必須フィールドです。

- 未承認ユーザー・アカウントの作成

- ldap.allow-user-creation

- 未承認ユーザーのアカウントの作成を可能とする場合は、Trueを選択します。デフォルト値はtrueです。これはオプションのフィールドです。

- ユーザーへのデフォルト・ロールの割当て

- ldap.assign-default-roles

- ユーザーにデフォルトのロールを割り当てる場合は、trueを選択します。

- 欠落しているロールの自動作成

- ldap.auto-create-missing-roles

- 欠落したロールの自動作成を有効にする場合は、trueを選択します。

- 欠落している部署の自動作成

- ldap.auto-create-missing-depts

- 欠落した部署の自動作成を有効にする場合は、trueを選択します。

- LDAPバージョン

- ldap.version

- 使用するLDAPのバージョンは、2または3のいずれかです。デフォルト値は2です。これはオプションのフィールドです。

- 管理者アカウントの識別名

- ldap.bindDN

- 管理者アカウントの識別名。これはオプションのフィールドです。

- 管理者アカウントのパスワード

- ldap.bindPassword

- 管理者アカウントのパスワード。これはオプションのフィールドです。

- SSL接続の使用

- ldap.ssl.enabled

- LDAP用のSSL接続を有効にします。デフォルトはfalseです。

- 照会先を追跡する

- ldap.follow-referrals

- trueの場合、照会先を追跡します。

- 管理者アカウントを使用してデータを取得する

- ldap.retrieve-data-as-admin

- trueの場合、bindDNを設定する必要があります。デフォルトはfalseです。

- 検索を開始する場所

- ldap.baseDN

- 検索を定義するldap.maskおよびldap.scopeとともに使用する検索の開始場所。これはオプションのフィールドです。

- 検索範囲

- ldap.scope

- 検索範囲を決定します。これはオプションのフィールドです。

- 検出したエントリを識別する属性名

- ldap.uniqueIDAttrib

- 識別名の使用を超えて検出したエントリを識別する属性名で、指定されない場合、デフォルトはuidになります。これは必須フィールドです。

- 検出したエントリの電子メールの属性名

- ldap.emailAttrib

- 検出したエントリの電子メールの属性名。これはオプションのフィールドです。

- 検出したエントリの名前の属性名

- ldap.givennameAttrib

- 検出したエントリのファイル名の属性名。これはオプションのフィールドです。

- 検出したエントリのミドルネームの属性名

- ldap.middlenameAttrib

- 検出したエントリのミドルネームの属性名。これはオプションのフィールドです。

- 検出したエントリの姓の属性名

- ldap.surnameAttrib

- 検出したエントリの姓の属性名。これはオプションのフィールドです。

- 検出したエントリの電話番号の属性名

- ldap.telephoneAttrib

- 検出したエントリの電話番号の属性名。これはオプションのフィールドです。

- LDAPの部署を使用

- ldap.enable-synch-depts

- trueの場合、ユーザーの部署をLDAPログインの際に取得します。

- 部署属性

- ldap.deptAttrib

- 検出したエントリの部署の属性名。

- LDAPのロールを使用

- ldap.enable-synch-roles

- trueの場合、ユーザーのロールをLDAPログインの際に取得します。

- ロール属性

- ldap.rbac.roleAttrib

- 検出したエントリのロールの属性名。

- 第2レベルのルックアップ属性

- ldap.redirectDnAttrib

- ユーザー情報を取得するための第2レベルのルックアップを識別する属性で、dn(識別名)にする必要があります。これはオプションのフィールドです。

- ブリッジのクラス名

- ldap.bridge.classname

- このフィールドは必須です。このプロパティのテキストは、使用するブリッジのクラス名を表します。

3.4.3.4 コンテナ・ログイン設定

プロパティ

- コンテナ・ログイン・モジュールの表示名

- enterprise.loginmodules.containerloginmodule.displayname

- テキスト・ボックスに入力したテキストが、コンテナ・ログイン・モジュールの表示名として表示されます。

- コンテナ・ログイン・モジュール

- enterprise.loginmodules.containerloginmodule.enabled

- コンテナ・ログイン・モジュールを有効にする場合は、Trueオプションを選択します。

- コンテナ・ログイン・モジュール - 内部チェック

- enterprise.loginmodules.containerloginmodule.internalchecking

- コンテナ・ログイン・モジュールの内部チェックを有効にする場合は、Trueオプションを選択します。

3.4.4 インポート/エクスポートおよびイントロスペクション設定

この項には次のトピックが含まれます:

- 3.4.4.1項「インポート/エクスポート」

3.4.4.1 インポート/エクスポート

プロパティ

- インポート/エクスポート・ジョブ・モニター最大アイドル(ミリ秒)

- cmee.extframework.impexp.monitor.maxidle

- テキスト・フィールドに入力された値は、ジョブ・モニターによって自動的に強制終了されるまでの、インポート/エクスポート・ジョブのアイドル状態の最大時間(ミリ秒単位)を表します。

- REXトランザクション用のインポート/エクスポート・ジョブ・モニター最大アイドル(ミリ秒)

- cmee.extframework.impexp.monitor.rex.maxidle

- テキスト・フィールドに入力された値は、ジョブ・モニターによって自動的に強制終了されるまでの、REXトランザクションのアイドル状態の最大時間(ミリ秒単位)を表します。

- インポート/エクスポート・ジョブ・モニター最大実行時間(ミリ秒)

- cmee.extframework.impexp.monitor.maxruntime

- テキスト・フィールドに入力された値は、ジョブ・モニターによって自動的に強制終了されるまでの、インポート/エクスポート・ジョブの実行の最大時間(ミリ秒単位)を表します。

- インポート/エクスポート・ジョブ・モニター期間(ミリ秒)

- cmee.extframework.impexp.monitor.period

- テキスト・フィールドに入力された値は、ジョブ・モニターのスキャン間隔(ミリ秒単位)を表します。

- インポート/エクスポート・ジョブ・プロキシ期間(ミリ秒)

- cmee.extframework.impexp.proxy.period

- テキスト・フィールドに入力された値は、ジョブ・プロキシによる他のクラスタ・ノード上のジョブ・ステータスのチェック間隔(ミリ秒単位)を表します。

- インポート/エクスポート・ジョブ・プロキシ・タイムアウト(ミリ秒)

- cmee.extframework.impexp.proxy.timeout

- テキスト・フィールドに入力された値は、ジョブ・プロキシが他のクラスタ・ノード上のリモート・ジョブのモニタリング・ステータスを停止するまでの時間(ミリ秒単位)を表します。

4 インポート・エクスポート・ツール

この章では、インポート・エクスポート・ツールの機能と、このツールを使用してOracle API Catalogに対する項目のインポートとエクスポートを行う方法について説明します。

この章の内容は次のとおりです。

- 概要

- インポート/エクスポート・ツールの使用

- インポート/エクスポート・ツールの起動

- Oracle API Catalogからの項目のエクスポート

- Oracle API Catalogへの項目のインポート

4.1 概要

Oracle API Catalogのインポート/エクスポート・ツールは、Oracle API Catalogのインスタンス間でアセットや関連するメタデータのやり取りをできるように設計されています。

注意:
インポート/エクスポート・ツールを使用する場合は、次のベスト・プラクティスに従います。

- Oracle API CatalogからエクスポートしてOracle API Catalogへのインポートがサポートされます。

- Oracle Enterprise RepositoryからエクスポートしてOracle Enterprise Repositoryへのインポートがサポートされます。

- Oracle API CatalogからエクスポートしてOracle Enterprise Repositoryへのインポートがサポートされます。

- Oracle Enterprise RepositoryからエクスポートしてOracle API Catalogにインポートすることは、API Catalogへのエクスポート・ユーティリティを使用する場合にのみ、サポートされています。インポート/エクスポート・ユーティリティを使用すると、このユーティリティで作成されたzipファイルをインポートできます。OERからOACへのアセットのインポート以外でインポート/エクスポート・ツールを使用することは、サポートされていません。また、お薦めしません。
ユーティリティのインストールの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repositoryインストレーション・ガイド』のAPI Catalogへのエクスポート機能のパッチのインストールに関する項を、OERからOACにAPIアセットをエクスポートするユーティリティの使用の詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository統合ガイド』のAPI CatalogへのAPIアセットのエクスポートに関する項を参照してください。

4.2 インポート/エクスポート・ツールの使用

この項では、インポート/エクスポート・ツールを使用して、Oracle API Catalogからオブジェクトをインポートまたはエクスポートする方法を説明します。この項には次のトピックが含まれます:

- 4.2.1項「概要」

- 4.2.2項「parameter.propertiesファイル」

注意:
インポート/エクスポート・ツールは、Java Web Startを必要とします。Java Web Startのインストールと構成の詳細は、2.7項「Java Web Startのインストール」を参照してください。

4.2.1 概要

インポート/エクスポート・ツールは、Oracle Enterprise Repositoryの「管理」ページから使用可能です。Oracle Enterprise Repositoryのユーザーがツールにアクセスするには、管理者のロールが必要です。

インポート/エクスポート・ツールは、起動時にダウンロードして起動するJava WebStartプログラムです。

エクスポート操作では、エクスポートするOracle Enterprise Repositoryのオブジェクトを検索できます。エクスポートする単一または複数のAPIアセットを検索して選択できます。エクスポート操作の結果は、選択したAPIの.zipファイルです。デフォルトでは、結果として作成される.zipファイル内にサンプルのparameter.propertiesファイルが含まれます。

注意:
インポート/エクスポート・ツールは、Oracle API Catalog内のAPIのアイコンはインポートまたはエクスポートしません。すでにOACに存在する、インポート・バンドル内の重複するアセットは無視されます。

インポート操作は、インポート/エクスポート・ツールによってエクスポートされた.zipファイルを取得して、それに含まれる項目をOracle API Catalogにロードします。インポートの動作は、META-INF/parameter.propertiesまたは一連のデフォルト・アクションで決まります。

注意:
『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』のアセットの検索結果からのZIPへのエクスポートに関する項の説明に従って、検索結果の画面からエクスポートしたアセットをインポートすることもできます。

異なるOracle API Catalogインスタンス間でデータを移動する必要があるOracle API Catalog管理者は、インポート/エクスポート・ツールまたはOracle API Catalog OpenAPIを使用する必要があります。インポート/エクスポート・ツールを使用する場合、インポート操作を実行する前に、parameter.propertiesファイルを.zipバンドルに含める必要があります。エクスポート操作により、/META-INFディレクトリにあるプレースホルダ・ファイルが作成されます。

4.2.2 parameter.propertiesファイル

各インポート・バンドルには/META-INFディレクトリが含まれます。このディレクトリには、バンドルのインポート時にインポート/エクスポート・ツールの動作を制御するファイルが含まれます。parameter.propertiesファイルが存在しない場合、インポート操作の前にこのファイルを作成する必要があります。

4.2.2.1 parameter.propertiesファイルのサポート対象パラメータ

プロパティ・ファイルのサポート対象パラメータは、パラメータの法定値とともにリストされます。

PreserveUUIDs

- 使用者: アセット

- 説明: このパラメータは、ランダムに生成する新しいUUIDではなくバンドルのアセットのUUIDを保持します。

- 値:

- True - 新規作成されたアセットのUUIDは、インポート・バンドルで指定されるUUIDです。

- False - 新規作成されたアセットのUUIDは、Oracle API Catalogでランダムに生成されます。

Standard.saver.assettype.props.duplicate.matching

注意:
このパラメータはOracle API Catalogでは使用されませんが、parameter.propertiesファイルには存在しています。デフォルト値として、このプロパティを残しておくことをお薦めします。

- 使用者: アセット・タイプ

- 説明: このパラメータは、インポート・ツールによって、バンドルのアセット・タイプがOracle API Catalogにすでに存在するものの複製であるかどうかを特定する方法を指定します。

- 値:

- UUID - インポート・バンドルで指定されるアセット・タイプのUUIDが、Oracle API Catalogのアセット・タイプのUUIDと一致する場合、複製が確定されます。

- 名前 - インポート・バンドルで指定されるアセット・タイプの名前が、Oracle API Catalogのアセット・タイプの名前と一致する場合、複製が確定されます。

Standard.saver.assettype.props.duplicate.handling

注意:
このパラメータはOracle API Catalogでは使用されませんが、parameter.propertiesファイルには存在しています。デフォルト値として、このプロパティを残しておくことをお薦めします。

- 使用者: アセット・タイプ

- 説明: このパラメータは、Oracle API Catalogのアセット・タイプの複製であると特定されるバンドルのアセット・タイプがインポート・ツールによって処理される方法を指定します。

- 値:

- 新しいバージョンの作成 - インポート・バンドルのUUIDとアーキタイプで新しいアセット・タイプを作成しますが、名前の最後に接尾辞「V」と番号が付けられてバージョン指定されます(Service V2など)。アセット・タイプには新しいUUIDがあります。

- 無視 - バンドルの複製アセット・タイプを無視します。アセット・タイプをインポートせず、Oracle API Catalogのアセット・タイプを変更しません。

- マージ - Oracle API Catalogのアセット・タイプと、バンドルの複製アセット・タイプをマージします。マージ操作では、Oracle API Catalogのアセット・タイプの要素が変更されるわけではありません。操作は追加的なものであり、バンドルのアセット・タイプの要素が、Oracle API Catalogのアセット・タイプに付加されます。要素の一致は、要素のXMLマッピングによって行われます。ルールは次のとおりです。

- 要素のXMLマッピングが存在する場合、要素を無視します。

- 要素のXMLマッピングが存在しない場合、それを追加します。要素は、最初に要素のタブを見つけてから、タブが存在しない場合は作成することで追加されます。要素はタブの最後に追加されます。

- 上書き - Oracle API Catalogのアセット・タイプを、バンドルの複製アセット・タイプに置き換えます。Oracle API Catalogのアセット・タイプのアセットは変更されませんが、これらのアセットの表示は影響を受けます。

Standard.saver.relationshiptype.props.duplicate.handling

注意:
このパラメータはOracle API Catalogでは使用されませんが、parameter.propertiesファイルには存在しています。デフォルト値として、このプロパティを残しておくことをお薦めします。

- 使用者: リレーションシップ・タイプ

- 説明: このパラメータは、Oracle API Catalogのリレーションシップ・タイプの複製であると特定されるバンドルのリレーションシップ・タイプをインポート・ツールによって処理する方法を指定します。複製のリレーションシップ・タイプは、リレーションシップ・タイプの名前と方向の特性で常に一致します。

- 値:

- 無視 - バンドルの複製リレーションシップ・タイプを無視します。該当のリレーションシップ・タイプを使用し、すでにOracle API Catalogには存在しないアセット・リレーションシップを作成します。

- 上書き - Oracle API Catalogのリレーションシップ・タイプを、バンドルの複製リレーションシップ・タイプに置き換えます。これにより、リレーションシップ・タイプのすべての情報が上書きされます。該当のリレーションシップ・タイプを使用し、すでにOracle API Catalogには存在しないアセット・リレーションシップも作成されます。

Standard.saver.metadata.props.duplicate.handling

注意:
このパラメータはOracle API Catalogでは使用されませんが、parameter.propertiesファイルには存在しています。デフォルト値として、このプロパティを残しておくことをお薦めします。

- 使用者: CMFメタデータ

- 説明: このパラメータは、Oracle API CatalogのCMFメタデータの複製であると特定されるバンドルのCMFメタデータのブロックをインポート・ツールによって処理する方法を指定します。複製CMFメタデータは、メタデータのUUIDで常に一致します。

- 値:

- 無視 - バンドルの複製CMFメタデータを無視します。

- 上書き - Oracle API CatalogのCMFメタデータを、バンドルの複製CMFメタデータに置き換えます。これにより、CMFメタデータのすべての情報が上書きされます。

Standard.saver.metadata.props.duplicate.handling

注意:
このパラメータはOracle API Catalogでは使用されませんが、parameter.propertiesファイルには存在しています。デフォルト値として、このプロパティを残しておくことをお薦めします。

- 使用者: CMFメタデータ・エントリ・タイプ

- 説明: このパラメータは、Oracle API CatalogのCMFメタデータ・エントリ・タイプの複製であると特定されるバンドルのCMFメタデータ・エントリ・タイプをインポート・ツールによって処理する方法を指定します。複製CMFメタデータ・エントリ・タイプは、メタデータ・エントリ・タイプの名前で常に一致します。

- 値:

- 無視 - バンドルの複製CMFメタデータ・タイプを無視します。

- 上書き - Oracle API CatalogのCMFメタデータ・エントリ・タイプを、バンドルの複製CMFメタデータ・エントリ・タイプに置き換えます。これにより、CMFメタデータ・エントリ・タイプのすべての情報が上書きされます。

4.2.2.2 parameter.propertiesサンプル・ファイル

すべてのオプションが含まれるサンプルのparameter.propertiesファイルは次のようになります。

##Name: parameters.properties
##Location: import_bundle.zip/META_INF/

##Legend:
## a double ## indicates a comment
## a single # indicates a command which can be used in an import bundle
## the text between []'s is the set of valid values for the parameter with comma
separating individual values

## for assets:
## This parameter will retain the UUIDs of assets in the bundle rather than randomly generating new UUIDs
#PreserveUUIDs=[true,false]
#Standard.saver.asset.props.duplicate.handling=[Create New Version, Ignore, Overwrite]
#Standard.saver.asset.props.duplicate.matching=[UUID, NameVersion]

## for assettypes:
#Standard.saver.assettype.props.duplicate.handling=[Create New Version, Ignore, Merge, Overwrite]
#Standard.saver.assettype.props.duplicate.matching=[UUID, Name]

## for relationship types:
#Standard.saver.relationshiptype.props.duplicate.handling=[Ignore, Overwrite]

## For CMF metadata
#Standard.saver.metadata.props.duplicate.handling=[Ignore, Overwrite]

## For CMF metadata entry types
#Standard.saver.metadataentrytype.props.duplicate.handling=[Ignore, Overwrite]

4.3 インポート/エクスポート・ツールの起動

インポート/エクスポート・ツールは、Oracle API Catalogの「管理」画面から起動することもできます。インポート/エクスポート・ツールにはJDK 1.4.2以上が必要です。

4.3.1 Oracle API Catalogからの起動

インポート/エクスポート・ツールは、「管理」ページから起動します。インポート/エクスポート・ツールの特性と、包括的なバックアップに必要なデータ量により、ツールは、管理者のロールが割り当てられているユーザー(組込みの管理ユーザーなど)に制限されます。

「管理」ページの「インポート/エクスポート」セクションは、システム設定のプロパティによって有効になり構成されます。このセクションが管理者のロールを持つユーザーに表示されない場合、次のシステム設定が有効でTrueに設定されていることを確認します。

cmee.importexport.enabled

4.3.2 Oracle API Catalogの外部からの起動

Oracle API Catalogにローカルにログインしていないときも、インポート/エクスポート・ツールを使用する必要があることがあります。インポート・エクスポート・ツールを保存して、ローカル・マシンから実行できます。

ローカル・マシンからインポート/エクスポート・ユーティリティを実行する手順は、次のとおりです。

1. システム上でJava Web Startを実行するように構成するには、2.7項「Java Web Startのインストール」の指示に従います。

2. 「管理」ページから「インポート/エクスポート」をクリックします。

3. クライアントのインポート/エクスポート・アイコンをクリックし、「ファイルの保存」(または、ご使用のブラウザの同等のもの)を選択し、impexp.jnlpファイルを保存します。

4. impexp.jnlpファイルを、それを実行する場所に移動します。

5. impexp.jnlpファイルを実行します。

注意:
インポート・エクスポート・ツールは、それをローカルに保存して実行することもでき、その場合は<JAVA_HOME>/jre/binにあるjavaws実行可能ファイルを使用します。次に例を示します。

<JAVA_HOME>/jre/bin/javaws -verbose /path_to_file/impexp.jnlp

4.3.3 初期起動

図4-1に示すように、インポート/エクスポート・ツールの起動時に、Oracle Enterprise Repositoryの接続情報の入力が求められることがあります。

注意:
SSO環境以外では、資格証明が求められることはありません。

図4-1 Oracle API Catalogのインポート/エクスポート・ユーティリティ

- OER URL
Oracle API Catalogインストールのパスは、システム設定で定義されているとおり、通常はServletパスと同じになります。例: http://example.com/oer/

- ユーザー名
Oracle API Catalog内で管理者のロールが付与されているユーザーの名前。

- パスワード
上のボックスで指定したユーザーのパスワード。

インポート/エクスポート・ツールがジョブ・モニターによって自動的に中断されるまでに実行可能な最大時間をミリ秒単位で設定するには、新しいシステム設定を次のように構成する必要があります。

cmee.extframework.impexp.monitor.maxruntime

4.4 Oracle API Catalogからの項目のエクスポート

この手順は、Oracle Enterprise Repositoryの「管理」画面で実行されます。

1. 「管理」ページから「インポート/エクスポート」をクリックします。

2. 「インポート/エクスポート」アイコンをクリックします。インポート/エクスポート・クライアントが表示されます。

3. 「エクスポート」タブをクリックします。

図4-2 Oracle API Catalogの「エクスポート」タブ

4. ターゲット・ファイルの選択フィールドに適切なファイル名を入力して「参照」をクリックし、ターゲット・ファイルをエクスポートするディレクトリを選択します。「次」をクリックします。

5. 第II部「エクスポート・ダイアログでのアセット選択」に示すように、エクスポートするアセットの選択ダイアログが表示されます。

図4-3 エクスポートするアセットの選択ダイアログ

6. 「検索」を使用するか、すべてをリストをクリックすると、「使用可能」列に項目のリストが表示されます。

7. 矢印ボタンを使用し、選択した項目を「使用可能」と「選択済」列の間で移動します。

8. 「次」をクリックします。エクスポートの実行準備完了ダイアログに、エクスポートするファイルのリストが表示されます。

9. 「次」をクリックします。エクスポート・プロセスのステータスが、進行状況バーに示されます。

注意:
エクスポートされた項目のサイズや複雑性に違いがある場合、このプロセスの速度や進行状況バーの動作に影響があります。

図4-4に示すように、完了するとエクスポートの概要が表示されます。

図4-4 エクスポート操作の実行中ダイアログ

Microsoft Windowsプラットフォームでは、Windows Explorerが開き、アーカイブが保存されたフォルダが表示されます(システム権限によりアプリケーションからのシェルの実行が許可されると仮定)。

4.5 Oracle API Catalogへの項目のインポート

この手順は、Oracle API Catalogの「管理」画面で実行します。

1. 「管理」ページから「インポート/エクスポート」をクリックします。

2. 「インポート/エクスポート」アイコンをクリックします。インポート/エクスポート・クライアントが表示されます。

3. 「インポート」タブをクリックします。

4. 「インポートするファイルの選択」フィールドに適切なファイル名を入力するか、図4-5のように「参照」をクリックして、インポートするソース・ファイルを選択します。

図4-5 インポート元ソース・ファイルの選択ダイアログ

5. 「次」をクリックします。図4-6に示すように、インポート実行の準備ダイアログには、選択したソース・ファイルが表示されます。

図4-6 インポート実行の準備ダイアログ

6. 「次」をクリックします。インポート・プロセスのステータスが、進行状況バーに示されます。インポートされた項目のサイズや複雑性に違いがある場合、このプロセスの速度や進行状況バーの動作に影響があります。
図4-7に示すように、完了するとインポートの概要が表示されます。

図4-7 インポート操作の実行ダイアログ

注意:
インポート/エクスポート・ツールを実行する場合、比較的大きなデータ・セットをインポートすると、メモリーの問題が生じる可能性があります。これを回避するには、インポート/エクスポート・クライアント・リンクを右クリックして、リンクに名前を付けて保存...オプションをコンテキスト・メニューから選択することで、impexp.jnlpファイルをローカルに保存します。インポートするデータ・セットのサイズにさらに合うように、impexp.jnlpファイルを編集してmax-heap-sizeのデフォルトの量を増やします。データ・セットをインポートするマシンに十分なメモリーがある場合、次の例に示すように、max-heap-sizeパラメータの値をさらに高く変更します(<j2se version="1.6" max-heap-size="1024m"/>)。

第III部

アセット・ライフサイクルの管理

この部では、ライフサイクルの高度な管理タスクについて説明します。

この部は、次の章で構成されています。

- 第5章「自動収集の構成と使用」

- 第6章「Oracle API CatalogにおけるAPIアセットのメタデータの編集」

5 自動収集の構成および使用

Oracle API Catalogの移入に使用されるツールはハーベスタと呼ばれます。このハーベスタにより、Oracle製品およびデプロイ済サービスからメタデータが読み込まれます。これには、Oracle SOA SuiteおよびOracle Service Busを含みます。

ハーベスタにより自動的にアセットが作成され、収集されたサービスの情報に基づいてアセットのメタデータが移入されます。

ランタイム環境にデプロイ済のファイルが収集されます。ハーベスタは、コマンド行、Ant内およびWebLogic Scripting Tool(WLST)から使用できます。

この章には、次のセクションがあります。

- 5.1項「ハーベスタのスタートガイド」

- 5.2項「ハーベスタの構成」

- 5.3項「ハーベスタの追加情報の理解」

5.1 ハーベスタのスタートガイド

この項では、ハーベスタの使用を開始する方法、および様々な高レベルのユースケースでの使用について説明します。

この項には次のトピックが含まれます:

- 5.1.1項「前提条件」

- 5.1.2項「ハーベスタの機能」

- 5.1.3項「アーティファクトおよび製品バージョンのマトリックス」

5.1.1 前提条件

ハーベスタを使用する前に、次の前提条件を実行する必要があります。

- Oracle Service Busから収集する場合、Oracle Service Busのインストール場所と同じFMW_HOMEまたはOracle Service Busインストールにアクセス可能な共有ファイル・システムに、ハーベスタをインストールします。詳細は、5.2.2.2項「コマンド行での収集用にアーティファクトを選択する」を参照してください。

注意:
Oracle Service Busからプロジェクトを収集する場合は、通常のハーベスタ・ユーティリティharvest.batまたはharvest.shのかわりに、osb-harvest.batまたはosb-harvest.shユーティリティを使用する必要があります。これには、Oracle Service Bus 12cライブラリがインストールされている必要があります。OSBハーベスタの詳細は、第5章「Oracle Service BusからのWebサービスの収集」を参照してください。

- Oracle SOA SuiteやOracle Service Busなどのデプロイ済アプリケーションからアセットを収集する場合、アプリケーションをWebLogic 11g以上にデプロイする必要があります。

- ハーベスタには、Java SDKのバージョン6以上が必要です。

5.1.2 ハーベスタの機能

ハーベスタを使用し、表5-1に示すアーティファクトおよび製品から公開されているサービスを公開できます。

5.1.3 アーティファクト/製品とバージョンのマトリックス

表5-1に、ハーベスタでサポートされているアーティファクト/製品のバージョン・マトリックスを示します。

表5-1 アーティファクト/製品とバージョンのマトリックス

アーティファクト/製品

バージョン

デプロイ済WSDL

1.1

デプロイ済WADL

1.1.5

Oracle SOA Suite

11gおよび12c (12.1.3および12.2.1)

Oracle Service Bus

11gおよび12c (12.1.3および12.2.1)

WebLogic Webサービス

11gおよび12c (12.1.3および12.2.1)

注意:
ハーベスタは、12.2.1リリースで導入されたOracle SOA SuiteおよびService Busのエンド・ツー・エンドJSONまたはネイティブRESTサービスの収集をサポートしません。これらの製品の12.2.1リリースの他のアーティファクトの収集はサポートされています。

5.2 ハーベスタの構成

この項では、ハーベスタを構成する方法について説明します。

この項には次のトピックが含まれます:

- 5.2.1項「ハーベスタの入手」

- 5.2.2項「コマンド行からのハーベスタの構成」

- 5.2.3項「Repository.Submit Antタスクを使用したハーベスタの起動」

- 5.2.4項「WLSTからのハーベスタの起動」

- 5.2.5項「ランタイム収集の詳細」

- 5.2.6項「オプションのハーベスタ構成の実行」

- 5.2.7項「ハーベスタのためのロギングの構成」

- 5.2.8項「ハーベスタ内のトランザクション処理」

5.2.1 ハーベスタの入手

Oracle API Catalogのインストール時に、ハーベスタは自動的に次のディレクトリに解凍されます。

- <FMW_HOME>/oer/tools/harvester

- <FMW_HOME>/oer/tools/osbharvester

ハーベスタは、Oracle API Catalog 12cインストールにバンドルされている12.1.3.0.0-OER-Harvester.zipを使用することもでき、次の場所にあります。

<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-OER-Harvester.zip

OSBハーベスタは、Oracle API Catalog 12cインストールにバンドルされている12.1.3.0.0-OSB12c-Harvester.zipを使用することもでき、次の場所にあります。

<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-OSB12c-Harvester.zip

このマニュアルでは、どちらのハーベスタを使用しているかに応じて、<FMW_HOME>/oer/tools/harvesterまたは<FMW_HOME>/oer/tools/osbharvesterのいずれかを<Harvester Home>ディレクトリとして参照します。

表5-2に、製品とそれに対応するバージョンの関係のマトリックスを示します。

表5-2 ハーベスタの製品とバージョンのマトリックス

製品とバージョン

収集

IDEの検索、参照および使用

Service Bus 11gおよび12c (12.1.3および12.2.1)

OER 12c

はい

SOA Suite 11gおよび12c (12.1.3および12.2.1)

OER 12c

はい

WSDL

OER 12c

状況により異なる

WADL

OER 12c

状況により異なる

注意:
ハーベスタは、12.2.1リリースで導入されたOracle SOA SuiteおよびService Busのエンド・ツー・エンドJSONまたはネイティブRESTサービスの収集をサポートしません。これらの製品の12.2.1リリースの他のアーティファクトの収集はサポートされています。

5.2.2 コマンド行でのハーベスタの構成

コマンド行からハーベスタを構成できます。組織は、コマンド行からハーベスタを使用して、簡単にAPI Catalogのインストールを開始できます。

この項では、コマンド行でハーベスタを構成するために実行する必要のあるタスクについて説明します。

- 5.2.2.1項「コマンド行でのリポジトリ接続情報の設定」

- 5.2.2.2項「コマンド行での収集用にアーティファクトを選択する」

5.2.2.1項「コマンド行でのリポジトリ接続情報の設定」

<Harvester Home>にあるXMLファイルHarvesterSettings.xmlを開き、次のように、正しい資格証明を使用し、ハーベスタがOracle API Catalogのインスタンスを指すようにXMLを変更します。

<repository>
<uri>http://localhost:7101/oer</uri>
<credentials>
<user>smith</user>
<password>*****</password>
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
</credentials>
<timeout>30000</timeout>
</repository>

注意:
管理者のロールを持つユーザーでハーベスタを実行することをお薦めします。

5.2.2.2 コマンド行での収集用にアーティファクトを選択する

ハーベスタは、harvest.batまたはharvest.shユーティリティを使用してコマンド行から実行できます。

注意:
Oracle Service Busからプロジェクトを収集する場合は、OSBハーベスタを使用する必要があります。OSBハーベスタは、<FMW_HOME>/oer/tools/osbharvesterディレクトリにインストールされていて、osb-harvest.batまたはosb-harvest.shを使用して実行できます。OSBハーベスタは、OSB 12cがインストールされているのと同じFMW_HOMEにインストールする必要があります。
OSBハーベスタ使用方法の詳細は、5.2.5.3項「Oracle Service BusからのWebサービスの収集」を参照してください。

harvest.batおよびharvest.shユーティリティは、Oracle API Catalogがインストールされているサーバーから実行できます。別のクライアントからハーベスタを実行する場合は、<FMW_HOME>/oer/modules/tools/solutionsディレクトリから12.1.3.0.0-OER-Harvester.zipファイルを入手し、表5-3に示すような、有効なJAVA_HOME環境変数のセットが設定されている任意のクライアントにzipファイルを解凍します。

osb-harvest.batおよびosb-harvest.shユーティリティは、Oracle API Catalogがインストールされているサーバーから実行できます。別のクライアントからハーベスタを実行するには、次のようにします。

- Oracle Service Busをクライアント・マシンの<FMW_HOME>ディレクトリにインストールします。

- クライアント・マシンに、表5-3に示すように、JAVA_HOME環境変数が設定されていることを確認します。

- Oracle API Catalogがインストールされているマシンの<FMW_HOME>/oer/modules/tools/solutionsディレクトリから12.1.3.0.0-OSB12c-Harvester.zipファイルを入手します。このファイルを、ターゲット・マシンの<FMW_HOME>/oer/toolsディレクトリに解凍します。ファイルを解凍した後のハーベスタのフルパスは、<FMW_HOME>/oer/tools/osbharvesterとなるはずです。OSBハーベスタは、OSB 12cがインストールされているのと同じFMW_HOMEにインストールする必要があります。

harvest.bat、harvest.sh、osb-harvest.batまたはosb-harvest.shを実行する前に、表5-3に示す環境変数が設定されていることを確認します。Windowsでは、コマンド・ウィンドウから変数Xの値を表示するには「set X」と、Xの値を「abc」に設定するには「set X=abc」と入力します。

表5-3 コマンド行スクリプト

環境変数

説明

JAVA_HOME

JAVA_HOME環境変数がインストール済のJavaランタイム(JRE)またはSDKを指していることを確認します。Oracle Service Busのイントロスペクションのため、Javaのバージョン6以上が必要です。

JAVA_OPTS

オプションで、JAVA_OPTSパラメータを設定し、必要とする付加的なJavaパラメータを追加します。たとえば、HTTPプロキシ・サーバーを使用する必要がある場合は、-Dhttp.proxyHost=www-proxy.yourhost.com -Dhttp.nonProxyHosts= "*.yourhost.com |localhost"のように値を設定します。

関連項目: http://java.sun.com/javase/6/docs/technotes/guides/net/proxies.html

表5-4に、ハーベスタのコマンド行ユーティリティを使用して指定できるオプションを示します。

表5-4 ハーベスタのコマンド行オプション

ハーベスタのオプション

説明

-settings<ファイル>

構成設定XMLファイルを指定します。

-url <URL>

Oracle API CatalogのURLを指定します。

-user <OER/OACユーザー名>

Oracle API Catalogユーザーのユーザー名を指定します。

-asset_version

そのモデルで作成されるすべてのアセットに適用されるバージョン。

-file <ファイル名またはURL>

収集するファイルまたはディレクトリを指定します。ファイル名またはファイルのURLを指定できます。

-file_type <タイプ>

収集するファイルのファイル・タイプを指定します。指定しない場合は、ファイルの拡張子からタイプが導出されます。これは、config/pluginsフォルダ内のファイル・タイプのいずれかに対応している必要があります。デフォルトでは、次のものがサポートされています: .bpel、.mfl、.policy、.wsdl、.xsd、.xquery、.xslt。

-remote_url <URL>

ファイルのかわりに、リモート・プロジェクトを収集する実行中のサーバーを指定します。

-remote_username <ユーザー名>

リモート・サーバーに接続するためのユーザー名を指定します。

-remote_server_type <タイプ>

リモート・サーバーのタイプを指定します。リモート・サーバーは、次のいずれかが可能です: SOASuite、SOASuite11g、OSB、WLS。

注意: SOA Suite 11gサーバーに対して実行する場合は、SOASuite11gを使用します。SOA Suite 12cサーバーに対して実行する場合は、SOASuiteを使用します。

-remote_project <タイプ>

ファイルのかわりに、収集するリモート・プロジェクトの名前を指定します。省略した場合、サーバー上のすべてのプロジェクトが収集されます。Oracle SOA Suiteの場合は、たとえばMyComposite_rev1のような、コンポジットとリビジョンを加えた名前にする必要があります。WLSの場合は、WebLogic Administration consoleおよびEnterprise Managerのように、アプリケーション名にする必要があります。

-soa_partition <タイプ>

Oracle SOA Suite用のパーティションの名前を指定し、デフォルトでは、SOAの「default」パーティションを使用します。

-version

出力するバージョン情報を指定します。

-preview

収集をプレビュー・モードで実行するかどうかを指定します。trueに設定すると、プレビュー・モードでハーベスタを実行します。成功と失敗の詳細な情報が記録され、変更はOracle API Catalogにはコミットされません。

falseに設定するか、値が指定されていない場合は、本番モードでハーベスタを実行します。成功と失敗の詳細な情報が記録され、変更はOracle API Catalogにコミットされます。

-simple_model

trueに設定すると、単一アセット・モデルを作成します。これは、APIアセット・タイプを必要とします。Oracle API Catalogのデフォルトで、trueに設定されます。

-help

ハーベスタのコマンド行ユーティリティのオンライン・ヘルプを表示します。

リモート収集の例を次に示します。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_server_type SOASuite -remote_project MyComposite_rev1.0 -soa_partition department1

図5-1に、harvest.bat -helpコマンドで表示されるコマンド行ユーティリティのオプションとオンライン・ヘルプを示します。

図5-1 ハーベスタのコマンド行ユーティリティのオプション

コマンド行オプションは、Oracle SOA Suite 11gサーバーからの収集時にのみ必要となります。この場合、-remote_server_type SOASuite11gオプションを含める必要があります。詳細は、5.2.5.1項「Oracle SOA Suiteサーバーから収集する」を参照してください。

オプションが省略された場合、ハーベスタは、harvest.batが置かれている<Harvester Home>ディレクトリのHarvesterSettings.xmlファイルにある情報を使用します。コマンド行でオプションが指定されている場合、そのオプションがHarvesterSettings.xmlでの設定より優先されます。

セキュリティを確保するため、パスワードはコマンド行経由では渡さず、暗号化する必要があります。Oracle API Catalogとリモート・サーバーのパスワードを設定する唯一の方法は、ハーベスタ構成ファイル(HarvesterSettings.xml)に格納することです。パスワード暗号化ツール(encrypt.batまたはencrypt.sh)により、ファイルに格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第8章「パスワードの暗号化」を参照してください。

収集するアーティファクトを示すため、<Harvester Home>内のHarvesterSettings.xmlファイルを使用し、次のXMLを変更します。

<query>
<fileQuery>
<rootDir>C:\samples</rootDir>
<files>BPEL</files>
</fileQuery>
</query>

または

<query>
<fileQuery>
<files>http://remote/server/my_generated_wsdl</files>
<fileType>.wsdl</fileType>
</fileQuery>
</query>

5.2.3 Repository.Submit Antタスクを使用したハーベスタの起動

Antタスクとしてハーベスタを起動でき、デプロイ時に確実にすべてのデプロイメント情報をOracle API Catalogに格納できます。Oracle API Catalogへの収集とメタデータのインポートに、Oracle API Catalogとともに提供されるAntタスクrepository.submitを使用できます。このタスクは、<FMW_HOME>/oer/tools/harvesterディレクトリにあるharvest-tasks.xmlファイルに定義できます。

この項には次のトピックが含まれます:

- 5.2.3.1項「repository.Submit Antタスクのパラメータを指定する」

- 5.2.3.2項「ネストされた要素としてのパラメータの指定」

- 5.2.3.3項「Antからのハーベスタの実行」

- 5.2.3.4項「サード・パーティ・タスクの使用」

5.2.3.1 repository.Submit Antタスクのパラメータを指定する

表5-5に、harvest-tasks.xmlファイル内のAntタスクrepository.submitに指定できるパラメータを示します。

表5-5 repository.submit Antタスクのパラメータ

属性

説明

必須

repositoryURL

接続するリポジトリ・インスタンス。

はい(プロパティで指定されないかぎり)。

repositoryUsername

Oracle API Catalogにログインするユーザー名。

はい(プロパティで指定されないかぎり)。

repositoryPassword

Oracle API Catalogにログインするパスワード。

セキュリティを確実にするために、パスワードを暗号化する必要があります。

Oracle API CatalogのWebコンソールには、パスワードを暗号化するため、次のツールがあります。

http://<host>:<port>/<domain>/diag/encryptstrings.jsp

はい(プロパティで指定されないかぎり)。

timeout

Oracle API Catalogへのコールがタイムアウトするまでの秒数。

いいえ。デフォルトは300(5分)。

failOnError

Oracle API Catalogの操作結果にエラーがあると、ビルド・スクリプトの全体が失敗します。

いいえ。デフォルトは「true」。

errorProperty

リポジトリの操作結果にエラーがあった場合に設定するAntプロパティの名前。これは、failOnErrorがfalseに設定されている場合にのみ有効です。エラーがある場合、指定されたプロパティがtrueに設定されます。そうでない場合は、指定されたプロパティが未設定のままになります。

いいえ。

debug

Antの-debugの設定に関係なく、Oracle API Catalogタスクからのデバッグ情報を表示します。Antランタイムに-debugパラメータを渡す場合は、デバッグ情報も表示されます。

いいえ。デフォルトは「true」。

description

Oracle API Catalogで作成した各アセットとハーベスタの説明を関連付けます。これはハーベスタのプロパティに表示されます。

いいえ。

namespace

Oracle API Catalogで作成した各アセットの前に付けるネームスペース。

いいえ。

version

Oracle API Catalogで作成した各アセットとハーベスタのバージョンを関連付けます。これはハーベスタのプロパティに表示されます。

いいえ。

beaHome

インストールされたOracle Service BusサーバーのBEA_HOMEディレクトリ。

はい(Oracle Service Busプロジェクトのjarファイルを収集するとき)。

settingsFile

設定XMLファイルの場所。BPEL_Harvester_Settings.xsdに従う必要があります。このファイルは、ハーベスタのクラスがどのファイル・タイプにマップされているか、およびエンティティとリレーションシップがOracle API Catalogのどのタイプにマップされているかを構成します。オプションで、この属性またはsettingsURL属性を指定できますが、両方は指定できません。

いいえ。デフォルトはAntタスクにバンドルされている設定XML。

settingsURL

設定XMLファイルの場所。BPEL_Harvester_Settings.xsdに従う必要があります。このファイルは、ハーベスタのクラスがどのファイル・タイプにマップされているか、およびエンティティとリレーションシップがOracle API Catalogのどのタイプにマップされているかを構成します。オプションで、この属性またはsettingsFile属性を指定できますが、両方は指定できません。

いいえ。デフォルトはAntタスクにバンドルされている設定XML。

preview

このオプションは、ハーベスタをプレビュー・モードに設定します。ハーベスタは、作成または変更されるすべてのアセットを表示しますが、トランザクションはコミットされません。有効にするには、「true」を設定します。

いいえ。デフォルトはfalse。

5.2.3.2 ネストされた要素としてのパラメータの指定

fileSet

fileSetは、収集するファイルのセットの選択に使用されます。1つ以上のfileSetを指定する必要があります。ハーベスタにより、.zip形式(.zip、.jar、.earなど)内のファイルを含め、fileSetで選択されたすべてのファイルが検証されます。例5-1に示すAnt repository.submitタスクでは、ハーベスタにより、fileSetのディレクトリ(/tmp/componentsディレクトリ)以下のすべてのファイルとディレクトリが検証され、Oracle API Catalogにインポートされます。

URI

URIは、イントロスペクションするファイルを識別します。1つ以上のURIを指定できます。これには、リモート・ファイルを指す「http:」URL、ローカル・ファイルを指す「file:」URL、その他のJavaでサポートされるURLなどがあります。単一のファイルまたはzip、jar、earsなどを含むzip形式内のファイルを指すことができます。エクスポートされたOracle Service Busプロジェクトのjarを含むこともできます。Oracle Service Busプロジェクトは、Export|Oracle Service Bus|Configuration Jarコマンドを使用してOracle Service Bus Workshopからエクスポートできます。artifactStore属性は、参照するOracle API Catalogアーティファクト・ストアの名前です。アーティファクト・ストアは、あらかじめOracle API Catalogのアセット・エディタで作成しておく必要があります。指定した場合、URIはアーティファクト・ストアのURLの相対として解決されます。アーティファクト・ストアからの相対URIを指定する場合、そのURIは、必ず.wsdlまたは.zipファイルとして解決されます。ディレクトリを指すURIはサポートされていません。fileType属性は、収集するファイルのファイル・タイプを示します。指定しない場合は、ファイルの拡張子からタイプが導出されます。これは、config/pluginsフォルダ内のファイル・タイプのいずれかに対応している必要があります。デフォルトでは、次のものがサポートされています: .bpel、.mfl、.policy、.wsdl、.xsd、.xquery、.xslt。

例5-1 Ant repository.submitタスクで収集するファイルの指定

<repository.submit repositoryurl="http://server.example.com:8080/oer"
repositoryusername="myuser"
registrypassword="*****"
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
settingsFile="../MyCustomSettings.xml">
<fileset dir="/tmp/components/">
<include name="**/*"/>
</fileset>
</repository.submit>

RemoteProject

RemoteProjectは、ハーベスタがファイルからではなく、リモート・サーバーからプロジェクトを読み込むことを指定します。uri属性は、そこからリモート・プロジェクトを収集する、実行中のサーバーを示します。ユーザー名とパスワードの属性は、リモート・サーバーのログイン情報を示します。

serverType属性は、リモート・サーバーのタイプを示し、Oracle SOA Suite(SOASuiteまたはSOASuite11g)、Oracle Service Bus(OSB)またはWebLogic Server(WLS)のいずれかです。projectName要素は、ファイルのかわりに収集するリモート・プロジェクトの名前を示します。省略した場合、サーバー上のすべてのプロジェクトが収集されます。Oracle SOA Suiteの場合は、たとえばMyComposite_rev1のような、コンポジットとリビジョンを加えた名前にする必要があります。WLSの場合は、WebLogic Administration consoleおよびEnterprise Managerのように、アプリケーション名にする必要があります。

例5-2 ネストされた要素としてのパラメータの指定 - RemoteProject

<repository.submit repositoryurl="http://server.example.com:8080/oac"
repositoryusername="myuser"
registrypassword="*****"
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
settingsFile="../MyCustomSettings.xml">
<remoteProjects uri="http://mywlsserver:7001" username="admin" password="*****"
serverType="SOASuite" soaPartition="${partiton}">
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
<projectName>MySOAComposite1_rev1.0</projectName>
<projectName>MySOAComposite3_rev2.0</projectName>
</remoteProjects>
</repository.submit>

プロジェクトの作成

収集したものから作成されるすべてのアセットのため、生成中のプロジェクトとしてタグ付けされた複数のプロジェクトを指定できます。このプロジェクトはすでにOERに存在している必要があります。

<repository.submit>要素は次のものを含みます。

- <producingProject name="MyProjectName"/>

- <producingProject name="MyOtherProjectName"/>

生成中のプロジェクトも、同じ方法でHarvesterSettings.xmlファイル内に設定できます。

5.2.3.3 Antからのハーベスタの実行

ハーベスタのAntタスクをインポートするには、AntのXMLに次のような行を含めます。

<taskdef file=${harvester.dir}/harvest-tasks.xml/>

ここで、harvester.dirは<FMW_HOME>/oer/tools/harvesterディレクトリです。

コマンド行から実行する場合は、ハーベスタ・ライブラリがAntのクラスパスで利用できることを確認します。ハーベスタには、Antのクラスパスを正しく設定するrunantと呼ばれるスクリプトが含まれています。ハーベスタのAntタスクを使用するときは、このスクリプトを使用してAntを起動する必要があります。次に例を示します。

runant -f mybuild.xml

(mybuild.xmlはAntのビルドXML)

runantに渡される引数は、すべてAntに渡されます。harvest.batまたはharvest.shを実行する前に、環境変数が設定されていることを確認します。表5-6に、設定が必要な環境変数のリストを示します。

表5-6 コマンド行スクリプト

環境変数

説明

JAVA_HOME

JAVA_HOME環境変数がインストール済のJavaランタイム(JRE)またはSDKを指していることを確認します。Oracle Service Busのイントロスペクションのため、Javaのバージョン6以上が必要です。

ANT_HOME

ANT_HOME環境変数がApache Antのバージョン1.6.2以上を指していることを確認します。Oracle Service Busのイントロスペクションには、Antのバージョンが1.6.5以上であることを確認してください。

BEA_HOME

Oracle Service Busからプロジェクトを収集する場合は、BEA_HOME環境変数がOracle Service Busサーバーを含むインストール・ディレクトリを指していることを確認します。たとえば、C:\beaです。

JAVA_OPTS

オプションで、JAVA_OPTSパラメータを設定し、必要とする付加的なJavaパラメータを追加します。たとえば、HTTPプロキシ・サーバーを使用する必要がある場合は、-Dhttp.proxyHost=www-proxy.yourhost.com -Dhttp.nonProxyHosts= "*.yourhost.com |localhost"のように値を設定します。

関連項目: http://java.sun.com/javase/6/docs/technotes/guides/net/proxies.html

5.2.3.4 サード・パーティ・タスクの使用

runantスクリプトは、Antの古いランチャであるorg.apache.tools.ant.Mainを使用します。新しいランチャはURIClassLoaderインタフェースを使用し、これはOracle Service BusのカスタムなURIStreamHandlersの使用と衝突します。

古いAntランチャは、ant/libディレクトリのカスタムAntタスクの自動検出をサポートしていません。<taskdef>でカスタム・タスクを定義する場合は、classpath属性を指定する必要があります。

たとえば、次の例は、定義されていない<taskdef>です。

<taskdef id="ant-contrib" resource="net/sf/antcontrib/antcontrib.properties"/>

次の例は、定義されている<taskdef>です。

<taskdef id="ant-contrib" resource="net/sf/antcontrib/antcontrib.properties" classpath="${ant.home}\lib\ant-contrib.jar"/>

5.2.4 WLSTからのハーベスタの起動

WLST(WebLogic Scripting Tool)は、システム管理者がWebLogic Serverインスタンスの管理に使用できる、コマンド行スクリプト・インタフェースです。WLSTは、Oracle Service Bus 11gと12cおよびSOA Suite 11gと12cをサポートします。WLSTの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。WLSTからハーベスタを呼び出し、デプロイ時に確実にすべてのデプロイメント情報をOracle API Catalogに格納できます。次の手順を実行し、WLSTからハーベスタを起動します。

1. oer.pyファイルをハーベスタのインストール・フォルダから<BEA_HOME>\wlserver\common\wlst\libディレクトリにコピーします。

2. コマンド・ウィンドウで、次のコマンドを入力します。

- WLSTのclasspathの初期化: run <BEA_HOME>\wlserver\server\bin\setWLSEnv.cmd

- ハーベスタのclasspathの初期化: cd to the <harvester> folder and run <harvester>\setenv.bat

- WLSTの起動: java weblogic.WLST<scriptname>

3. AntからWLSTを起動するには、次の手順を実行します。

- コマンド・プロンプトで、cdコマンドを使用して<harvester>ディレクトリに移動します。

- runant.bat -f<antscriptname>と入力すると、AntスクリプトがAntの<java>タスクを使用してJavaクラスのweblogic.WLSTを起動します。

- <java>タスクでは、「fork = true」を設定します。

- <java>には、環境変数CLASSPATHを含めます(runant.batでCLASSPATHにハーベスタのクラスが含まれるように設定されます)。

- <java>タスクには、WLSTスクリプトによって参照されるあらゆるライブラリのクラスパスも含めます。

サンプルのAntスクリプトを次に示します。

<property environment="env"/>
<target name="harvest">
<java classname="weblogic.WLST" fork="true">
<arg line="${domain.import.script}"/>
<arg line="${import.config.file}"/>
<classpath refid="extra.class.path"/> <!--extra jars used by WLST script, e.g.
OSB jars-->
<classpath path="${env.CLASSPATH}"/>
</java>
</target>

oer.harvest()メソッドは1つの引数を受け取り、それはコマンド行パラメータのディクショナリです。これは、ハーベスタのコマンド行から使用できるものと同じパラメータです。

コマンド行からのハーベスタの使用方法の詳細は、5.2.2.2項「コマンド行での収集用にアーティファクトを選択する」を参照してください。

次に、その使用方法の例を示します。

argMap = {}
argMap['-harvester_home'] = '.'
argMap['-bea_home'] = 'c:/bea'
argMap['-remote_url'] = 'http://mywlsserver:7001'
argMap['-remote_username'] = 'admin'
argMap['-remote_password'] = '*****'
//To ensure security, the password must be encrypted.
//The password encryption tool (encrypt.bat/encrypt.sh) allows you to encrypt
// the passwords that are stored in the Harvester configuration
// (HarvesterSettings.xml) file.
argMap['-remote_server_type] = 'SOASuite'
argMap['-remote_project] = 'MySOAComposite_rev1.0'
argMap['-soa_partition'] = 'department1'
oer.harvest(argMap)

-harvester_home引数は、ハーベスタのインストール場所を指している必要があります。-bea_home引数は、Oracle Service Busでの収集に必要です。

5.2.5 ランタイム収集の詳細

アセットが、開発からテスト、ステージングおよび本番環境に移行するとき、Oracle API Catalogが最新のエンドポイントを持つように、Oracle API Catalogにこれらのアセットを収集することもできます。Oracle API Catalogは、Oracle API Catalog内の既存のアセットの既存のエンドポイントを上書きします。WSDLがそのライフサイクルを通じてアセットを移動するように変更されている場合は、更新されたWSDLもOracle API Catalog内の既存のアセットに関連付けられます。

この項では、異なるサーバーのランタイム収集の詳細を説明します。この項には次のトピックが含まれます:

- 5.2.5.1項「Oracle SOA Suiteサーバーから収集する」

- 5.2.5.2項「WebLogicサーバーからWebサービスを収集する」

- 5.2.5.3項「Oracle Service BusからWebサービスを収集する」

- 5.2.5.4項「デプロイ済サービスの収集」

5.2.5.1 Oracle SOA Suiteサーバーから収集する

実行中のサーバーにデプロイしたOracle SOA Suiteプロジェクトがイントロスペクトされると、すべてのサービスがOracle API Catalog内のAPIアセットのコンポジットの結果によって公開されます。

Oracle SOA Suiteサーバーから収集するときには、次のWLSセキュリティ・ロールが必要になります。

- 管理

- オペレータ

- モニター

-remote_urlパラメータは、soa-infra管理対象サーバーのポートを指している必要があります。Oracle SOA Suiteでのデフォルト値は8001です。

soa-infra管理対象サーバーが起動して実行中である必要があります。収集では、リモート収集の一部としてのMDSデータベースに接続します。MDSデータベースが実行されており、収集が行われているマシンからアクセスできる必要があります。

SSL/HTTPプロトコルがサポートされます。ハーベスタは、t3プロトコルを介してサーバーのMBeanに接続します。

ハーベスタは、自動的に-remote_urlの値をランタイム・サーバーから収集されたアセットのDeployment URIプロパティに保存します。

Oracle SOA Suiteサーバーからの収集の例を次に示します。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_server_type SOASuite -remote_project MyComposite_rev1.0 -soa_partition default

Oracle SOA Suite 11gサーバーからの収集の例を次に示します。

harvest.bat -remote_url mysoasuiteserver:8001 -remote_username weblogic -remote_server_type SOASuite11g -remote_project MyComposite_rev1.0 -soa_partition default

セキュリティを確保するため、パスワードはコマンド行経由では渡さず、暗号化する必要があります。Oracle API Catalogとリモート・サーバーのパスワードを設定する唯一の方法は、ハーベスタ構成ファイル(HarvesterSettings.xml)に格納することです。パスワード暗号化ツール(encrypt.batまたはencrypt.sh)により、ファイルに格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第8章「パスワードの暗号化」を参照してください。

Oracle SOA Suiteサーバーは、実行時にコンポジットを分類するためにパーティションも実装しています。これによりハーベスタで、コンポジット名とともに、使用するパーティションを選択できます。HarvesterSettings.xmlファイル内のパラメータ名は、soaPartitionと呼ばれます。サンプルのHarvesterSettings.xmlファイルを次に示します。

<remoteQuery>
<serverType>SOASuite</serverType>
<projectName>MyComposite_rev1.0</projectName>
<uri>http://remotehost:8001/</uri>
<credentials>
<user>weblogic</user>
<password>password</password>
</credentials>
<soaPartition>partition_name</soaPartition>
</remoteQuery>

注意:
Oracle SOA Suite 11gでは、<servertype>要素をSOASuite11gに設定する必要があります。また、Oracle SOA Suite 11gサーバーから収集するときは、-remote_server_type SOASuite11gコマンド行引数を含める必要があります、

注意:
パーティションは、SOAサーバーのバージョン11g R1 PS2以降でのみ使用します。PS2よりも前のバージョンを使用する場合は、soaPartition要素をコメントにします。
デフォルトでは、ハーベスタは、「default」に設定されたpartition_nameオプションを使用して収集します。指定しない場合は、SOAのデプロイメントによる「default」パーティションが即時利用可能です。

注意:
SOA Suiteの異なるパーティションに同じコンポジットをデプロイできます。
そのような状況があり、その複数を収集する場合は、1つのAPIアセットのみがOACで作成され、最新の収集で連続的に上書きされます。

クラスタでのSOA Suiteコンポジットの収集

OHSサーバーは、ミドルウェア・ホームにWebTierラベルの一部としてデプロイされており、同様に、このミドルウェア・ホーム内で構成されたドメインに関連付けられています。

通常、OHSサーバーのmod_wl_2x.soのHTTPサーバー・モジュールに割り当てられている多数のURIがあり、そのいくつかを次に示します(OHSのmod_wl_ohs.confファイルからの引用で、外部で使用するために汎用的なものに変更しています)。

LoadModule weblogic_module

"/opt/Oracle/Middleware/wlserver_10.3/server/plugin/linux/x86_64/mod_wl_22.so"
<IfModule weblogic_module>
ConnectTimeoutSecs 10
ConnectRetrySecs 2
Debug ALL
WLLogFile /tmp/weblogic.log
DebugConfigInfo ON
WLSocketTimeoutSecs 2
WLIOTimeoutSecs 300
Idempotent ON
FileCaching ON
KeepAliveSecs 20
KeepAliveEnabled ON
DynamicServerList ON
WLProxySSL OFF
</IfModule>

<Location /soa-infra>
SetHandler weblogic-handler
WebLogicCluster slc01ese.example.com:23049,wls02.example.com:15980
</Location>
<Location  ~ "/bea_wls_internal/iiop/Client*">
SetHandler weblogic-handler
WebLogicCluster wls01.example.com:23049,wls02.example.com:15980
</Location>
<Location  ~ "/bea_wls_internal/HTTPClnt*">
SetHandler weblogic-handler
WebLogicCluster wls01.example.com:23049,wls02.example.com:15980
</Location>
<Location /console>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 19617
</Location>
<Location /em>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 19617
</Location>
<Location /bea_wls_internal>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 19617
</Location>
<Location /jndi>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 23049
</Location>
<Location /HTTPClnt>
SetHandler weblogic-handler
WebLogicHost wls01.example.com
WebLogicPort 23049
</Location>

これらの特別なURIパターンにより、JMSおよびJMXのリクエストは、OHSのWebLogicモジュールを介してルーティングできます。

コードに適用した変更以外は、SOAクラスタ化されたインストールに適用されたカスタマイズのみです。

5.2.5.2 WebLogicサーバーからWebサービスを収集する

Oracle Service Busのプロジェクトは、コマンド行からOracle API Catalogに発行できます。プロジェクトは、Export|Oracle Service Bus: Configuration jarコマンドを使用して、Oracle Service Bus Workshopからエクスポートする必要があります。

ハーベスタは、プロキシ・サービスとWSDLのアーティファクトを処理します。結果として生じたアセットは、APIアセット・タイプになります。

WebLogicサーバーから収集するときは、WebLogicサーバーのセキュリティ・ロールはなにも必要ありません。

-remote_urlパラメータは、WLS管理サーバーのポートを指している必要があります。Weblogicでのデフォルト値は7001です。WLS管理サーバーが起動して実行中である必要があります。SSL/HTTPプロトコルがサポートされます。ハーベスタは、t3プロトコルを介してサーバーのMBeanに接続します。

ハーベスタは、自動的に-remote_urlの値をランタイム・サーバーから収集されたアセットのDeployment URIプロパティに保存します。

5.2.5.3 Oracle Service BusからWebサービスを収集する

Oracle Service Busから収集するときには、Admin WLSのセキュリティ・ロールが必要になります。

Oracle Service BusからWebサービスを収集する場合は、OSBハーベスタを使用する必要があります。OSBハーベスタは、<FMW_HOME>/oer/tools/osbharvesterディレクトリにインストールされています。

OSBハーベスタは、osb-harvest.batまたはosb-harvest.shユーティリティを使用してコマンド行から実行できます。OSBハーベスタの構成の詳細は、5.2.2項「コマンド行でのハーベスタの構成」を参照してください。

注意:
osb-harvest.bat/.shユーティリティを使用してService Bus 11gサーバーから収集する場合、Service Bus 12cがインストールされている同じミドルウェア・ホームからService Busハーベスタを実行する必要があります。Service Busサーバーが11gであっても、ハーベスタにはService Bus 12cライブラリが必要です。これを実行するには様々な方法がありますが、最も簡単な方法は、Service Busハーベスタを既存のService Bus 12cサーバーにコピーすることです。
Service Bus 12cが別のクライアントまたは別のミドルウェア・ホームにインストールされている場合、この場所を記述するsetenv.shまたはsetenv.batスクリプトを更新できます。

Oracle Service Busドメインでは、-remote_urlパラメータはWLS管理サーバーのポートを指している必要があります。Weblogicでのデフォルト値は7001です。WLS管理サーバーが起動して実行中である必要があります。SSL/HTTPプロトコルがサポートされます。ハーベスタは、t3プロトコルを介してサーバーのMBeanに接続します。

ハーベスタは、自動的に-remote_urlの値をランタイム・サーバーから収集されたアセットのDeployment URIプロパティに保存します。

Oracle Service BusからのWebサービスの収集の例を次に示します。

osb-harvest.bat -remote_url myosbserver:7001 -remote_username weblogic -remote_server_type OSB -remote_project MyOSBProject

セキュリティを確保するため、パスワードはコマンド行経由では渡さず、暗号化する必要があります。Oracle API Catalogとリモート・サーバーのパスワードを設定する唯一の方法は、ハーベスタ構成ファイル(HarvesterSettings.xml)に格納することです。パスワード暗号化ツール(encrypt.batまたはencrypt.sh)により、ファイルに格納されているパスワードを暗号化できます。パスワードの暗号化の詳細は、第8章「パスワードの暗号化」を参照してください。

5.2.5.4 デプロイ済サービスの収集

SOA SuiteおよびService BusからのAPIの収集に加え、デプロイ済WSDLファイルへのURLを使用してデプロイ済サービスを収集することもできます。次の例は、インターネットから天気サービスを収集します。

./harvest.sh -file "http://example.com/WeatherWebService/Weather.asmx?WSDL"

この方法は、Oracle API Gateway(OAG)からセキュア・エンドポイントを収集するために使用できます。OAGからWSDL URLを取得するには、WebサービスのService Handlerの「WSDL」タブにあるゲートウェイにWSDLのクライアントへの公開を許可するチェック・ボックスを選択し、OAG Policy StudioでそのWSDLをクライアントに公開します。

5.2.6 オプションのハーベスタ構成の実行

オプションで、<Harvester Home>ディレクトリにあるXMLファイルHarvesterSettings.xml内の、次のような追加の構成設定を変更できます。

- <harvesterDescription>: 実行した収集についての説明。この情報は、Oracle API Catalogで作成されたアセットのHarvester Propertiesに格納されます。

- <harvesterVersion>: 実行したハーベスタのバージョン。この情報は、Oracle API Catalogで作成されたアセットのHarvester Propertiesに格納されます。

- <namespace>: 収集中に作成されたOracle API Catalogアセットの概要(アーティファクトではない)に追加されるネームスペース。ネームスペースは、重複の検出に使用されます。空のままにした場合、使用可能になったときに、Oracle SOA SuiteおよびOracle Service Busプロジェクトからの情報に基づいて設定されます。一般的には、これがベスト・プラクティスなので、注意してオーバーライドします。

- <workDir>: zipおよびjarファイルが解凍される一時ディレクトリ。デフォルトでは、システムの一時ディレクトリが使用されます。

5.2.7 ハーベスタのためのロギングの構成

ハーベスタは、実行した詳細タスクをlog4jを使用してロギングし、ログ・ファイルは<Harvester Home>ディレクトリに配置されます。ロギングのオプションは、<Harvester Home>ディレクトリにあるlog4fl.propertiesファイルを更新することで変更できます。

5.2.8 ハーベスタ内のトランザクション処理

デフォルトでは、ハーベスタはOracle API Catalogに対するすべての変更を単一のトランザクションで行います。ハーベスタ機能におけるトランザクション操作は、次の規則に基づいています。

- Oracle API Catalogサーバーは、一度に1つのトランザクションをサポートしています。トランザクションが開始できない場合は、そのことがハーベスタによって通知されます。

- トランザクションに関連づけられた一連のタイムアウトがあります。タイムアウトを超えた場合、ハーベスタの操作は終了します。

- cmee.extframework.impexp.monitor.rex.maxidleの設定は、クライアントとの接続が切断した場合における、トランザクションのキープ・アライブの最大時間を指定します。これにより、クライアント側のハーベスタ・プロセスが停止された場合に、トランザクションの取消しができます。

- cmee.extframework.impexp.monitor.maxruntimeの設定は、トランザクション全体にかかる時間の最大を指定します。

1つの操作がcmee.extframework.impexp.monitor.rex.maxidle(maxidle)の設定を超過すると、後続のすべての操作が失敗する可能性があります。その場合、ログの最後のエラーにはトランザクションが開始されていないため、ロールバックしようとしたときにエラーが発生しました。と記録されます。これは、トランザクション文がmaxidleを超過すると、トランザクションが自動的にロールバックされるためです。このため、クライアント・アプリケーションが強制的にロールバックを試行しても、トランザクションを使用できず、エラーが検出されます。その結果、ハーベスタの操作によるデータはOracle API Catalogには追加されません。

5.3 ハーベスタの追加情報の理解

この項では、ハーベスタの使用方法に関する追加情報を説明します。

この項には次のトピックが含まれます:

- 5.3.1項「ハーベスタで作成されたアセットのプレビュー」

- 5.3.2項「ベスト・プラクティス」

- 5.3.3項「既知の問題」

5.3.1 ハーベスタで作成されたアセットのプレビュー

ハーベスタで作成されたアセットを表示するため、プレビュー機能を使用できます。次のいずれかの方法でプレビュー機能を使用できます。

コマンド行を使用する

コマンド行またはAntタスクで「-preview true」を追加すると、ハーベスタが実行され、作成されるアセットのすべてのリストが表示されますが、実際には変更がコミットされません。

HarvesterSettings.xmlファイルを使用する

次のように、HarvesterSettings.xmlファイルでプレビュー・モードを設定することもできます。

<introspection preview="true">
<reader>com.oracle.oer.sync.plugin.reader.file.FileReader</reader>
<writer>com.oracle.oer.sync.plugin.writer.oer.OERWriter</writer>
</introspection>

5.3.2 ベスト・プラクティス

この項では、ハーベスタのベスト・プラクティスについて説明します。内容は次のとおりです。

- 5.3.2.1項「推奨される収集の権限」

- 5.3.2.2項「ネームスペースのパラメータをオーバーライドしない」

- 5.3.2.3項「WSDLファイル内のネームスペース」

5.3.2.1 推奨される収集の権限

管理者のロールを持つユーザーのみがアセットを収集できます。

5.3.2.2 ネームスペースのパラメータをオーバーライドしない

ハーベスタには、収集したアセットのプロジェクトのネームスペースを設定する機能があります。プロジェクトのネームスペースは、ネームスペースの異なるものは、異なるアセットになるように、重複するアセットの検出に使用されます。ほとんどの場合、このパラメータをオーバーライドしないことをお薦めします。

ただし、Oracle SOA SuiteまたはOracle Service Busからの収集時、これらの製品のプロジェクト名に基づいて、ハーベスタによりプロジェクトのネームスペースが自動的に設定されます。

これに従うことは、複数のソース(JDevおよびランタイム)から、同じプロジェクトとリビジョンを収集するとき、特に重要です。ネームスペースの変更またはオーバーライドは、OERのアセットの重複につながります。

5.3.2.3 WSDLファイル内のネームスペース

WSDLファイルの収集では、それぞれが一意のインタフェース、サービスおよびエンドポイントに、一意のネームスペースを使用することをお薦めします。

Oracle API Catalog内の既存アセットとの相関はQNameを介して行われるため、インタフェース、サービスまたはエンドポイントのアセットに大幅な変更を加え、QNameを変更しなかった場合、変更したアセットで既存のアセットを上書きすることになります。

表5-7に、Oracle API CatalogのアセットとWSDL構造の相関を示します。

表5-7 Oracle API CatalogのアセットとWSDL構造の相関

リポジトリのアセット

WSDL構造

サービス

/definition/service/@name

エンドポイント

/definition/service/port/@name

インタフェース

/definition/portType/@name

5.3.3 既知の問題

この項では、次のハーベスタの既知の問題について説明します。

- 5.3.3.1項 「サポートされているリモート・サーバーのタイプ」

- 5.3.3.2項「アセットのバージョニング」

- 5.3.3.3項「不適切な暗号化パスワードの使用」

- 5.3.3.4項「リポジトリ・オプションでの表示」

5.3.3.1 サポートされているリモート・サーバーのタイプ

現在、ハーベスタは、Oracle SOA Suite、Oracle Service BusおよびWebLogic 11gと12c上で実行中のWebLogic Serverプロジェクトへのリモート接続のみをサポートしています。

5.3.3.2 アセットのバージョニング

ハーベスタは、アーティファクトのイントロスペクト(WSDL、WADL、コンポジット)からアセット名を導出します。すでにOACに存在するアーティファクトを収集すると、ハーベスタによって既存のものが単に上書きされます。

しかし、アーティファクトになんらかの変更がある場合、サービス名プラスWSDLからのネームスペースというように、名前付けの規則が既存のものと同じであるときは、ハーベスタにより新規アセットが作成され、アセット名の末尾に「-2」、「-3」、「-4」といった番号が追加されます。

手動で、OACから古いアセットを削除し、新しいアセットの名前を変更できます。

5.3.3.3 不正な暗号化パスワードの使用

不正な暗号化パスワードでHarvesterSettings.xmlファイルを構成した場合、次に示すような、長いスタック・トレースが表示されます。

log4j:WARN No appenders could be found for logger
(org.apache.axis.i18n.ProjectResourceBundle).
log4j:WARN Please initialize the log4j system properly.
@ com.oracle.oer.sync.framework.MetadataIntrospectionException:
@ com.oracle.oer.sync.framework.MetadataIntrospectionException: Unable to read
plugin file:
C:\Drive-E\XU-harvest-tools\dec16\OER-Harvester\.\plugins\biz.introspector
at
@ com.oracle.oer.sync.framework.MetadataManager.init(MetadataManager.java:308)
@         at com.oracle.oer.sync.framework.Introspector.<init>
Introspector.java:188)
at
@ com.oracle.oer.sync.framework.Introspector.main(Introspector.java:395)
@ Caused by: com.oracle.oer.sync.framework.MetadataIntrospectionException:
Unable
to read plugin file:
C:\Drive-E\XU-harvest-tools\dec16\OER-Harvester\.\plugins\biz.introspector
at
@ com.oracle.oer.sync.framework.impl.DefaultPluginManager.processIntrospector(De
faultPluginManager.java:127)
at
@ com.oracle.oer.sync.framework.impl.DefaultPluginManager.<init>(DefaultPluginMa
nager.java:73)
at
@ com.oracle.oer.sync.framework.MetadataManager.init(MetadataManager.java:306)
... 2 more
Caused by: java.lang.IllegalArgumentException: The char '0x12' in
'java.lang.Ill
egalArgumentException: The char '0x12' in 'E/?&#8597;?&#8597;H?rd' is not a
valid XML character.' is not a valid XML character.
at
@ org.apache.axis.components.encoding.AbstractXMLEncoder.encode(Abstrac
tXMLEncoder.java:110)
at org.apache.axis.utils.XMLUtils.xmlEncodeString(XMLUtils.java:131)
at org.apache.axis.AxisFault.dumpToString(AxisFault.java:366)
at org.apache.axis.AxisFault.printStackTrace(AxisFault.java:796)
at
com.oer.log4j.spi.ThrowableInformation.getThrowableStrRep(Throw
ableInformation.java:42)
at
com.oer.log4j.spi.LoggingEvent.getThrowableStrRep(LoggingEvent.java:217)
at
com.oer.log4j.WriterAppender.subAppend(WriterAppender.java:298)
at
com.oer.log4j.RollingFileAppender.subAppend(RollingFileAppender.java:294
)
at com.oer.log4j.WriterAppender.append(WriterAppender.java:157)
at
com.oer.log4j.AppenderSkeleton.doAppend(AppenderSkeleton.java:251)
at
com.oer.log4j.helpers.AppenderAttachableImpl.appendLoopOnAppenders(Appen
derAttachableImpl.java:57)
at com.oer.log4j.Category.callAppenders(Category.java:255)
at com.oer.log4j.Category.forcedLog(Category.java:445)
at com.oer.log4j.Category.log(Category.java:882)
at
@ com.oracle.oer.sync.framework.logger.DefaultMetadataLogger.error(DefaultMetada
taLogger.java:98)
at
@ com.oracle.oer.sync.plugin.writer.oer.OERConnectionCache.getAuthToken(OERCon
nectionCache.java:138)
at
@ com.oracle.oer.sync.plugin.writer.oer.OERAssetQueries.getToken(OERAssetQueri
es.java:82)
at
@ com.oracle.oer.sync.plugin.writer.oer.OERAssetQueries.assetTypeQueryByUUID(AL
ERAssetQueries.java:159)
at
@ com.oracle.oer.sync.framework.MetadataManager.putAssetType(MetadataManager.jav
a:204)
at
@ com.oracle.oer.sync.framework.impl.DefaultPluginManager.processIntrospector(De
faultPluginManager.java:104)
... 4 more

5.3.3.4 リポジトリ・オプションでの表示

Oracle JDeveloper 12cから、リポジトリの表示をクリックするとJDeveloperにアセットの詳細が開きますが、それは読取り専用のもので、ページ内のリンクは動作しません。

回避するには、Oracle API Catalogコンソールにログインし、詳細情報のリンクをクリックします。

6 Oracle API CatalogでのAPIアセットのメタデータの編集

この章では、Oracle API Catalogで収集したAPIアセットのメタデータの編集、およびAPIアセットの公開について説明し、開発者のロールを持つユーザーがAPIを発見し、使用できるようにします。

APIアセットが収集されると、第5章「自動収集の構成と使用」の説明のとおり、キュレータまたは管理者のロールを持つOracle API Catalogユーザーは、そのメタデータを編集でき、開発者によるAPIの発見と理解を容易にできます。たとえば、キュレータがキーワードを追加して、特定のキーワードによる検索の際にアセットをより検出しやすくできます。キュレータはまた、収集され、Oracle API Catalogに追加された各APIの詳細な説明およびドキュメントへのリンクを追加できます。

この章で説明しているロールの詳細は、『Oracle Fusion Middleware Oracle API Catalogコンセプト・ガイド』のロール・ベースの機能に関する項を参照してください。

この章には、次のセクションがあります。

- APIアセットのメタデータの編集

- APIアセットの公開

- EasyLinkの使用

- アセットの削除

6.1 APIアセットのメタデータの編集

キュレータのロールを持つユーザーは、APIアセットを収集した後、メタデータを追加する必要があります。

APIアセットのメタデータを編集する手順は、次のとおりです。

1. メタデータを編集するAPIアセットを検索します。API検索の詳細は、『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』のアセットの検索に関する項を参照してください。

2. 「検索結果」ページのAPIをクリックし、その詳細ページを開きます。

3. 図6-1に示すように、「編集」アイコンをクリックします。APIのアセットの編集ページが表示されます。

図6-1 編集アイコン、API詳細ページ

注意:
APIアセットの詳細ページのすべての情報を編集できるわけではありません。たとえば、APIの技術的情報、WSDLサマリーおよびハーベスタ・プロパティは編集できません。

4. APIに関連する任意の新規メタデータを追加します(または、既存のメタデータを編集します)。
編集できるメタデータを次に示します。

- 名前: Oracle API Catalogに表示されるAPIアセットの名前。このフィールドは、ハーベスタにより自動的に移入されます。デフォルトの名前のままにしておく必要はありません。このAPIのための、わかりやすいものに変更できます。このフィールドは必須です。

- バージョン: APIアセットのバージョン。ハーベスタにより、コンポジットで検索した情報に基づいてデフォルトのバージョンが埋められます。コンポジットでバージョン情報が見つからない場合は、ハーベスタがデフォルトのバージョンを割り当てます。このAPIのための、わかりやすいものに変更できます。

- キーワード: ユーザーが検索結果でこのアセットを検索するために使用できるキーワード。platform=linuxなどの名前と値のペアを含めることもできます。各キーワードはカンマで区切ります。

注意:
「キーワード」フィールドに入力できる最大文字数は4000です。

- APIステータス: APIの公開ステータス。APIが初めて収集されたときに、デフォルトで「ドラフト」に設定されます。アセットを公開する場合は、開発者が検出できるように、リストから「公開」を選択します。APIアセットの公開の詳細は、6.2項「APIアセットの公開」を参照してください。

- アクティブ・ステータス: APIのアクティブ・ステータス。デフォルトで「アクティブ」が選択されます。APIをリタイアする場合は、「リタイア」を選択します。

注意:
APIをリタイアした場合、その公開ステータスに関係なく、開発者には検出されません。

- 説明: APIの機能の詳細な説明で、機能およびAPIの使用方法についての関連情報を含みます(セキュア・エンドポイントURLなど)。
説明フィールドにはHTMLタグを使用でき、リンクや連絡先などの新規要素を追加できます。たとえば、説明フィールドに<b>Contacts:</b>John Smith<br>を追加することで、John Smithという名前を含む、検索可能なContacts要素を追加できます。

このフィールドでHTMLタグを機能させるには、cmee.asseteditor.enable-embedded-html-asset-descriptionシステム設定を有効にする必要があります。

注意:
「説明」フィールドに入力できる最大文字数は4000です。

- ドキュメントURL: そのAPIについてのドキュメントのURL。単一のドキュメント、wikiページまたは複数のドキュメントへのリンクを集めた別のページにリンクできます。このURLは、APIアセットの詳細ページへのクリック可能なリンクになります。

- アイコン: 次のいずれかを選択します。

- アイコンURL: そのAPIに使用するアイコンを指すURL。アイコンのプレビューを表示するには、プレビューをクリックします。

- アイコンのアップロード: 「参照」をクリックし、APIに使用するローカル・マシン上のアイコンを参照します。

5. 「保存」をクリックして変更を保存します。

6.2 APIアセットの公開

収集されたAPIアセットは、開発者には検出できません。キュレータまたは管理者のロールを持つユーザーは、開発者にそれが見えるようにAPIを公開する必要があります。

APIを公開する手順は、次のとおりです。

1. 公開するAPIアセットを検索します。API検索の詳細は、『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』のアセットの検索に関する項を参照してください。

ヒント:
リストから「ドラフト」を選択すると、未公開のAPIのみが表示されます。

2. 「検索結果」ページのAPIをクリックし、その詳細ページを開きます。

3. 「編集」アイコンをクリックします。APIのアセットの編集ページが表示されます。

4. APIステータスのリストから「公開」を選択します。

5. 「保存」をクリックして変更を保存します。これで、開発者のロールを持つユーザーは、検索でこのアセットを検出できます。このAPIは、Oracle API Catalogのホームページの最近公開されたAPIセクションに表示されます。

6.3 EasyLinkの使用

API詳細ページにドキュメントまたは別のAPI詳細ページのリンクを追加する場合、EasyLinkが役立つ可能性があります。

図6-2に示すように、APIページにはEasyLinkアイコンが表示されます。このアイコンは、API詳細ページのURLを表示するポップアップ・ウィンドウを開くもので、クリップボードにコピーしたり、特定のAPIへのポインタとしてドキュメントや電子メール・メッセージに貼り付けたりできます。

図6-2 EasyLinkアイコン

API詳細ページにリンクを追加する手順は、次のとおりです。

1. リンクを作成するAPIの詳細ページに移動します。

2. EasyLinkアイコンをクリックします。

3. リンクを作成する場所にポップアップ・ウィンドウからURLを貼り付けます。

4. API詳細ページの「説明」フィールドへのリンクを追加する場合は、リンクにtarget="_blank"属性を追加し、新規タブで開くようにリンクを編集します。

6.4 アセットの削除

Oracle API Catalogでアセットを削除するには、次の手順を実行します。

注意:
管理者のロールを持つユーザーのみがOracle API Catalogからアセットを削除できます。

1. Oracle API Catalogから削除するAPIアセットの検索を実行します。

2. APIを削除するには:

- 「検索結果」画面からAPIを削除するには、削除する各APIの横のチェック・ボックスを選択し、「削除」をクリックします。この方法を使用して、一度に複数のAPIを削除できます。

- 詳細ページからAPIを削除するには、削除するAPIの詳細ページを開き、「削除」をクリックします。

第IV部

Oracle API Catalogの保護

この部では、セキュリティ・タスクについて説明します。

この部は、次の章で構成されています。

- 第7章「外部の認証ツールを使用するOracle API Catalogの構成」

- 第8章「パスワードの暗号化」

7 外部の認証ツールを使用するOracle API Catalogの構成

この章では、LDAP/Active Directoryなどの外部の認証ツールを使用したOracle API Catalogの認証方法について説明します。

この章には、次のセクションがあります。

- 7.1項「概要」

7.1 概要

この項では、Oracle API Catalogで、ユーザーを認証するためにLDAP/Active Directoryを使用する方法について説明します。

この項には次のトピックが含まれます:

- 7.1.1項「LDAP/Active Directory」

- 7.1.2項「LDAP統合システム・プロパティの有効化」

- 7.1.3項「LDAP/Active Directoryのプロパティの変更」

- 7.1.4項「セキュリティに関する考慮事項」

- 7.1.5項「LDAPプロパティの例」

7.1.1 LDAP/Active Directory

ユーザーの認証にLDAP/Active Directory(AD)を使用する場合、LDAP/Active Directoryサーバーを使用する前に、ユーザーの部署とロールの構成にいくつかの考慮が必要です。統合を有効にすると、すべてのユーザーがLDAP/ADを介して認証されます。そのためには、Oracle API Catalogのデータベース内に作成された、LDAP/ADからのユーザー名と一致する、少なくとも1つの管理者レベルのユーザー・アカウントが必要です。LDAP/ADが有効な場合も、Oracle API Catalog内の管理機能が実行できるように、このユーザー・アカウントには管理者のロールを割り当てる必要があります。

LDAP/ADからのロール同期が有効になっている場合は、少なくとも1つのユーザー・アカウントに管理者レベルのロールを割り当てる必要があります。ロール同期のオプションを使用する前に、Oracle API Catalog内でLDAPロールを作成し、適切なOracle API Catalogの権限を割り当てる必要があります。ロール名は名前のみで同期されます。管理者レベルのユーザーがLDAP/ADを使用してOracle API Catalogにログインする場合、当然、そのユーザーはアプリケーションを構成および管理できます。このユーザー・アカウントは、日常的な業務には使用しないでください。

7.1.2 LDAP統合システム・プロパティの有効化

この手順は、Oracle API Catalogの「管理」画面で実行します。

1. 左ペインの「システム設定」をクリックします。「システム設定」画面がメイン・ペインに表示されます。

2. システム設定の検索ボックスを使用すると、簡単に次の各設定を検索できます。

3. 検索ボックスにenterprise.authentication.ldap.enabledと入力します。値にTrueを設定し、「保存」をクリックします。
次に示すように設定を変更します。

- 未承認ユーザーのログイン

- Trueに設定します。

- プラグイン・ログイン・モジュールのクラス名

- テキスト・ボックスにcom.flashline.enterprise.authentication.server.loginmodule.LDAPLoginと入力します。

注意:
このプロパティにより、LDAPのオンとオフが切り替わります。有効にすると、アプリケーションはユーザー認証にLDAPサーバーを使用します。

4. 完了したら、「保存」をクリックします。

7.1.3 LDAP/Active Directoryのプロパティの変更

LDAP/ADのプロパティは次のように変更できます。

1. 左ペインの「システム設定」をクリックします。

2. システム設定の検索を使用すると、簡単に次の各設定を検索できます。次に示すように値を入力します。

- LDAPサーバーのホスト名

- テキスト・ボックスに、ホスト名またはディレクトリ・サーバーのIPアドレスを入力します。

- LDAPサーバーのポート番号

- テキスト・ボックスに389と入力します。

- LDAPマスク

- LDAPの場合はuid=^と入力します。
または

- Active Directoryの場合はsamAccountName=^と入力します。

- 未承認ユーザー・アカウントの作成

- Trueに設定します。

- ユーザーへのデフォルト・ロールの割当て

- Trueに設定します。

注意:
このプロパティにより、すべてのユーザー認証でデフォルトのロールが割り当てられます。

- 欠落しているロールの自動作成

- Trueに設定します。

注意:
このプロパティにより、LDAP/ADサーバーから同期してロールを作成しますが、そのロールには何も権限を割り当てません。

- 欠落している部署の自動作成

- Trueに設定します。

注意:
このプロパティにより、LDAP/ADサーバーから同期して部署を作成しますが、その部署には何も説明を割り当てません。ただし、ユーザーには新規ロールが割り当てられます。

- LDAPバージョン

- テキスト・ボックスに3と入力します。(サポートされるバージョンは2および3です)

- 管理者アカウントの識別名

注意:
このプロパティは、Active Directoryの使用に必須です。このプロパティには、少なくとも読取り専用ディレクトリのルックアップ権限を持つユーザー・アカウントのDNが含まれている必要があります。

例: CN=Some_User,CN=Users,DC=ad,DC=example,DC=com

- 管理者アカウントのパスワード

- テキスト・ボックスに、前述の管理者アカウントの識別名プロパティで識別される管理者アカウントのパスワードを入力します。

- SSL接続の使用

- Trueを設定し、LDAPのSSL接続を有効にします。デフォルト値はfalseです。

- 照会先を追跡する

- Trueに設定します。

- 管理者アカウントを使用してデータを取得する

- LDAP(該当する場合)では、Falseに設定します。

- Active Directoryまたは制限されたLDAP環境では、Trueに設定します。

- 検索を開始する場所

注意:
このプロパティには、ユーザー・レコードの検索を開始するディレクトリ・ツリー内の場所を定義します。

例:

- LDAPの場合: OU=MemberGroupB, O=en_us

- Active Directoryの場合: CN=Users,DC=ad,DC=example,DC=com

- 検索範囲

- リスト内のサブツリーを選択します。

注意:
このプロパティには、ユーザー・レコード検索の深さ(baseDNの下)を定義します。

- 検出したエントリを識別する属性名

注意:
このプロパティには、ツリー検索の有効範囲内でユーザー・アカウントを一意に識別する属性名を指定します。

- LDAPの場合: uid
または

- Active Directoryの場合: samAccountName

- 検出したエントリの電子メールの属性名

- mailと入力します。

- 検出したエントリの名前の属性名

- givenNameと入力します。

- 検出したエントリのミドルネームの属性名

- LDAPまたはActive Directoryからのミドルネーム属性を入力します(該当する場合)

- 検出したエントリの姓の属性名

- snと入力します

- 検出したエントリの電話番号の属性名

- telephoneNumberと入力します

- LDAPの部署を使用

- Trueに設定します。

注意:
このプロパティには、Oracle API Catalog内で同期されているユーザーの部署の属性値を定義します。

- 部署属性

- departmentと入力します

- LDAPのロールを使用

- Falseに設定します。

- ロール属性

- ユーザーのロール情報が含まれているLDAP/Active Directory属性を入力します。

- 第2レベルのルックアップ属性

注意:
このプロパティには、ユーザー情報を取得するための第2レベルのルックアップを識別する属性を定義します。その値はDNにする必要があります。第2レベルのルックアップのリダイレクトを使用している場合は、この第2のルックアップのベースDNを定義します。

3. 完了したら、「保存」をクリックします。

4. Oracle API Catalogアプリケーションを再起動します。

7.1.4 セキュリティ上の考慮事項

Oracle API CatalogのLDAP/Active Directoryコネクタを使用すると、Oracle API Catalogのユーザー認証およびロール割当てのためのユーザー識別の単一のソースとしてLDAPを動作させることができます。しかしこれは、Oracle API Catalogを介してファイルにアクセスするためのユーザー認証を、各ホストのリポジトリが管理することを妨げるものではありません。

Oracle API CatalogのLDAP/Active Directoryコネクタを使用すると、Oracle API Catalogは、ユーザーを認証するために、LDAPまたはActive Directoryに依存します。ユーザー名とパスワードの組合せは、バインド要求としてLDAPシステムに委任されます。ユーザーはバインド要求が成功した場合にのみ認証されます。

オプションとして、Oracle API Catalogのユーザー・ロールの割当てを格納または取得するようにLDAPを構成できます。この構成では、ユーザーがログインするたびに、Oracle API Catalogにより、LDAPに格納されているそのユーザーのロールと同期されます。ロールはLDAPを介して直接追加され、Oracle API Catalogでは管理されません。LDAP内のグループ·マッピングはOERでは使用されません。このオプションを使用するには、ldap.enable-synch-rolesシステム設定をTrueに設定する必要があります。ldap.rbac.roleAttribシステム設定は、ユーザーがOracle API Catalog内に持っているロール名を含む、複数値LDAP属性の名前に設定する必要があります。ldap.enable-synch-rolesシステム設定が有効に設定されていない場合、またはldap.rbac.roleAttribオプションで参照されているLDAP属性が構成されていない場合は、管理者が手動でOracle API Catalogにユーザーのロールを割り当てます。

7.1.4.1 ユース・ケースのサンプル・シナリオ

次のシナリオで、LDAPの設定および構成の選択を説明し、ユーザー管理のためのプロパティ設定を明らかにします。

シナリオ1

LDAP認証にもかかわらず、Oracle API Catalogへのユーザーのアクセスを防止します。アクセスは、アクティブなOracle API Catalogアカウントを持つ既存のユーザーのみに提供されます。

- 理由

- あらかじめユーザーのベースが定義されている非エンタープライズのライセンス契約では、アプリケーションに許可されるユーザーの数が限られます。

- プロパティ設定

- ldap.allow-user-creation

- Falseに設定します。

- enterprise.security.unapproveduser.allowlogin

- Falseに設定します。

シナリオ2

LDAP認証で、デフォルトのOracle API Catalogユーザー・アカウントを作成してデフォルトのロールを割り当てながら、Oracle API Catalogへのユーザーのアクセスを拒否します。

Oracle API Catalogでは、デフォルトのロールは開発者です。

- 理由

- 新規ユーザー・アカウントが作成されたことがセキュリティ管理者に通知されるまで、新規ユーザーのOracle API Catalogへのアクセスを拒否します。セキュリティ管理者に承認されると、ユーザーのステータスがOracle API Catalogへのログインが許可されるアクティブに変更されます。

- プロパティ設定

- ldap.allow-user-creation

- Trueに設定します。

- ldap.assign-default-roles

- Trueに設定します。

- enterprise.security.unapproveduser.allowlogin

- Falseに設定します。

シナリオ3

LDAP認証で、デフォルトのOracle API Catalogユーザー・アカウントがデフォルトのロールで作成され、ユーザーはOracle API Catalogへのログインを許可されます。

- 理由

- LDAP認証が新規ユーザーの作成に関する唯一の制限であるエンタープライズ・ライセンス契約。通常、LDAPアカウントでロールが事前定義されていない新規ユーザーのアクセスを制限するため、デフォルトのOracle Enterprise Repositoryのロールは開発者に設定されます。

- プロパティ設定

- ldap.allow-user-creation

- Trueに設定します。

- ldap.assign-default-roles

- Trueに設定します。

- enterprise.security.unapproveduser.allowlogin

- Trueに設定します。

7.1.5 LDAPプロパティの例

ディレクトリ・サーバーに匿名でバインドされている(認証されていない)間、Active Directoryの制限によりトップレベルより下のディレクトリの検索が防止されるため、Oracle API Catalogのユーザー情報のルックアップでは、「バインドDN」、「バインド・パスワード」および「管理者としてデータを取得」のプロパティに適切な値を設定する必要があります。表7-1に、LDAP/Active Directoryのプロパティとその例を示します。

表7-1 Active Directoryおよび従来のLDAPプロパティ

Active Directory

従来のLDAP(InetOrgPerson)

ldap.host

ad.example.com

ldap.host

ad.example.com

ldap.port

389

ldap.port

389

ldap.version

3

ldap.version

3

ldap.bindDN

CN=Some_User,OU=Users,DC=ad,DC=example,DC=com

ldap.bindDN

(匿名ルックアップが無効化されている場合は必須)

ldap.bindPassword

password

ldap.bindPassword

(匿名ルックアップが無効化されている場合は必須)

ldap.retrieve-data-as-admin

true

ldap.retrieve-data-as-admin

false(匿名ルックアップが無効化されている場合はTRUE)

ldap.mask

sAMAccountName=^

ldap.mask

uid=^

ldap.baseDN

CN=Users,DC=ad,DC=example,DC=com

ldap.baseDN

OU=MemberGroupB, O=en_us

ldap.scope

subtree

ldap.scope

one

ldap.uniqueIDAttrib

samAccountName

ldap.uniqueIDAttrib

uid

ldap.emailAttrib

mail

ldap.emailAttrib

mail

ldap.givennameAttrib

givenname

ldap.givennameAttrib

givenName

ldap.surnameAttrib

sn

ldap.surnameAttrib

sn

ldap.telephoneAttrib

telephonenumber

ldap.telephoneAttrib

telephoneNumber

ldap.deptAttrib

department

ldap.deptAttrib

department

表7-2に、カスタムおよび共通のLDAPプロパティを示します。

表7-2 カスタムおよび共通のLDAPプロパティ

カスタムおよび共通のプロパティ(実装の有無を問わず)

ldap.deptAttrib

department

ldap.rbac.roleAttrib

ロール

ldap.allow-user-creation

true

ldap.enable-synch-roles

true

ldap.enable-synch-depts

true

8 パスワードの暗号化

この章では、パスワードを暗号化する方法について説明します。

Oracle API Catalogでは、デフォルトでパスワードの暗号化が有効になっています。

この章には、次のセクションがあります。

- 8.1項「暗号化パスワードの生成」

- 8.2項「構成ファイルのパスワードの暗号化」

8.1 暗号化パスワードの生成

パスワードは、2つの異なる方法で暗号化でき、その1つはOracle API Catalogの「診断」ページを使用する方法で、もう1つはパスワード暗号化ツールを使用する方法です。暗号化パスワードを生成するには、次の手順を実行する必要があります。

1. Oracle API Catalogの「診断」ページにアクセスします。
http://host_name:port/application_name/diag/index.jspに移動します(host_nameは適切な場所に置き換えます)。

注意:
Oracle API Catalog 12cリリースでは、Oracle API Catalogの「診断」ページはデフォルトで無効化されています。
「診断」ページが現在無効化されていることを確認するには、http://host_name:port/application_name/diag/index.jspに移動します(host_nameは適切な場所に置き換えます)。「診断」ページが無効化されている場合、次のメッセージが表示されます。

現在、診断ページは無効化されています。Oracle Enterprise Repositoryの管理者に問い合せてください。

「診断」ページの有効化の詳細は、2.6項「Oracle API Catalogの診断ページへのアクセス」を参照してください。

2. 「ツール」セクションにスクロールして、パスワードの文字列の暗号化リンクをクリックし、パスワードの暗号化ページを表示します。

3. クリア・テキストのパスワードを暗号化する文字列テキスト・ボックスに入力します。

4. 「問合せの発行」ボタンをクリックします。

5. 暗号化されたパスワード文字列をコピーして、適切なコンテキスト・ファイルまたはプロパティ・ファイルに貼り付けます。

パスワードの暗号化ツールは、<FMW_HOME>/oer/modules/tools/solutions/12.1.3.0.0-OER-PasswordTools.zipにあります。12.1.3.0.0-OER-PasswordTools.zipファイルには、次の2つのスクリプトがあります(Windows用およびUnix用)。

- encrypt.bat/encrypt.sh - xmlの構成ファイルのパスワード要素を暗号化します

- encryptpassword.bat/encryptpassword.sh - コマンド行からの単一のパスワードを暗号化します

この項には次のトピックも含まれます。

- 8.1.1項「Oracle API Catalogのデプロイで使用される暗号化パスワード」

- 8.1.2項「その他のパスワード」

8.1.1 Oracle API Catalogのデプロイで使用される暗号化パスワード

暗号化パスワードの推奨される使用方法は次のとおりです。

- database.propertiesファイル内
データベースの接続パスワードです。

- Antタスクのプロパティ・ファイルまたはビルド・スクリプト
Oracle API Catalogユーザーがログイン時に使用するパスワードです。

- ハーベスタのHarvesterSettings.xml構成ファイル内
HarvesterSettings.xmlファイル内に格納されているパスワードです。

8.1.2 その他のパスワード

システム内のその他のパスワードは自動的に暗号化されます。この操作はユーザーには見えません。次のような、プロパティ・ファイルに格納されている多数のフィールドは、デフォルトで暗号化されています。

- ldap.bindPassword

- enterprise.guest.password

プロパティが編集され、保存されるときに、この暗号化が発生します。アップグレード中のパスワードの自動暗号化は、現時点では使用できません。

アーティファクト・ストアに格納されるパスワードは、暗号化された形式でデータベースに格納されます。

8.2 構成ファイルのパスワードの暗号化

セキュリティを確保するため、構成ファイル内のパスワードは暗号化する必要があります。次の説明に従って、構成ファイルのパスワードを暗号化する必要があります。

- 8.2.1項「ハーベスタの構成ファイル」

8.2.1 ハーベスタの構成ファイル

セキュリティを確保するため、ハーベスタの構成ファイル内のパスワードは暗号化する必要があります。パスワードの暗号化ツール(encrypt.bat/encrypt.sh)がoer/modules/tools/solutions/12.1.3.0.0-OER-PasswordTools.zipにあり、これにより、ハーベスタの構成ファイル(HarvesterSettings.xml)に格納されているパスワードを暗号化できます。

1. <Harvester Home>ディレクトリに移動します。

2. 次のように、コマンド・プロンプトからパスワード暗号化ツールを実行します。
> encrypt.bat HarvesterSettings.xml HarvesterSettings.xml

ここで

HarvesterSettings.xmlがハーベスタの構成ファイルです。

索引
A  B  C  D  E  F  G  H  I  K  L  M  O  P  R  S  T  U  V

A

システム設定へのアクセス, 3.1

Oracle Enterprise Repositoryの「診断」ページにアクセスする, 2.6

アーティファクト/製品とバージョンのマトリックス, 5.1.3

B

基本構成, 2

「部署」を参照

「概要」を参照

ベスト・プラクティス, 5.3.2

C

ハーベスタのコマンド行オプション, 5.2.2.2

Linux上でのOracle Enterprise Repository Web Startの構成, 2.7.3

自動収集の構成および使用, 5

ハーベスタのためのロギングの構成, 5.2.7

外部の認証ツールを使用するOracle Enterprise Repositoryの構成, 7

ハーベスタの構成, 5.2

コマンド行でのハーベスタの構成, 5.2.2

新規部門の作成, 2.2.1

新規ユーザーの作成, 2.4.1

D

単一セッションの削除, 2.5.2

複数セッションの削除, 2.5.3

部署, 2.2

「診断」ページ, 2.6

Java Web Startのダウンロードとインストール, 2.7.1

E

部署情報の編集, 2.2.2

ユーザー情報の編集, 2.4.4

LDAP統合システム・プロパティの有効化, 7.1.2

Oracle Enterprise Repositoryのデプロイで使用される暗号化パスワード, 8.1.1

エンタープライズ認証の設定, 3.4.3

Oracle Enterprise Repositoryからの項目のエクスポート, 4.4

F

fileSet, 5.2.3.2

機能設定, 3.4.1

G

暗号化パスワードの生成, 8.1

ハーベスタのスタートガイド, 5.1

「ベスト・プラクティス」を参照

「前提条件」を参照

「既知の問題」を参照

H

ハーベスタ, 5

ハーベスタの構成ファイル, 8.2.1

ハーベスタの機能, 5.1.2

Oracle SOA Suiteサーバーから収集する, 5.2.5.1

アーティファクトの収集, 5.3

Oracle Service BusからWebサービスを収集する, 5.2.5.3

WebLogicサーバーからWebサービスを収集する, 5.2.5.2

I

インポート・エクスポート・ツール, 4

インポート/エクスポート・ツール, 4.1

Oracle Enterprise Repositoryへの項目のインポート, 4.5

初期起動, 4.3.3

Java Web Startのインストール, 2.7

WLSTからのハーベスタの起動, 5.2.4

Repository.Submit Antタスクを使用したハーベスタの起動, 5.2.3

K

既知の問題, 5.3.3

L

Oracle Enterprise Repositoryからの起動, 4.3.1

LDAPプロパティの例, 7.1.5

LDAP/Active Directory, 7.1

「概要」を参照

「セキュリティに関する考慮事項」を参照

M

LDAP/Active Directoryのプロパティの変更, 7.1.3

設定のデータベースへの移動, 3.3

O

ハーベスタの入手, 5.2.1

その他のパスワード, 8.1.2

概要, 2.1, 7.1.1

P

repository.submit Antタスクのパラメータ, 5.2.3.1

オプションのハーベスタ構成の実行, 5.2.6

前提条件, 5.1.1

PDF経由でのアセット詳細の印刷, 3.4.1.2

R

RemoteProject, 5.2.3.2, 5.2.3.2

ロール, 2.3

Antからのハーベスタの実行, 5.2.3.3

ランタイム収集の詳細, 5.2.5

S

サンプルのparameter.propertiesファイル, 4.2.2.2

検索, 3.4.1.1

システム設定の検索, 3.2

セキュリティに関する考慮事項, 7.1.4

コマンド行での収集用にアーティファクトを選択する, 5.2.2.2

サーバー設定, 3.4.2

セッション, 2.5

「単一セッションの削除」を参照

「複数セッションの削除」を参照

「セッションの表示」を参照

コマンド行でのリポジトリ接続情報の設定, 5.2.2.1 ネストされた要素としてのパラメータの指定, 5.2.3.2 repository.Submit Antタスクのパラメータを指定する, 5.2.3.1 インポート/エクスポート・ツールの起動, 4.3 parameter.propertiesファイルのサポート対象パラメータ, 4.2.2.1 Oracle Enterprise Repository内のシステム設定, 3.4 システム設定の概要, 3

T

parameter.propertiesファイル, 4.2.2

ハーベスタ内のトランザクション処理, 5.2.8

Java Web Startのトラブルシューティング, 2.7.2

U

URI, 5.2.3.2

ユーザーの検索, 2.4.3

ユーザー, 2.4

EasyLinkの使用, 6.3

インポート/エクスポート・ツールの使用, 4.2

サード・パーティ・タスクの使用, 5.2.3.4

V

セッションの表示, 2.5.1

ユーザー情報の表示, 2.4.2

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

コピーライトについて

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

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

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

保証免責

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

制限付権利について

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

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 Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

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 Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

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

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

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

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

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、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を参照してください。