接続の管理
接続されたアシスタントはすべてあなた自身の権限で動作し、チームメンバーが作成したものを含め、アカウント内のすべてのスコアカードおよび回答データにアクセスできます。他人のアカウントにアクセスすることはできません。
接続中アプリの確認
Section titled “接続中アプリの確認”管理画面の Connected apps から、現在アカウントに接続されているすべてのアプリケーション、許可されているスコープ、接続日時の一覧を確認できます。
該当アプリの行にある Disconnect ボタンを押します。アクセス権はその瞬間に失効し、再接続するには再度認可フローを通す必要があります。
接続を切断しても、作成済みのスコアカードや収集した回答データが削除されることはありません。
接続の有効期間
Section titled “接続の有効期間”内部では2つのトークンが機能しています:
| トークン | 有効期間 | 役割 |
|---|---|---|
| アクセストークン | 1時間 | アシスタントからの各リクエスト時に送信 |
| リフレッシュトークン | 30日間 | バックグラウンドで新しいアクセストークンを取得 |
リフレッシュが行われるたびに新しいリフレッシュトークンが再発行され、そこから30日間のカウントが再スタートします:
- 定期的に使い続けているアシスタントは半永久的に接続を維持します。
- 30日間利用がなかったアシスタントは自動的に失効し、再接続が必要になります。
権限スコープの変更
Section titled “権限スコープの変更”付与されたスコープはセッション中固定されます。権限を拡大または縮小したい場合は、一度切断し、希望するスコープを選択して再接続してください。クライアントの接続を参照してください。
クライアント開発者向け仕様
Section titled “クライアント開発者向け仕様”DimensionKitは /oauth/revoke エンドポイントにて RFC 7009 トークン失効仕様をサポートしています:
POST /oauth/revokeContent-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を返します。 - クライアントは自身に発行されたトークンのみを失効できます。