詳細情報:
外部クライアントアプリケーション OAuth の利用状況
外部クライアントアプリケーション OAuth の利用状況情報を取得し、Connect REST API を使用してトークンを取り消します。Connect API は、組織のユーザーが接続している外部クライアントアプリケーション、アプリケーションのすべての OAuth ユーザーのリスト、または特定のアプリケーションとユーザーのトークンに関する情報を返します。外部クライアントアプリケーションへのアクセス権を取り消す場合、Connect API 使用状況リソースを使用して、特定のトークン、アプリケーションに関連付けられたすべてのトークン、または特定のユーザーに関連付けられたトークンを取り消します。
接続アプリケーションを操作する場合、システム管理者は [設定] の [利用状況] ページから利用状況情報にアクセスします。外部クライアントアプリケーションには UI コンポーネントがないため、外部クライアントアプリケーションの利用状況情報は Connect REST API を介してのみ使用できます。
Connect REST API
Connect REST API を使用して OAuth 利用状況リソースにアクセスします。登録者組織の外部クライアントアプリケーションのシステム管理者は、使用状況リソースにアクセスするために特別な権限は必要ありません。
OAuth 利用状況機能
Connect API の OAuth 利用状況には 5 つの URI があります。5 つのエンドポイントではそれぞれ、GET メソッドと DELETE メソッドのいずれか、または GET メソッドと DELETE メソッドの両方がサポートされています。次のコンポーネントを使用して、アプリケーションの利用状況を監視し、トークンを取り消します。このリソースの詳細は、『Connect REST API 開発者ガイド』を参照してください。
| URI | メソッド | 説明 |
|---|---|---|
| /apps/oauth/usage/ | GET | 現在の組織のすべての外部クライアントアプリケーションをリストします。「OAuth Usage」を参照してください。 |
| /apps/oauth/usage/<appIdentifier>/users | GET | アプリケーション ID で示された外部クライアントアプリケーションのすべてのユーザーをリストします。 「OAuth Users by App ID」を参照してください。 |
| /apps/oauth/usage/<appIdentifier>/<userIdentifier>/tokens | GET | 外部クライアントアプリケーションのユーザーのすべてのトークンをリストします。「Refresh Token by User and App」を参照してください。 |
| /apps/oauth/usage/<appIdentifier>/<userIdentifier>/tokens | DELETE | 外部クライアントアプリケーションのユーザーのすべてのトークンを取り消します。「Refresh Token by User and App」を参照してください。 |
| /apps/oauth/usage/<appIdentifier>/tokens | DELETE | 外部クライアントアプリケーションで使用できるすべてのトークンを取り消します。「Refresh Token by App ID」を参照してください。 |
| /apps/oauth/usage/tokens/<tokenIdentifier> | DELETE | 1 つのトークンを取り消します。「OAuth Refresh Token」を参照してください。 |
