APIキーは開発者のAPIキー、ワークフローIDはワークフローのページ、Webhookの署名シークレットは開発者のWebhookでエンドポイントごとに確認できます。

簡単な回答

コンソールから3つの値が必要です。APIキーは開発者 → APIキーで作成します。ワークフローIDはワークフローのページでコピーします。Webhookの署名シークレットは開発者 → Webhookの各エンドポイントに属し、表示でいつでももう一度確認できます。3つとも、同じアプリケーションの同じ環境（LiveまたはSandbox）から取得してください。

スターターアプリやAIが生成したプロジェクトには、DIDIT_API_KEY、DIDIT_WORKFLOW_ID、DIDIT_WEBHOOK_SECRETのような環境変数が記載されていることがよくあります。これらの名前はそのアプリのもので、Diditが設定するものではありません。次の表に、各値の入手先を示します。

#各値の場所

値入手先知っておくこと
APIキー開発者 → APIキーでキーを作成（どのアプリケーションにもプライマリキーがあります）完全なシークレットが表示されるのは、キーを作成またはローテーションしたときの1回だけなので、そのときにシークレット管理ツールへコピーしてください。LiveアプリケーションとSandboxアプリケーションではキーが異なり、Sandboxキーでライブの検証は作成されません。x-api-keyヘッダーで、サーバーからのみ送信します
ワークフローID本人確認 → ワークフロー：行のメニューを開き、ワークフローIDをコピーを選びます（プレビューパネルにも同じボタンがあります）ワークフローのIDは、アプリケーションごとに別々です。ワークフローを複製すると、新しいIDになります
Webhookの署名シークレット開発者 → Webhookでエンドポイントを開き、署名シークレットの表示を押しますアプリケーションごとではなく、エンドポイントごとに1つです。表示するには本人確認が必要で、60秒以内にもう一度非表示になります。必要なときにいつでも再表示できます
APIのベースURLコンソールにはありません：docs.didit.meに記載されていますhttps://verification.didit.meが検証API（セッション、ワークフロー、リスト、Webhook）を提供し、x-api-keyヘッダーで認証します。API認証をご覧ください
注記

APIキーと署名シークレットは別の値です。APIキーはDiditへの呼び出しを認証し、署名シークレットは、webhookが本当にDiditから届いたことを確認するためのものです。一方を他方の代わりに使うと、401または署名の不一致になります。

#Webhookの署名シークレットをもう一度見られますか

はい。開発者 → Webhookでエンドポイントを開き、表示を押します。本人確認をすると、シークレットが最大60秒間表示されます。表示がグレーアウトしている場合は、アクセス権のあるチームメンバーに依頼するか、サポートに問い合わせてください。新しいシークレットが必要な場合は、ローテーションしてください。古いシークレットは24時間は引き続き使えます。詳しくはwebhookによる検証結果の取得をご覧ください。

#設定を確認する

  1. 環境を合わせる

    まずコンソールでアプリケーションとLiveまたはSandboxの環境を選び、そこでキーとワークフローIDをコピーし、webhookエンドポイントを作成します。Sandboxキーとライブのワークフローを組み合わせると、401や403になる原因としてよくあります。

  2. 値をサーバーの設定に入れる

    サーバー側のシークレットとして保存します。APIキーや署名シークレットを、フロントエンドのコード、公開リポジトリ、モバイルアプリに入れてはいけません。

  3. セッションを作成する

    キーとワークフローIDを使って、https://verification.didit.meのセッション作成エンドポイントを呼び出します。401はキーが間違っている、期限切れ、または取り消されたことを意味し、ワークフローに対する403は、通常、キーが別のアプリケーションのものであることを意味します。APIエラーをご覧ください。

  4. テストイベントを送信する

    開発者 → Webhookでエンドポイントを開き、テストイベントを送信を押します。サーバーは署名シークレットで署名を確認し、2xxで応答する必要があります。何も届かない場合は、webhookが届かないときをご覧ください。

#関連記事

まだ解決しませんか？担当者に相談する。

組織 ID と、問い合わせたいセッション ID を添えてください。

サポートに問い合わせる