よくある質問

FACEIOの顔認証、ID Match、Meeting Shieldについて、開発チーム向けによくある質問に回答します。 fio.js、 enroll()、 authenticate()、Facial ID、Webhook、REST APIの利用、会議中のディープフェイク検出、FACEIO Consoleの設定について説明します。

FACEIO Consoleに接続してアプリケーションを作成し、APIを管理し、登録、認証、Facial IDイベント用のWebhookを設定します。

適切な開始地点を見つける

このよくある質問で実装の要点を確認し、次に構築する内容に応じて、セットアップガイド、fio.js 統合リファレンス、バックエンドドキュメント、または FACEIO Console ↗ を利用してください。

スタートガイドのアイコン

はじめに

最初のFACEIOアプリケーションを作成し、Public IDをコピーしてWebフローに顔認証を追加します。

始める
統合設定のアイコン

fio.js統合

enroll()、 authenticate()、セッション処理を使って、パスワードだけのログインを顔認証に置き換えます。

APIリファレンスを見る
開発者向けコードのアイコン

開発者センター

Webhook、REST API、Facial ID、セキュリティ、プライバシー、実装の詳細についてFACEIO公式ドキュメントを確認します。

開発者ドキュメントを見る

はじめに

FACEIOとは何ですか?

FACEIO は、Web サイトや Web アプリ向けのクロスブラウザー対応顔認証フレームワークです。開発者は認識基盤を自作せずに、顔認証ログイン、パスワードレス認証、アカウント再認証を追加できます。

統合にはブラウザー向け JavaScript ライブラリの fio.js を使用します。実装方法はFACEIO 統合ガイドで確認できます。ユーザーは Web カメラまたはモバイル端末のフロントカメラで動作するホスト型ウィジェットから登録と認証を行います。

FACEIOは誰が開発・運用していますか?

FACEIOはPixLab ↗が開発・運用し、PixLabはSymisc Systems ↗の一部です。FACEIOはブラウザー対応の顔認証、セルフィーとID顔写真を照合するID Match、対応するブラウザー会議向けのMeeting Shieldを提供します。それぞれ目的が異なる別の製品です。

プライバシー、セキュリティ、運用方針については、トラストセンター、プライバシーのベストプラクティスガイド、セキュリティのベストプラクティスガイドを参照してください。

Webアプリケーションに顔認証を追加するにはどうすればよいですか?
  1. FACEIO Console ↗ でアプリケーションを作成します。
  2. アプリケーションの Public ID をコピーします。
  3. fio.js を Web サイトまたは Web アプリに追加します。
  4. enroll() で新規ユーザーを登録し、authenticate() で既存ユーザーを認証します。

最短で試すには、はじめにガイドを参照してください。本番向けの実装は、fio.js API リファレンスと統合ガイドで確認できます。

FACEIOはAPI、SDK、ホスト型ウィジェットのどれですか?

FACEIOは複数の要素で構成されます。 fio.js JavaScript SDK、安全なブラウザウィジェット、バックエンドの顔認証サービス、オプションのREST API、サーバー向けWebhookイベントを組み合わせます。

多くの顔認証統合はホスト型ウィジェットから始まります。ウィジェットはカメラ撮影、ライブネスチェック、顔照合、ブラウザー互換性を処理し、設定された同意フローを表示します。通知と同意の責任はアプリケーション所有者にあります。その後、Webhooks、REST APIエンドポイント、Facial IDのワークフローを接続できます。

FACEIOはモバイルブラウザで動作しますか?

はい。FACEIOはWebカメラまたはフロントカメラにアクセスできる最新のデスクトップ・モバイルブラウザ向けに設計されています。同じ fio.js パターンをデスクトップとモバイルのWebフローで使い、リリース前にカメラ権限とブラウザの動作をテストします。

ブラウザーとフレームワークに関する注意点は、開発者センターと統合ガイドで確認してください。

統合とAPIドキュメント

開発者向けのFACEIO公式ドキュメントはどこにありますか?
  • はじめに 最初のアプリケーションと簡単なセットアップについて確認します。
  • 統合ガイド では fio.js、 enroll()、 authenticate()、エラー処理とセッション処理です。
  • 開発者センター フレームワーク例、REST API、Webhook、プライバシー、セキュリティ、本番運用の参考資料を確認します。
  • Webhooks と Facial ID を使って、バックエンドの同期と登録ユーザーのライフサイクルを管理します。
FACEIOはどのJavaScriptフレームワークをサポートしていますか?

FACEIOは特定のフレームワークに依存しません。 fio.js を、プレーンHTML、React、Vue、Next.js、Angular、jQueryなど、ブラウザJavaScriptを実行してカメラ権限を要求できるフロントエンドから読み込めます。

バックエンドは Node.js、PHP、Python、Go、Rust、Java、.NET など、Webhook を受信して HTTPS リクエストを送信できる任意のスタックで構築できます。サーバー側の操作には REST API を利用できます。まずは開発者センターと統合ガイドを確認してください。

FACEIOはパスワードログインを置き換えられますか?

はい。FACEIOはパスワードレスの顔ログイン、二要素目の認証、または重要な操作前のアカウント再認証に利用できます。適切な構成はセッションモデル、アカウント復旧フロー、ユーザー同意の要件によって異なります。

設計時には、パスワードレス認証ガイド、顔ログインガイド、セキュリティのベストプラクティスを参照してください。

FACEIOはWebhookをサポートしていますか?

はい。FACEIOの Webhooks により、バックエンドでユーザー登録、認証成功、Facial ID削除のイベントを受け取れます。サーバー側でアカウント状態を同期し、監査ログを記録し、アプリケーションのワークフローを開始する場合に便利です。

を検証し、 WWW-Authenticate Webhookペイロードを信頼する前に、ベアラートークンと想定するアプリケーション識別子を確認してください。

FACEIOのFacial IDとは何ですか?

Facial IDはIndex IDとも呼ばれ、登録ユーザーの顔認証レコードに関連付けられたFACEIOの識別子です。生の顔画像、顔特徴ベクトル、またはバイオメトリックハッシュをアプリケーションに公開せず、認証状態、削除要求、アカウント連携を管理できます。

FACEIO REST APIはどのように使いますか?

REST APIは、アプリケーションデータの管理、Facial IDの処理、登録レコードの削除など、非公開のバックエンド操作に使用します。ウィジェットの初期化とは別に、 fio.jsユーザーのブラウザで実行されます。

API キーは FACEIO Console ↗ の Application Manager から取得し、サーバー側だけで保管してください。本番環境から呼び出す前に、REST API ドキュメントを確認してください。

Facial IDとは何で、どう削除しますか?

Facial ID は、UUID ↗ に相当する匿名の一意識別子です。ユーザーの明示的な同意後に、選択された 顔認識エンジンによって割り当てられます。バックエンドで顔認証と独自のアカウントレコードを関連付けながら、ユーザー向けアカウントデータを顔認識エンジンのインデックスから分離できます。

顔の登録は、Web サイトまたは Web アプリに組み込んだ fio.js から enroll() を 1 回呼び出すことで開始できます。

Facial ID を削除するには、非公開のバックエンドからDELETEFACIALID REST API エンドポイントを呼び出します。成功すると、指定された Facial ID、関連ペイロードデータ、バイオメトリックハッシュがその FACEIO アプリケーションから削除されます。エンドポイントの仕様は、 REST API リファレンスを参照してください。

バックエンドから削除する Python の例は、GitHub Gist ↗で確認できます。プライバシーとコンプライアンスについては、FACEIO トラストセンターを参照してください。

FACEIOウィジェットはカスタマイズできますか?

はい。Application Managerでは、ウィジェットの外観、ロゴ、法的リンク、アプリケーションごとのセキュリティ設定を変更できます。同意と法的リンクはユーザー向け認証フローの一部なので、分かりやすく表示してください。

ウィジェット設定は FACEIO Console ↗から変更し、ユーザーが実際に使うブラウザとデバイスでフローをテストしてください。

製品と認証

どの顔認識エンジンを選ぶべきですか?

顔認識エンジンは登録ユーザーの顔を数学的な特徴ベクトルに変換し、通常は分離されたアプリケーションインデックス内でバイオメトリックハッシュとして扱います。FACEIOはPixLab InsightとAWS Rekognitionをサポートし、エンジン、リージョン、デプロイモデルはアプリケーション所有者が設定します。

データレジデンシー、クラウドプロバイダーの要件、オンプレミスの必要性、法務・セキュリティレビューを基準に選択してください。Facial ID リファレンス、プライバシーのベストプラクティス、セキュリティのベストプラクティスを確認し、 FACEIO Console ↗ で設定をテストしてください。

FACEIOはオンプレミスで実行できますか?

FACEIOはクラウドの顔認識エンジンに加え、顧客管理のインフラストラクチャ内でPixLab Insightを使用するオンプレミス構成に対応します。エンジン、リージョン、認証情報、デプロイ方式の選択と設定はアプリケーション所有者が行います。計画についてはFACEIO Consoleサポート ↗へお問い合わせください。

FACEIO Meeting Shieldとは何ですか?

FACEIO Meeting Shieldは、対応するブラウザー会議でディープフェイクや合成映像のリスクシグナルを評価するChrome拡張機能です。fio.jsによる顔認証とは別の製品であり、すべての加工映像を検出できる保証はありません。

FACEIO ID Matchとは何ですか?

FACEIO ID Match は、ライブセルフィーと身分証を取得し、ライブネスを確認してセルフィーと身分証の顔写真を照合するウィジェットです。idmatch() でブラウザフローを開きます。

FACEIOが顔検出、ライブネス、1:1顔照合を提供し、PixLab DOCSCAN ↗が書類をスキャンして任意の項目を抽出します。ID Matchは書類の真正性や法的な本人確認を行わず、KYCやAMLを完了せず、承認判断も行いません。

ID Matchは標準の顔認証とどう違いますか?

FACEIOの標準顔認証はユーザーを登録し、再訪時にその登録レコードに対して認証します。ID Matchはユーザーを登録または認証しません。ライブセルフィーと提示されたID顔写真を一度だけ1:1で照合し、必要に応じて書類項目を返します。

実装は fio.js に記載された統合パターン 統合ガイドに従いますが、検証フローでは idmatch() を呼び出し、 enroll() ではなく authenticate()。

料金とアカウント

アプリケーションと請求はどこで管理できますか?

FACEIO Console ↗ では、アプリケーションの作成、Public ID の取得、ウィジェットの外観とセキュリティ設定、利用状況、サポートリクエスト、請求を管理できます。

利用可能なプランの詳細は、FACEIO の料金ページで確認できます。

FACEIOのテスト用無料プランはありますか?

FACEIO は、プロトタイプ、MVP、本番アプリケーション向けのプランを提供しています。最新の上限、機能、アップグレード方法は料金ページで確認し、FACEIO Console ↗ から開始してください。

最初のFACEIOアプリケーションはどう作成しますか?

FACEIO Console ↗ にサインインし、新しいアプリケーションを選択してウィザードに従います。生成された Public ID を fio.js の統合で使用します。

はじめにガイドでは、最初のユーザーを登録・認証するための最小限のコードと同じ手順を説明しています。

FACEIOアカウントの作成・閉鎖方法を教えてください。

FACEIO Console のサインアップページ ↗でアカウントを作成し、ダッシュボードから最初のアプリケーションを作成します。必要な確認手続きは、アプリケーション設定の一部として FACEIO Console 内で行われます。

アカウントを閉鎖するには、不要なアプリケーションを削除し、アクティブなサブスクリプションの要件を整理してから、 FACEIO Consoleサポートチャンネル ↗のアカウント操作または非公開サポートを利用してください。アカウント削除は永久的なので、閉鎖を申請する前に必要なデータをエクスポートしてください。

請求情報はどこに保存されますか?

FACEIO は、FACEIO Console にクレジットカードの完全な情報を保存しません。該当する場合、支払いとサブスクリプションは、チェックアウト時に表示される販売者または決済処理業者が処理します。

プラン変更、請求書、非公開の請求に関する質問は、FACEIO Console のサポートチャンネル ↗へお問い合わせください。

プライバシーとセキュリティ

本番環境でFACEIOを安全に使用する責任は誰にありますか?

アプリケーション所有者は、製品内でのFACEIOの使い方に責任を負います。ウィジェットを表示するタイミング、ユーザーへの説明、同意の取得方法、認識エンジンの選択、セキュリティ設定、FACEIOが認証結果を返した後の処理が含まれます。

FACEIOは2022年から提供されている本番運用向けの顔認証フレームワークで、900万件を超えるウィジェットインスタンスと世界中の数千の顧客に対応しています。この実績は、アプリケーションレベルでのセキュリティ、プライバシー、法務、同意に関する責任に代わるものではありません。

FACEIOはブラウザウィジェット、API、Webhook、実装ガイダンスを提供します。アプリケーションの誤用、ユーザーへの通知不足、脆弱なアカウント復旧、安全でないセッション処理、アプリケーションによるその後の判断について責任を負いません。公開前に セキュリティのベストプラクティスガイド、 プライバシーのベストプラクティスガイド、 トラストセンターを確認してください。

FACEIOは生の顔画像やバイオメトリックハッシュを保存しますか?

いいえ。FACEIO自体は、fio.js、埋め込みウィジェット、REST API、FACEIO Consoleを含め、生の顔画像を保持せず、バイオメトリックハッシュを保存または公開しません。アプリケーションが受け取るのは識別子と認証結果であり、生の顔画像、顔特徴ベクトル、バイオメトリックハッシュではありません。

選択した顔認識エンジンは、アプリケーション所有者の設定、リージョン、同意フロー、削除ポリシーに従って顔特徴ベクトルまたはハッシュ署名を扱います。エンジンの選択、ユーザーへの説明、削除またはオプトアウト手段の提供はアプリケーション所有者の責任です。Facial ID リファレンス、プライバシーのベストプラクティスガイド、トラストセンターを参照してください。

FACEIOはユーザーの同意なしにバイオメトリックハッシュを保存しますか?

いいえ。FACEIO自体はバイオメトリックハッシュを保存しません。選択した顔認識エンジンは、ユーザーの明示的な同意を得た登録フローを通じてのみハッシュを作成し処理します。ハッシュは数学的特徴ベクトルであり、生の顔画像ではなく、フロントエンドに返されません。

各FACEIOアプリケーションは独自の分離されたインデックスを使用します。顧客向けの中央バイオメトリックハッシュデータベースはなく、削除フローはドキュメント化された Facial ID と REST API フローで処理されます。法的通知、同意、保持期間の選択、ユーザーの削除要求は引き続きアプリケーション所有者の責任です。

ライブネスとアンチスプーフィングのチェックで、すべての攻撃を防げますか?

いいえ。FACEIOのライブネスとアンチスプーフィングチェックは顔認証フローの一部ですが、プレゼンテーション攻撃、リプレイ、自動化、アカウント悪用のすべてを検出・阻止できるシステムはありません。

アプリケーション所有者は、FACEIOをデフォルトのPIN Code検証、ドメイン制限、レート制限、アカウント復旧ルール、サーバー側認可チェック、Webhook検証、適切なサポート手順と組み合わせてください。 セキュリティのベストプラクティスガイド でアプリケーションに必要な制御を判断してください。

デフォルトのPIN CodeはFACEIOのセキュリティをどう高めますか?

FACEIOではPIN Code検証がデフォルトで有効です。PINはユーザーだけが知る秘密情報を追加するため、設定されたフローでは顔照合だけで認証が完了しません。PINは追加の認証要素であり、ディープフェイク検出機能ではありません。ライブネスチェックやアプリケーション側のセキュリティ制御と組み合わせてください。

アプリケーション所有者は、PIN Code の要件、弱い PIN の拒否、ドメイン制限、国制限などのセキュリティ設定を、FACEIO Console ↗ の Application Manager で確認できます。推奨構成はセキュリティのベストプラクティスを参照してください。

FACEIOを承認済みのドメインや国に制限できますか?

はい。アプリケーション所有者は、ウィジェットの初期化を承認済みドメイン名、設定した場合は承認済みの国に制限できます。許可されていないWebサイトによるFACEIOアプリケーションの読み込みを防ぎ、提供対象外の地域からの不要なトラフィックを減らせます。

これらの設定をApplication ManagerのSECURITYタブで行い、本番公開前に動作を確認してください。 セキュリティのベストプラクティスガイド でデプロイのガイダンスを確認してください。

プライバシー、法務、セキュリティのレビューはどこから始めるべきですか?

まず、トラストセンター、プライバシーのベストプラクティスガイド、セキュリティのベストプラクティスガイドを確認してください。プロダクト、法務、エンジニアリングの各チームは、プライバシーポリシーと利用規約も確認してから、実際のユーザーに FACEIO を提供してください。

FACEIOのドキュメントはチームによる責任ある顔認証の実装を支援しますが、アプリケーション所有者自身の法務・セキュリティレビュー、ユーザー通知、同意フロー、サポート手順、提供地域のコンプライアンス義務に代わるものではありません。

サポートとコミュニティ

実装に関する質問はどこでできますか?

FACEIO コミュニティフォーラム ↗には、公開可能な実装上の質問、開発者同士の議論、他のチームにも役立つ顔認証統合の具体的なトピックを投稿できます。

非公開のアカウント、請求、本番、セキュリティ、顧客固有の問題は、FACEIO Console のサポートチャンネル ↗へお問い合わせください。

サポートではなくコミュニティフォーラムを使うのはいつですか?

フレームワーク例、統合パターン、Webhook処理、顔ログインUX、ID Match実装、非公開のアカウントデータを含まないトラブルシューティングなど、再利用できる質問にはフォーラムを利用してください。

アプリケーションID、請求情報、ユーザーデータ、本番インシデント、セキュリティ上の機密情報が含まれる場合は非公開サポートを利用してください。

FACEIOのサービス状況はどこで確認できますか?

FACEIO ステータスページ ↗で、現在のサービス稼働状況とインシデントの更新を確認できます。実装のサポートはサポートページを利用するか、FACEIO Console から非公開リクエストを送信してください。

FACEIOフローを構築、テスト、保護する

FACEIO Consoleでアプリケーションを作成して fio.js、ID Match、Webhook、REST APIアクセス、PIN Codeなどのデフォルトのセキュリティ設定をテストできます。他の開発者にも役立つ公開の実装質問はコミュニティフォーラムに投稿してください。