認証
Oracle WebCenter Portal Rest APIでは、ユーザー名およびパスワードを受け入れる基本認証を第一に持ち、リソース索引にアクセスします。リソース索引(/rest/api)では、ユーザーにAPIトークンを与えて、ポータルAPIにアクセスします。
APIトークンを取得してREST APIにアクセスする方法は次のとおりです。
次のURL構造を使用してOracle WebCenter Portal REST APIリソースにアクセスします。
https://hostname:port/rest/api/
「認可」詳細および「承認」詳細を入力します。
HTTPヘッダー
説明
認可
WebCenter Portalのユーザー名とパスワードを使用した基本認証
受入れ
application/json
utokenが「レスポンス」メッセージに表示されています。次の例では、utoken付きの「レスポンス」メッセージにサンプル索引URLを提供しています。
{ "links": [ { "href": "http://hostname:port/rest/api/v1/resourceIndex?utoken=sampletoken", "rel": "alternate", "resourceType": "urn:oracle:webcenter:resourceindex", "capabilities": "urn:oracle:webcenter:read" }, "resourceType": "urn:oracle:webcenter:resourceindex", "version": "12.2.1.0.0" }
utokenがわかると、次のようにOracle WebCenter Portal REST APIリソースにアクセスできるようになります。
curl -u jstein:welcome1 -H "Content-Type:application/json" -H "Accept: application/json" -X POST -d '{"commentStr":"add test Comment"}' http://hostname.port/rest/api/v1/portal/portals?utoken=sampletoken
注意:
『Oracle WebCenter Portalの管理』で示しているように、Oracle WebCenter Portalリソースを作成、管理および削除する権限があることを確認してください。
HTTPSの場合、Verisign CA証明書に対して信頼できることを証明するSSL認証局(CA)の証明書ファイルまたはバンドルが認証に必要です。