cljwebauthn.core — me.grison/cljwebauthn 0.1.3

*challenges* clj

decode-client-data clj

(decode-client-data data)

Decode the client data by parsing its JSON content.

eliptic-curve clj

generate-challenge clj

(generate-challenge)

Generate a challenge for both registration and login.

login-user clj

(login-user {:keys [credential-id user-handle authenticator-data client-data
                    signature challenge]}
            {:keys [protocol host port]}
            get-authenticator)

Login a user using Webauthn.

Example:

(clogin-user
  {:credential-id      "ARkFqKfCJaxgXG4m53c2y3zWpxSZGriN0sH...qt57yU="
   :user-handle        "Zm9vQGJhci5jb20="
   :authenticator-data "09CVCOxdEGxTwSc5mFML...3Wl3siTnwk0FXo82Tg=="
   :client-data        "eyJjaGFsbGVuZ2UiOiJabTl2WW1...G4uZ2V0In0="
   :signature          "MEUCIQCkfqWpAhi7CRO0exa2wenWgDaakqJ..gv+gI1roY="
   :challenge          "439cf387-25a9-40bc-a36a-bb84168e5f54"}
 {:site-id   "grison.me",
   :site-name "Stuff and Thoughts about IT Stuff",
   :protocol  "https",
   :port      443,
   :host      "grison.me"}
 (fn [user-id]
    ; retrieve the authenticator associated with user-id
 ))
=> {:user-id "[e-mail]" :challenge "439cf387-25a9-40bc-a36a-bb84168e5f54"}

prepare-login clj

(prepare-login user-id get-authenticator)

Prepare user login using WebAuthn.

Returns both a challenge and the credential-id used upon registration.

Example:

(prepare-login
  "[e-mail]"
  (fn [user-id]
    ; retrieve the authenticator for user-id
  ))
=> {:challenge   #uuid "439cf387-25a9-40bc-a36a-bb84168e5f54"
  :credentials [{:type "public-key"
                 :id   "AWcH5uwgu/phBRUWh6B9A2...tg54nA=="}]}

prepare-registration clj

(prepare-registration user-id properties)

(prepare-registration user-id can-register-user properties)

Prepare a user for registration by generating a challenge and giving the information needed by the browser to follow with the registration process.

The user-id variable can be anything, it's usually an e-mail.

The method will call the given can-register-user function before preparing for registration.

Example:

(prepare-registration
  "[e-mail]"
  {:site-id   "grison.me",
   :site-name "Stuff and Thoughts about IT Stuff",
   :protocol  "https",
   :port      443,
   :host      "grison.me"})
=> {:rp        {:id  "grison.me"
              :name "Stuff and Thoughts about IT Stuff"}
  :user      {:id "Zm9vQGJhci5jb20="}
  :cred      [{:type "public-key"
               :alg  -7}]
  :challenge #uuid "439cf387-25a9-40bc-a36a-bb84168e5f54"}

register-user clj

(register-user {:keys [attestation client-data challenge]}
               {:keys [protocol host port]}
               save-authenticator)

Register a user given its attestation, client-data and challenge.

The save authenticator function takes both the user-id and the authenticator to be saved so that it can be retrieved during login operation.

Example:

(register-user
  {:attestation "o2NmbXRmcGFja2VkZ2F0dFN0bXSiY2FsZ...dbaqAkCY1nvQuI="
   :client-data "eyJjaGFsbGVuZ2UiOiJabTl2...ZWF0ZSJ9"
   :challenge   "439cf387-25a9-40bc-a36a-bb84168e5f54"}
  {:site-id   "grison.me",
   :site-name "Stuff and Thoughts about IT Stuff",
   :protocol  "https",
   :port      443,
   :host      "grison.me"}
   (fn [user-id authenticator]
     ; save the authenticator for user-id somewhere
   ))
=> {:user-id "[e-mail]" :challenge "439cf387-25a9-40bc-a36a-bb84168e5f54"}