確認結果へのアクセス

ユーザーのプライバシーを優先する Stripe Identity でシステムを構築するには、アクセスする必要がある最小限の PII をまず決定します。最も機密性が高いデータ (制限付きの API キーによる認証を必要とするもの) にアクセスする必要がない場合は、シークレットキーのみを使用して認証するように実装を設定できます。

本人確認の結果である PII にアクセスするには、VerificationSession を取得し、verified_outputs フィールドと last_verification_report フィールド (確認結果の詳細な内訳が必要な場合) のいずれかを拡張します。これらのいずれのフィールドを拡張しても、シークレットキーのみを必要とする格納 PII フィールドがすべて含まれています。

verified_outputs フィールドを展開して、Stripe Identity によって本人確認が行われたユーザーの名前を取得する例を次に示します。

// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const verificationSession = await stripe.identity.verificationSessions.retrieve(
  '{{SESSION_ID}}',
  {
    expand: [
      'verified_outputs',
    ],
  }
);

const firstName = verificationSession.verified_outputs.first_name;

制限付きのキーを必要とする機密 PII にアクセスする必要がない場合は、このガイドのステップに従ってください。

アカウントのシークレット API キーは、制限なしのすべての API リクエストの実行にも使用できます。機密データである確認結果にアクセスするには、より安全な制限付きのキーが必要です。

制限付きキーを新規作成する

1. ダッシュボードの API キーのページに移動して、制限付きのキーを作成をクリックします。
2. キーに名前を付けます。
3. Identity の確認セッションとレポート、およびAccess recent sensitive verification results (最近の機密データである確認結果にアクセス の権限が 読み取りに設定されていることを確認します。
4. (オプション) 収集された画像へのアクセスが必要な場合は、ファイルの書き込み権限を追加します。
5. キーを作成をクリックします。
6. キーを安全に保管します。キーを安全に保管する方法に関する詳細をご覧ください。

VerificationReport には、送信されたセッションから収集されたすべてのデータと確認結果が含まれます。セッションのすべての本人確認チェックが処理されると VerificationReport が作成されます。VerificationReport を確認することで、本人確認チェックが失敗した理由と、どのデータが正常に確認されたかを把握できます。

last_verification_report セッションフィールドを拡張することで、関連する VerificationReport を取得できます。

デフォルトでは、VerificationReports に機密データである確認結果は含まれません。これらにアクセスするには、次のことを行う必要があります。

1. ステップ 1 で作成した制限付きの API キーを使用して認証する。
2. アクセス対象のフィールドを拡張する。

ここでは、書類チェックで抽出された生年月日、ID 番号、書類の番号にアクセスする例を示します。

// Set your restricted key. Remember to switch to a live restricted key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('rk_test_...');

const verificationSession = await stripe.identity.verificationSessions.retrieve(
  '{{SESSION_ID}}',
  {
    expand: [
      'verified_outputs.dob',
      'verified_outputs.id_number',
      'last_verification_report.document.number',
    ],
  }
);

const dateOfBirth = verificationSession.verified_outputs.dob;
const idNumber = verificationSession.verified_outputs.id_number;
const documentNumber = verificationSession.last_verification_report.document.number;

収集された画像へのアクセス

セッションの一部として収集された本人確認書類および顔画像は、File Upload API を使用して取得できます。VerificationReport の以下のフィールドは、Stripe API の File (ファイル) リソースへの参照を保持できます。

• document.files: 本人確認書類の画像
• selfie.document: 写真付き本人確認書類の表面の画像
• selfie.selfie: ユーザーの顔写真画像

ファイルのコンテンツにアクセスするには、事前に作成した制限付きのキーを使用して認証を行い、有効期限の短い FileLink を作成し、url をクライアントに送信する必要があります。

// Set your restricted key. Remember to switch to a live restricted key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')('rk_test_...');

// Get the VerificationReport
const session = await stripe.identity.verificationSessions.retrieve(
  '{{SESSION_ID}}',
  {
    expand: ['last_verification_report'],
  }
);

// Retrieve the File id
const report = session.last_verification_report;
const documentFrontFile = report.document.files[0];

// Create a short-lived FileLink
const fileLink = await stripe.fileLinks.create({
  file: documentFrontFile,
  expires_at: Math.floor(Date.now() / 1000) + 30,  // link expires in 30 seconds
});

// Access the FileLink URL to download file contents
const fileUrl = fileLink.url;

Identity によって収集された機密データに攻撃者がアクセスしたと思われる場合は、サポートにお問い合わせください。

Identity 権限のみを持つ制限付きの API キーを使用すると、他の Stripe 製品の組み込みに影響を与えることなく、緊急時にキーを更新できます。

制限付きキーの使用状況を定期的に監視し、キーにアクセスしている者がいないか確認することをお勧めします。ダッシュボードでオーバーフローメニュー (…) を使用して、特定の API キーのリクエストログを表示し、そのキーから行われたすべてのリクエストを確認できます。

API キーが不正にアクセスされた場合は、そのキーをダッシュボードで更新してブロックし、新規キーを生成します。不正行為者が機密情報を取得するのを防ぐために、ただちにキーを失効させてください。

Identity によって収集された機密データに攻撃者がアクセスしたと思われる場合は、サポートにお問い合わせください。

プライバシーポリシーに機密データである確認結果の司法方法が含まれていることを確認します。これは、セキュリティの取り扱いに関する方法を提供することも有益です。

参照情報

• ビジネスとして本人確認データを扱う際のプライバシーへの考慮事項
• ユーザーに提供する FAQ