POST FIDO Create API

FIDO認証器は、ネームスペース内で一意になります。
FIDO認証器はFIDOアライアンス認可した、FIDO2(U2Fを含む)準拠認証器を利用可能です。
当サービスでは、どちらのFIDO認証器でもご利用できます。ただし、FIDO UAFはご利用できません。

FIDO(Fast IDentity Online) : ユーザー認証におけるパスワードへの依存を軽減するために、オープンで拡張性と相互運用性があるメカニズムを定義する技術仕様です。
FIDO2 : パスワードレス認証のメカニズムを定義する認証仕様です。W3C採用のWebAuthnと認証器のプロトコルCTAP2で構成されます。U2FやUAFとの下位互換性があります。
U2F(Universal Second Factor) : 公開鍵暗号化を利用した認証デバイスによる認証方式です。既存のパスワードと組み合わせすことでセキュリティを強化します。
UAF(Universal Authentication Framework) : バイオメトリクスによる認証方式です。パスワードレス認証が実現可能です。

FIDO認証器の登録は、下記のフローのとおりです。
自作のWebアプリケーションにFIDO認証器を登録するには、下記の機能を実装する必要があります

ブラウザ側の処理を簡単にするために、DAuthではスクリプト(dauth.js)を提供しています。こちらからダウンロードできます。
各処理を実装するためのサンプルソースは、[API実行]ボタン下のタブでご確認いただけます。

ヘッダーパラメータ

DAuth APIキー必須

[文字列型] DAuthのAPIキー(32桁)。事前にWebコンソールで作成して下さい。
APIキーのネームスペースと同じリソースにのみアクセスできます。

オリジン必須

[文字列型] 要求元のOrigin情報。
FIDOを使用するWebサイトのURLが入ります。

リクエストパラメータ

Body

user_id必須

[文字列型] ユーザID。

display_name

[文字列型] ユーザの表示名。初めて登録する場合、未設定の場合はユーザIDとなります。
２回目以降登録するときにdisplay_nameを指定した場合は、その値で上書きされ、未設定の場合は前回値のまま更新しません。

device_name

[文字列型] FIDO認証器名。未設定の場合は、Fidoアライアンスのメタ情報に登録されているデバイス名が適用されます。
メタ情報にデバイス名が登録されていない場合は、"{display_name} Security Key"となります。

attestation

[文字列型] 認証器の正当性をRPが検証するための手段。デフォルトは"none"。

authenticator_attachment

[文字列型] 登録対象となる認証器種別を指定。デフォルトは指定なし。

user_verification

[文字列型] PINや生体認証などユーザ認証を必要とするかどうかの挙動を指定。デフォルトは"discouraged"。