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

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

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

戻る
- FIDO
- Microsoft Passport

目次 †

概要 †

FIDO 2.0 の Web Application用 JavaScript Library。

サポート状況 †

ブラウザ †

Microsoft Edge
早期ドラフトの実装 (ms-prefix実装)。

Chrome

Firefox

Safari

認証器 †

Embedded Authenticator (利用 Device に付随した認証) に限定
External Authenticator (外部 Device による認証) は将来対応予定

API †

Web Authentication API で使用する (主な) 関数は 2 つだけ。

W3C で定義されている API の名前空間は
- window.webauthn.makeCredential
- window.webauthn.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を使用すれば、複数のデバイスの登録が可能。
しかし、デバイスを特定する方法が無いので、登録が重複してしまう。

参考 †

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

しばやん雑記 †

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

Tags: :認証基盤