発行済のアクセストークン一覧を取得する方法

概要


本ドキュメントでは、既に発行済のアクセストークン一覧を取得する方法について解説します。


/auth/token/get/list API


発行済のアクセストークン一覧を取得するためには /auth/token/get/list API を利用してください。

定義


GET /auth/token/get/list?clientIdentifier={clientIdentifier}&subject={subject}&start={start}&end={end}

リクエスト


パラメーター
パラメーター名
必須
説明
デフォルト値
clientIdentifier
NO
特定のクライアントに紐づくアクセストークン一覧を取得したい場合はこのパラメーターに対象のクライアントの識別子を指定する。識別子として指定できる値は、クライアント ID あるいはクライアント ID の別名のいずれかである。
なし
subject
NO
特定のユーザーに紐づくアクセストークン一覧を取得したい場合はこのパラメーターに対象のユーザーの一意識別子を指定する。
なし
start
NO
検索結果の開始インデックス。
0
end
NO
検索結果の終了インデックス。
5

(注意) 本 API より返却されるアクセストークンの数 (= end - start の値) は、最大で 20 となっています (パフォーマンス劣化を防ぐため)。したがって、これを超えるようなパラメーター指定はエラーとなりますのでご注意ください。

レスポンス


パラメーター

パラメーター名
説明
accessTokens
アクセストークンのリスト。 返却されるアクセストークンの情報については下記「アクセストークンの情報」を参照のこと。
start
検索結果の開始インデックス。
end
検索結果の終了インデックス。
totalCount
検索条件に該当するアクセストークンの総数。この値は accessTokens の要素数とは異なるので注意すること。

アクセストークンの情報

パラメーター名
説明
accessTokenExpiresAt
アクセストークンの有効期限。
accessTokenHash
アクセストークンのハッシュ値。
clientId
アクセストークンに紐づけられているクライアントの ID。
createdAt
アクセストークンの作成日時。
grantType
アクセストークン生成時における認可種別。アクセストークンが更新されてもこの値は変更されないことに注意。
lastRefreshedAt
アクセストークンが最後にリフレッシュトークンによって更新された日時。
refreshTokenExpiresAt
リフレッシュトークンの有効期限。
refreshTokenHash
リフレッシュトークンのハッシュ値。
scopes
アクセストークンに紐づけられているスコープ群。
subject
アクセストークンに紐づけられているユーザー一意識別子。

レスポンス例

{
                          "accessTokens": [
                              {
                                  "accessTokenExpiresAt": 1527583747000,
                      	    "accessTokenHash": "kjjduowWXMPiHt1AjxbgkqWANOsVWQfKYCyFO76q1MU",
                      	    "clientId": 11867130158,
                      	    "createdAt": 1527497347000,
                      	    "grantType": "AUTHORIZATION_CODE",
                      	    "lastRefreshedAt": 0,
                      	    "refreshTokenExpiresAt": 1528361347000,
                      	    "refreshTokenHash": "hCkIkuS6py0drpe5XOybw0MxkgsYNOk2q3dtilLiI64",
                      	    "scopes": ["openid"],
                      	    "subject": "john"
                              }, 
                              {...},
                              {...},
                              {...},
                              {...}
                          ],
                          "end": 5,
                          "start": 0,
                          "totalCount": 15
                      }
How did we do with this article?