はじめに
連携 / SDK
ユーザー認証
法人確認
トランザクションモニタリング
変更履歴https://mcp.didit.me/mcpにあるホスト型サーバーは、サインインしたユーザーに169個のツールを提供します。内訳は読み取り80個、書き込み62個、破壊的操作27個です。
17個のInvestigatorツールも一覧に含まれていますが、組織でInvestigatorが有効になっている場合にのみ動作します。
さらに2つのツール（didit_org_top_upとdidit_org_reveal_application_api_key）は、OAuthで認証されたすべてのカタログで非表示になっており、ローカルのstdioサーバーにのみ表示されます。ローカルのstdioサーバーでは、アカウント設定用のツールも5つ追加されます（セルフホスティングを参照）。
このページは、didit-protocol/mcpのツールレジストリ（src/index.ts、ホスト型サーバーがserverInfoで報告するバージョン）から生成されています。名前、タイプ、必須引数はサーバー自身のtools/listレスポンスから取得しており、役割の権限はsrc/permissions.tsから取得しています。
表の見方
| 列 | 意味 |
|---|---|
| タイプ | ツールのMCPアノテーションに基づきます。読み取りは読み取り専用です。書き込みは何かを作成または変更します。破壊的は、データを削除または上書きするもの、即座に反映される変更を行うもの（公開済みのワークフロー、セッションの判定など）、シークレットを表示するもの、または資金を移動するものです。クライアントはこれらを実行する前に確認を求めます。課金対象のスタンドアロンチェックは書き込みとして扱われます。 |
| 対象範囲 | ツールに必要な役割の権限をリソースに含むOAuthスコープです。セッション、企業、ケース、ネットワーク、取引、ブロックリストにはdidit:verification、ワークフロー、アンケート、リスト、Webhook、連携、メンバー、役割、APIキー、監査ログ、組織、アプリケーション、サブスクリプション、ユーザーにはdidit:managementが対応します。いずれかは、両方のスコープに含まれるアナリティクス、または役割ごとのチェックがなく、承認したいずれかのスコープで実行されるツールを意味します。認証を参照してください。 |
| 役割の権限 | 組織での役割が保持している必要がある権限で、Diditのバックエンドがチェックするものです。ダッシュは、エンドポイントの範囲がメンバーシップで決まるか、役割ごとのチェックがないことを意味します。役割にその権限がない場合、ツールは権限名を示すmissing_scopeエラーを返します。 |
organization_idとapplication_idを受け付けます。組織とアプリが1つずつの場合は自動的に解決されます。複数ある場合は、*_searchツールとdidit_analyticsがそのすべてを対象とし、アプリ単位の*_listツールも対象範囲を渡さなければ同様に動作します。
didit_session_deleteとdidit_session_batch_deleteは、引数にconfirm: trueがないと実行を拒否します。Investigatorの判定ツール（accept、override、batch_accept、rereview、question_answer、question_dismiss）とローカル専用のdidit_org_reveal_application_api_keyも同様です。didit_case_manageはSARを提出する場合に、didit_vendor_user_deleteとdidit_vendor_business_deleteはdelete_allがtrueの場合に、これが必要です。ディスカバリーとアプリ横断
これらのツールは、アクセス可能なすべての組織とアプリケーションを1回の呼び出しで横断します。各行には組織とアプリのタグが付きます。| ツール | タイプ | 対象範囲 | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_context_get | 読み取り | いずれか | — | アクセスできるすべての組織とアプリケーションを階層構造で返します。組織とアプリが1つしかない場合は、デフォルトの組織とアプリも返します。最初に呼び出してください。 |
didit_session_search | 読み取り | didit:verification | list:sessions | すべてのアプリと組織にわたって認証セッションを新しい順に検索します。 |
didit_transaction_search | 読み取り | didit:verification | list:transactions | すべてのアプリと組織にわたって、モニタリング対象の取引を検索します。 |
didit_case_search | 読み取り | didit:verification | list:cases | すべてのアプリと組織にわたって調査ケースを検索します。 |
didit_vendor_user_search | 読み取り | didit:management | list:users | すべてのアプリにわたって、名前、メールアドレス、またはvendor_dataで顧客を検索します。 |
didit_vendor_business_search | 読み取り | didit:verification | list:businesses | すべてのアプリにわたってKYBの企業を検索します。 |
didit_workflow_search | 読み取り | didit:management | read:workflows | すべてのアプリにわたって、IDまたはラベルでワークフローを検索します。結果には、そのワークフローを所有する組織とアプリが示されます。 |
didit_analytics | 読み取り | いずれか | read:analytics | すべてのアプリにわたって、指定した期間の集計アナリティクス（リクエストの内訳、機能ごとのファネル、コンバージョン率）を取得します。 |
セッション(KYCとKYB)
| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_session_create | 書き込み | didit:verification | create:sessionsまたはwrite:sessions | ワークフローの認証セッションを作成します。session_id、url、session_tokenを返します。 |
didit_session_list | 読み取り | didit:verification | list:sessions | 1つのアプリケーション内のセッションを一覧表示します。スコープを指定しない場合は、すべてのアプリケーションが対象になります。 |
didit_session_get_decision | 読み取り | didit:verification | read:sessions | セッションの判定全体と、抽出されたすべてのデータを取得します。 |
didit_session_get_location_evidence | 読み取り | didit:verification | read:sessions | 1件のセッションについて、Locationステップごとに、Precise Locationの証拠を取得します。判定に用いた設定、判定結果、すべての試行、基準点、距離、エリアが含まれます。 |
didit_session_update_status | 破壊的 | didit:verification | write:sessions | セッションを承認または却下するか、再提出を依頼します。 |
didit_session_update_data | 書き込み | didit:verification | write:sessions | 本人確認書類から抽出されたデータを修正します(レビュアーによる上書き)。 |
didit_session_update_poa_data | 書き込み | didit:verification | write:sessions | 住所証明書類から抽出されたデータを修正します。 |
didit_session_delete | 破壊的 | didit:verification | delete:sessions | 1件のセッションを、その認証データおよびメディアとともに完全に削除します。confirm: trueが必要です。 |
didit_session_batch_delete | 破壊的 | didit:verification | delete:sessions | セッション番号で指定した複数のKYCセッション、またはアプリケーション内のすべてのKYCセッションを完全に削除します。confirm: trueが必要です。KYBセッションには一切影響しません。 |
didit_session_generate_pdf | 書き込み | didit:verification | read:sessions | セッションのPDF認証レポートを生成します。 |
didit_session_list_reviews | 読み取り | didit:verification | read:sessions | セッションのレビュー履歴とアクティビティログを取得します。 |
didit_session_add_review | 書き込み | didit:verification | write:sessions | セッションにレビューメモを追加します。必要に応じてステータスも変更できます。 |
didit_session_share | 書き込み | didit:verification | write:sessions | 認証済みのセッションを信頼できるパートナーと共有します(再利用可能なKYC)。 |
didit_session_import_shared | 書き込み | いずれか | - | パートナーから共有されたセッションをインポートします(再利用可能なKYC)。 |
didit_session_create_import | 書き込み | いずれか | - | ホストされたCSVまたはNDJSONファイルから一括インポートジョブを開始します。 |
didit_session_get_import_template | 読み取り | いずれか | - | インポートテンプレート(列ヘッダーと形式)をダウンロードします。 |
didit_session_get_import | 読み取り | いずれか | - | 一括インポートジョブのステータスと概要を取得します。 |
didit_session_get_import_errors | 読み取り | いずれか | - | 一括インポートジョブの行ごとの失敗を取得します。 |
didit_session_explain_decision | 読み取り | didit:verification | read:sessions | セッションが承認済み、却下、レビュー中のいずれかになった理由を説明します。決め手となった機能、影響を与えた各警告、トリガーされたすべてのステータスルール、レビュアーによる上書きの有無、各原因の元となったワークフロー設定が含まれます。 |
didit_session_webhooks | 読み取り | didit:verification | read:sessions | 過去30日間に1件のセッションについて送信されたWebhookの配信を取得します。送信先、HTTPステータス、タイミング、署名ヘッダー、サイズ上限付きのペイロードのコピーが含まれます。 |
didit_session_webhook_resend | 書き込み | didit:verification | create:sessions | セッションについて記録されたWebhook配信の1件を、設定済みのエンドポイントに再送信します。たとえば、エンドポイントを修正した後に使用します。 |
ワークフロー
シンプルなワークフローはフラットな機能リストです。グラフワークフローでは、分岐、条件、Document AIステップが加わります。応用: 分岐ワークフローを参照してください。| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_workflow_list | 読み取り | didit:management | read:workflows | 本人確認ワークフローを一覧表示します。スコープを指定しない場合は、すべてのアプリが対象になります。 |
didit_workflow_create | 書き込み | didit:management | write:workflows | 順序付きの機能リストから、シンプルな線形ワークフローを作成します。status: "draft"を渡さない限り公開されます。 |
didit_workflow_get | 読み取り | didit:management | read:workflows | 1つのワークフローの完全な設定を返します。機能ごとに返されるデータポイントも含みます。 |
didit_workflow_update | 破壊的 | didit:management | write:workflows | ワークフローの最上位の設定（ラベル、デフォルトフラグ、再試行、有効期限、ホワイトラベル、許可リスト）を変更します。 |
didit_workflow_delete | 破壊的 | didit:management | write:workflows | 下書きのワークフローを削除します。 |
didit_workflow_get_graph | 読み取り | didit:management | read:workflows | ワークフローのノードグラフを、そのステータスと編集可否とともに返します。大きな設定は、明示的に要求しない限り要約されます。 |
didit_workflow_get_field_definitions | 読み取り | didit:management | read:workflows | 分岐条件に使用できるすべてのフィールドと、それぞれが受け付ける演算子を返します。 |
didit_workflow_get_feature_config_schema | 読み取り | いずれか | — | 各ワークフロー機能が受け付けるすべてのconfigキーを、型、範囲、デフォルト値、意味とともに返します。 |
didit_workflow_get_id_verification_methods_catalog | 読み取り | didit:management | read:workflows | 国ごとに、提供されている書類以外の照会とデジタルIDウォレット、それらが本番提供中かどうか、照会のカタログ料金を返します。 |
didit_workflow_get_kyb_registry_catalog | 読み取り | いずれか | — | 国ごとに、登記所が提供する企業データのレベルと、登記モニタリングが販売されているかどうかを料金とともに返します。組織やアプリは不要です。 |
didit_workflow_get_branch_fields | 読み取り | didit:management | read:workflows | 候補グラフの1つの分岐点で利用可能なフィールドを返します。 |
didit_workflow_validate_graph | 読み取り | didit:management | read:workflows | グラフ全体をドライランで検証します。何も保存しません。 |
didit_workflow_edit_graph | 破壊的 | didit:management | write:workflows | 小さな操作で既存のグラフを変更します。サーバーがグラフ全体を自ら取得し、下書きとして保存します。 |
didit_workflow_set_graph | 破壊的 | didit:management | write:workflows | ワークフローのグラフ全体を置き換えます。下書きとして保存され、公開は別のステップです。 |
didit_workflow_create_draft | 書き込み | didit:management | write:workflows | 公開済みのワークフローから編集可能な下書きを作成します。 |
didit_workflow_publish | 破壊的 | didit:management | write:workflows | 保留中の下書きを公開し、新しいセッションでそれが使用されるようにします。 |
didit_workflow_build_graph | 読み取り | didit:management | read:workflows | シンプルな機能仕様から、何も保存せずに完全なグラフを構築します。 |
コンプライアンスアシスタント
規制プロファイルからワークフローを構築します。適応型のインタビュー、適用される義務とその根拠条文、そして生成される複数国対応のワークフローを提供します。| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_compliance_interview_next | 読み取り | didit:management | read:workflows | 適応型コンプライアンスインタビューの次の質問を返します。完了している場合はdoneを返します。呼び出しのたびに、それまでに収集したすべての回答を渡してください。 |
didit_compliance_profile_get | 読み取り | didit:management | read:workflows | 保存されているコンプライアンスプロファイル（インタビューの回答と、そこから導出された属性）を返します。 |
didit_compliance_profile_set | 破壊的 | didit:management | write:workflows | 完了したインタビューの回答を保存し、既存のコンプライアンスプロファイルがあれば置き換えます。 |
didit_compliance_requirements | 読み取り | didit:management | read:workflows | 保存されたプロファイルから導出された、適用される規制上の義務を根拠条文とともに返します。 |
didit_compliance_generate_workflow | 読み取り | didit:management | read:workflows | 保存されたプロファイルから、複数国対応のワークフローグラフを生成します。共通の幹と、各国が求めるチェックを含む国別の分岐で構成されます。 |
didit_compliance_check_workflow | 読み取り | didit:management | read:workflows | ワークフローのバージョンがどの義務を満たし、どの義務に違反しているかを根拠条文とともにチェックします。 |
アンケート
| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_questionnaire_list | 読み取り | didit:management | read:questionnaires | アプリのカスタムアンケートを一覧表示します。 |
didit_questionnaire_create | 書き込み | didit:management | write:questionnaires | 順序付きの質問リストからアンケートを作成します。 |
didit_questionnaire_append_choices | 書き込み | didit:management | write:questionnaires | 下書きのアンケートの1つの質問に回答の選択肢を追加します。 |
didit_questionnaire_get | 読み取り | didit:management | read:questionnaires | 1つのアンケートの質問と選択肢を返します。 |
didit_questionnaire_update | 破壊的 | didit:management | write:questionnaires | アンケートのタイトル、説明、質問を更新します。 |
didit_questionnaire_delete | 破壊的 | didit:management | write:questionnaires | アンケートを削除します。 |
スタンドアロン検証API
セッションを使わない、課金対象の単発呼び出しです。クエリのように見えるもの（kyb_search、face_search）も含め、すべてクレジットを消費するPOSTです。
| ツール | 種別 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_verify_id | 書き込み | didit:verification | create:sessions | 本人確認書類を表面の画像と、任意で裏面の画像から検証します。 |
didit_verify_poa | 書き込み | didit:verification | create:sessions | 住所証明書類を検証します。 |
didit_verify_database | 書き込み | didit:verification | create:sessions | 本人情報を国内外の公的な情報源と照合します。 |
didit_verify_kyb_search | 書き込み | didit:verification | create:sessions | 社名または登記番号で公式の法人登記を検索し、候補を返します。 |
didit_verify_kyb_select | 書き込み | didit:verification | create:sessions | didit_verify_kyb_searchが返した候補について、法人登記の完全な記録を取得します。 |
didit_verify_passive_liveness | 書き込み | didit:verification | create:sessions | 1枚の画像によるパッシブなライブネス検知を行います。 |
didit_verify_face_match | 書き込み | didit:verification | create:sessions | 2枚の顔画像を比較します（1:1）。 |
didit_verify_face_search | 書き込み | didit:verification | create:sessions | 顔画像を過去に検証済みの顔の中から検索します（1:N）。 |
didit_verify_age | 書き込み | didit:verification | create:sessions | 顔画像から人物の年齢を推定します。 |
didit_verify_aml | 書き込み | didit:verification | create:sessions | 制裁リスト、PEP、ウォッチリスト、および任意でネガティブメディアを対象に氏名をスクリーニングします。 |
didit_verify_email_send | 書き込み | いずれか | — | メールアドレスにワンタイムコードを送信します。 |
didit_verify_email_check | 書き込み | いずれか | — | メールアドレスに送信したコードを確認します。 |
didit_verify_phone_send | 書き込み | いずれか | — | 電話番号にワンタイムコードを送信します。 |
didit_verify_phone_check | 書き込み | いずれか | — | 電話番号に送信したコードを確認します。 |
トランザクションモニタリング
| ツール | 種別 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_transaction_list | 読み取り | didit:verification | list:transactions | 1つのアプリでモニタリング対象の取引を一覧表示します。スコープを指定しない場合はすべてのアプリが対象になります。 |
didit_transaction_create | 書き込み | didit:verification | create:transactions | モニタリングとルール評価のために取引を送信します。 |
didit_transaction_get | 読み取り | didit:verification | list:transactions | ルール評価結果を含む、モニタリング対象の取引1件を取得します。 |
didit_transaction_screen_wallet | 書き込み | didit:verification | create:transactions | 取引を作成せずに、暗号資産ウォレットのアドレスのAMLリスクをスクリーニングします。 |
didit_transaction_rule_list | 読み取り | didit:verification | list:transactions | アプリのトランザクションモニタリングルールを一覧表示します。 |
didit_transaction_rule_get | 読み取り | didit:verification | list:transactions | 条件、集計、スコープ、アクション、カウンターを含むルール1件を取得します。 |
didit_transaction_rule_create | 書き込み | didit:verification | write:transactions | カスタムルールを作成します。 |
didit_transaction_rule_update | 書き込み | didit:verification | write:transactions | ルールを部分的に更新します。 |
didit_transaction_rule_delete | 破壊的 | didit:verification | write:transactions | カスタムルールを削除します。 |
didit_transaction_rule_backtest | 読み取り | didit:verification | list:transactions | 仮想のルールを、直近の最大10,000件の取引に対してドライランで実行します。書き込みは行いません。 |
didit_transaction_rule_library_list | 読み取り | didit:verification | list:transactions | Diditのプリセットルールライブラリを、インストール状況とともに閲覧します。 |
didit_transaction_rule_install | 書き込み | didit:verification | write:transactions | ライブラリキーまたはバンドルを指定して、プリセットルールをインストールします。 |
didit_transaction_rule_uninstall | 破壊的 | didit:verification | write:transactions | ライブラリキーまたはバンドルを指定して、インストール済みのプリセットルールを削除します。 |
didit_transaction_sdk_token | 書き込み | いずれか | — | クライアントSDKから取引を送信するための、1人のエンドユーザーに紐づいた短期間有効なトークンを発行します。 |
トラベルルール
| ツール | 種類 | スコープ | 役割に必要な権限 | 内容 |
|---|---|---|---|---|
didit_travel_rule_get_settings | 読み取り | いずれか | — | トラベルルールの設定です。VASPプロフィール、ネゴシエーションポリシー、証明方法、ネットワークごとのモード、自社のトラベルアドレスを含みます。 |
didit_travel_rule_update_settings | 書き込み | いずれか | — | トラベルルールの設定を変更します。変更するフィールドのみを送信してください。有効化には法的名称が必要です。 |
didit_travel_rule_search_vasps | 読み取り | いずれか | — | VASPディレクトリを検索します。デューデリジェンススコアと、各VASPに到達できるネットワークも返します。 |
didit_travel_rule_list_wallet_addresses | 読み取り | いずれか | — | 受信送金の照合先となるウォレットアドレス帳です。各アドレスの所有権検証の状態も含みます。 |
didit_travel_rule_add_wallet_address | 書き込み | いずれか | — | 自社が管理するウォレットをアドレス帳に追加します。任意で、自己申告により所有権検証済みとして追加できます。 |
didit_travel_rule_update_wallet_address | 書き込み | いずれか | — | アドレス帳エントリの保有者情報を更新します。 |
didit_travel_rule_delete_wallet_address | 破壊的 | いずれか | — | アドレス帳エントリを削除します。削除したエントリは直ちに新しい送金と照合されなくなります。 |
didit_travel_rule_confirm_ownership | 破壊的 | いずれか | — | 所有権の証明を待っている送金について、ウォレットの所有権を確認または否認します。 |
didit_travel_rule_transfer_action | 破壊的 | いずれか | — | 送信送金をオンチェーンハッシュで完了する、確定していない送金をキャンセルする、または取引相手へのルーティングを再実行します。 |
didit_travel_rule_get_vasp | 読み取り | いずれか | — | IDを指定してVASPディレクトリのエントリを1件取得します。検索結果の行と同じフィールド(ルート、ネットワーク掲載情報、エイリアス、連絡先、エンティティ)を含みます。 |
didit_travel_rule_list_networks | 読み取り | いずれか | — | アプリケーションにおける各トラベルルールネットワークの状態です。理由、自社の参加者レコード、デューデリジェンスアンケートも含みます。 |
didit_travel_rule_request_network | 書き込み | いずれか | — | 参加者としてトラベルルールネットワークへの参加を申請します。リクエストはデューデリジェンスアンケートが承認されるまで保留されます。 |
didit_travel_rule_get_network_questionnaire | 読み取り | いずれか | — | ネットワーク利用のためのデューデリジェンスアンケートです。ステータス、保存済みの回答、レビュアーのメモ、ステータス履歴を含みます。 |
didit_travel_rule_update_network_questionnaire | 書き込み | いずれか | — | アンケートの下書きに回答を保存します。変更する回答のみを送信してください。 |
didit_travel_rule_submit_network_questionnaire | 破壊的 | いずれか | — | 保存済みのアンケートをレビューに提出します。レビュー中は編集できません。 |
didit_travel_rule_set_counterparty_vasp | 書き込み | いずれか | — | ルーティングできなかった送信送金の取引相手VASPを選択し、そのVASPとの情報交換を再実行します。 |
didit_travel_rule_list_messages | 読み取り | いずれか | — | 送金について取引相手VASPとやり取りしたメッセージと書類リクエストです。古い順に並びます。 |
didit_travel_rule_send_message | 書き込み | いずれか | — | 送金の取引相手VASPにメッセージまたは書類リクエストを送信します。メッセージをやり取りできるのは、他のDidit顧客との送金、またはメール経由の送金のみです。 |
didit_travel_rule_list_counterparty_contacts | 読み取り | いずれか | — | メールで取引相手VASPに連絡する際に使うコンプライアンス連絡先です。プラットフォームの連絡先と、自社アプリケーション独自の連絡先があります。 |
didit_travel_rule_add_counterparty_contact | 書き込み | いずれか | — | ディレクトリ上のVASPに対するコンプライアンス連絡先を追加します。この連絡先は自社アプリケーション専用で非公開です。 |
didit_travel_rule_delete_counterparty_contact | 破壊的 | いずれか | — | 自社アプリケーション独自の取引相手連絡先を1件削除します。 |
didit_travel_rule_get_sandbox_scenarios | 読み取り | いずれか | — | サンドボックスアプリケーションがやり取りするDidit Test VASPと、各ウォレットアドレスで選択されるシナリオ(承認、却下、氏名の不一致、到達不能、タイムアウト、セルフホスト型)です。 |
didit_travel_rule_trigger_test_inbound | 書き込み | いずれか | — | サンドボックスアプリケーションのみ:Didit Test VASPから受信トラベルルール送金を送信させます。 |
ベンダーのユーザーと企業
| ツール | 種類 | スコープ | 役割の権限 | 内容 |
|---|---|---|---|---|
didit_vendor_user_list | 読み取り | didit:management | list:users | vendor_dataでグループ化された認証済みユーザーを一覧表示します。スコープを指定しない場合はすべてのアプリが対象になります。 |
didit_vendor_user_create | 書き込み | didit:management | create:users | ユーザーレコードを手動で作成します。 |
didit_vendor_user_get | 読み取り | didit:management | read:users | vendor_dataで指定したユーザーを1件取得します。 |
didit_vendor_user_update | 書き込み | didit:management | write:users | ユーザーのプロフィールフィールドを更新します。 |
didit_vendor_user_update_status | 書き込み | didit:management | write:users | ユーザーのステータスをACTIVE、FLAGGED、BLOCKEDのいずれかに設定します。 |
didit_vendor_user_delete | 破壊的 | didit:management | delete:users | vendor_dataを指定してユーザーを一括削除するか、すべてのユーザーを削除します。 |
didit_vendor_business_list | 読み取り | didit:verification | list:businesses | vendor_dataでグループ化された認証済み企業を一覧表示します。スコープを指定しない場合はすべてのアプリが対象になります。 |
didit_vendor_business_create | 書き込み | didit:verification | create:businesses | 企業レコードを手動で作成します。 |
didit_vendor_business_get | 読み取り | didit:verification | read:businesses | vendor_dataで指定した企業を1件取得します。 |
didit_vendor_business_update | 書き込み | いずれか | — | 企業のプロフィールフィールドを更新します。 |
didit_vendor_business_update_status | 書き込み | didit:verification | write:businesses | 企業のステータスをACTIVE、FLAGGED、BLOCKEDのいずれかに設定します。 |
didit_vendor_business_delete | 破壊的 | didit:verification | delete:businesses | vendor_dataまたは内部IDを指定して企業を一括削除するか、すべての企業を削除します。 |
リスト、ブロックリスト、許可リスト
| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_lists_list | 読み取り | didit:management | read:lists | アプリケーションのすべてのリスト(ブロックリスト、許可リスト、カスタムリスト)を取得します。 |
didit_lists_create | 書き込み | didit:management | create:lists | 許可リストまたはカスタムリストを作成します。 |
didit_lists_get | 読み取り | didit:management | read:lists | UUIDで指定したリスト1件を取得します。 |
didit_lists_update | 書き込み | didit:management | write:lists | リストの名前を変更するか、説明を変更します。 |
didit_lists_delete | 破壊的 | didit:management | delete:lists | リストとそのすべてのエントリを削除します。 |
didit_lists_entries_list | 読み取り | didit:management | read:lists | 1つのリストのエントリを取得します。 |
didit_lists_entry_create | 書き込み | didit:management | create:lists | 値またはセッションから、リストにエントリを追加します。 |
didit_lists_entry_upload_face | 書き込み | didit:management | create:lists | セッションを使わずに、画像から顔リストに顔を追加します。 |
didit_lists_entry_delete | 破壊的 | didit:management | delete:lists | リストからエントリを削除します。 |
didit_blocklist_get | 読み取り | didit:verification | read:blocklist | ブロックリストのエントリを一覧表示します(レガシーヘルパー)。 |
didit_blocklist_add | 書き込み | didit:verification | write:blocklist | ブロックリストにエントリを追加します(レガシーヘルパー)。 |
didit_blocklist_remove | 破壊的 | didit:verification | write:blocklist | ブロックリストからエントリを削除します(レガシーヘルパー)。 |
didit_allowlist_add | 書き込み | didit:verification | write:blocklist | 許可リストにエントリを追加します(レガシーヘルパー)。 |
ケース
| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_case_list | 読み取り | didit:verification | list:cases | 1つのアプリのケースを一覧表示します。スコープを指定しない場合は、すべてのアプリが対象になります。 |
didit_case_get | 読み取り | didit:verification | read:cases | ケース1件とその詳細を取得します。 |
didit_case_create | 書き込み | didit:verification | write:cases | ケースを作成します。 |
didit_case_statistics | 読み取り | didit:verification | list:cases | ステータス別のケース件数などの統計を取得します。 |
didit_case_manage | 破壊的 | didit:verification | write:cases | ケースの割り当て、解決、再オープン、エスカレーション、コメント、更新を行います。 |
不正ネットワーク
| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_network_list | 読み取り | didit:verification | list:networks | 1つのアプリの不正ネットワークを、コンソールと同じフィルターとKPIとともに一覧表示します。 |
didit_network_get | 読み取り | didit:verification | read:networks | 不正ネットワーク1件とそのメンバー、シグナルを取得します。リクエストに応じて、グラフ、マップ、タイムラインも取得できます。 |
didit_network_membership_get | 読み取り | didit:verification | read:networks | セッション、企業セッション、ユーザー、企業、または取引が属する不正ネットワークを取得します。 |
Investigator
これらのツールはサインインしたすべてのユーザーのtools/listに表示されますが、動作するのは組織でInvestigatorが有効になっている場合のみです。
| ツール | 種類 | スコープ | 役割の権限 | 機能 |
|---|---|---|---|---|
didit_investigator_queue_list | 読み取り | いずれか | — | Investigatorの未処理のレポート、つまりレビューキューを、それぞれの推奨と信頼度とともに一覧表示します。 |
didit_investigator_report_get | 読み取り | いずれか | — | Investigatorのレポート1件を取得します。推奨、信頼度、リスク、説明、証拠、先例、質問が含まれます。 |
didit_investigator_record_get | 読み取り | いずれか | — | 1件の認証または1件の取引に対するInvestigatorの最新のレビューを、未処理か判定済みかを問わず取得します。 |
didit_investigator_accept | 破壊的 | いずれか | — | 1件の項目についてInvestigatorの推奨を承認します。項目は判定され、あなたの名前で記録されます。 |
didit_investigator_override | 破壊的 | いずれか | — | 推奨の代わりに、別のアクション、カテゴリ、理由を指定して1件の項目を判定します。 |
didit_investigator_batch_accept | 破壊的 | いずれか | — | 処理可能な推奨を最大50件まで一度に承認します。承認できない項目は、その理由とともにスキップされます。 |
didit_investigator_add_note | 書き込み | いずれか | — | レポートの項目に関する事実をチームノートとして追加します。このノートは次回のレビューで参照されます。 |
didit_investigator_rereview | 破壊的 | いずれか | — | 項目の再レビューをInvestigatorに依頼します。新しいレポートが未処理のレポートを置き換えます。 |
didit_investigator_question_list | 読み取り | いずれか | — | Investigatorが提起するポリシーに関する質問を、新しい順に一覧表示します。 |
didit_investigator_question_get | 読み取り | いずれか | — | ポリシーに関する質問1件を、その状況に対するチームの過去30日間の対応と、考えられる回答とともに取得します。 |
didit_investigator_question_answer | 破壊的 | いずれか | — | ポリシーに関する質問に回答します。ほとんどの回答では、新しいポリシーバージョンが作成されます。 |
didit_investigator_question_dismiss | 破壊的 | いずれか | — | 回答せずにポリシーに関する質問をクローズします。 |
didit_investigator_backtest_start | 書き込み | いずれか | — | 現在のポリシーを過去30日または90日間の判定に再適用する無料のバックテストを開始します。判定は一切行いません。 |
didit_investigator_backtest_get | 読み取り | いずれか | — | 保存済みのバックテストを取得します。キュー、レベル、しきい値ごとの一致率が含まれます。 |
didit_investigator_performance_get | 読み取り | いずれか | — | 7日、30日、または90日間における、Investigatorとチームの一致率、処理量、時間短縮、オーバーライドを取得します。 |
didit_investigator_dashboard_get | 読み取り | いずれか | — | Investigatorダッシュボードを取得します。30日間の自動化、週ごとの履歴、支出、オーバーライドが含まれます。 |
didit_investigator_activity_list | 読み取り | いずれか | — | Investigatorのアクティビティログを新しい順に一覧表示します。エージェントと担当者が行った操作が記録されています。 |
レポート・監査ログ・アラート
| ツール | 種類 | スコープ | 役割の権限 | 説明 |
|---|---|---|---|---|
didit_report_list | 読み取り | いずれか | — | エクスポートレポートを一覧表示します。 |
didit_report_get | 読み取り | いずれか | — | 1件のエクスポートレポートのステータスと詳細。 |
didit_report_get_download_url | 読み取り | いずれか | — | 完了したレポートの署名付きダウンロードURL。 |
didit_report_export | 書き込み | いずれか | — | エクスポートを開始します(セッション、取引、ユーザー、企業)。 |
didit_audit_log_list | 読み取り | いずれか | — | アプリケーションの監査ログエントリ。誰が何を変更したかを確認できます。 |
didit_alert_list | 読み取り | didit:management | read:applications | アプリケーションに設定されているアラート。 |
didit_alert_configure | 書き込み | didit:management | write:applications | 種類を指定して、アラートを1件設定します。 |
Webhook
| ツール | 種類 | スコープ | 役割の権限 | 説明 |
|---|---|---|---|---|
didit_webhook_list | 読み取り | didit:management | read:webhooks | アプリケーションのWebhookの送信先。 |
didit_webhook_create | 書き込み | didit:management | write:webhooks | Webhookの送信先を作成します。署名シークレットはレスポンスでは伏せられるため、コンソールからコピーしてください。 |
didit_webhook_get | 読み取り | didit:management | read:webhooks | 1件のWebhookの送信先。署名シークレットは伏せられます。 |
didit_webhook_update | 破壊的 | didit:management | write:webhooks | 送信先のURL、バージョン、有効フラグ、購読するイベントを変更します。 |
didit_webhook_delete | 破壊的 | didit:management | write:webhooks | Webhookの送信先を削除します。 |
マーケットプレイス
| ツール | 種類 | スコープ | 役割の権限 | 説明 |
|---|---|---|---|---|
didit_marketplace_list_catalog | 読み取り | didit:management | read:integrations | プロバイダーマーケットプレイス。ブロックチェーン分析、AMLスクリーニング、電話番号検証や銀行口座検証のプロバイダー、トラベルルールネットワークを、それぞれに必要な認証情報とともに表示します。 |
didit_marketplace_list_connections | 読み取り | didit:management | read:integrations | アプリのマーケットプレイス接続とネットワークメンバーシップを、ステータスと最終利用日時とともに表示します。シークレットが返されることはありません。 |
didit_marketplace_request_integration | 書き込み | didit:management | write:integrations | まだセルフサービスで利用できない連携をリクエストします。Diditのチームが追ってご連絡します。 |
組織・メンバー・請求・ブランディング
このグループの2つのツール(didit_org_top_up、didit_org_reveal_application_api_key)はサーバーに定義されていますが、OAuthで認証されたすべての呼び出し元のカタログには表示されません。これらはローカルのstdioサーバーでのみ一覧に表示されます。
| ツール | 種類 | スコープ | 役割の権限 | 説明 |
|---|---|---|---|---|
didit_org_list | 読み取り | いずれか | — | 所属している組織。 |
didit_org_list_applications | 読み取り | いずれか | — | 1つの組織のアプリケーション。 |
didit_org_get_application | 読み取り | いずれか | — | アプリケーションの詳細。APIキーは伏せられます。 |
didit_org_reveal_application_api_key | 破壊的 | いずれか | — | アプリケーションのAPIキーをそのまま返します。明示的なIDとconfirm: trueが必要です。ホスト型コネクターでは表示されません。 |
didit_org_get_balance | 読み取り | didit:management | read:subscription | クレジット残高と自動チャージの設定。 |
didit_org_top_up | 破壊的 | いずれか | — | クレジットを追加するためのStripeチェックアウトを作成します。ホスト型コネクターでは表示されません。 |
didit_branding_get | 読み取り | didit:management | read:customization | 検証UIに適用されているブランディング(ロゴ、色)。 |
didit_branding_update | 書き込み | didit:management | write:customization | 新しいブランディング画像をアップロードします。 |
didit_org_list_members | 読み取り | didit:management | list:members | 組織のメンバー。 |
didit_org_invite_member | 書き込み | didit:management | write:members | 役割を指定して、メールでメンバーを招待します。 |
didit_org_update_member | 書き込み | didit:management | write:members | メンバーの役割を変更します。 |
didit_org_remove_member | 破壊的 | didit:management | delete:members | 組織からメンバーを削除します。 |
didit_org_list_roles | 読み取り | didit:management | list:roles | 組織で利用できる役割。 |
didit_org_list_api_keys | 読み取り | didit:management | read:applications | APIキーのメタデータ。生の値は伏せられます。 |
ファイル入力
ファイルを受け取るツール(didit_verify_id、didit_verify_poa、didit_verify_passive_liveness、didit_verify_face_match、didit_verify_face_search、didit_verify_age、didit_lists_entry_upload_face、didit_branding_update)は、次の2つの形式のいずれかでファイルを受け付けます。
*_base64: ファイルの内容をインラインで、生のbase64またはdata:URLとして渡します。ホスト型エンドポイントに対してはこちらを使用してください。*_path: サーバーを実行しているマシン上の絶対パス。お使いの環境と同じファイルシステムを共有するローカルのstdioサーバーでのみ機能します。
例
これらのツールをエンドツーエンドで使用する会話の例。
高度な設定
役割、アプリ間の動作、分岐するワークフロー、Webhook、セルフホスティング。