メインコンテンツまでスキップ

生体認証

Face ID / Touch ID / Optic ID の利用可能性をテストし、認証チェックを実行します。

概要

生体認証ツールでは、デバイスで生体認証が利用可能かどうかを確認し、利用可能な場合はシステムプロンプトを使用して実際の認証を試行できます。

生体認証:タイプ/ステータス、認証ボタン、診断ログ
例:Face ID が検出され、まだ認証されていない状態

目次

主要セクション

生体認証は単一のスクロール画面で構成されており、以下が含まれます:

  • 検出された生体認証タイプと現在のステータスを表示するヒーローカード
  • 認証ボタン
  • メトリクスセクション(生体認証タイプと認証ステータス)
  • イベントとエラーを記録する診断ログ

認証

認証をタップすると、システム認証プロンプトが表示されます。結果によりステータスが更新され、ログエントリが追加されます。生体認証ハードウェアが検出されない場合(生体認証タイプが None の場合)、認証ボタンは無効になります。

認証が成功すると、生体認証アイコンが短いパルスアニメーションを再生します。特定の状態(利用不可、未登録、ロックアウト、失敗など)に達すると、ヒーローカードの下にガイダンスを含むコンテキストエラーコールアウトメッセージが表示されます。

ステータスとメトリクス

以下が表示されます:

  • 生体認証タイプ:Face ID、Touch ID、Optic ID(visionOS)、または None
  • 認証ステータス:最後の試行の現在の状態

診断ログ

ログには以下のような重要なイベントが記録されます:

  • 検出された生体認証タイプ
  • 認証開始
  • 認証結果(成功/失敗/キャンセル)
  • エラーとロックアウト状態

クリアを使用してログ履歴を削除できます。

一般的なステータス状態

デバイスの設定とユーザーの操作に応じて、ツールは以下のような状態を表示できます:

  • 未認証
  • 成功
  • 失敗
  • 利用不可
  • 未登録
  • ロックアウト
  • ユーザー/システムによるキャンセル
  • フォールバック
  • 不明

注意事項と制限

  • アプリは生体認証データ自体にアクセスできません。認証評価をリクエストすることのみ可能です。
  • 利用可能性とエラー状態は OS によって制御されます(例:失敗回数が多すぎた後のロックアウト)。