3 認証

Oracle Compute Cloud ServiceへのすべてのAPIコールを認証する必要があります。 APIコールは、トークンを使用して認証されます。 Oracle Compute Cloud Serviceから認証トークンをリクエストできます。後続のAPIコールに、このトークンを含めます。この項では、認証トークンをリクエストする方法について説明します。

トピック:

ユーザーの認証

ユーザーの認証

このAPIを使用すると、認証トークンを取得できます。

このAPIリクエストは、Set-Cookieレスポンス・ヘッダーに認証トークンを返します。デフォルトで、トークンは5分後に失効します。サービスへのすべてのリクエストで、有効(つまり、有効期限が切れていない)認証トークンがCookie:レスポンスのヘッダーに含まれている必要があります。クライアントは、有効期限をチェックし、cookieが期限切れの場合、cookieを破棄する必要があります。リクエストに期限切れのcookieが含まれる場合、Unauthorizedエラーが発生します。

メソッド

POST

RESTリソース

/authenticate/

URI

https://api_endpoint/authenticate/

リクエスト本文のパラメータ

パラメータ	説明
user	ユーザー名
password	ユーザーのパスワード。

URIの例

https://api.oc.example.com/authenticate/

リクエスト本文の例

{"user": "/mytenant/admin", "password": "mytenant2psswd123" }

レスポンス・ヘッダーの例

204 No Content
Used response headers:
x-oracle-compute-call-id: 15102801fb6b260ec3b522beb113021d200f3e
Set-Cookie: nimbula={"identity": "{\"realm\": \"apiexample\", \"value\":
 \"{\\\"customer\\\": \\\"mytenant\\\", \\\"realm\\\": \\\"apiexample\\\",
 \\\"entity_type\\\": \\\"user\\\", \\\"session_expires\\\": 1405250409.271111,
 \\\"expires\\\": 1405241409.271148, \\\"user\\\": \\\"/mytenant/admin\\\",
 \\\"groups\\\": [\\\"/mytenant/admin\\\", \\\"/mytenant\\\"]}\",
 \"signature\": \"AE2vZOGt0XIIEstK0HL6IgJ7vrRxgo30qQrWhwepRbNbATuEMh2k...\"}"};
 Path=/; Max-Age=10800
 expires: Wed, 28 Oct 2015 08:01:04 GMT
 vary: Accept
 server: nginx
 connection: keep-alive
 cache-control: no-cache
 date: Wed, 28 Oct 2015 08:01:04 GMT
 content-type: application/oracle-compute-v3+json