sumsub-check-permissions

権限の確認

テナントで許可されているエンタイトルメントを返します。これにより、呼び出し側は API に書き込む前に機能の利用可否を判定できます。

認証 — アプリトークン + シークレット（サンドボックスのみ）

このスキルは公開 Sumsub API と通信し、 認証リファレンスに従って各リクエストに署名します。 仕組みの詳細は sumsub-api-auth スキルに記載されています。401 Invalid signature が発生した場合は、そちらをお読みください。

⚠️ サンドボックスのトークンのみ使用してください。 ここでは本番環境のアプリトークンを受け取ったり、使用したりしないでください。 ユーザーから提示された場合は受け取りを拒否し、https://cockpit.sumsub.com/checkus/devSpace/appTokens でサンドボックス用の ペアを生成するよう依頼してください（最初にワークスペースを Sandbox に切り替えてから、Create を選択します）。 トークンとシークレットは一度しか表示されないため、ダイアログを閉じる前に両方をコピーしてください。このヘルパースクリプトは このルールを適用し、sbx: で始まらないトークンを拒否します。

変数	例
SUMSUB_APP_TOKEN	sbx:... — ダッシュボードで取得したサンドボックス用アプリトークン。
SUMSUB_SECRET_KEY	トークン作成時に一度だけ表示される、ペアとなるシークレット。
SUMSUB_BASE	任意。デフォルトは https://api.sumsub.com です。

使い方

スクリプトを実行して、結果を解析します。

bash ${CLAUDE_SKILL_DIR}/scripts/check_permissions.sh

出力：Sumsub の生のレスポンスボディの後に HTTP <code> が続きます。

成功（HTTP 200）：

{"allowedChecks": {"REUSABLE_KYC_SDK": "Reusable KYC via API/SDK: ...", "VIDEO_IDENT": "Video Identification: ..."}}
HTTP 200

エラー（200 以外）：

{"description":"Unauthorized","errorName":"...","correlationId":"..."}
HTTP 401

• allowedChecks — このテナントで有効になっているすべてのエンタイトルメントについて、権限キーと人が読めるラベルを対応付けたマップです。
• allowedChecks のキーとして存在する権限キーが、許可されているエンタイトルメントです。

呼び出し側での使用方法

HTTP ステータスが 200 でない場合は、ただちに処理を停止してください。エラーボディをユーザーに表示し、先へ進まないでください。

レスポンスが成功したら、必要な BackgroundCheckTarget キーが allowedChecks に存在するか確認してください。存在しない場合は、ただちに処理を停止し、ペイロードを作成したり POST したりしないでください。不足しているエンタイトルメントと、有効化するには CSM または Sumsub Support に問い合わせる必要があることをユーザーに伝えてください。

エンタイトルメントと機能の対応関係（キーの例）：

機能	必須のエンタイトルメント
E_KYC docset	E_KYC_TARGET
PROOF_OF_RESIDENCE docset	POA
E_SIGN docset	E_SIGN_TARGET
deviceIntelligenceSettings.enabled: true	DEVICE_INTELLIGENCE
QUESTIONNAIRE のスコアリング	QUESTIONNAIRE_SCORING
QUESTIONNAIRE の添付ファイル	QUESTIONNAIRE_ATTACHMENT
NFC チップの読み取り	NFC
ビデオ本人確認セッション	VIDEO_IDENT
SDK 経由の再利用可能な KYC	REUSABLE_KYC_SDK
既知の顔の検索	KNOWN_FACE_SEARCH
AML／ウォッチリストのステップ	WATCHLISTS