Webアプリ向け顔認証API

顔認証をゼロから構築するには、実際の製品フローをリリースする前に、ライブネスチェック、アンチスプーフィング、認識エンジンの挙動、照合品質、ブラウザ間のカメラキャプチャに対応する必要があります。セキュリティとプライバシーに関わるインフラ作業です。

FACEIO はこれらのレイヤーをマネージド API とブラウザー向けライブラリにまとめています。アプリケーションは Facial ID と認証結果を受け取り、バックエンドはユーザーマッピング、セッション作成、認可、アカウント復旧ポリシーを管理します。短期間で導入する場合は、マネージド顔認証サービスとして利用できます。

FACEIO API と fio.js SDK は、認証ライフサイクル全体をカバーする 2 つの主要メソッドを提供します。エンドポイント単位の制御については、REST API リファレンスを参照してください。

• enroll()

  FACEIO ウィジェットで登録フローを開始します。ユーザーの明示的な同意後、設定された顔認識エンジンが不可逆の生体認証ハッシュまたはアプリケーションインデックスエントリを作成し、FACEIO は一意の Facial ID を返します。バックエンドは、その Facial ID をユーザーレコードに関連付けて保存します。

• authenticate()

  ライブ認証フローを開始し、ライブネスを確認します。一致に成功すると、関連するペイロードと Facial ID を返します。バックエンドは結果を検証してセッションを作成できます。パスワードレスログインの設計については、Web アプリ向け生体認証ログインを参照してください。

フロントエンド統合は意図的に小さく設計されています。SDKウィジェットがカメラ権限、キャプチャUI、ライブネスチェックを処理するため、アプリケーション側でこれらを実装する必要はありません。

// ステップ1 - ページにSDKを埋め込む
<script src="https://cdn.faceio.net/fio.js"></script>

// ステップ2 - Public IDで初期化
const faceio = new faceIO('YOUR_APP_ID');

// ステップ3 - 新しいユーザーを登録
faceio.enroll({ locale: 'auto', payload: { userId: 'abc123' } });

// ステップ4 - 再訪時に認証
faceio.authenticate({ locale: 'auto' })
  .then((data) => sendToBackend(data.facialId, data.payload))
  .catch((err) => handleError(err));

authenticate() が成功したら、返された facialId とペイロードをサーバーへ送り、信頼できるセッションを作成します。詳しい手順は、統合ガイド、Webhooks ドキュメント、セキュリティのベストプラクティスを参照してください。

FACEIO API は各認証イベントに複数のセキュリティ制御を適用します。既定の制御に加えて、アプリケーション要件に合わせた設定を FACEIO Console で管理できます。プラットフォームのセキュリティ方針については、トラストセンターを参照してください。

• ライブネスとアンチスプーフィング

  各キャプチャで人間が実際に存在することを確認し、写真、印刷画像、録画映像、画面リプレイ、合成メディア、マスクによる試行など、一般的な提示攻撃を拒否するよう設計されています。

• プライベートAPIキーの検証

  バックエンドはプライベートREST APIキーを使って認証イベントを検証します。偽造または再生されたフロントエンドの応答を有効なセッションとして扱わないよう、キーはサーバーに保管してください。

• アプリケーション単位のFacial ID

  各 FACEIO アプリケーションは分離されています。Facial ID、ペイロード、認識エンジンのインデックスはアプリケーション単位で管理され、プラットフォームのレート制限が総当たり試行の低減に役立ちます。

FACEIOの統合の多くは、信頼性とコンプライアンスの要件に応じて、2つのパターンのいずれかを使用します。