Oracle® Fusion Middleware

Oracle API Managerの使用

12c (12.2.1.1.0)

E79333-01(原本部品番号:E67927-02)

2016年8月

Oracle API Managerを紹介し、製品のインストールおよび管理方法と、APIのキュレート、検出および使用方法について説明します。

Oracle Fusion Middleware Oracle API Managerの使用, 12c (12.2.1.1.0)

E79333-01

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

原本著者: Oracle Corporation

原本協力著者:

原本協力者:

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

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

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

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の登録商標です。

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

目次

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

はじめに

- 対象読者

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

- 表記規則

第I部 Oracle API Managerの概要

1 Oracle API Managerの概要

- 1.1 Oracle API Managerとは

- 1.2 Oracle API Managerの機能について

- 1.3 Oracle API Managerのユーザー・ロールについて

- 1.4 Oracle API Managerのスタート・ガイド

第II部 Oracle API Managerのインストールと構成

2 Oracle API Managerのインストール

- 2.1 インストールの計画

- 2.1.1 製品の配布

- 2.1.2 動作保証、システム要件および相互運用性の確認

- 2.1.2.1 環境が動作保証要件を満たしていることの確認

- 2.1.2.2 動作保証情報を確認するためのシステム要件ドキュメントの使用

- 2.1.2.3 複数の製品間での相互運用性の確認

- 2.2 API Managerのインストールに必要なソフトウェアのインストール

- 2.2.1 動作保証されたJDKのインストール

- 2.2.2 動作保証されたデータベースのインストールと構成

- 2.2.3 Oracle Fusion Middleware 12c Infrastructureのインストール

- 2.3 Oracle API Managerソフトウェアのインストール

- 2.4 次のステップ

3 Oracle API Managerドメインの構成

- 3.1 データベース・スキーマの作成

- 3.1.1 動作保証されたデータベースのインストールと構成

- 3.1.2 リポジトリ作成ユーティリティ(RCU)の起動

- 3.1.3 スキーマ作成のためのRCU画面のナビゲート

- 3.1.3.1 RCUの概要

- 3.1.3.2 スキーマ作成の方法の選択

- 3.1.3.3 データベース資格証明の指定

- 3.1.3.4 カスタム接頭辞の指定とスキーマの選択

- 3.1.3.5 スキーマ・パスワードの指定

- 3.1.3.6 スキーマ作成の実行

- 3.2 WebLogicドメインの構成

- 3.2.1 構成ウィザードの起動

- 3.2.2 ドメインを構成するための「構成ウィザード」画面のナビゲート

- 3.2.2.1 ドメイン・タイプとドメイン・ホームの場所の選択

- 3.2.2.2 構成テンプレートの選択

- 3.2.2.3 アプリケーション・ホームの場所の選択

- 3.2.2.4 管理者アカウントの構成

- 3.2.2.5 ドメイン・モードとJDKの指定

- 3.2.2.6 データベース構成タイプの指定

- 3.2.2.7 JDBCコンポーネント・スキーマ情報の指定

- 3.2.2.8 JDBC接続のテスト

- 3.2.2.9 キーストアの構成

- 3.2.2.10 詳細な構成の選択

- 3.2.2.11 管理サーバーのリスニング・アドレスの構成

- 3.2.2.12 ノード・マネージャの構成

- 3.2.2.13 管理対象サーバーの構成

- 3.2.2.14 クラスタの構成

- 3.2.2.15 クラスタへの管理対象サーバーの関連付け

- 3.2.2.16 Coherenceクラスタの構成

- 3.2.2.17 新しいマシンの作成

- 3.2.2.18 サーバーのマシンへの割当て

- 3.2.2.19 構成の指定内容の確認とドメインの構成

- 3.2.2.20 ドメイン・ホームと管理サーバーURLの記録

- 3.3 サーバーの起動

- 3.3.1 ノード・マネージャの起動

- 3.3.2 管理サーバーの起動

- 3.3.3 管理対象サーバーの起動

- 3.4 次のステップ

4 Oracle API Managerでのユーザーの管理

- 4.1 ユーザーの管理

- 4.1.1 編集セッションの作成

- 4.1.2 API Managerロール用のグループの作成

- 4.1.3 API Managerユーザーの作成

- 4.1.4 グループへのユーザーの割当て

- 4.1.5 Monitors親グループへのグループの追加

- 4.1.6 Fusion Middleware Controlを使用したグループへのアプリケーション・ロールの割当て

- 4.1.7 編集セッションの解放

- 4.2 次のステップ

第III部 Oracle API Managerの使用

5 APIの作成

- 5.1 Oracle Service Busコンソールへのアクセス

- 5.2 APIとして公開するプロキシ・サービスの作成

- 5.3 セッションのアクティブ化

- 5.4 次のステップ

6 Oracle Service Busを使用したAPIのキュレートおよび公開

- 6.1 APIのメタデータの編集

- 6.2 APIステータスについて

- 6.3 APIのプライベート化

- 6.4 Oracle API Manager PortalへのAPIの公開

- 6.4.1 APIを管理対象とするか管理対象外とするかの決定

- 6.4.2 「公開済」へのAPIステータスの変更

- 6.5 API Manager PortalからのAPIの非公開化

- 6.6 APIの非推奨化

- 6.7 次のステップ

7 Oracle API Manager Portalの使用方法

- 7.1 Oracle API Manager Portalの概要

- 7.2 API Manager Portalへのアクセス

- 7.2.1 API Manager Portalへのサインイン

- 7.2.2 API Manager Portalからのログアウト

- 7.3 アプリケーションの管理

- 7.3.1 アプリケーションの作成

- 7.3.2 「サブスクリプション」ページからのAPIへのサブスクライブ

- 7.3.3 アプリケーションの説明の編集

- 7.3.4 API Manager Portalからのアプリケーションの削除

- 7.4 APIの検出

- 7.4.1 「カタログ」ページを使用したAPIの検索

- 7.4.2 APIの詳細の表示

- 7.4.3 API詳細ページに表示されるデータ

- 7.4.4 「カタログ」ページからのAPIへのサブスクライブ

- 7.5 サブスクリプションの表示

- 7.5.1 サブスクライブされているAPIの表示

- 7.5.2 特定のアプリケーションにサブスクライブされているAPIの表示

- 7.6 アプリケーションでのAPIの使用方法

- 7.6.1 管理対象APIと管理対象外APIの違いについて

- 7.6.2 管理対象外APIの使用方法

- 7.6.3 管理対象APIの使用方法

- 7.6.4 アプリケーションの権限キーの取得

- 7.6.5 APIのテスト

- 7.7 APIからのサブスクライブ解除

- 7.7.1 「サブスクリプション」ページの「API」パネルを使用したAPIからのサブスクライブ解除

- 7.7.2 「サブスクリプション」ページの「アプリケーション」パネルを使用したAPIからのサブスクライブ解除

- 7.8 次のステップ

8 Oracle API Managerの管理

- 8.1 「サブスクリプション」ページを使用したサブスクリプション統計の表示

- 8.1.1 ユーザーのサブスクリプションの表示

- 8.1.2 APIのサブスクリプション詳細の表示

- 8.1.3 クイック検索機能の使用方法

- 8.2 Oracle API Managerでの分析の表示

- 8.2.1 API分析の有効化

- 8.2.2 APIの単純な分析の表示

- 8.2.3 APIの詳細な分析の表示

- 8.2.4 API詳細ページに表示される分析データ

- 8.3 APIおよびAPIキュレーション・メタデータのインポートとエクスポート

- 8.3.1 環境からのエクスポート

- 8.3.2 キュレーション・メタデータをエクスポートするためのサンプル・スクリプト

- 8.3.3 環境へのインポート

- 8.3.4 キュレーション・メタデータをインポートするためのサンプル・スクリプト

はじめに

『Oracle Fusion Middleware Oracle API Managerの使用』では、Oracle API Managerを紹介し、製品のインストールおよび管理方法と、APIのキュレート、検出および使用方法について説明します。

対象読者

このマニュアルは、Oracle API Manager内のAPIのキュレータ、コンシューマおよび管理者、Oracle Service Busでプロキシ・サービスを作成する開発者、製品の知識を得ることに関心があるユーザーを対象としています。

ドキュメントのアクセシビリティ

Oracleのアクセシビリティへの取り組みについては、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を参照してください。

表記規則

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

表記規則

意味

太字

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

イタリック

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

固定幅フォント

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

第I部 Oracle API Managerの概要

第I部では、Oracle API Managerの概要について説明します。

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

- Oracle API Managerの概要

1 Oracle API Managerの概要

この章では、Oracle API Managerを紹介し、その機能について説明します。また、使用を開始するための次のステップも示します。

内容は次のとおりです。

- Oracle API Managerの概要

- Oracle API Managerの機能について

- Oracle API Managerのユーザー・ロールについて

- Oracle API Managerのスタート・ガイド

1.1 Oracle API Managerとは

Oracle API Managerを使用すると、バックエンド・システムや他のサービスの機能を公開するAPIの作成が容易になります。このようなAPIは、アプリケーション開発者によって使用するために公開され、実行時に管理およびモニターされます。

アプリケーションでアプリケーション・プログラミング・インタフェース(API)を使用することが増えています。このようなAPIは、レコードのエンタープライズ・システムにアクセスするように内部または外部のエンティティによって開発できます。使用可能なAPIの数は日々増えています。その使用量には、増え続けるモバイル機器やコンピューティング・プラットフォーム(Web、タブレット、スマートフォン、TV、車およびその他の家庭用機器、すなわちモノのインターネット)の数がかけられます。組織が作成し使用するAPIの数が増加するのにつれて、このようなAPIの管理や認識度はますます重要になります。

API Managerは、開発者がAPIとして公開されるWSDLベースのSOAPプロキシ・サービスおよびRESTプロキシ・サービスを作成できるスタンドアロンのOracle Service Busインスタンスとともにインストールされます。

注意:

非推奨のWLS 9ポリシーで構成されたプロキシ・サービスは、APIとして公開できません。

Service Bus 12.2.1で作成したネイティブRESTサービス(型付き/型なしの両方)は、サポートされていません。12.1.3形式のWSDLベースのRESTサービスのみが、APIとして公開できます。『Oracle Service Busでのサービスの開発』のJDeveloperを使用したService Bus用WSDLベースのRESTサービスの作成方法に関する項を参照して、このタイプのRESTサービスをService Bus 12.2.1で作成してください。

APIキュレータは、このようなサービスのうちのどれを管理対象とし、開発者に公開するかを決定します。次に、APIキュレータはメタデータを追加し、アプリケーション開発者がサブスクライブしたり、APIの使用に必要な情報を表示するAPI Manager PortalにAPIを公開します。管理ユーザーはAPI Manager Portalを使用して、使用状況メトリックや実行時のパフォーマンス分析をモニターできます。

API Managerの使用例およびAPIの管理ライフサイクルの説明は、「Oracle API Managerの機能について」を参照してください。

1.2 Oracle API Managerの機能について

API Managerでは、APIを作成して、ポータルに公開できます。また、目的のAPIを検索することもできます。さらに、アプリケーションを作成して、APIにサブスクライブすることもできます。

- APIの作成: Service Busの機能を使用して様々なバックエンド・サービスのためのAPIとして公開するプロキシ・サービスを作成します。
プロキシ・サービスの開発の詳細は、『Oracle Service Busでのサービスの開発』のAPIの作成に関する項、およびプロキシ・サービスの作成と構成に関する項を参照してください。

- 説明的なメタデータの追加とポータルへのAPIの公開: API Curatorロールを持つユーザーが説明的なメタデータをAPIに追加し、APIを管理対象とするかどうかを決定してAPI Manager PortalにAPIを公開します。
APIキュレーション・タスクの詳細は、「Oracle Service Busを使用したAPIのキュレートおよび公開」を参照してください。

- APIの検出と理解: API Consumerロールを持つユーザーがAPI Manager Portalを使用して興味があるAPIを検索し、そのメタデータを確認してAPIの機能を理解するためにテストします。
APIの検出とサブスクライブの詳細は、「APIの検出」を参照してください。

- アプリケーションの作成とAPIへのサブスクライブ: API Managerで組織のアプリケーションを表すアプリケーションを作成する必要があります。アプリケーションが作成されると、API Consumerロールを持つユーザーがAPIをアプリケーションにサブスクライブできます。
アプリケーションの管理の詳細は「アプリケーションの管理」を、APIへのサブスクライブの詳細は「「サブスクリプション」ページからのAPIへのサブスクライブ」を参照してください。

- 実行時のAPIへのアクセス: ユーザーが興味があるAPIにサブスクライブすると、エンドポイントURLおよび権限キーを使用して、(APIとして公開された)バンクエンド・サービスにアクセスできます。
APIの使用方法の詳細は、「アプリケーションでのAPIの使用方法」を参照してください。

- 分析を使用したAPIパフォーマンスの理解: API Adminロールを持つユーザーがサブスクリプション・データおよび各種実行時分析をAPI Manager Portalでモニターします。
APIの使用状況の統計およびパフォーマンス分析の表示の詳細は、「「サブスクリプション」ページを使用したサブスクリプション統計の表示」および「Oracle API Managerでの分析の表示」を参照してください。

この項で説明されているユーザー・ロールの詳細は、「Oracle API Managerのユーザー・ロールについて」を参照してください。

1.3 Oracle API Managerのユーザー・ロールについて

API Managerでは特定のロールが使用できます。また、一部のService BusロールもAPI Managerで使用できます。

次のロールは、API Managerで使用するために作成されています。

- API Curator: このロールを持つユーザーは、Service Busコンソールを使用して、プロキシ・サービスに関連付けられているメタデータをキュレートし、プロキシ・サービスをAPIとしてAPI Manager Portalに公開します。このロールを割り当てられたユーザーは、Service Busコンソールのリマインダへの読取り専用アクセス権を持つため、アーティファクト情報を表示できます。

- API Consumer: このロールを持つユーザーは、API Manager Portalを使用してAPIを表示、サブスクライブ、使用できます。また、管理対象APIの実行時メトリックも表示できます。このロールを割り当てられたユーザーは、Service Busコンソールにアクセスできません。

- API Admin: このロールを持つユーザーには、API Manager Portalの管理権限があります。API Adminユーザーは、ユーザーおよびAPIごとにAPI使用状況メトリック、分析情報、詳細なサブスクリプション情報を表示できます。このロールを割り当てられたユーザーは、Service Busコンソールにアクセスできません。

次のService BusロールもAPI Managerで使用されます。

- Developer: このロールを持つユーザーは、Service Busコンソールを使用して、API Manager PortalでAPIとして公開できるプロキシ・サービスを作成します。

- Administrator: このロールを持つユーザーには、Oracle WebLogic Serverへのフル・アクセス権に加えて、Service BusコンソールおよびAPI Manager Portalへのフル・アクセス権があります。このロールを割り当てられたユーザーは、API Manager Portalを使用してアセットにサブスクライブできません。

- Deployer: このロールを割り当てられたユーザーは、Service Busアーティファクトとキュレーション情報の両方を含め、APIのデプロイを担当します。このロールは、既存のDeployer Service Busロールにマップされ、キュレーション・メタデータのインポート/エクスポートをさらに担当します。

- Monitor: このロールを割り当てられたユーザーは、モニタリングを担当します。

既存のユーザー・ロールの詳細は、『Oracle Service Busの管理』の「Oracle Service Busのアクセス・セキュリティの定義」を参照してください。

API Managerでのユーザーの作成とそのユーザーへのロールの割当ての説明は、「Oracle API Managerでのユーザーの管理」を参照してください

1.4 Oracle API Managerのスタート・ガイド

API Managerをインストールして構成したら、Service BusでAPIをキュレートし、PortalでAPIを検出して使用します。また、その他の様々な管理タスクを実行します。

API Managerをインストールして構成するには、「Oracle API Managerのインストールと構成」の項目を参照してください。この部ではユーザーの作成についても説明します。

「Oracle API Managerのインストールと構成」で説明されているタスクを完了したら、Oracle Service Busを使用したAPIのキュレート、API Manager PortalによるAPIの検出および使用、API Managerの管理機能に関する各章について、「Oracle API Managerの使用」を参照してください。

第II部 Oracle API Managerのインストールと構成

ここでは、Oracle API Managerのインストール方法およびWebLogic ServerインスタンスへのAPI Managerのデプロイ方法について詳しく説明します。

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

- Oracle API Managerのインストール

- Oracle API Managerドメインの構成

- Oracle API Managerでのユーザーの管理

2 Oracle API Managerのインストール

この章では、Oracle API Managerソフトウェアのインストール方法について説明します。

内容は次のとおりです。

- インストールの計画

- API Managerのインストールに必要なソフトウェアのインストール

- Oracle API Managerソフトウェアのインストール

- 次のステップ

2.1 インストールの計画

この項では、ソフトウェアを取得する場所、システムが動作要件を満たしているかの確認、API Managerのインストールに必要なソフトウェアのインストールなど、Oracle API Managerをインストールする前に理解を深めておく必要がある項目について説明します。

2.1.1 製品の配布方法

Oracle API Managerソフトウェアは、Oracle Service Bus 12.2.1のインストール・ファイルを使用してインストールされます。次の場所にあるOracle Software Delivery CloudからOracle Service Bus 12.2.1インストール・ファイルを入手する必要があります。

https://edelivery.oracle.com/

注意:

インストール・ファイルをダウンロードする前に、ライセンス契約に同意する必要があります。

2.1.2 動作保証、システム要件および相互運用性の確認

ご使用の環境がインストールに必要な要件を満たしていることを確認するには、動作保証マトリックスおよびシステム要件のドキュメントをあわせて使用することをお薦めします。

- 環境が動作保証要件を満たしていることの確認

- 動作保証情報を確認するためのシステム要件ドキュメントの使用

- 複数の製品間での相互運用性の確認

2.1.2.1 環境が動作保証要件を満たしていることの確認

製品を、サポートされているハードウェアおよびソフトウェア構成上にインストールすることを確認してください。詳細は、Oracle Fusion Middlewareのサポートされるシステム構成ページで、ご使用のリリース向けの動作保証情報のドキュメントを参照してください。

Oracleは、動作保証されているすべてのシステムおよび環境で製品のパフォーマンスをテストおよび検証しており、新しい動作保証要件が確認されると、それらはすぐに適切な動作保証に関するドキュメントに追加されます。新しい動作保証要件は随時確認される場合があるため、動作保証に関するドキュメントはドキュメント・ライブラリの外部に置かれ、Oracle Technology Networkで提供されています。

2.1.2.2 動作保証情報を確認するためのシステム要件ドキュメントの使用

Oracle Fusion Middlewareのシステム要件と仕様に関するドキュメントを使用して、動作保証要件が満たされていることを確認してください。たとえば、ご使用の製品が64-BitのOracle Linux 6で動作保証されていることが動作保証情報のドキュメントに記載されている場合、そのOracle Linux 6システムが、ディスク領域、使用可能なメモリー、特定のプラットフォーム・パッケージとパッチおよびその他のオペレーティング・システム固有の項目などの最小要件を満たしていることをこのドキュメントで確認する必要があります。システム要件は随時更新されるため、システム要件情報のドキュメントは、ドキュメント・ライブラリとは別に作成され、Oracle Technology Networkで利用できます。

2.1.2.3 複数の製品間での相互運用性の確認

相互運用および互換性の理解には、相互運用性の定義、互換性の定義、および同一リリースまたは混在するリリースからなる複数のFusion Middleware製品を相互に使用する方法が説明されています。システムに複数のFusion Middleware製品をインストールする場合は、このドキュメントを読む必要があります。

2.2 API Managerのインストールに必要なソフトウェアのインストール

API Managerをインストールする前に、この項で説明されているタスクを完了して必要なソフトウェアをインストールする必要があります。動作保証されたJDKのインストール、動作保証されたデータベースのインストールと構成、およびOracle Fusion Middleware 12c Infrastructureのインストールが必要です。

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

- 動作保証されたJDKのインストール

- 動作保証されたデータベースのインストールおよび構成

- Oracle Fusion Middleware 12c Infrastructureのインストール

2.2.1 動作保証されたJDKのインストール

Oracle API Managerをインストールするには、インストーラを実行する前に、サポートされているJDKをシステムにダウンロードしてインストールする必要があります。

JDKは、Oracleホームの外部にインストールしてください。Oracle Universal Installerにより指定されたOracleホーム・ディレクトリが空であることが検証され、空のディレクトリが指定されていなければインストールは行われません。JDKをOracleホームにインストールした場合、今後の操作で問題が発生します。したがって、JDKのインストール場所は、/home/oracle/products/jdkディレクトリにすることをお薦めします。java -jarコマンドを使用して、インストーラJARファイルを実行できます。

このドキュメントが公開された時点では、Oracle Fusion Middleware製品にはJDK 8.0 Update 40以降が必要です。しかし、「動作保証、システム要件および相互運用性の確認」で説明されているように動作保証情報を参照して、必要なJDKバージョンを確認する必要があります。

必要なJDKをダウンロードするには、ブラウザを使用して次のURLに移動し、Java SE JDKをダウンロードします: http://www.oracle.com/technetwork/java/javase/downloads/index.html。

2.2.2 動作保証されたデータベースのインストールと構成

Oracle API Managerには、ドメイン構成の前にデータベース・スキーマが必要です。このようなスキーマをインストールできるデータベースがない場合は、動作保証されたデータベースをインストールして構成する必要があります。

オペレーティング・システムで動作保証されているデータベースを調べるには、Oracle Fusion Middlewareのサポートされるシステム構成ページで、ご使用のリリース向けの動作保証情報のドキュメントを参照してください。

スキーマ作成用にデータベースが適切に構成されていることを確認するには、Oracle Fusion Middlewareのシステム要件と仕様ドキュメントのOracle Repository Creation Utilityの要件の確認に関する項を参照してください。

注意:

12c (12.2.1)では、動作保証されたOracleデータベースのみがOracle Fusion Middleware Infrastructure標準インストール・トポロジに使用できます。

製品スキーマの作成の詳細は、次を参照してください。

- リポジトリ作成ユーティリティ(RCU)は、データベースにスキーマを作成するために使用するツールです。このツールはOracle Fusion Middleware Infrastructureをインストールすることで利用できます。詳細はOracle Fusion Middleware Infrastructureのインストールと構成を参照してください。

- Oracle API Managerで必要な具体的なスキーマと、そのスキーマの作成手順は、「データベース・スキーマの作成」を参照してください。

- Repository Creation Utilityの詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成を参照してください。

2.2.3 Oracle Fusion Middleware 12c Infrastructureのインストール

JDKをインストールし、動作保証されたデータベースをインストールして構成したら、Oracle WebLogic Serverインスタンスをインストールする必要があります。Oracle API Managerをインストールし、必要なデータベース・スキーマを作成したら、ドメインを構成してアプリケーションをWebLogicサーバー・インスタンスにデプロイします。

最新バージョンのOracle WebLogic ServerはOracle Fusion Middleware Infrastructureをインストールすることで利用できます。

注意:

Oracle WebLogic Serverをインストールするには、Java Required Files (JRF)が含まれているOracle Fusion Middleware 12c (12.2.1.0.0) Infrastructureインストーラを使用する必要があります。JRFは、WebLogic Serverのインストールには通常含まれていないコンポーネントで構成されており、Oracleビジネス・アプリケーションおよびアプリケーション・フレームワークで使用する共通の機能を提供します。

このインストーラを次に示すOracle Software Delivery Cloudから入手する必要があります。

https://edelivery.oracle.com/

別のインストーラを使用してWebLogic Serverをインストールすると、API Managerをインストールできません。

Oracle Fusion Middleware Infrastructureのインストールおよび構成の詳細は、Oracle Fusion Middleware Infrastructureのインストールと構成を参照してください。

2.3 Oracle API Managerソフトウェアのインストール

API Managerは、Oracle Service Bus 12.2.1のインストール時にインストールされます。API ManagerとOracle Service Busは、Oracle Fusion Middleware Infrastructureがインストールされている同じOracleホームにインストールする必要があります。

Service Busのインストールの詳細は、『Oracle Service Busのインストールと構成』のOracle Service Busのインストールの計画に関する項、およびOracle Service Busソフトウェアのインストールに関する項を参照してください。

API ManagerとOracle Service Busをインストールするには:

1. Oracle Software Delivery Cloud (https://edelivery.oracle.com/)からOracle Service Bus 12.2.1のインストールzipファイルを入手します。

a. Oracle Software Delivery Cloudにサインオンします。

b. 製品フィールドに「Oracle Service Bus」と入力します。

c. プラットフォームの選択をクリックし、製品をインストールするプラットフォームを選択して、選択をクリックします。

d. 続行をクリックします。

e. リリースのシリーズを展開して、Service Bus 12.2.1リリースのエントリのみを選択します。その他のオプションが選択されていないことを確認します。

f. 続行をクリックします。表示されたライセンス契約を確認し、確認したことを示すオプションを選択して、ライセンス条項を受諾してから、続行をクリックします。

g. すべてダウンロードをクリックして、Service Bus 12.2.1のインストールzipをダウンロードします。

2. インストールzipファイルの内容をローカル・ディレクトリに解凍します。解凍されたディレクトリにインストールファイルの fmw_12.2.1.0.0_osb.jarが含まれていることを確認します。

3. 『Oracle Service Busのインストールと構成』の次に関する各項で説明されているタスクを確認および完了します。

- インストール・チェックリストの確認

- インストール・プログラムの起動

- インストール画面への移動

- インストールの確認

この時点で、API Managerソフトウェアのインストールは完了です。

注意:

Oracle Service BusをWebLogic Serverドメインにデプロイする必要はありません。「Oracle API Managerドメインの構成」で説明されているように、Service Busドメイン・テンプレートはAPI Managerドメイン構成の一部として選択されてデプロイされます。

API Managerドメインによる既存のService Busドメインの拡張はこのリリースではサポートされません。

2.4 次のステップ

次のステップには、API Managerに必要とされるデータベース・スキーマの作成と、Oracle WebLogic Serverの構成が含まれます。

「Oracle API Managerドメインの構成」を参照して、必要なタスクを完了します。

3 Oracle API Managerドメインの構成

この章では、Oracle API Manager用のWebLogic Serverドメインを作成および構成する方法について説明します。

この章が終わるまでに、Oracle API Manager用のデータベース・スキーマが作成され、単一のホストに1つのクラスタと2つの管理対象サーバーを備えたOracle WebLogicドメインが構成されます。

内容は次のとおりです。

- データベース・スキーマの作成

- WebLogicドメインの構成

- サーバーの起動

- 次のステップ

3.1 データベース・スキーマの作成

Oracle API Managerドメインを構成するには、このリリースのOracle API Managerでの使用が保証されているデータベースに必要なスキーマをインストールする必要があります。

これらのスキーマを、この項の手順に従ってインストールします。

- 動作保証されたデータベースのインストールおよび構成

- リポジトリ作成ユーティリティ(RCU)の起動

- RCU画面からスキーマ作成へのナビゲート

3.1.1 動作保証されたデータベースのインストールと構成

動作保証されたデータベースを適切にインストールして構成し、そのデータベースを起動して稼働させておく必要があります。

詳細は、『Oracle Fusion Middlewareのインストールのプランニング』の「データベースおよびデータベース・スキーマのインストール」を参照してください。

3.1.2 リポジトリ作成ユーティリティ(RCU)の起動

リポジトリ作成ユーティリティ(RCU)を起動するには:

1. ご使用のシステムのORACLE_HOME/oracle_common/binディレクトリに移動します。

2. RCUを起動します。

UNIXオペレーティング・システムの場合:

./rcu

Microsoft Windowsオペレーティング・システムの場合:

rcu.bat

3.1.3 RCU画面からスキーマ作成へのナビゲート

この項の説明に従って、Oracle API Manager用のスキーマを作成します。

- RCUの概要

- スキーマ作成の方法の選択

- データベース資格証明の指定

- カスタム接頭辞の指定とスキーマの選択

- スキーマ・パスワードを指定

- スキーマ作成の実行

3.1.3.1 RCUの概要

「次へ」をクリックします。

3.1.3.2 スキーマ作成の方法の選択

対象のデータベースに対するDBAアクティビティの実行に必要なパーミッションと権限が付与されている場合は、「システム・ロードおよび製品ロード」を選択します。この手順は、必要な権限が付与されていることを前提としています。

データベースに対するDBAアクティビティの実行に必要なパーミッションまたは権限が付与されていない場合は、この画面で、「システム・ロードに対するスクリプトの準備」を選択する必要があります。このオプションにより、SQLスクリプトが生成されます。このスクリプトをデータベース管理者に提出してください。リポジトリ作成ユーティリティを使用したスキーマの作成のシステム・ロードおよび製品ロードの理解に関する項を参照してください。

3.1.3.3 データベース資格証明の指定

RCUがデータベースに接続できるようにするために、データベース接続の詳細を指定します。次の情報を指定する必要があります。

- データベース・タイプ

- ホスト名

- ポート

- サービス名

- ユーザー名

- パスワード

- ロール

「次へ」をクリックして先に進み、データベースへの接続が成功したことを確認するダイアログ・ウィンドウで、「OK」をクリックします。

3.1.3.4 カスタム接頭辞の指定とスキーマの選択

「接頭辞の新規作成」を選択して、「SOA Suite」スキーマを選択します。これにより、自動的に「SOAインフラストラクチャ」が選択され、同時に次のスキーマが依存関係として選択されます。

- Metadata Services

- 監査サービス

- 監査サービスへの追加

- 監査サービス・ビューア

- Oracle Platform Security Services

- ユーザー・メッセージング・サービス

- WebLogicサービス

共通インフラストラクチャ・サービスというスキーマも自動的に作成されます。このスキーマは、グレー表示されていて選択することも選択解除することもできません。このスキーマを使用すると、ドメインの構成中にRCUから情報を取得できるようになります。詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成のサービス表スキーマの理解に関する項を参照してください。

カスタム接頭辞は、これらのスキーマを論理的にグループ化して、このドメイン内でのみ使用することを目的としています。複数のドメイン間でのスキーマの共有はサポートされていないため、ドメインごとに固有のスキーマのセットを作成する必要があります。

ヒント:

カスタム接頭辞の詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成でカスタム接頭辞の理解に関する項を参照してください。

マルチドメイン環境のスキーマを構成する方法の詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成のスキーマの作成計画に関する項を参照してください。

ヒント:

ここに入力するカスタム接頭辞は、メモしておく必要があります。このカスタム接頭辞は、後述するドメイン作成のプロセスで必要になります。

「次へ」をクリックして先に進み、スキーマ作成の前提条件チェックが成功したことを確認するダイアログ・ウィンドウの「OK」をクリックします。

3.1.3.5 スキーマ・パスワードを指定

スキーマのパスワードをデータベースに設定する方法を指定してから、パスワードの指定と確認を行います。

ヒント:

この画面で設定するパスワードは、メモしておく必要があります。このパスワードは、後述するドメイン作成のプロセスで必要になります。

3.1.3.6 スキーマの作成の実行

RCU画面の残りの部分を先に進めて、スキーマ作成を完了します。「完了サマリー」画面に到達したら、「閉じる」をクリックしてRCUを終了します。

RCUおよびその機能と概念については、リポジトリ作成ユーティリティを使用したスキーマの作成を参照してください

3.2 WebLogicドメインの構成

この項では、構成ウィザードを使用してWebLogicドメインを作成するための指示について説明します。

ドメイン作成に使用可能なその他の方法の詳細は、『構成ウィザードによるWebLogicドメインの作成』のWebLogicドメインの作成、拡張および管理のための追加ツールに関する項を参照してください。

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

- 構成ウィザードの起動

- ドメインを構成するための構成ウィザード画面への移動

3.2.1 構成ウィザードの起動

ドメインの構成を開始するには、ORACLE_HOME/oracle_common/common/binディレクトリに移動して、WebLogic Server構成ウィザードを起動します。

UNIXオペレーティング・システムの場合:

./config.sh

Microsoft Windowsオペレーティング・システムの場合:

config.cmd

Windowsオペレーティング・システムでは、「スタート」メニューから「すべてのプログラム」を選択し、「Oracle」、「OracleHome」、「WebLogic Server 12c (12.1.3)」、「ツール」、「構成ウィザード」の順に選択することで構成ウィザードを起動することもできます。

3.2.2 ドメインを構成するための構成ウィザード画面のナビゲート

この項の説明に従って、ドメインを作成して構成します。

注意:

API Managerドメインによる既存のService Busドメインの拡張はこのリリースではサポートされません。この項で説明されているように、API Managerドメイン構成テンプレートを使用して新しいドメインを作成する必要があります(Service Busもデプロイする)。

- ドメイン・タイプとドメイン・ホームの場所の選択

- 構成テンプレートの選択

- アプリケーション・ホームの場所の選択

- 管理者アカウントの構成

- ドメイン・モードとJDKの指定

- データベース構成タイプの指定

- JDBCコンポーネント・スキーマ情報の指定

- JDBC接続のテスト

- キーストアの構成

- 詳細な構成の選択

- 管理サーバーのリスニング・アドレスの構成

- ノード・マネージャの構成

- 管理対象サーバーの構成

- クラスタの構成

- クラスタへの管理対象サーバーの関連付け

- Coherenceクラスタの構成

- 新しいマシンの作成

- サーバーのマシンへの割当て

- 構成の指定内容の確認とドメインの構成

- ドメイン・ホームと管理サーバーURLの記録

3.2.2.1 ドメイン・タイプとドメイン・ホームの場所の選択

「構成タイプ」画面で、「新規ドメインの作成」を選択します。

「ドメインの場所」フィールドで、使用するドメイン・ホーム・ディレクトリを指定します。

Oracle Fusion Middlewareの理解のOracle Fusion Middlewareの主要ディレクトリに関する項にまとめられているディレクトリ構造(Oracleホーム・ディレクトリの外部にドメイン・ホームがある)に従って、ドメイン・ホームを配置することをお薦めします。このディレクトリ構造は、ソフトウェアのアップグレードや再インストールが必要になったときに問題を回避するために役立ちます。

ヒント:

ドメイン・ホーム・ディレクトリの詳細は、Oracle Fusion Middlewareのインストールのプランニングのドメイン・ホームの選択に関する項を参照してください。

この画面に示されるその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の構成タイプに関する項を参照してください。

3.2.2.2 構成テンプレートの選択

「テンプレート」画面では、「製品テンプレートを使用してドメインを作成」が選択されていることを確認し、次のテンプレートを選択します。

- Oracle API Manager - 12.2.1. [osb]
このテンプレートを選択すると、次の依存関係も選択されます。

- Basic WebLogic Server Domain - 12.2.1. [wlserver]

- Oracle Service Bus - 12.2.1 [osb]

- WebLogic Advanced Web Services for JAX-PRC Extension - 12.2.1 [wlserver]

- ODSI XQuery 2004 Components - 12.2.1 - [oracle_common]

- Oracle Enterprise Manager - 12.2.1 [em]

- Oracle WSM Policy Manager - [oracle_common]

- Oracle JRF - 12.2.1 [oracle_common]

- WebLogic Coherenceクラスタの拡張 - 12.2.1 [wlserver]

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のテンプレートに関する項を参照してください。

3.2.2.3 アプリケーション・ホームの場所の選択

「アプリケーションの場所」画面では、ドメインに関連付けられたアプリケーションを格納する場所を選択します。この場所は、アプリケーション・ホーム・ディレクトリとも呼ばれます。

Oracle Fusion Middlewareの理解のOracle Fusion Middlewareの主要ディレクトリに関する項にまとめられているディレクトリ構造(Oracleホーム・ディレクトリの外部にアプリケーション・ホームがある)に従って、アプリケーション・ホームを配置することをお薦めします。このディレクトリ構造は、ソフトウェアのアップグレードや再インストールが必要になったときに問題を回避するために役立ちます。

ヒント:

アプリケーション・ホーム・ディレクトリの詳細は、Oracle Fusion Middlewareのインストールのプランニングのアプリケーション・ホームの選択に関する項を参照してください。

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のアプリケーションの場所に関する項を参照してください。

3.2.2.4 管理者アカウントの構成

「管理者アカウント」画面では、ドメインに対するデフォルトのWebLogic管理者アカウントにユーザー名とパスワードを指定します。

この画面で設定したユーザー名およびパスワードを書き留めておくことをお薦めします(これらの資格証明は、後でドメインの管理サーバーを起動して接続する際に必要になります)。

3.2.2.5 ドメイン・モードとJDKの指定

「ドメイン・モードおよびJDK」画面では、次の操作を実行します。

- 「ドメイン・モード」フィールドで、「本番」を選択します。

- 「JDK」フィールドで「Oracle Hotspot JDK」を選択します。

「本番モード」をこの画面で選択すると、環境で高度なセキュリティが実現され、アプリケーションのデプロイと管理サーバーの起動でユーザー名とパスワードが必要になります。

ヒント:

開発モードと本番モードの違いなど、この画面のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のドメイン・モードとJDKに関する項を参照してください。

本番モードでは、起動アイデンティティ・ファイルを作成することで、管理サーバーの起動時に必要なユーザー名とパスワードの指定を省略できます。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の管理サーバー用の起動アイデンティティ・ファイルの作成に関する項を参照してください。

3.2.2.6 データベース構成タイプの指定

「RCUデータ」を選択して、この画面に示されるフィールドをアクティブ化します。「RCUデータ」オプションは、構成ウィザードにデータベースとサービス表(STB)スキーマに接続して、ドメインの構成に必要なスキーマに関するスキーマ情報を自動的に取得するように指示します。

注意:

この画面の「手動構成」を選択した場合は、「JDBCコンポーネント・スキーマ」画面でスキーマのパラメータを手動で入力する必要があります。

「RCUデータ」を選択してから、次の各フィールドに入力します。

フィールド

説明

DBMS/サービス

データベースのDBMS名(サービス・タイプ・ドライバを選択している場合はサービス名)を入力します。

ホスト名

データベースをホストするサーバーの名前を入力します。

ポート

データベースがリスニングするポート番号を入力します。

スキーマ所有者

スキーマ・パスワード

データベースのサービス表スキーマに接続するためのユーザー名とパスワードを入力します。これはRCUの「スキーマ・パスワード」画面でサービス表コンポーネントに指定したスキーマ(「データベース・スキーマの作成」を参照)のユーザー名およびパスワードです。

デフォルトのユーザー名はprefix_STBであり、この場合prefixはRCUで定義したカスタム接頭辞です。

データベース接続情報の指定が完了したら、「RCU構成の取得」をクリックします。操作に成功すると、「接続結果ログ」に次の出力が示されます。

Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK

Successfully Done.

ヒント:

「RCUデータ」オプションの詳細は、リポジトリ作成ユーティリティを使用したスキーマの作成のサービス表スキーマの理解に関する項を参照してください。

この画面のその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のデータ・ソース・デフォルトに関する項を参照してください

3.2.2.7 JDBCコンポーネント・スキーマ情報の指定

ドメインを作成する製品に関連付けられるJDBCコンポーネント・スキーマは、画面の下半分にリスト表示されます。

スキーマの名前の横のチェック・ボックスを選択して、データ・ソース設定を指定するスキーマを選択します。

「データベース・スキーマの作成」で作成したデータベース・スキーマの情報を画面の上部の各フィールドに入力します。

フィールド

説明

ベンダー

データベースのベンダーを選択します。

ドライバ

データベースへの接続に使用するJDBCドライバを選択します。リストには、選択したデータベース・ベンダーでよく使用されるJDBCドライバが含まれています。

DBMS/サービス

データベースのDBMS名(サービス・タイプ・ドライバを選択している場合はサービス名)を入力します。

ホスト名

データベースをホストするサーバーの名前を入力します。

ポート

データベースのホストになるサーバーへの接続に使用するポート番号を入力します。

スキーマ所有者

データベースのOracle API Managerスキーマに接続するためのユーザー名を入力します。これはRCUの「スキーマ・パスワード」画面で指定したスキーマ(「データベース・スキーマの作成」を参照)のユーザー名です。

デフォルトのユーザー名はprefix_STBであり、この場合prefixはRCUで定義したカスタム接頭辞です。

スキーマ・パスワード

データベースのスキーマに接続するためのパスワードを入力します。これはRCUの「スキーマ・パスワード」画面でサービス表コンポーネントに指定したパスワードです(「データベース・スキーマの作成」を参照)。

ヒント:

この画面のその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の「JDBCコンポーネント・スキーマ」に関する項を参照してください。

3.2.2.8 JDBC接続のテスト

「JDBCコンポーネント・スキーマ」画面に示される値が、すべてのスキーマに対して適切であることを確認します。前の画面で「RCUデータ」を選択した場合、スキーマ表はすでに適切に移入されている必要があります。

ヒント:

この画面のその他のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のコンポーネント・スキーマのテストに関する項を参照してください

3.2.2.9 キーストアの構成

デフォルトのAPI Manager構成の場合、「キーストア」画面では何も構成する必要はありません。「次へ」をクリックします。

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のキーストアに関する項を参照してください。

3.2.2.10 詳細な構成の選択

目的のトポロジに応じたドメインの構成を完了するには、「拡張構成」画面で次のオプションを選択します。

- 管理サーバー
これは、管理サーバーのリスニング・アドレスを適切に構成するために必要です。

- ノード・マネージャ
これは、ノード・マネージャを構成するために必要です。

- 管理対象サーバー、クラスタおよびCoherence
これは、Oracle API Manager管理対象サーバーを構成するために必要です。

3.2.2.11 管理サーバーのリスニング・アドレスの構成

「管理サーバー」画面で、「リスニング・アドレス」の横にあるドロップダウン・リストを選択し、管理サーバーが存在するホストのIPアドレスを選択します。「すべてのローカル・アドレス」は使用しないでください。

管理サーバーにサーバー・グループは指定しないでください。

3.2.2.12 ノード・マネージャの構成

「ノード・マネージャ」画面は、構成するノード・マネージャのタイプと、そのノード・マネージャの資格証明を選択するために使用できます。

ノード・マネージャのタイプとして「ドメインごとのデフォルトの場所」を選択して、ノード・マネージャの資格証明を指定します。

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のノード・マネージャに関する項を参照してください。

ノード・マネージャのタイプの詳細は、『Oracle WebLogic Serverノード・マネージャの管理』でノード・マネージャの概要に関する項を参照してください。

3.2.2.13 管理対象サーバーの構成

「管理対象サーバー」画面で、osb_server1という名前の新しい管理対象サーバーを作成します。

1. 「リスニング・アドレス」ドロップダウン・リストで、管理対象サーバーを配置するホストのIPアドレスを選択します。「すべてのローカル・アドレス」は使用しないでください。「サーバー・グループ」でOSB-MGD-SVRS-COMBINEDが選択されていることを確認します。

Service Busサーバーとは異なるサーバーにOWSMPMを配置する場合、OSB-MGD-SVRS-ONLYを選択します。これにより、サーバーにはService Busのみがターゲット設定され、OWSMPMはターゲット設定されません。

2. 「追加」をクリックし、この手順を繰り返して、osb_server2という名前の2番目の管理対象サーバーを作成します。

2番目の管理対象サーバーの構成は、高可用性の標準トポロジを構成するために必要な手順の1つです。高可用性環境を作成しない場合、この手順はオプションになります。

高可用性の標準トポロジの詳細は、『高可用性ガイド』のFusion Middleware標準HAトポロジの理解に関する項を参照してください。

これらのサーバー名は、このドキュメント全体で引用されるため、別の名前を選択したときには、それらの名前を必要に応じて置換してください。

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の管理対象サーバーに関する項を参照してください。

3.2.2.14 クラスタの構成

「クラスタ」画面を使用して、新しいクラスタを作成します。

1. 「追加」をクリックします。

2. 「クラスタ名」フィールドにapimgr_cluster1と指定します。

3. 「クラスタ・アドレス」フィールドは、空白のままにしておきます。

デフォルトでは、クラスタ内のサーバー・インスタンスは、ユニキャストを使用して相互に通信します。マルチキャストを使用するようにクラスタの通信を変更する場合は、『Oracle WebLogic Serverクラスタの管理』のユニキャストまたはマルチキャストを選択する際の考慮事項に関する項を参照してください。

新しいクラスタは、Fusion Middleware Controlを使用して作成することもできます。この場合、クラスタ通信(ユニキャストまたはマルチキャスト)は、新しいクラスタの作成時に構成できます。詳細は、『Oracle WebLogic Server Administration Consoleオンラインヘルプ』のクラスタの作成と構成に関する項を参照してください。

ヒント:

この画面のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のクラスタに関する項を参照してください。

3.2.2.15 クラスタへの管理対象サーバーの関連付け

「サーバーのクラスタへの割当」画面を使用して、osb_server1とosb_server2を新しいクラスタapimgr_cluster1に割り当てます。

1. 「クラスタ」ペインで、サーバーを割り当てるクラスタ(ここではapimgr_cluster1)を選択します。

2. 「サーバー」ペインで、次のいずれかを実行して、osb_server1をapimgr_cluster1に割り当てます。

- osb_server1を1回クリックして選択し、右矢印をクリックして「クラスタ」ペイン内の選択したクラスタ(apimgr_cluster1)の下に移動します。

- osb_server1をダブルクリックして、「クラスタ」ペイン内の選択したクラスタ(apimgr_cluster1)の下に移動します。

3. 繰り返して、osb_server2をapimgr_cluster1に割り当てます。

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のサーバーのクラスタへの割当てに関する項を参照してください。

3.2.2.16 Coherenceクラスタの構成

「Coherenceクラスタ」画面を使用して、ドメインに自動的に追加されるCoherenceクラスタを構成します。Coherenceクラスタのリスニング・ポートとして、デフォルトのポート番号の0をそのまま使用します。

注意:

ユニキャストのリスニング・ポートを0に設定すると、管理対象サーバーの各ポート番号にオフセットが作成されます。このオフセットは5000です。つまり、管理対象サーバーのポート番号として割当て可能な最大許容値は、65535ではなく60535になります。

注意:

Coherenceライセンス情報については、『Oracle Fusion Middlewareライセンス情報ユーザー・マニュアル』のOracle Coherenceクラスタへのクライアント・アクセスに関する項を参照してください。

3.2.2.17 新しいマシンの作成

「マシン」画面を使用して、ドメイン内に新しいマシンを作成します。マシンは、ノード・マネージャでサーバーを起動または停止できるようにするために必要です。

ヒント:

高可用性環境を作成する際に目的のトポロジで必要になるマシンのリストがわかっているときには、この項の手順を実行して、この時点ですべてのマシンを作成できます。詳細は、『高可用性ガイド』のオプションのスケール・アウト手順に関する項を参照してください。

1. 「追加」をクリックして、新しいマシンを作成します。

2. 「名前」フィールドでapimgr_machine1と指定します。

3. 「ノード・マネージャ・リスニング・アドレス」フィールドで、管理対象サーバーを構成するマシンのIPアドレスを選択します。

localhostではなく、特定のインタフェースを選択する必要があります。これにより、Coherenceクラスタのアドレスが動的に計算されます。

4. 「ノード・マネージャ・リスニング・ポート」フィールドのポート番号を確認します。

この例に示されているポート番号5556は、このドキュメントの別の例でも引用されることがあります。このポート番号は、必要に応じて各自のポート番号に置換してください。

注意:

既存のドメインを拡張している場合は、既存のマシンにサーバーを割り当てることもできます。新しいマシンが不要な場合は、マシンを作成する必要はありません。

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のマシンに関する項を参照してください。

3.2.2.18 サーバーのマシンへの割当て

「サーバーのマシンへの割当」画面を使用して、作成したばかりの新しいマシンに管理サーバーと管理対象サーバーを割り当てます。

1. 「マシン」ペインで、サーバーを割り当てるマシン(ここではapimgr_machine1)を選択します。

2. 「サーバー」ペインで、次のいずれかを実行して、AdminServerをapimgr_machine1に割り当てます。

- AdminServerを1回クリックして選択し、右矢印をクリックして「マシン」ペイン内の選択したマシン(apimgr_machine1)の下に移動します。

- AdminServerをダブルクリックして、「マシン」ペイン内の選択したマシン(apimgr_machine1)の下に移動します。

3. 繰り返して、osb_server1とosb_server2の両方をapimgr_machine1に割り当てます。

ヒント:

この画面に示されるオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』のサーバーのマシンへの割当てに関する項を参照してください。

3.2.2.19 構成の指定内容の確認とドメインの構成

「構成サマリー」画面には、これから作成するドメインに関する詳細な構成情報が表示されます。この画面に示された各項目の詳細を調べて、情報に間違いがないことを確認します。

変更が必要な場合は、「戻る」ボタンを使用するか、ナビゲーション・ペインで画面を選択することで任意の画面に戻れます。

ドメイン作成は、「作成」をクリックするまでは開始されません。

ヒント:

この画面のオプションの詳細は、『構成ウィザードによるWebLogicドメインの作成』の構成サマリーに関する項を参照してください。

3.2.2.20 ドメイン・ホームと管理サーバーURLの記録

「構成に成功しました」画面には、構成したばかりのドメインについて、次の項目が表示されます。

- ドメインの場所

- 管理サーバーURL

どちらの項目も後で必要になるため、メモしておく必要があります。ドメインの場所は、管理サーバーの起動に使用するスクリプトへのアクセスで必要になります。また、URLは管理サーバーへのアクセスで必要になります。

「終了」をクリックして、構成ウィザードを閉じます。

3.3 サーバーの起動

この項では、構成の完了後に、ドメインを管理するためにアクセスできるツールについて説明します。

注意:

ドメイン管理に使用する追加のツールの詳細は、『Oracle Fusion Middleware Oracle Fusion Middlewareの管理』のOracle Fusion Middleware管理ツールの概要に関する項を参照してください。

- ノード・マネージャの起動

- 管理サーバーの起動

- 管理対象サーバーの起動

3.3.1 ノード・マネージャの起動

ドメインごとのノード・マネージャを起動するには、DOMAIN_HOME/binディレクトリに移動します。

UNIXオペレーティング・システムの場合は、次に示すように、nohupとサンプル出力ファイルnm.outを使用してノード・マネージャを起動します。

nohup ./startNodeManager.sh > $LOG_DIR/nm.out&

上記コマンドで、LOG_DIRはログ・ファイルを格納するディレクトリの場所です。

Windowsオペレーティング・システムの場合は、次のコマンドを実行します。

startNodeManager.cmd

注意:

Windowsオペレーティング・システムの場合は、ノード・マネージャを起動サービスとして実行するように構成することをお薦めします。これによって、システムが再起動されるたびに、ノード・マネージャが自動で起動されます。

詳細は、『Oracle WebLogic Serverノード・マネージャの管理』の起動サービスとしてのノード・マネージャの実行に関する項を参照してください。

ノード・マネージャのその他の構成オプションについては、『Oracle WebLogic Serverノード・マネージャの管理』を参照してください。

3.3.2 管理サーバーの起動

管理サーバーを起動するには、DOMAIN_HOME/binディレクトリに移動します。

UNIXオペレーティング・システムの場合は、次のコマンドを実行します。

./startWebLogic.sh

Windowsオペレーティング・システムの場合は、次のコマンドを実行します。

startWebLogic.cmd

「ドメイン・モードとJDKの指定」で、「ドメイン・モードおよびJDK」画面の「本番モード」を選択した場合は、「管理者アカウントの構成」の「管理者アカウント」画面で指定した管理者ユーザーのログイン資格証明を入力するように求めるプロンプトが表示されます。

ヒント:

管理サーバーの起動の詳細は、『Oracle Fusion Middlewareの管理』で管理サーバーの起動と停止に関する項を参照してください。

本番モードでは、起動アイデンティティ・ファイルを作成することで、管理サーバーの起動時に必要なユーザー名とパスワードの指定を省略できます。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の管理サーバー用の起動アイデンティティ・ファイルの作成に関する項を参照してください。

管理サーバー・コンソールにアクセスすることで、管理サーバーが稼働中であることを確認できます。URLは「ドメイン・ホームおよび管理サーバーURLを書き込む」の「構成に成功しました」画面のURLに指定されます。

注意:

製品スキーマをホストしているデータベースが稼働中であり、管理サーバーからアクセスできることを確認してください。

http://administration_server_host:administration_server_port/console

デフォルトの管理サーバーのポート番号は7001です。

管理コンソールの使用方法については、『Oracle Fusion Middlewareの管理』のOracle WebLogic Server管理コンソールの使用のスタート・ガイドを参照してください。

3.3.3 管理対象サーバーの起動

管理サーバーを起動するには:

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

http://administration_server_host:administration_server_port/em

管理サーバーのホストおよびポート番号は「構成に成功しました」画面のURLにありました(「ドメイン・ホームおよび管理サーバーURLを書き込む」)。デフォルトの管理サーバーのポート番号は7001です。

ログイン資格証明は「管理者アカウントの構成」の「管理者アカウント」画面で指定されました。

2. 「ターゲット・ナビゲーション」ペインで、管理対象サーバー(osb_server1とosb_server2)が表示されるまで矢印をクリックしてドメインを開きます。

3. 最初の管理対象サーバー(osb_server1)を選択します。

4. 「WebLogic Server」メニューの横にある「起動」を選択します。

5. 手順3と4を繰り返して、osb_server2を起動します。

6. 「ターゲット・ナビゲーション」ページでドメイン名を選択し、すべてのサーバーが稼働中であることを確認します。

3.4 次のステップ

次のステップには、ユーザーの作成とユーザー・ロールの割当てが含まれます。

詳細は、「Oracle API Managerでのユーザーの管理」を参照してください。

4 Oracle API Managerでのユーザーの管理

この章では、Oracle API Managerのユーザー管理について説明します。

内容は次のとおりです。

- ユーザーの管理

- 次のステップ

4.1 ユーザーの管理

API Managerユーザーは、Fusion Middleware Controlを使用して管理します。管理ユーザーがFusion Middleware Controlでグループを作成してアプリケーション・ロールをそれらのグループにマップし、ユーザーを作成してグループに割り当てます。

Fusion Middleware Controlにログオンするには、次のURLを使用します。

http://administration_server_host:administration_server_port/em

管理サーバーのホストおよびポート番号は「構成に成功しました」画面のURLにありました(「ドメイン・ホームおよび管理サーバーURLを書き込む」)。デフォルトの管理サーバーのポート番号は7001です。

注意:

この項のタスクでは、Fusion Middleware Controlを使用したユーザーの作成およびロールの割当てについて説明します。ユーザーの管理にはLDAP認証プロバイダを使用することもできます。詳細は、『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』のLDAP認証プロバイダの構成に関する項を参照してください。

4.1.1 編集セッションの作成

この章の残りのタスクを完了する前に、編集セッションを作成する必要があります。ユーザーとグループは、そのセッションをロックしてからFusion Middleware Controlを使用して作成できるようになります。

編集セッションの詳細は、Fusion Middleware Controlのオンライン・ヘルプを参照してください。

編集セッションを作成するには:

1. Fusion Middleware Controlから、「変更」の矢印をクリックして、「セッションの編集」をクリックします。

2. 「セッションの編集」ダイアログから、「作成」をクリックします。

3. 「新しい編集セッションの作成」ダイアログから、「名前」フィールドにセッションの名前を入力して、「作成」をクリックします。

4. 前の手順で作成したセッションを選択して、「編集セッションの切替え」をクリックします。プロンプトが表示された、そのダイアログの「編集セッションの切替え」をクリックします。
編集セッションは、この時点でアクティブになります。

5. セッションをロックして構成を編集するために、「変更」の矢印をクリックして、ロックして編集をクリックします。

この時点で、ユーザーとグループを作成できるようになります。これについては、この章の残りのタスクで説明します。

終了したら、「API Managerロール用のグループの作成」で説明されている手順を完了します。

4.1.2 API Managerロール用のグループの作成

Fusion Middleware Controlを使用してAPI Managerロールにマップするグループを作成します。

API Managerユーザー・ロールの詳細は、「Oracle API Managerのユーザー・ロールについて」を参照してください。

次のグループを作成するためにこのタスクを複数回完了する必要があります。

- API Admins

- API Consumers

- API Curators

- API Developers

次のすぐに使用できるService Busグループ用にグループを作成する必要はありません。

- Administrators

- Deployers

- Monitors

グループを作成するには:

1. 管理権限があるユーザーとして、Fusion Middleware Controlにログインします。

2. ターゲットのナビゲータで、「WebLogicドメイン」を開き、ドメインの名前を右クリックします。「セキュリティ」 > 「ユーザーとグループ」の順に移動して、「ユーザーとグループ」ページを表示します。

3. 「グループ」タブをクリックします。

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

5. 「新規グループの作成」ページから、上でリストされたグループの次に示すプロパティを定義します。

- 名前(一意である必要があります)

- 説明

- プロバイダ

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

7. ステップ4から6を繰り返して残りのグループを作成します。

終了したら、「API Managerユーザーの作成」で説明されているタスクを完了します。

4.1.3 API Managerユーザーの作成

API ManagerユーザーはFusion Middleware Controlを使用して作成します。

次のロールのいずれかに対して少なくとも1人のユーザーを作成する必要があります。

- API Admins

- API Consumers

- API Curators

- API Developers

- Deployers

- Monitors

警告:

ユーザー名には、「; , + = \」のいずれの文字も使用してはいけません(二重のバックスラッシュは、smith\\のように使用できます)。ユーザー名の最初の文字に、ポンド記号(#)または二重引用符(")を使用してはいけません。これらの無効な文字を含むユーザーを作成すると、WebLogicドメインが破損する場合があります。

API Managerユーザーを作成するには:

1. 管理権限があるユーザーとして、Fusion Middleware Controlにログインします。

2. ターゲットのナビゲータで、「WebLogicドメイン」を開き、ドメインの名前を右クリックします。「セキュリティ」 > 「ユーザーとグループ」の順に移動して、「ユーザーとグループ」ページを表示します。

3. 「ユーザー」タブをクリックします。

4. 「ユーザー」表の上側で、「作成」をクリックします。

5. 「新規ユーザーの作成」ダイアログの「名前」フィールドに、ユーザーのログインIDを入力します。

6. 必要に応じて、「説明」フィールドに、ユーザーの識別に役立つ簡単な説明を入力します。

7. 「プロバイダ」ドロップダウン・リストで、ユーザーの認証プロバイダを選択します。

8. 「パスワード」フィールドに、ユーザーのパスワードを入力します。パスワードは、8文字以上にする必要があります。

9. ユーザーのパスワードを「パスワードの確認」フィールドに再入力します。

10. 「作成」をクリックして、変更内容を保存します。

11. ステップ4から10を繰り返して残りのユーザーを作成します。

「ユーザー」表に、ユーザー名が表示されます。

終了したら、「グループへのユーザーの割当て」で説明されているタスクを完了します。

4.1.4 グループへのユーザーの割当て

適切なグループにユーザーを追加して、そのグループに関連付けられているロールの権限を付与します。たとえば、API Curatorグループにユーザーを割り当てて、API Curatorロールに関連付けられている権限をそのユーザーに付与します。

ロールごとにユーザーを少なくとも1つ作成した後に、意図したロールと一致するグループにそのユーザーを追加する必要があります。

- API Admins

- API Consumers

- API Curators

- API Developers

- Deployers

- Monitors

API Managerユーザーをグループに追加するには:

1. 管理権限があるユーザーとして、Fusion Middleware Controlにログインします。

2. ターゲットのナビゲータで、「WebLogicドメイン」を開き、ドメインの名前を右クリックします。「セキュリティ」 > 「ユーザーとグループ」の順に移動して、「ユーザーとグループ」ページを表示します。

3. 「ユーザー」タブをクリックします。

4. 「ユーザー」表で、「API Managerユーザーの作成」で作成したユーザーの名前をクリックします。

5. ユーザーの設定ページで、「グループ」タブをクリックします。

6. ユーザーを追加するグループを選択し、右矢印をクリックして「選択済」リストに追加します。たとえば、API CuratorユーザーはAPI Curatorsグループに追加する必要があります。

7. 次の図に示すように、「保存」をクリックし、「ユーザーとグループ」リンクをクリックして、「ユーザーとグループ」ページに戻ります。

8. 「API Managerユーザーの作成」で作成した各ユーザーについても、ステップ4から7を繰り返します。

終了したら、「Monitors親グループへのグループの追加」で説明されているタスクを完了します。

4.1.5 Monitors親グループへのグループの追加

Service BusコンソールにアクセスしているすべてのユーザーはMonitorsグループのメンバーである必要があります。これらのユーザーをモニター・グループに割り当てる最も簡単な方法は、その親グループをモニター・グループに追加することです。

これらのグループをMonitorsグループに追加します。

- API Curators

- API Developers

- Deployers

注意:

Service Busコンソールにアクセスするユーザーはすべて、Monitors親グループ、またはMonitors親グループのメンバーであるグループに追加する必要があります。適切なユーザーでService Busコンソールにアクセスする際にトラブルが発生した場合、このタスクが完了していることを確認します。

グループをMonitors親グループへ追加するには:

1. 管理権限があるユーザーとして、Fusion Middleware Controlにログインします。

2. ターゲットのナビゲータで、「WebLogicドメイン」を開き、ドメインの名前を右クリックします。「セキュリティ」 > 「ユーザーとグループ」の順に移動して、「ユーザーとグループ」ページを表示します。

3. 「グループ」タブをクリックします。

4. Monitorsに追加するグループをクリックします。たとえば、API Curatorsをクリックします。

5. 「メンバーシップ」タブをクリックします。

6. 「使用可能」リストからMonitorsグループを選択し、右矢印(>)アイコンをクリックしてMonitorsグループを「選択済み」リストに移動します。

7. 「保存」をクリックし、「ユーザーとグループ」リンクをクリックして、「ユーザーとグループ」ページを表示します。

8. 残りのグループについても、ステップ4から7を繰り返します。

終了したら、「Fusion Middleware Controlを使用したグループへのアプリケーション・ロールの割当て」で説明されているタスクを完了します。

4.1.6 Fusion Middleware Controlを使用したグループへのアプリケーション・ロールの割当て

API Managerのロールと一致するグループを作成したら、アプリケーション・ロールをそれらのグループに割り当てる必要があります。このタスクを完了すると、指定のグループに割り当てられているユーザーには該当するアプリケーション・ロールが付与されます。

アプリケーション・ロールをグループに割り当てるには:

1. 管理者権限を持つユーザーとして、Fusion Middleware Controlにログインします。

2. ターゲットのナビゲータで、「WebLogicドメイン」を開き、ドメインの名前を右クリックします。「セキュリティ」 > 「アプリケーション・ロール」に移動して「アプリケーション・ロール」ページを表示します。

3. 「アプリケーション・ストライプ」リストから「Service Busコンソール」を選択し、「アプリケーション・ロール」アイコンをクリックします。

4. API Curatorアプリケーション・ロールをAPI Curatorグループにマップします。

a. アプリケーション・ロールのリストからAPICuratorを選択し、「編集」をクリックします。

b. 「メンバー」リージョンで、「追加」をクリックします。

c. 「プリンシパルの追加」ダイアログで「タイプ」リストから「グループ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

d. API Curatorsグループを選択し、「OK」をクリックしてダイアログを閉じます。

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

5. Developerアプリケーション・ロールをAPI Developerグループにマップします。

a. アプリケーション・ロールのリストからDeveloperを選択し、「編集」をクリックします。

b. 「メンバー」リージョンで、「追加」をクリックします。

c. 「プリンシパルの追加」ダイアログで「タイプ」リストから「グループ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

d. API Developersグループを選択し、「OK」をクリックしてダイアログを閉じます。

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

6. Deployerアプリケーション・ロールをDeployersグループにマップします。

a. アプリケーション・ロールのリストからDeployerを選択し、「編集」をクリックします。

b. 「メンバー」リージョンで、「追加」をクリックします。

c. 「プリンシパルの追加」ダイアログで「タイプ」リストから「グループ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

d. Deployersグループを選択し、「OK」をクリックして、ダイアログを閉じます。

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

7. Monitorアプリケーション・ロールをMonitorsグループにマップします。

a. アプリケーション・ロールのリストからMonitorを選択し、「編集」をクリックします。

b. 「メンバー」リージョンで、「追加」をクリックします。

c. 「プリンシパルの追加」ダイアログで「タイプ」リストから「グループ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

d. Monitorsグループを選択し、「OK」をクリックして、ダイアログを閉じます。

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

8. 「アプリケーション・ストライプ」リストから「APIマネージャ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

9. API Adminアプリケーション・ロールをAPI Adminグループにマップします。

a. アプリケーション・ロールのリストからAPIApplicationAdminsitratorを選択し、「編集」をクリックします。

b. 「メンバー」リージョンで、「追加」をクリックします。

c. 「プリンシパルの追加」ダイアログで「タイプ」リストから「グループ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

d. API Adminsグループを選択し、「OK」をクリックしてダイアログを閉じます。

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

10. API Consumerアプリケーション・ロールをAPI Consumerグループにマップします。

a. アプリケーション・ロールのリストからAPIConsumerを選択し、「編集」をクリックします。

b. 「メンバー」リージョンで、「追加」をクリックします。

c. 「プリンシパルの追加」ダイアログで「タイプ」リストから「グループ」を選択し、「アプリケーション・ロール」アイコンをクリックします。

d. API Consumersグループを選択し、「OK」をクリックしてダイアログを閉じます。

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

Administrator Service Busグループには、アプリケーション・ロールを割り当てる必要がありません。これは、あらかじめ実行されています。

終了したら、「編集セッションの解放」で説明されているタスクを完了します。

4.1.7 編集セッションの解放

API Managerユーザーの管理の完了後に、編集セッションを解放する必要があります。編集セッションを解放しないと、将来の構成の変更が現行の編集セッションで行われた変更と競合する危険性があります。

編集セッションを解放するには、「変更」の矢印をクリックして、次のいずれかを選択します。

- 構成の解放: この章で説明した構成の変更以外は、構成に変更を加えていない場合に選択します。

- 変更のアクティブ化: この構成に別の変更を加えた場合に選択します。

4.2 次のステップ

次のステップには、Oracle Service Busを使用したAPIの作成、API Manager PortalからのAPIの検出と使用、およびAPI Managerの管理が含まれます。

詳細は、「Oracle API Managerの使用」を参照してください。

第III部 Oracle API Managerの使用

ここでは、Oracle Service Busを使用したAPIのキュレート、APIの検出、API Manager Portalの使用方法、API Managerの管理など、Oracle API Managerの使用方法について説明します。

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

- APIの作成

- Oracle Service Busを使用したAPIのキュレートおよび公開

- Oracle API Manager Portalの使用方法

- Oracle API Managerの管理

5 APIの作成

この章では、Oracle Service Busコンソールを使用してAPIを作成する方法について説明します。

内容は次のとおりです。

- Oracle Service Busコンソールへのアクセス

- APIとして公開するプロキシ・サービスの作成

- セッションのアクティブ化

- 次のステップ

5.1 Oracle Service Busコンソールへのアクセス

Oracle Service Busコンソールには、Webブラウザからアクセスします。

Oracle Service Busコンソールを起動するには:

1. API Managerドメインおよびすべてのサーバーが稼働していることを確認します。サーバーが停止している場合は、管理ユーザーが「サーバーの起動」で説明されているタスクを完了すると起動できます。

2. サーバーが起動したら、次のURLのいずれかをブラウザに入力します。

http://hostname:port/servicebus

または、SSLの場合:

https://hostname:port/servicebus

hostnameはAPI Manager管理サーバーのホスト名を、portはリスニングするポート番号をそれぞれ表します。

ログイン・ページが表示されます。

3. 適切なロールを持つユーザーのユーザー名およびパスワードを入力して、「サインイン」をクリックします。

5.2 APIとして公開するプロキシ・サービスの作成

Oracle Service Busで作成したWSDLベースのSOAPプロキシ・サービスとRESTプロキシ・サービスは、API Manager PortalにAPIとして公開できます。Service Busの機能を使用してプロキシ・サービスを作成してから、装飾的なメタデータを追加し、API Manager Portalでプロキシ・サービスをAPIとして公開します。

注意:

非推奨のWLS 9ポリシーで構成されたプロキシ・サービスは、APIとして公開できません。

Service Bus 12.2.1で作成したネイティブRESTサービス(型付き/型なしの両方)は、サポートされていません。12.1.3形式のWSDLベースのRESTサービスのみが、APIとして公開できます。『Oracle Service Busでのサービスの開発』のJDeveloperを使用したService Bus用WSDLベースのRESTサービスの作成方法に関する項を参照して、このタイプのRESTサービスをService Bus 12.2.1で作成してください。

プロキシ・サービスが含まれる構成JARを既存のService Busインスタンスからインポートすることもできます。詳細は、「APIおよびAPIキュレーション・メタデータのインポートとエクスポート」を参照してください。

注意:

依然として、この方法を使用してメタデータを追加し、追加されたプロキシ・サービスを公開する必要があります。

Service Busにプロキシ・サービスを移入した後で、必ずセッションをアクティブ化してください。セッションをアクティブ化した後で、ナビゲータでSOAPまたはRESTベースのプロキシ・サービスを選択し、「API」タブを表示します。「API」タブはSOAPおよびRESTベースのプロキシ・サービスに対してのみ表示されます。「セッションのアクティブ化」で説明されているタスクを完了し、Service Busコンソールで「API」タブを表示します。

5.3 セッションのアクティブ化

APIプロキシ・サービスを作成した後で、メタデータを追加して、API Manager Portalで使用するためにAPIを公開する前に、セッションをアクティブ化する必要があります。このタスクを完了するまで、「API」タブはService Busコンソールに表示されません。

セッションをアクティブ化するには:

1. 次のイメージで示されているように、「アクティブ化」をクリックします。

2. 「セッションのアクティブ化の確認」ダイアログから、次の手順を実行します。

a. (オプション) このセッションで行った変更の説明を「説明」フィールドに入力します。

b. 「アクティブ化」をクリックしてセッションをアクティブ化します。

セッションがアクティブ化されます。「API」タブがService Busコンソールで使用可能になりました。

注意:

サービスがアクティブ化されても、公開されるまで、トラフィックを受信しません。サービスがトラフィックを受信する前に、「Oracle Service Busを使用したAPIのキュレートおよび公開」の説明に従って、APIをキュレートおよび公開する必要があります。

5.4 次のステップ

次のステップには、API Manager Portalへのメタデータの追加とAPIの公開が含まれます。

詳細は、「Oracle Service Busを使用したAPIのキュレートおよび公開」を参照してください。

6 Oracle Service Busを使用したAPIのキュレートおよび公開

APIを作成した後、トラフィックを受信する前に、メタデータをAPIに追加してAPIを公開する必要があります。この章では、API ManagerとともにインストールされるOracle Service Busコンソールを使用したWSDLベースのSOAPプロキシ・サービスとRESTプロキシ・サービスのAPIとしてのキュレートおよび公開について説明します。

ここで説明されているタスクは、API Curatorロールを持つユーザーが実行します。

注意:

この章のタスクを開始する前に、APIプロキシ・サービスを作成してアクティブ化する必要があります。詳細は、「APIの作成」を参照してください。

内容は次のとおりです。

- APIのメタデータの編集

- APIステータスについて

- APIのプライベート化

- Oracle API Manager PortalへのAPIの公開

- 「ドラフト」へのステータスの変更によるAPI Manager PortalからのAPIの非公開化

- APIの非推奨化

- 次のステップ

6.1 APIのメタデータの編集

プロキシ・サービスを作成したら、API Manager PortalでAPI詳細ページに表示される説明的なメタデータを追加できます。

APIコンシューマは、このメタデータを使用してAPIが自分のアプリケーションに対して適切な選択肢かどうかを判断し、APIをテストします。Service Busコンソールへのアクセス権を持つユーザーもメタデータを使用してそのAPIを評価できます。

APIのメタデータを編集するには:

1. Oracle Service Busコンソールから、公開するサービスのプロキシ・サービス定義を開きます。

2. 「API」タブをクリックします。次の図に示すように、「概要」リージョンで「編集」をクリックします。

3. 次の表の説明に従って、メタデータ・プロパティを編集します。

要素

説明

概要

このセクションを使用してAPIに関連付けられている基本的なメタデータを変更します。

名前

APIの名前を入力します。

バージョン

プロキシ・サービスのバージョン情報を入力します。

説明

APIの機能の詳細説明を入力します。

タグ

APIに関連付けるタグを入力します。Oracle API Manager Portalでは、これらのタグを使用してAPIを検索できます。

非推奨ステータス

このセクションを使用してAPIの非推奨化に関連するオプションを設定します。

非推奨

APIを非推奨にする場合に選択します。

説明

後継バージョン(ある場合)など、APIが非推奨となった理由を説明するテキストを入力します。

参照

このセクションを使用して外部ドキュメント参照などの情報ソースを追加します。

注意: 参照は最大4つに制限されます。

名前

参照の名前を入力します。

URL

参照のURLを入力します。

セキュリティ

このセクションを使用してセキュリティ情報を追加します。

概要

このAPIにアタッチするグローバル・セキュリティ・ポリシーの概要を入力します。

注意: OWSMからの個々のセキュリティ・ポリシーの説明は、「API詳細」ページでコンシューマに公開されます。

テスト

このセクションを使用してテスト情報を追加します。

テストURL

APIのテストに使用するURLを入力します。

ヒント:

テストURLの使用方法を「概要」セクションの「説明」フィールドに指定するか、「参照」セクションにHTML参照として指定できます。

4. 「保存」をクリックします。これで、APIのメタデータが更新され、変更内容がOracle Service BusコンソールおよびAPI Manager Portalに反映されます。

6.2 APIステータスについて

APIのステータスにより、API Manager Portalに対して非公開になるか、公開されるかが決まります。

次の図に示すように、APIステータスは、「API」タブの「パブリッシュ・ステータス」リージョンの「ステータス」リストで設定します。

APIには次のステータスを設定できます。

- ドラフト: ドラフトAPIは、Oracle API Manager Portalに公開されず、それに対するリクエストはすべてブロックされます。このオプションがデフォルトです。

- プライベート: プライベートAPIは、Oracle Service BusでDeveloper権限を持つユーザーが使用できます。プライベートAPIは、API Manager Portalに表示されず、API Consumerロールを持つユーザーは使用できません。APIのプライベート化の説明は、「APIのプライベート化」を参照してください。

- 公開済: 公開済APIは、Oracle API Manager Portalでコンシューマに公開されます。APIの公開の説明は、「Oracle API Manager PortalへのAPIの公開」を参照してください。

6.3 APIのプライベート化

Service BusでDeveloper権限を持つユーザーが使用できるようにする場合は、APIをプライベートにできます。「「プライベート」」とマークされたAPIは、API Manager Portalに表示されず、API Consumerロールを持つユーザーは使用できません。

APIをプライベートにするには:

1. Oracle Service Busコンソールから、プライベートにするサービスのプロキシ・サービス定義を開きます。

2. 「API」タブをクリックします。「パブリッシュ・ステータス」リージョンで「編集」をクリックします。

3. 「ステータス」リストから、「プライベート」を選択します。

4. 「保存」をクリックします。これで、APIはプライベートになります。

6.4 Oracle API Manager PortalへのAPIの公開

API Manager PortalからコンシューマがAPIを使用できるようにするには、管理対象とするか管理対象外とするかを決める必要があります。次に、ステータスを「公開済」に変更してAPIを公開します。

ヒント:

必ず「APIのメタデータの編集」の説明に従ってAPIにメタデータを追加してから、API Manager Portalに公開します。

6.4.1 APIを管理対象とするか管理対象外とするかの決定

APIを公開する前に、APIを管理対象として公開するか、管理対象外として公開するかを決定する必要があります。

- 管理対象APIは、実行時にアプリケーションの権限キーをヘッダーとして渡すことによってのみ起動できます。ユーザーは、APIにサブスクライブしてこのキーを受信する必要があります。ユーザーがキーを使用しないで管理対象APIを起動しようとすると、エラー・メッセージが表示されます。

- 管理対象外APIは、実行時に制御されず、権限キーを渡さずにアクセスできます。ユーザーは、サブスクライブせずにこのようなAPIを起動できます。

「「公開済」へのAPIステータスの変更」で説明されているように、APIを公開して管理対象にする際に「管理対象」チェック・ボックスを選択します。後でAPIを非公開にすることにした場合は、「管理対象」チェック・ボックスの選択を解除します。

注意:

すでに管理対象のAPIを管理対象外にすることにした場合、アプリケーションの権限キー(管理対象APIには必要、管理対象外APIには不要)が含まれるAPIに対するユーザー・リクエストでは、ヘッダーのX-API-KEY属性が無視されます。リクエストは通常どおりに処理されます。

6.4.2 「公開済」へのAPIステータスの変更

APIのステータスを「公開済」に変更して、API Manager Portalに公開します。

APIを公開するには:

1. Oracle Service Busコンソールから、公開するサービスのプロキシ・サービス定義を開きます。

2. 「API」タブをクリックします。「パブリッシュ・ステータス」リージョンで「編集」をクリックします。

3. 「ステータス」リストから、「公開済」を選択します。

4. そのAPIを管理対象にする場合は、「管理対象」チェック・ボックスを選択します。

5. 「保存」をクリックします。APIがAPI Manager Portalに公開されます。

注意:

このリージョンで「すべてクリア」ボタンをクリックすると、すべてのフィールドがデフォルト値にリセットされます。次に、「OK」をクリックして確認します。

6.5 API Manager PortalからのAPIの非公開化

APIを公開した後で、API Manager Portalで表示されないようにし、そのAPIに対するリクエストをすべてブロックすることにした場合は、ステータスを「ドラフト」に戻すことができます。

注意:

Service Busコンソールからプロキシ・サービスを削除すると、API Manager Portalからも削除されます。

APIのステータスを「ドラフト」に変更するには:

1. Oracle Service Busコンソールから、「ドラフト」とマークするサービスのプロキシ・サービス定義を開きます。

2. 「API」タブをクリックします。「パブリッシュ・ステータス」リージョンで「編集」をクリックします。

3. 「ステータス」リストから、「ドラフト」を選択します。

4. 「保存」をクリックします。これで、APIはAPI Manager Portalから非公開になります。

6.6 APIの非推奨化

非推奨APIは、API Manager Portalに公開されたままになります。ユーザーは、非推奨APIの詳細を表示できますが、サブスクライブはできません。

どのAPIが非推奨バージョンよりも優先されるかなど、APIが非推奨になった理由について詳細を指定できます。

注意:

非推奨になる前にAPIにサブスクライブしていたユーザーは、引き続きサブスクライブしています。APIに対するリクエストは通常どおりに処理されます。

APIを非推奨にするには:

1. Oracle Service Busコンソールから、非推奨にするサービスのプロキシ・サービス定義を開きます。

2. 「API」タブをクリックします。「概要」リージョンで「編集」をクリックします。

3. 「非推奨ステータス」セクションで「非推奨」オプションを選択します。

4. 次の図に示すように、「非推奨ステータス」セクションで「説明」フィールドに非推奨の説明を入力します。この説明は、そのAPIが非推奨になった理由や後継バージョンなどです。

5. 「保存」をクリックします。これで、APIはAPI Manager Portalで「非推奨」とマークされます。

6.7 次のステップ

次のステップには、APIの検出、テストおよび使用が含まれます。

詳細は、「Oracle API Manager Portalの使用方法」を参照してください。

7 Oracle API Manager Portalの使用方法

この章では、Oracle API Managerを使用したAPIの検出およびサブスクライブについて説明します。Oracle API Manager PortalにAPIを公開すると、API Consumerロールを持つユーザーはポータルを使用して、自分のアプリケーションで使用するAPIを見つけてサブスクライブすることができます。

内容は次のとおりです。

- Oracle API Manager Portalの概要

- API Manager Portalへのアクセス

- アプリケーションの管理

- APIの検出

- サブスクリプションの表示

- アプリケーションでのAPIの使用方法

- APIからのサブスクライブ解除

- 次のステップ

7.1 Oracle API Manager Portalの概要

APIとして公開されたOracle Service Busプロキシ・サービスは、Oracle API Manager Portalに公開されます。API Manager Portalから、API Consumerロールを持つユーザーはAPIを見つけて調査し、サブスクライブして使用することができます。

ユーザーは、「サブスクリプション」ページを使用して自分のサブスクリプションを管理し、「カタログ」ページを使用して新しいAPIを見つけて調査します。

また、API Manager Portalを使用して、自分のアプリケーションでAPIを使用するのに必要な情報を探し出します。APIは、アプリケーションのコンテキストで使用します。公開されたAPIを使用する予定の各アプリケーションは、API Manager Portalに表示される必要があります。これにより、アプリケーションごとにAPIの管理およびサブスクリプション統計の収集が可能になります。

API Adminロールを持つユーザーは、API Manager Portalで追加のタスクを実行できます。これらのタスクの詳細は、「Oracle API Managerの管理」を参照してください。

7.2 API Manager Portalへのアクセス

この項では、API Manager Portalのサインインおよびログアウトについて説明します。

7.2.1 API Manager Portalへのサインイン

API Manager Portalにサインインするには:

1. Oracle API Manager PortalのURL (http://example.com:7001/apimanager/など)にナビゲートします。

2. フィールドにユーザー名およびパスワードを入力し、「サインイン」をクリックします。

7.2.2 API Manager Portalからのログアウト

API Manager Portalからログアウトするには、次の図に示すように、ユーザー名をクリックしてユーザー・メニューを展開し、「ログアウト」をクリックします。

7.3 アプリケーションの管理

APIを使用する予定の各アプリケーションは、API Manager Portalに表示される必要があります。

この項では、アプリケーションの作成、アプリケーションへのAPIのサブスクライブ、使用しなくなったアプリケーションのAPI Manager Portalからの削除について説明します。

7.3.1 アプリケーションの作成

APIをアプリケーションにサブスクライブするには、APIを使用する予定のアプリケーションに対応するアプリケーションをAPI Manager Portalで作成する必要があります。

「サブスクリプション」ページからアプリケーションを作成するには:

1. 次の図に示すように、「アプリケーション」パネルで「新規アプリケーション」ボタンをクリックします。

2. 「名前」フィールドに、アプリケーションの一意の名前を入力します。

3. 「説明」フィールドに、アプリケーションの説明を入力します。

4. 「作成」をクリックしてアプリケーションを作成します。

注意:

アプリケーションは、「カタログ」ページから作成することもできます。詳細は、「「カタログ」ページからのAPIへのサブスクライブ」を参照してください。

7.3.2 「サブスクリプション」ページからのAPIへのサブスクライブ

アプリケーションを作成したら、「サブスクリプション」ページからアプリケーションで使用するAPIにサブスクライブできます。

「サブスクリプション」ページからアプリケーションにAPIをサブスクライブするには:

1. 「サブスクリプション」ページで、アプリケーションの名前をクリックして「アプリケーション」パネルに表示します。

2. 次の図に示すように、「API」リージョンで「APIの追加」ボタンをクリックします。

3. サブスクライブするAPIを見つけます。APIの検索の詳細は、「「カタログ」ページを使用したAPIの検索」を参照してください。

4. 次の図に示すように、サブスクライブする各APIの「選択」アイコンをクリックします。

5. 次の図に示すように、「選択したAPI」リージョンで「サブスクライブ」ボタンをクリックします。

注意:

「選択したAPI」リストでAPIにカーソルを合せ、APIの横にある「選択解除」アイコンをクリックすると、選択したAPIを削除できます。

「選択したAPI」リージョンで「クリア」アイコンをクリックすると、選択したAPIをすべて削除できます。

7.3.3 アプリケーションの説明の編集

アプリケーションの説明を編集すると、API Manager Portalでの説明を変更できます。

アプリケーションの説明を編集するには:

1. 「サブスクリプション」ページで、説明を編集するアプリケーションの名前をクリックしてます。

2. 次の図に示すように、「編集」アイコンをクリックします。

3. テキスト領域で説明を編集した後、「保存」アイコンをクリックして保存するか、「取消」アイコンをクリックして取り消します。

7.3.4 API Manager Portalからのアプリケーションの削除

アプリケーションが使用されなくなった場合は、API Manager Portalからアプリケーションを削除できます。APIは、API Manager Portalに公開されたままですが、アプリケーションの古い権現キーを使用した管理対象APIへのコールは拒否されます。

API Manager Portalからアプリケーションを削除するには:

1. 「サブスクリプション」ページにナビゲートします。

2. 削除するアプリケーションの名前をクリックして「アプリケーション」パネルを表示します。

3. 次の図に示すように、「削除」アイコンをクリックします。

4. プロンプトが表示されたら、「はい」をクリックして、削除を確認します。

7.4 APIの検出

API Consumerロールを持つユーザーは、API Manager Portalを使用してAPIを検索し、興味があるAPIに関連付けられたメタデータを確認して自分のアプリケーションでAPIが有用であるかどうかを判断できます。

ユーザーは「カタログ」ページから、非推奨にされていないAPIに直接サブスクライブできます。

7.4.1 「カタログ」ページを使用したAPIの検索

API Manager Portalの「カタログ」ページを使用してアプリケーションで使用するAPIを検索します。「カタログ」ページから、各APIの詳細を表示してアプリケーションで使用するかどうかを決定できます。

APIを検索するには:

1. 「カタログ」ページから、「フィルタ」フィールドに検索テキストを入力します。名前、説明またはタグがそのテキストと一致するAPIが検索結果として戻されます。

注意:

非推奨APIは選択できません。次の図に示すように、「非推奨」シンボルとともに表示されます。

「非推奨」シンボルにカーソルを合せると、APIが非推奨になった理由を読むことができます。

2. 「タイプ」リストから、結果として戻すAPIのタイプを選択します。すべてのタイプのAPIを戻す場合は「すべてのタイプ」(このオプションはデフォルトで選択されています)、WSDLベースのSOAP APIを戻す場合は「SOAP」、REST APIを戻す場合は「REST」を選択します。

3. 「管理対象」リストから、結果として戻すAPIの管理対象ステータスを選択します。管理対象と管理対象外の両方のAPIを戻す場合は「管理対象と管理対象外」、管理対象APIのみを戻す場合は「管理対象」、管理対象外APIのみを戻す場合は「管理対象外」を選択します。

管理対象APIと管理対象外APIの違いの説明は、「管理対象APIと管理対象外APIの違いについて」を参照してください。

ヒント:

検索結果をクリアしてAPIの完全なリストを戻すには、次の図に示すように、「フィルタのクリア」アイコンをクリックします。

7.4.2 APIの詳細の表示

興味があるAPIを見つけたら、「詳細」ページを表示して関連付けられたメタデータを確認できます。

API詳細ページを表示するには:

1. 「「カタログ」ページを使用したAPIの検索」で説明されているタスクを使用してAPIを見つけます。

2. 次の図に示すように、APIの「詳細」アイコンをクリックして「詳細」ページを開きます。このページに表示されているデータの説明は、「API詳細ページに表示されるデータ」を参照してください。

3. (オプション) このAPIにサブスクライブするには、次の図に示すように、「選択」をクリックして「カタログ」ページの「選択したAPI」リージョンにこのAPIを追加し、「「カタログ」ページからのAPIへのサブスクライブ」(手順3から開始)で説明されているタスクを実行してサブスクリプション・プロセスを完了します。

7.4.3 API詳細ページに表示されるデータ

API詳細ページにはAPIについて次のステータスが表示されます。

- 管理対象ステータス: APIが管理対象か管理対象外かを示します。

- 非推奨ステータス: APIが非推奨か非推奨以外かを示します。

API詳細ページには、次の分析が表示されます。

- 現在のAPIステータス: APIが稼働しているか停止しているかを示します。

- エラー数: このAPIの起動時に受信したエラーの数が表示されます。

- メッセージ数: APIから受信したメッセージの数が表示されます。

- 時間間隔: 表示されたデータが集計された時間を表示します。

- 平均レスポンス時間: 平均メッセージ・レスポンス時間(ミリ秒)が表示されます。集約間隔の変更の詳細は、『Oracle Service Busの管理』の「操作設定とグローバル設定の構成」を参照してください。

表示される分析は、「統計の表示」リストで選択したオプションによって決まります。「現在の集約間隔」を選択して現在の集約間隔(詳細ページに表示される「期間」)のみの分析を表示するか、「最後のリセット以降」を選択して最後のリセット以降の分析統計を表示します。

API詳細ページには、次のメタデータも表示されます。

要素

説明

APIプロファイル

APIに関連付けられている基本的なメタデータが表示されます。

API URL

APIのURLへのリンク。

バージョン

APIのバージョン情報が表示されます。

説明

APIの機能の詳細説明が表示されます。

タグ

APIに関連付けるタグのリストが表示されます。

管理

APIが管理対象か管理対象外かを示します。

SOAP

関連付けられたWSDLファイルのリンクが表示されます。

注意: このリージョンは、WSDLベースのSOAP APIの場合のみ表示されます。

WSDL

WSDLファイルへのリンクが表示されます。

OraWSDL

該当する場合、OraWSDLファイルへのリンクが表示されます。

REST

WADLファイルへのリンクが表示されます。

注意: このリージョンは、REST APIの場合のみ表示されます。

参照

APIの外部ドキュメント参照などの情報ソースが表示されます。

API詳細

APIの追加の詳細が表示されます。

セキュリティ概要

このAPIにアタッチするグローバル・セキュリティ・ポリシーの概要が表示されます。

セキュリティ・ポリシー

このAPIにアタッチされたセキュリティ・ポリシーが表示されます。ポリシーにカーソルを合せて「詳細」アイコンをクリックすると、ポリシーの説明が表示されます。

非推奨

APIが非推奨か非推奨以外かを示します。

テスト中

APIのテストURLが表示されます。

7.4.4 「カタログ」ページからのAPIへのサブスクライブ

「カタログ」ページからAPIに直接サブスクライブできます。

「カタログ」ページからAPIにサブスクライブするには:

1. 「カタログ」ページで、サブスクライブする各APIの「選択」アイコンをクリックします。サブスクリプション用に複数のAPIを選択できます。

注意:

非推奨APIは選択できません。新しいサブスクリプションには使用できません。

2. 次の図に示すように、「選択したAPI」リージョンで「サブスクライブ」ボタンをクリックします。

注意:

「選択したAPI」リストでAPIの横にある「選択解除」アイコンをクリックすると、選択したAPIを削除できます。「選択したAPI」リージョンで「クリア」アイコンをクリックすると、選択したAPIをすべて削除できます。次の図に、これらのアイコンを示します。

3. (オプション) 使用するアプリケーションがリストにない場合:

a. 次の図に示すように、「作成」アイコンをクリックします。

b. アプリケーションの作成ダイアログで、「名前」フィールドにアプリケーションの名前を入力し、「説明」フィールドに説明を入力します。

c. 「作成」ボタンをクリックしてアプリケーションを作成します。

4. 選択するアプリケーションをクリックして、「選択」ボタンをクリックします。選択したAPIにサブクスライブされます。

7.5 サブスクリプションの表示

次の2つの異なるビューを使用して、サブスクライブしているAPIを表示できます。

- 「サブスクリプション」ページの「API」パネル: サブスクライブしているAPIのリストを表示する場合に使用します。この詳細は、「サブスクライブされているAPIの表示」を参照してください。

- 「サブスクリプション」ページの「アプリケーション」パネル: 選択したアプリケーションがサブスクライブされているAPIを表示する場合に使用します。この詳細は、「特定のアプリケーションにサブスクライブされているAPIの表示」を参照してください。

7.5.1 サブスクライブされているAPIの表示

サブスクライブされているAPIを表示するには、「サブスクリプション」ページで「API」をクリックします。サブスクライブされている各APIがリストに表示されます。名前、タグ、アプリケーション、キーおよび説明がAPIごとに表示されます。

ヒント:

「順序付け」リストを使用すると、次の基準に基づいてAPIをソートできます。

- API名、降順

- API名、昇順

- アプリケーション名、降順

- アプリケーション名、昇順

複数のアプリケーションが同じAPIにサブスクライブされている場合、次の図に示すように、そのAPIは、サブスクライブされているアプリケーションごとに1回ずつ、複数回リストに出現します。

7.5.2 特定のアプリケーションにサブスクライブされているAPIの表示

アプリケーションの詳細とサブスクライブされているAPIを表示するには、「サブスクリプション」ページでアプリケーションの名前をクリックします。

「アプリケーション」リージョンに、アプリケーションの名前、キーおよび説明が表示されます。

「API」リージョンには、選択したアプリケーションがサブスクライブされているAPIのリストが表示されます。各APIのタグおよび説明も表示されます。

7.6 アプリケーションでのAPIの使用方法

この項では、管理対象APIと管理対象外APIの違い、APIのテスト、アプリケーションでのAPIの使用方法について説明します。

7.6.1 管理対象APIと管理対象外APIの違いについて

管理対象APIへのアクセスはアプリケーションの権限キーを使用して実行時に制御されます。このキーを指定しないでAPIをコールすると失敗します。詳細は、「管理対象外APIの使用方法」を参照してください。

管理対象APIを正常に起動するためには、まずアプリケーションを作成して該当する管理対象APIにサブスクライブします。次に、コールが成功するようにAPIキーをリクエスト・ヘッダーに指定して、クライアントでAPIを起動する必要があります。

管理対象外APIは、サブスクリプトしなくても、実行時に権限キーを渡さなくても起動できます。

分析は、管理対象APIにも管理対象外APIにも使用できます。このような詳細は、「API詳細ページに表示されるデータ」で説明されているように、API詳細ページの上部に表示されます。

7.6.2 管理対象外APIの使用方法

管理対象外APIを使用するために実行する必要がある特別なアクションはありません。管理対象外APIにサブスクライブする必要も、実行時に権限キーを渡す必要もありません。アプリケーションで通常するように管理対象外APIを起動します。

7.6.3 管理対象APIの使用方法

管理対象APIを使用するには、まずそのAPIにサブスクライブする必要があります。APIへのサブスクライブの詳細は、「「サブスクリプション」ページからのAPIへのサブスクライブ」を参照してください。

API Manager Portalの各アプリケーションは、そのアプリケーションがサブスクライブされているAPIごとに実行時に渡す必要がある一意のキーを持っています。権限キーは、X-API-KEY属性を使用してHTTPユーザー・ヘッダーとして渡す必要があります。たとえば、アプリケーションの権限キーがb4a4cd59-744c-4a08-a888-6287ce6431c0の場合、コールが成功するように管理対象APIを起動するためには、属性X-API-KEY: b4a4cd59-744c-4a08-a888-6287ce6431c0がリクエスト・ヘッダーに存在する必要があります。

API Manager Portalでアプリケーションの権限キーを探す方法の説明は、「アプリケーションの権限キーの取得」を参照してください。

7.6.4 アプリケーションの権限キーの取得

アプリケーションの権限キーは、「サブスクリプション」ページの該当するアプリケーションのエントリに表示されます。

アプリケーションの権限キーを探すには、「サブスクリプション」をクリックします。「アプリケーション」パネルで、権限キーを探すアプリケーションの名前をクリックします。次の図に示すように、アプリケーションの権限キーは「アプリケーション」リージョンに表示されます。

注意:

「管理対象APIの使用方法」で説明されているように、このキーを使用して管理対象APIを起動します。キーを使用せずに管理対象APIを起動すると、HTTPステータス・コード403 Forbiddenが表示されます。

ヒント:

アプリケーションのキーにカーソルを合せると、ツール・チップが表示されます。このツール・チップから、アプリケーションのキーが含まれるX-API-KEY属性を直接コピーできます。

7.6.5 APIのテスト

API作成者は、テスト用のURLを提供できます。テストURLが提供され、API Curatorロールを持つユーザーがそのURLをAPIメタデータに追加して(「APIのメタデータの編集」を参照)いると、APIコンシューマはサブスクライブする前にAPIの機能をテストして評価できます。

APIをテストするには:

1. 「「カタログ」ページを使用したAPIの検索」で説明されている手順に従って、テストするAPIを見つけます。

2. 可能な場合は、「API詳細」ヘッダーの下にある「テスト中」フィールドにテストURLが表示されます。

ヒント:

APIキュレータは、APIをテストする手順を「概要」セクションの「説明」フィールドに指定するか、「参照」セクションにHTML参照として指定できます。これらのフィールドでテストの手順がないか探します。

3. ブラウザ・プラグインなどのWebサービス・テスト・ツールを使用して、提供されたURLを使用してAPIをテストします。

7.7 APIからのサブスクライブ解除

APIを使用しなくなった場合は、そのAPIからサブスクライブ解除できます。たとえば、APIが非推奨となって新しいバージョンを採用する場合やAPIがアプリケーションに合致しなくなったと判断した場合、そのAPIからサブスクライブ解除できます。

管理対象APIからサブスクライブ解除した後では、サブスクライブに使用されていたアプリケーションの権限キーを使用してそのAPIを起動しようとすると拒否されます。

この項では、APIからのサブスクライブ解除に使用する2つの方法について説明します。

7.7.1 「サブスクリプション」ページの「API」パネルを使用したAPIからのサブスクライブ解除

「API」パネルを使用してAPIからサブスクライブ解除するには:

1. 「サブスクリプション」ページにナビゲートします。「API」パネルが選択されていることを確認します。

2. リストでサブスクライブ解除するAPIを見つけます。

3. 次の図に示すように、「サブスクライブ解除」アイコンをクリックします。

ヒント:

複数のアプリケーションがAPIにサブスクライブされている場合は、そのAPIのエントリが複数あります。サブスクリプションを削除するアプリケーションと合致するAPIエントリの「サブスクライブ解除」アイコンを必ずクリックしてください。

4. プロンプトが表示されたら、「はい」をクリックして、サブスクリプション解除を確認します。

7.7.2 「サブスクリプション」ページの「アプリケーション」パネルを使用したAPIからのサブスクライブ解除

「アプリケーション」パネルを使用してAPIからサブスクライブ解除するには:

1. 「サブスクリプション」ページにナビゲートします。

2. APIをサブスクライブ解除するアプリケーションの名前をクリックして「アプリケーション」パネルを表示します。

3. 次の図に示すように、サブスクライブ解除するAPIにカーソルを合せて「サブスクライブ解除」アイコンをクリックします。

4. プロンプトが表示されたら、「はい」をクリックして、サブスクリプション解除を確認します。

7.8 次のステップ

次のステップには、API Managerの管理が含まれます。

詳細は、「Oracle API Managerの管理」を参照してください。

8 Oracle API Managerの管理

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

内容は次のとおりです。

- 「サブスクリプション」ページを使用したサブスクリプション統計の表示

- Oracle API Managerでの分析の表示

- APIおよびAPIキュレーション・メタデータのインポートとエクスポート

8.1 「サブスクリプション」ページを使用したサブスクリプション統計の表示

ユーザーおよびAPIについてサブスクリプション統計を表示できます。ユーザーのサブスクリプション統計には、各ユーザーの作成されたアプリケーションと、そのアプリケーションにサブスクライブされているAPIが表示されます。

この項では、サブスクリプション詳細の表示方法について説明します。ここで説明されているタスクは、APIApplicationAdministratorロールを持つユーザーがAPI Manager Portalを使用して実行します。

8.1.1 ユーザーのサブスクリプションの表示

各ユーザーの作成されたアプリケーションと、そのアプリケーションにサブスクライブされているAPIを表示できます。

ユーザーのサブスクリプションを表示するには:

1. 「サブスクリプション」ページで「ユーザー」をクリックします。「ユーザー」ページに、アプリケーションを作成したりAPIにサブスクライブしているユーザーごとに、作成されたアプリケーションの数とサブスクライブされているAPIの数が表示されます。

2. 次の図に示すように、ユーザーの「詳細」アイコンをクリックして、そのユーザーの「詳細」ページを表示します。ユーザー詳細ページには、選択したユーザーが作成したアプリケーションがすべて表示されます。

3. 詳細およびサブスクライブされているAPIを表示するアプリケーションの名前をクリックします。

8.1.2 APIのサブスクリプション詳細の表示

APIにサブスクライブしているユーザーおよびアプリケーションを表示できます。

APIのサブスクリプション詳細を表示するには:

1. 「サブスクリプション」ページで、「API」をクリックして「API」パネルを表示します。サブスクリプションがある各APIが表示されます。「API」パネルには、サブスクライブしているユーザーの数と各APIに対するサブスクリプションの数が表示されます。

2. APIの「詳細」アイコンをクリックしてAPI詳細ページの「使用状況」タブを表示します。このページでは、そのAPIにサブスクライブしているすべてのユーザーおよびアプリケーションがリストに表示されます。

8.1.3 クイック検索機能の使用方法

Oracle API Manager Portalには、問合せに一致するアプリケーションまたはAPIをすべて戻すクイック検索問合せが組み込まれています。クイック検索を使用して、空のアプリケーション、未使用のAPI (サブスクライブされていないAPI)および非推奨APIを戻すことができます。

クイック検索を実行するには:

1. 「サブスクリプション」ページの「クイック検索」リージョンで、エントリのいずれか(「空のアプリケーション」、「未使用のAPI」、「非推奨API」)をクリックします。

ヒント:

「非推奨API」クイック検索は、ユーザーがサブスクライブされている非推奨APIのみを戻します。非推奨APIにサブスクリプションがない場合、そのAPIは「未使用のAPI」クリック検索によってのみ戻されます。

2. (オプション) 「フィルタ」フィールドに検索用語を入力すると、クイック検索の結果をフィルタ処理できます。

8.2 Oracle API Managerでの分析の表示

API Manager Portalでは、使用状況およびパフォーマンス分析統計を表示できます。

ここで説明されているタスクは、APIApplicationAdministratorロールを持つユーザーが実行します。

注意:

分析データをAPI Managerに移入する場合、「API分析の有効化」で説明されているAPI分析の有効化が必要になることがあります。

8.2.1 API分析の有効化

API Managerで分析情報を有効にするには、Fusion Middleware Controlでプロキシ・サービスのモニタリング操作設定を有効にする必要があります。

注意:

分析はモニタリング操作設定が選択されているサービスでのみ使用可能です。分析情報へのアクセスが困難な場合、API分析が必要な各サービスに対し、モニタリングが有効なことを確認します。

API分析を有効にするには:

1. Fusion Middleware Controlから、次のいずれかの方法でサービスを見つけます。

- ドメイン全体でサービスを検索するには、ターゲット・ナビゲータで「SOA」を展開し、「service-bus」をクリックします。

- Service Busプロジェクト内のサービスを検索するには、ターゲット・ナビゲータで「SOA」→「service-bus」を開いて、検索するプロジェクトの名前を選択します。

2. 「操作」タブをクリックします。

3. 使用する検索基準を指定して、その設定を変更するサービスを検索します。次の基準を指定できます。「タイプ」以外はすべてオプションです。

- タイプ: 「プロキシ・サービス」を選択します。

- 名前: 検索するサービスの名前を入力します。

- パス: 検索するサービスのパス(プロジェクト名とフォルダ名、ある場合)。Service Busプロジェクトの「操作」タブの場合、パスにはすでに値が入力されています。

ヒント:

前述の条件のいずれも指定せずに検索すると、ドメインまたはプロジェクト内のすべてのサービスが返されます。

4. 「検索」をクリックします。

5. 結果リストの任意のプロキシ・サービスに対し、「モニター」チェック・ボックスを選択して対応するAPIのAPI分析を有効にするか、チェック・ボックスを選択解除してAPI分析を無効にします。

ヒント:

リストのすべてのサービスに対しAPI分析を有効または無効にするには、列見出しの横の「モニター」チェック・ボックスを選択または選択解除します。

6. 「適用」をクリックします。

API分析が選択されたサービスに対して有効になりました。

8.2.2 APIの単純な分析の表示

「分析」ページを使用してAPIの単純な分析を表示できます。選択したAPIについて、合計メッセージ数を表すグラフ、集約間隔で受信したエラー・メッセージ数、平均レスポンス時間(ミリ秒)が表示されます。

APIの分析を表示するには、次の図に示すように、「分析」ページで単純な分析データを表示するAPIの「詳細」アイコンをクリックします。

次の図に示すように、データはページの右側にあるペインに表示されます。

表示される分析は、「統計の表示」リストで選択したオプションによって決まります。「現在の集約間隔」を選択して現在の集約間隔(詳細ページに表示される「期間」)のみの分析を表示するか、「最後のリセット以降」を選択して最後のリセット以降の分析統計を表示します。

8.2.3 APIの詳細な分析の表示

詳細ページでAPIのさらに詳細な統計を表示できます。API詳細ページのデータの説明は、「API詳細ページに表示される分析データ」を参照してください。

APIの詳細な分析を表示するには:

1. 「カタログ」で、詳細な分析データを表示するAPIを見つけます。

2. APIの「詳細」アイコンをクリックした後、「詳細」タブをクリックして詳細ページを表示します。

3. (オプション)「統計の表示」リストから、「現在の集約間隔」を選択して現在の集約間隔(詳細ページに表示される「期間」)のみの分析を表示するか、「最後のリセット以降」を選択して最後のリセット以降の分析統計を表示します。

8.2.4 API詳細ページに表示される分析データ

API詳細ページにはAPIについて次のステータスが表示されます。

- 管理対象ステータス: APIが管理対象か管理対象外かを示します。

- 非推奨ステータス: APIが非推奨か非推奨以外かを示します。

次の図に、サンプルのAPI詳細ページを示します。

API詳細ページには、次の分析が表示されます。

- 現在のAPIステータス: APIが稼働しているか停止しているかを示します。

- エラー数: このAPIの起動時に受信したエラーの数が表示されます。

- メッセージ数: APIから受信したメッセージの数が表示されます。

- 時間間隔: 表示されたデータが集計された時間を表示します。

- 平均レスポンス時間: 平均メッセージ・レスポンス時間(ミリ秒)が表示されます。集約間隔の変更の詳細は、『Oracle Service Busの管理』の「操作設定とグローバル設定の構成」を参照してください。

表示される分析は、「統計の表示」リストで選択したオプションによって決まります。「現在の集約間隔」を選択して現在の集約間隔(詳細ページに表示される「期間」)のみの分析を表示するか、「最後のリセット以降」を選択して最後のリセット以降の分析統計を表示します。

API詳細ページには、次のメタデータも表示されます。

要素

説明

APIプロファイル

APIに関連付けられている基本的なメタデータが表示されます。

API URL

APIのURLへのリンク。

バージョン

APIのバージョン情報が表示されます。

説明

APIの機能の詳細説明が表示されます。

タグ

APIに関連付けるタグのリストが表示されます。

管理

APIが管理対象か管理対象外かを示します。

SOAP

関連付けられたWSDLファイルのリンクが表示されます。

注意: このリージョンは、WSDLベースのSOAP APIの場合のみ表示されます。

WSDL

WSDLファイルへのリンクが表示されます。

OraWSDL

該当する場合、OraWSDLファイルへのリンクが表示されます。

REST

WADLファイルへのリンクが表示されます。

注意: このリージョンは、REST APIの場合のみ表示されます。

参照

APIの外部ドキュメント参照などの情報ソースが表示されます。

API詳細

APIの追加の詳細が表示されます。

セキュリティ概要

このAPIにアタッチするグローバル・セキュリティ・ポリシーの概要が表示されます。

セキュリティ・ポリシー

このAPIにアタッチされたセキュリティ・ポリシーが表示されます。ポリシーにカーソルを合せて「詳細」アイコンをクリックすると、ポリシーの説明が表示されます。

非推奨

APIが非推奨か非推奨以外かを示します。

テスト中

APIのテストURLが表示されます。

8.3 APIおよびAPIキュレーション・メタデータのインポートとエクスポート

ある環境から別の環境に移動する場合、APIおよびAPIメタデータを最初の環境からエクスポートした後、データをその他の環境にインポートする必要があります。 その他の環境にデータを簡単に移行できるように、Oracle API Managerでは、インポート機能とエクスポート機能が公開されています。

この項では、インポート機能とエクスポート機能の使用方法について説明し、テスト環境から本番環境にAPIとAPIメタデータを移行する際に使用するサンプルのWLSTスクリプトを示します。ここで説明されているタスクは、DeployerロールまたはIntegrationAdministratorロールを持つユーザーが実行します。

8.3.1 環境からのエクスポート

環境からデータをエクスポートするには:

1. 『Oracle Service Busでのサービスの開発』のコンソールで構成JARファイルにリソースをエクスポートする方法に関する項のタスクを完了して、Oracle Service Busコンソールから必要なプロジェクトおよびリソースが含まれる構成JARファイルをエクスポートします。

2. WLSTを使用するように環境が設定されていることと、必要なライブラリが組み込まれていることを確認します。<MW_HOME/osb/lib/apimanager-client.jarにあるJARファイルは、API Managerのインポートおよびエクスポートのコールが機能するようにクラスパスの中に入れる必要があります。

WLSTの使用方法の詳細はOracle Fusion Middlewareの管理のOracle WebLogic Scripting Tool (WLST)の使用のスタート・ガイドに関する項を、API ManagerのAPI参照ドキュメントはAPI Manager Javaリファレンスを参照してください。

3. Service Busコンソールから、WLSTスクリプトを作成してキュレーション・メタデータJARファイルをエクスポートします。サンプルのWLSTエクスポート・スクリプトについては、「キュレーション・メタデータをエクスポートするためのサンプル・スクリプト」を参照してください。

4. スクリプトを実行します。キュレーション・メタデータがJARファイルにエクスポートされます。名前および場所はスクリプトで定義したプロパティによって決定されます。

8.3.2 キュレーション・メタデータをエクスポートするためのサンプル・スクリプト

次の例は、変更可能で、Service Busコンソールからキュレーション・メタデータをエクスポートするために使用される、サンプルのexportCuration.pyスクリプトを表します。

例 - キュレーション・メタデータをエクスポートするためのサンプルのexportCuration.pyスクリプト

from oracle.apimanager.importexport import CatalogExportPlan

hostname = sys.argv[1]
port = sys.argv[2]
username = sys.argv[3]
password = sys.argv[4]

connect(username, password,'t3://'+hostname+':'+port)

domainRuntime()
cd('DomainServices/AdminService')

print '*********Exporting curation metadata...'
#export curation metadata for all projects
explan=CatalogExportPlan()

filename='<file_path>/<file_name>'

print '*********Exporting curation metadata to' + str(filename)
exportedjar=cmo.exportCatalog(explan)
exportfile=open(filename, 'wb')
exportedjar.tofile(exportfile)
exportfile.close()
print '*********Export curation metadata finished...'

print '*********Exiting...'
exit()

8.3.3 環境へのインポート

環境にデータをインポートするには:

1. 『Oracle Service Busでのサービスの開発』のセッションの作成方法に関する項のタスクを完了して、Oracle Service Busコンソールで新しいセッションを作成します。

2. 『Oracle Service Busでのサービスの開発』のコンソールで構成JARファイルからリソースをインポートする方法に関する項のタスクを完了して、「環境からのエクスポート」の手順1で作成した構成JARをService Busコンソールにインポートします。

3. 『Oracle Service Busでのサービスの開発』のセッションのアクティブ化方法に関する項の手順を完了して、Service Busセッションをアクティブにします。

4. WLSTを使用するように環境が設定されていることと、必要なライブラリが組み込まれていることを確認します。<MW_HOME/osb/lib/apimanager-client.jarにあるJARファイルは、API Managerのインポートおよびエクスポートのコールが機能するようにクラスパスの中に入れる必要があります。

WLSTの使用方法の詳細はOracle Fusion Middlewareの管理のOracle WebLogic Scripting Tool (WLST)の使用のスタート・ガイドに関する項を、API ManagerのAPI参照ドキュメントはAPI Manager Javaリファレンスを参照してください。

5. 「環境からのエクスポート」の手順3で作成したキュレーション・メタデータJARファイルを、Service BusコンソールにインポートするWLSTスクリプトを作成します。サンプルのWLSTインポート・スクリプトについては、「キュレーション・メタデータをインポートするためのサンプル・スクリプト」を参照してください。

6. スクリプトを実行します。JARからメタデータがService Busコンソールにインポートされます。APIメタデータは、APIが公開されるとAPI Manager Portalに表示されます。

8.3.4 キュレーション・メタデータをインポートするためのサンプル・スクリプト

次の例は、変更可能で、Service Busコンソールにキュレーション・メタデータをインポートするために使用される、サンプルのimportCuration.pyスクリプトを表します。

例 - キュレーション・メタデータをインポートするためのサンプルのimportCuration.pyスクリプト

from oracle.apimanager.importexport import CatalogImportPlan
from java.util import HashSet

hostname = sys.argv[1]
port = sys.argv[2]
username = sys.argv[3]
password = sys.argv[4]

connect(username, password,'t3://'+hostname+':'+port)

domainRuntime()
cd('DomainServices/AdminService')

print 'Importing curation metadata...'
implan=CatalogImportPlan()

#select projects to be imported
#if project set is empty, all projects will be included
projects=HashSet()
projects.add('SOAPProject')
implan.setProjects(projects)

print 'import plan: '
getproj=implan.getProjects()
for gp in getproj:
print str(gp)

jar=open('<file_path>/<file_name>', "rb").read()

result=cmo.importCatalog(jar,implan)
jar.close()
print 'Import curation metadata finished...'

print '*********Printing All entries in archive...'
content=result.getContent()
for ct in content:
print ct.getFullName()

print '*********Printing imported entries...'
importset=result.getImported()
for ref in importset:
print ref.getFullName()

print '*********Printing skipped entries...'
skipset=result.getSkipped()
for skref in skipset:
print skref.getFullName()

print '*********Exiting...'
exit()

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

コピーライトについて

Copyright © 1994-2017, 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を参照してください。