アプリケーションプログラミングインターフェースガイド> REST API> TDVサーバーREST API> Auth API
 
Auth API
API呼び出しを使用して、認証と承認のためのトークンを発行/要求/取り消すことができます。実行できるオペレーションは次のとおりです。
POST/auth/refreshToken
DELETE/auth/revokeToken
POST/auth/requestToken
POST/auth/spnegoRequestToken
POST/auth/refreshToken
このAPIは、更新トークンを使用して新しいトークンを発行するために使用されます。更新トークンはCookieに含まれていると見なされます。
パラメーター
なし。
ユーザーのCookieの更新トークンを使用して新しいトークンを発行する例
curl -X POST -b cookie.txt "http://localhost:9400/rest/auth/v1/refreshToken"
DELETE/auth/revokeToken
更新トークンがCookieにあると仮定すると、このAPIを使用してトークンが取り消され、セッションが終了します。
パラメーター
なし
Cookieの更新トークンを取り消す例
curl -X DELETE -b cookie.txt "http://localhost:9400/rest/auth/v1/revokeToken"
POST/auth/requestToken
このAPIは、トークンをリクエストするために使用されます。
パラメーター
なし
リクエスト本文
値の例-スキーマ
[
{
"string"
}
]
リクエスト本文でユーザー「admin」のトークンをリクエストする例
curl -X POST -u admin:admin -c cookie.txt "http://localhost:9400/rest/auth/v1" -H "Content-Type:application/json" -d "{\"appId\":\"Contrail\"}"
POST/auth/spnegoRequestToken
このAPIは、Kerberos(GSS)認証を使用してトークンを要求するために使用されます。
パラメーター
なし
リクエスト本文
値の例-スキーマ
[
{
"string"
}
]
要求本文でKerberosユーザーのトークンを要求する例
curl -X POST --negotiate -u : -c cookie.txt "http://localhost:9400/rest/auth/v1/spnegoRequestToken" -H "Content-Type:application/json" -d "{\"appId\":\"Contrail\"}"