Web Authentication API のバックアップ(No.20) - マイクロソフト系技術情報 Wiki

[ トップ ] [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る
- FIDO2
- Microsoft Passport

目次 †

概要 †

FIDO の Web Application用 JavaScript Library。

API †

昔のサンプルは、ドラフト実装(makeCredential & getAssertion)だったが、
最近のサンプルは、Credential Management API(navigator.credentials.create & get)に、変わっている。

以下のような状況（？）らしい。
「Progressive Web App Checklist には記載されていないですが、
Web Authentication API の仕様では PWA の API の 1 つである
Credential Management API との連携について言及されています。」

ドラフト実装(makeCredential & getAssertion) †

使用する (主な) 関数は 2 つ。

W3C で定義されている API の名前は
- makeCredential()メソッド
- getAssertion()メソッド

仕様 †

ドラフト
- 現在はドラフト仕様に基づく ms-prefix実装であるため、
  現在 (2016/05 時点) の Edge の実装では、明示的に下記を使用。
  - window.msCredentials.makeCredential
  - window.msCredentials.getAssertion

Polyfill
webauthn.jsというPolyfillを使用すると良い。

Promise
Promiseで実装されている。

メソッド †

makeCredential()メソッド
初回の key pair の作成
- private key の (Device への) 登録
- public key の取得 (JWK format)

getAssertion()メソッド
private key を用いた challenge data のデジタル署名

補足 †

（現時点で）以下に値が入ってこない。
- result.algorithm
- result.attestation

PKIのキーペアは、CredentialIDを使用して、紐付けを行う模様。

このキーペアは、AIK（認証IDキー）だと思われる。

従って、CredentialIDには、認証器が生成した値を使用する必要がある。

なので、実装に注意が必要（あるサンプルコードは失敗する）。
https://github.com/OpenTouryoProject/MultiPurposeAuthSite/issues/50#issuecomment-336858649

なお、CredentialIDを使用すれば、複数のデバイスの登録が可能。
しかし、デバイスを特定する方法が無いので、登録が重複してしまう。

Credential Management API(navigator.credentials.create & get) †

使用する (主な) 関数は 2 つ。

W3C で定義されている API の名前は
- navigator.credentials.create()メソッド
- navigator.credentials.get()メソッド

仕様 †

メソッド †

参考 †

w3c †

Web Authentication Working Group
https://www.w3.org/Webauthn/

Credential Management Level 1
https://www.w3.org/TR/credential-management-1/

Web Authentication: An API for accessing Public Key Credentials - Level 1
http://w3c.github.io/webauthn/

webauthn.org †

WebAuthn? demo
https://webauthn.org
- apowers313/fido2-server-demo: A set of FIDO2 / WebAuthn? demo servers
  https://github.com/apowers313/fido2-server-demo/

fido2-net-lib †

abergs/fido2-net-lib: A proof of Concept implementation library
https://github.com/abergs/fido2-net-lib

＋ demo for fido2 and WebAuthn? using .NET (Work in progress)
https://github.com/abergs/fido2-net-lib/tree/master/Fido2Demo

WebAuthn?.io
https://fido2.azurewebsites.net/

FIDO2 - Things I learned by building a FIDO2 server – Ideas Of Anders Åberg
http://ideasof.andersaberg.com/development/fido2-net-library

Yubico †

Yubico WebAuthn? demo
https://demo.yubico.com/webauthn/

Developer Program
https://www.yubico.com/why-yubico/for-developers/developer-program/

New NIST Authentication Guidelines for Public Safety and First Responders
https://www.yubico.com/2018/05/new-nist-authentication-guidelines-for-public-safety-and-first-responders/

blog.jxck.io †

Web Authentication API で FIDO U2F(YubiKey?) 認証 |
https://blog.jxck.io/entries/2018-05-15/webauthentication-api.html
- Web Authentication API (FIDO-U2F) DEMO
  https://labs.jxck.io/webauthentication/fido-u2f/

enjoy struggling †

Edge が WebAuthN をサポートしたらしいので色々試してみた(Insider Preview)
https://blog.haniyama.com/2018/06/17/edge-support-webauthn/
- HWataru/webauthn-demo: WebAuthn? Demo
  https://github.com/HWataru/webauthn-demo
- fido-alliance/webauthn-demo: WebAuthn? Demo
  https://github.com/fido-alliance/webauthn-demo

（株）ソフト技研 †

ワンタイムパスワードトークンYubiKey?
http://yubikey.yubion.com
- ブログ
  http://yubikey.yubion.com/blog.html

Qiita †

もうすぐ来る? Web Authentication APIについて調べてみた
https://qiita.com/syoichi/items/62e6aa66938692a3c0b6

参考（旧） †

ドラフト実装(makeCredential & getAssertion)の頃の参考情報。

しばやん雑記 †

Windows Hello を Web で使うための Web Authentication API (FIDO 2.0) について調べた
http://blog.shibayan.jp/entry/20170129/1485665985

ASP.NET Core Identity に Windows Hello を使ったログイン機能を追加する
http://blog.shibayan.jp/entry/20170131/1485844075
- shibayan/webauthn-aspnet-demo: Demo Application for Windows Hello (Web Authn API)
  https://github.com/shibayan/webauthn-aspnet-demo

Views †

Manage/AddPublicKey?.cshtml
https://github.com/shibayan/webauthn-aspnet-demo/blob/master/src/WebAuthnDemo/Views/Manage/AddPublicKey.cshtml

Account/Login.cshtml
https://github.com/shibayan/webauthn-aspnet-demo/blob/master/src/WebAuthnDemo/Views/Account/Login.cshtml

Controllers †

AccountController?.cs
https://github.com/shibayan/webauthn-aspnet-demo/blob/master/src/WebAuthnDemo/Controllers/AccountController.cs#L149
ManageController?.cs
https://github.com/shibayan/webauthn-aspnet-demo/blob/master/src/WebAuthnDemo/Controllers/ManageController.cs#L127

Services †

FidoAuthenticator?.cs
https://github.com/shibayan/webauthn-aspnet-demo/blob/master/src/WebAuthnDemo/Services/FidoAuthenticator.cs

microsoft.com †

Web Authentication API 紹介 (Windows Hello を使った Edge 開発) – Tsmatz
https://blogs.msdn.microsoft.com/tsmatsuz/2016/06/08/w3c-web-authentication-api-javascript/

Dev guide: Web authentication - Microsoft Edge Development
https://developer.microsoft.com/en-us/microsoft-edge/platform/documentation/dev-guide/device/web-authentication/

A world without passwords: Windows Hello in Microsoft Edge - Microsoft Edge Dev BlogMicrosoft? Edge Dev Blog
https://blogs.windows.com/msedgedev/2016/04/12/a-world-without-passwords-windows-hello-in-microsoft-edge/

API リファレンス †

Web Authentication
https://msdn.microsoft.com/en-us/library/mt697638.aspx
- MSCredentials object
  https://msdn.microsoft.com/en-us/library/mt697639.aspx
  - makeCredential method
    https://msdn.microsoft.com/en-us/library/mt697641.aspx
  - getAssertion method
    https://msdn.microsoft.com/en-us/library/mt697640.aspx

adrianba/fido-snippets †

polyfill
- webauthn.js
  https://github.com/adrianba/fido-snippets/blob/master/polyfill/webauthn.js
- polyfill.html
  https://github.com/adrianba/fido-snippets/blob/master/polyfill/polyfill.html
csharp/app.cs
https://github.com/adrianba/fido-snippets/blob/master/csharp/app.cs

Qiita †

まだパスワードで消耗してるの？ TouchIDとFIDO2.0でパスワードレス認証を実装してみた（Keycloak編）
https://qiita.com/rkato/items/3607e6870c71fbd3ec06

FIDO2.0対応 - Open 棟梁 Wiki †

Tags: :認証基盤