diff --git a/content/docs/implement/_index.md b/content/docs/implement/_index.md index c0312737..481c8e36 100644 --- a/content/docs/implement/_index.md +++ b/content/docs/implement/_index.md @@ -1,9 +1,9 @@ --- -title : "Implement" -description: "Implement passkeys" +title : "Implementation" +description: "Adding passkeys to your website" lead: "" date: 2022-09-24T15:57:34.857Z -draft: true +draft: false images: [] weight: 500 sidebar: diff --git a/content/docs/implement/backend.md b/content/docs/implement/backend.md new file mode 100644 index 00000000..447c221e --- /dev/null +++ b/content/docs/implement/backend.md @@ -0,0 +1,35 @@ +--- +title: "Back End Requirements" +description: "Guidance on server-side handling of passkeys registration and authentication" +lead: "" +date: 2024-08-13T12:00:00.000Z +draft: false +images: [] +menu: + docs: + parent: "implement" +weight: 501 +toc: true +--- + +The back end drives WebAuthn ceremonies through four primary responsibilities: + +1. Generate registration options +2. Verify registration responses +3. Generate authentication options +4. Verify authentication responses + +The guidance below is intended to identify best practices to fulfill these responsibilities and +securely incorporate passkeys-based authentication into your website. + +**Please note that this guidance is not applicable to any specific server implementation.** +It is intended to be a launching point; care should be taken as you consider how best to adapt this +guidance for your particular site. + +## 1. Generate registration options + +## 2. Verify registration responses + +## 3. Generate authentication options + +## 4. Verify authentication responses diff --git a/content/docs/implement/requirements.md b/content/docs/implement/requirements.md deleted file mode 100644 index 9a1a0668..00000000 --- a/content/docs/implement/requirements.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "Requirements" -description: "" -lead: "" -date: 2022-09-24T16:02:27.390Z -draft: true -images: [] -menu: - docs: - parent: "implement" -weight: 501 -toc: true ---- - -## Back End - -Your back end will need to generate a challenge, and a set of configuration parameters for WebAuthn. - -This challenge - -### Session Data - -### Persistent Data - -Each passkey will - -## Front End diff --git a/hugo_stats.json b/hugo_stats.json index 778f5141..6a61defc 100644 --- a/hugo_stats.json +++ b/hugo_stats.json @@ -62,33 +62,20 @@ "time", "title", "tr", - "ul", - "wbr" + "ul" ], "classes": [ "DocSearch-Label", "about", "active", "align-middle", + "align-top", "anchor", "badge", "bg-color-green", "bg-light", "bi", - "bi-box-arrow-up-right", - "bi-calendar-plus", - "bi-chat-square-text-fill", - "bi-check-circle", - "bi-check-circle-fill", - "bi-circle-half", "bi-github", - "bi-house-heart", - "bi-mastodon", - "bi-pencil", - "bi-twitter-x", - "bi-usb-drive", - "bi-wrench-adjustable-circle-fill", - "bi-x-circle-fill", "border", "btn", "btn-black", @@ -99,7 +86,6 @@ "callout", "callout-body", "callout-content", - "callout-icon", "callout-note", "callout-title", "card", @@ -120,9 +106,6 @@ "col-xl-4", "col-xl-8", "col-xl-9", - "color-black", - "color-green", - "color-red", "container", "container-fluid", "container-lg", @@ -160,7 +143,6 @@ "form-control", "form-control-lg", "frame", - "fs-4", "fs-5", "fs-6", "fst-italic", @@ -178,17 +160,33 @@ "icon-tabler", "icon-tabler-arrow-left", "icon-tabler-arrow-right", + "icon-tabler-brand-github", + "icon-tabler-brand-mastodon", + "icon-tabler-brand-threads", + "icon-tabler-brand-x", + "icon-tabler-calendar-clock", + "icon-tabler-circle-check", + "icon-tabler-circle-check-filled", + "icon-tabler-circle-half-2", + "icon-tabler-circle-x-filled", + "icon-tabler-device-usb", "icon-tabler-dots-vertical", + "icon-tabler-edit-circle", + "icon-tabler-external-link", + "icon-tabler-home-check", + "icon-tabler-inline", + "icon-tabler-inlineicon-tabler-settings-code", "icon-tabler-menu", + "icon-tabler-messages", "icon-tabler-moon", "icon-tabler-search", "icon-tabler-sun", "icon-tabler-x", - "info-circle", "justify-content-between", "justify-content-center", "justify-content-end", "lead", + "lh-1", "list", "list-inline", "list-inline-item", @@ -198,7 +196,6 @@ "m-2", "mb-0", "mb-2", - "mb-3", "mb-4", "mb-5", "me-2", @@ -252,7 +249,6 @@ "page-nav", "pb-2", "pb-3", - "pe-1", "pe-4", "privacy-policy", "ps-3", @@ -280,7 +276,6 @@ "stretched-link", "submitted", "svg-icon-bw", - "svg-inline", "table", "table-responsive", "table-striped", @@ -301,22 +296,28 @@ "toc-mobile", "visually-hidden", "w-100", - "wrap", - "youtube-preview" + "wrap" ], "ids": [ + "1-generate-registration-options", "2-factor-authentication-2fa", + "2-verify-registration-responses", "2fa-user", + "3-generate-authentication-options", + "4-verify-authentication-responses", "Layer_1", "TableOfContents", "a-note-about-user-verification", "about", "account-bootstrapping", "advanced", + "advanced-capabilities", "attestation", "authenticating-the-user", "authentication-factor", "autofill-ui", + "back-end", + "back-end-requirements", "basic", "browser-behavior", "buttonColorMode", @@ -343,10 +344,21 @@ "discoverable-credential", "docs", "doks-docs-nav", + "embedded-webviews", + "embedded-webviews-ewv", "engage-and-contribute", "expired-sessions-and-logout", "fido2webauthn-tools", "first-party-passkey-provider", + "fn1", + "fn2", + "fn3", + "fn4", + "fn5", + "fn6", + "fn7", + "fn8", + "front-end", "general-passkey-demo-sites", "go", "h-rh-i-0", @@ -365,6 +377,8 @@ "maintainers", "matrix", "meta", + "native-apis", + "native-apps", "net", "offcanvasNavMain", "offcanvasNavMainLabel", @@ -376,6 +390,7 @@ "overview", "passkey", "passkey-provider", + "persistent-data", "persistent-linking", "platform-authenticator", "platform-notes", @@ -398,15 +413,13 @@ "searchToggleMobile", "selection-criteria", "sensitive-actions", + "session-data", "signing-in", "single-device-passkey", "socialMenu", - "supfive", - "supfour", - "supone", - "supthree", - "suptwo", "synced-passkey", + "system-webviews", + "system-webviews-swv", "third-party-passkey-provider", "title", "toc", @@ -424,7 +437,7 @@ "w3c-web-authentication-webauthn", "webauthn-versions-and-capabilities", "website-visitors", - "whats-next" + "webviews" ] } }