APIクライアントの管理

​

はじめに

管理者設定のAPIクライアント機能を使用すると、独自のAPIクライアントを作成および管理でき、管理者ユーザーはインスタンスのすべてのAPIクライアントを管理できます。APIクライアントでは、クライアントとそのスコープのリストが表示され、不要になったクライアントを取り消すことができます。

---

​

必要な許可

APIクライアント機能にアクセスするには、次のいずれかの許可が必要です。

• API OAuthクライアントを作成 — 独自のAPIクライアントを閲覧および取り消しできます。APIクライアントを作成するには、この許可が必要です。
• （管理者のみ）全てのアクセストークンとAPIクライアントを管理 — 管理者がDomoインスタンス内のすべてのAPIクライアントを閲覧および取り消しできます。

以下の表に、許可ごとの違いを示します。

アクセス	API OAuth クライアントを作成	全てのアクセストークンと APIクライアントを管理
クライアントの作成
自分が所有しているクライアントの閲覧
インスタンス内のすべてのクライアントの閲覧
作成したクライアントの削除/取り消し
インスタンス内のすべてのクライアントのアクセス権の取り消し

​

APIクライアントにアクセスする

［管理者］>［認証］>**［APIクライアント］**に移動します。

​

APIクライアントを作成する

**注記：**現在はAPIクライアントをDomoデベロッパーポータル

でも作成できますが、この機能は今後削除される予定です。

［API OAuthクライアントを作成］の許可を持つユーザーは、次の手順を実行してクライアントを作成できます。

1. APIクライアント機能にアクセスし、**［作成］**を選択して作成モーダルを開きます。

2. モーダルで、クライアントの一意の名前と説明を入力します。適切なクライアントガバナンスを促進するためにも、APIクライアントの計画的な運用法が反映された名前と説明を選択します。

   

3. クライアントに付与するスコープを選択します。

**注記：**Domoでは、最小権限の原則に従い、ユースケースで必要なスコープのみをクライアントに付与することを推奨しています。

重要： 4. **［作成］**を選択します。確認後、新しいクライアントのIDとシークレットが表示されます。**重要：**クライアントシークレットが表示されるのはこのタイミングだけです。

**警告：**クライアントIDとクライアントシークレットは、Domoインスタンスへのアクセスを付与するため、非常に機密性が高い情報です。これらの資格情報は、組織のセキュリティポリシーに従って取り扱ってください。

​

APIクライアントを閲覧および管理する

APIクライアントページには、自身の許可に応じて、Domoインスタンス内のアクティブなAPIクライアントがリスト表示されます。

セキュリティを確保するために、リストにはクライアントIDの一部のみが表示され、クライアントシークレットは表示されません。クライアントのスコープと所有者も併せて表示されます。

​

クライアントを削除する

APIクライアントは編集できませんが、自身の許可に応じてクライアントを削除できます。クライアントを削除するには、次の手順を実行します。

1. 削除するクライアントの行で、

   詳細（縦の三点リーダー）>**［削除］**を選択します。

   

2. 確認ダイアログで、**［取り消す］**を選択します。

   

**重要：****［取り消す］**を選択すると、警告ダイアログは表示されないまま、クライアントが取り消されます。この操作は元に戻せないため、正しいクライアントを取り消していることを確認してください。既存のセッションは、有効期限が切れるまで引き続き有効であることにご注意ください。