認証

Oracle WebCenter Portal Rest APIでは、ユーザー名およびパスワードを受け入れる基本認証を第一に持ち、リソース索引にアクセスします。リソース索引(/rest/api)では、ユーザーにAPIトークンを与えて、ポータルAPIにアクセスします。

APIトークンを取得してREST APIにアクセスする方法は次のとおりです。

1. 次のURL構造を使用してOracle WebCenter Portal REST APIリソースにアクセスします。

   https://hostname:port/rest/api/v1/resourceIndex

2. 「認可」詳細および「承認」詳細を入力します。

   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"
   }

3. 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)の証明書ファイルまたはバンドルが認証に必要です。