Oracle® Fusion Middleware Oracle Web Services Managerでの資格証明およびキーストアの管理のためのREST API 11g リリース1 (11.1.1.9) E61941-03 |
|
![]() 前 |
![]() 次 |
この項では、資格証明およびキーストアの管理のためのOracle Fusion Middleware Representational State Transfer (REST) APIについて説明します。
トピック:
資格証明およびキーストアを管理するREST APIは、ドメインおよびWebサービスの資格証明ストア、キーストアおよびトラスト・ストアを作成および構成するためのエンドポイントを提供します。
RESTエンドポイントは、次のようなクライアント・アプリケーションからアクセスできます。
Oracle WSM RESTエンドポイントは、次のような言語で開発されたRESTクライアント・アプリケーションで使用することもできます。
JavaScript
Ruby
Perl
Java
JavaFX
REST APIを使用する前に、次の項で説明するいくつかの重要なコンセプトを理解する必要があります。
セキュリティ・ストアの管理には、次のURLを使用します。
http(s)://host:port/idaas/contextpath/admin/v1/resource
各要素の意味は次のとおりです。
host
:port: Oracle Fusion Middlewareを実行しているホストおよびポート。
contextpath
: RESTリソースのコンテキスト・パス。この値は、ドメイン全体に適用されるリソース(キーストアや資格証明の管理リソースなど)の場合はplatform
、特定のWebサービスに適用されるリソース(信頼管理リソースなど)の場合はwebservice
に設定できます。
resource
: RESTリソースを定義する相対パス。詳細は、「REST APIリファレンス」を参照してください。Web Application Definition Language (WADL)ドキュメントにアクセスするには、application.wadl
を指定します。
Oracle WSM RESTエンドポイントは、Oracle WSMインスタンスを作成および管理するための標準メソッドをサポートします。
RESTメソッド | タスク |
---|---|
GET |
RESTリソースに関する情報を取得します。 |
POST |
RESTリソースを追加します。 |
PUT |
RESTリソースを更新します。 |
DELETE |
RESTリソースを削除します。 |
Oracle Fusion Middleware RESTリソースにHTTPでアクセスし、Oracle WebLogic Server管理者のユーザー名とパスワードを入力する必要があります。
たとえば、cURLを使用して認証するには、-u
cURLオプションを使用してユーザー名とパスワード(たとえば、Smithとpassword)を渡します。
curl -i -X GET -u Smith:password http://myhost:7001/idaas/platform/admin/v1/keystore
リクエスト本文でデータを送信しないPOST
およびDELETE
メソッドでは、キーストアまたはキーがパスワードで保護されている場合、カスタム・ヘッダーで、Base64で暗号化されたキーストアおよびキーのパスワードを渡す必要があります。次に例を示します。
curl -i -X DELETE -u Smith:password -H keystorePassword:password== -H keyPassword:password http://myhost:7001/idaas/platform/admin/v1/keystoreservice/certificates?"stripeName=myStripe&keystoreName=myKeystore&keyAlias=myAlias"
この項で説明されているリソースの操作に使用されるHTTPメソッドはすべて、次のHTTPステータス・コードのいずれかを返します。
HTTPステータス・コード | 説明 |
---|---|
200 OK | リクエストは正常に完了しました。ステータス200は、GET またはPOST メソッドが成功した場合に返されます。 |
201 Created | 要求が満たされ、新規リソースが作成されます。レスポンスには、新たに作成されたリソースの正規のURIを含むLocationヘッダーが含まれています。
ステータス201は、同期リソースの作成、またはレスポンスが返される前に完了した非同期リソースの作成から返されます。 |
202 Accepted | 要求の処理は受け入れられましたが、処理は完了していません。要求は、実際に処理される時に拒否される可能性があるため、最終的に処理されない場合もあります。
非同期( クライアントは、レスポンスに含まれるジョブ・リソースのLocationヘッダーを調べて、ジョブが終了した時期を確認する必要があります。ジョブの現在の状態を表すエンティティも返されます。 |
400 Bad Request | 情報が欠落しているか不適切であるため(入力フィールドの検証エラー、必須値の欠落など)、リクエストを処理できませんでした。 |
401 Unauthorized | リクエストが認可されていません。このリクエストに認証資格証明がないか、または無効です。 |
403 Forbidden | ユーザーを認証できません。ユーザーにはこのリクエストを実行する権限がありません。 |
404 Not Found | リクエストには、存在しないリソースURIが含まれています。 |
405 Method Not Allowed | リクエストに指定されたHTTP動詞(DELETE 、GET 、POST 、PUT )は、このリクエストURIではサポートされていません。 |
406 Not Acceptable | このリクエストによって識別されたリソースは、リクエストのAcceptヘッダーのいずれかのメディア・タイプに対応する表現を生成できません。たとえば、クライアントのAcceptヘッダーがXMLを返すように要求しているが、リソースとして返すことができるのはJSONのみである場合。 |
415 Not Acceptable | クライアントのContentTypeヘッダーが正しくありません(たとえば、クライアントがXMLでリクエストを送信しようとしたが、リソースがJSONのみを受理できる場合)。 |
500 Internal Server Error | サーバーに予期せぬ状態が発生し、リクエストを処理できませんでした。 |
503 Service Unavailable | サーバーが一時的に高負荷の状態にあるかメンテナンス中であるため、リクエストを処理できません。Oracle WSM REST Webアプリケーションは現在実行されていません。 |
このドキュメント内の例では、Oracle Java Cloud ServiceのRESTリソースへのアクセス方法を示すためにcURLを使用しています。
これらの例では、cURLの実行を指示するために次のオプションが1つ以上使用されています。
cURLオプション | 説明 |
---|---|
--data @file.json |
ローカル・マシン上のJSON形式のリクエスト・ドキュメントを識別します。 |
--form " name=value " |
フォーム・データを識別します。 |
-H |
次のうちの1つまたは両方を定義するヘッダー。
|
-i |
レスポンス・ヘッダー情報を表示します。 |
-u username:password |
認証のためのWebLogic管理者のユーザー名とパスワードを指定します。 |
-X |
リクエストの種類を指定します(GET、POSTなど)。サポートされるRESTメソッドの詳細は、「サポートされるRESTメソッド」を参照してください。 |
次に例を示します。
curl -i -X GET -u Smith:password http://myhost:7001/idaas/platform/admin/v1/keystore
cURLのダウンロードおよび使用の詳細は、http://curl.haxx.se
を参照してください。