メインコンテンツへスキップ

はじめに

管理者設定の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クライアントの計画的な運用法が反映された名前と説明を選択します。
    Screenshot 2025-01-17 at 11.55.54 AM.png
  3. クライアントに付与するスコープを選択します。
注記: Domoでは、最小権限の原則に従い、ユースケースで必要なスコープのみをクライアントに付与することを推奨しています。
Screenshot 2025-01-17 at 11.56.03 AM.png
  1. [作成] を選択します。確認後、新しいクライアントのIDとシークレットが表示されます。 重要: クライアントシークレットが表示されるのはこのタイミングだけです。
    警告: クライアントIDとクライアントシークレットは、Domoインスタンスへのアクセスを付与するため、非常に機密性が高い情報です。これらの資格情報は、組織のセキュリティポリシーに従って取り扱ってください。
    Screenshot 2025-01-13 at 8.47.30 AM.png
このページのトップへ

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

APIクライアントページには、自身の 許可 に応じて、Domoインスタンス内のアクティブなAPIクライアントがリスト表示されます。 セキュリティを確保するために、リストにはクライアントIDの一部のみが表示され、クライアントシークレットは表示されません。クライアントのスコープと所有者も併せて表示されます。

クライアントを削除する

APIクライアントは編集できませんが、自身の 許可 に応じてクライアントを削除できます。クライアントを削除するには、次の手順を実行します。
  1. 削除するクライアントの行で、 詳細 (縦の三点リーダー)> [削除] を選択します。
  2. 確認ダイアログで、 [取り消す] を選択します。
    Screenshot 2025-01-13 at 9.49.28 AM.png
    重要: [取り消す] を選択すると、警告ダイアログは表示されないまま、クライアントが取り消されます。この操作は元に戻せないため、正しいクライアントを取り消していることを確認してください。既存のセッションは、有効期限が切れるまで引き続き有効であることにご注意ください。
このページのトップへ 日本語