認証
Oracle WebCenter Portal Rest APIでは、ユーザー名およびパスワードを受け入れる基本認証を第一に持ち、リソース索引にアクセスします。リソース索引(/rest/api
)では、ユーザーにAPIトークンを与えて、ポータルAPIにアクセスします。
APIトークンを取得してREST APIにアクセスする方法は次のとおりです。
-
次のURL構造を使用してOracle WebCenter Portal REST APIリソースにアクセスします。
https://hostname:port/rest/api/v1/resourceIndex
-
「認可」詳細および「承認」詳細を入力します。
HTTPヘッダー 説明 認可
WebCenter Portalのユーザー名とパスワードを使用した基本認証
受入れ
application/json
utoken
が「レスポンス」メッセージに表示されています。次の例では、utoken
付きの「レスポンス」メッセージにサンプル索引URLを提供しています。{{ "links": [ { "href": "http://example.com:8888/rest/api/v1/portal/visualizationtemplates?utoken=abcd_1OABAC5wordfhVoMLRDcT6F5vL_w%2A%2A", "resourceType": "urn:oracle:webcenter:portal:visualizationtemplates", "capabilities": "urn:oracle:webcenter:read urn:oracle:webcenter:create", "template": "http://example.com:8888/rest/api/v1/portal/visualizationtemplates?q={q}& offset={offset}& orderBy={orderBy}& limit={limit}& utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w**" }, { "href": "http://example.com:8888/rest/api/v1/portal/portals?utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w%2A%2A", "resourceType": "urn:oracle:webcenter:portal:portals", "capabilities": "urn:oracle:webcenter:read urn:oracle:webcenter:create", "template": "http://example.com:8888/rest/api/v1/portal/portals?q={q}& offset={offset}& includePortalContent={includePortalContent}& orderBy={orderBy}& limit={limit}& utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w**" }, { "href": "http://example.com:8888/rest/api/v1/portal/pages?utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w%2A%2A", "resourceType": "urn:oracle:webcenter:portal:pages", "capabilities": "urn:oracle:webcenter:read urn:oracle:webcenter:create", "template": "http://example.com:8888/rest/api/v1/portal/pages?q={q}& offset={offset}& orderBy={orderBy}& limit={limit}& utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w**" }, { "href": "http://example.com:8888/rest/api/v1/portal/resourcecatalogs?utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w%2A%2A", "resourceType": "urn:oracle:webcenter:portal:resourcecatalogs", "capabilities": "urn:oracle:webcenter:read urn:oracle:webcenter:create", "template": "http://example.com:8888/rest/api/v1/portal/resourcecatalogs?q={q}& offset={offset}& orderBy={orderBy}& limit={limit}& utoken=ICoaAzpMRMbQpxAcJ_1OABAC50CobfhVoMLRDcT6F5vL_w**" }, "resourceType": "urn:oracle:webcenter:resourceindex", "version": "12.2.1.3.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リソースを作成、管理および削除する権限があることを確認してください。
HTTPSの場合、Verisign CA証明書に対して信頼できることを証明するSSL認証局(CA)の証明書ファイルまたはバンドルが認証に必要です。