コンテンツにスキップ
DimensionKit
Try the app

接続の管理

接続されたアシスタントはすべてあなた自身の権限で動作し、チームメンバーが作成したものを含め、アカウント内のすべてのスコアカードおよび回答データにアクセスできます。他人のアカウントにアクセスすることはできません。

管理画面の Connected apps から、現在アカウントに接続されているすべてのアプリケーション、許可されているスコープ、接続日時の一覧を確認できます。

該当アプリの行にある Disconnect ボタンを押します。アクセス権はその瞬間に失効し、再接続するには再度認可フローを通す必要があります。

接続を切断しても、作成済みのスコアカードや収集した回答データが削除されることはありません。

内部では2つのトークンが機能しています:

トークン 有効期間 役割
アクセストークン 1時間 アシスタントからの各リクエスト時に送信
リフレッシュトークン 30日間 バックグラウンドで新しいアクセストークンを取得

リフレッシュが行われるたびに新しいリフレッシュトークンが再発行され、そこから30日間のカウントが再スタートします:

  • 定期的に使い続けているアシスタントは半永久的に接続を維持します。
  • 30日間利用がなかったアシスタントは自動的に失効し、再接続が必要になります。

付与されたスコープはセッション中固定されます。権限を拡大または縮小したい場合は、一度切断し、希望するスコープを選択して再接続してください。クライアントの接続を参照してください。

DimensionKitは /oauth/revoke エンドポイントにて RFC 7009 トークン失効仕様をサポートしています:

POST /oauth/revoke
Content-Type: application/x-www-form-urlencoded
token=<access-or-refresh-token>&token_type_hint=access_token&client_id=<your-client-id>
  • いずれかのトークンを失効させると、ペアとなる認可全体が無効化されます。
  • token_type_hint は省略可能です。
  • 未知のトークンや失効済みのトークンに対しても 200 を返します。
  • クライアントは自身に発行されたトークンのみを失効できます。