Module: Unmagic::Passkeys::Request

Extended by:
ActiveSupport::Concern
Included in:
ChallengesController
Defined in:
lib/unmagic/passkeys/request.rb

Overview

Action Pack Passkey Request

Controller concern that sets up the WebAuthn request context and provides helper methods for passkey registration and authentication. Include this in any controller that handles passkey form submissions.

Registration example

class PasskeysController < ApplicationController
  include Unmagic::Passkeys::Request

  def new
    @registration_options = passkey_registration_options(holder: Current.user)
  end

  def create
    @passkey = Unmagic::Passkeys::Credential.register(
      passkey_registration_params, holder: Current.user
    )
    redirect_to settings_path
  end
end

Authentication example

class SessionsController < ApplicationController
  include Unmagic::Passkeys::Request

  def new
    @authentication_options = passkey_authentication_options
  end

  def create
    if passkey = Unmagic::Passkeys::Credential.authenticate(passkey_authentication_params)
       passkey.holder
      redirect_to root_path
    else
      redirect_to new_session_path, alert: "Authentication failed"
    end
  end
end

Before Action

Automatically populates Unmagic::Passkeys::WebAuthn::Current with the request host and origin.

Instance Method Summary collapse

Instance Method Details

#passkey_authentication_options(**options) ⇒ Object

Returns RequestOptions for the authentication ceremony.



69
70
71
 
# File 'lib/unmagic/passkeys/request.rb', line 69

def passkey_authentication_options(**options)
  Unmagic::Passkeys::Credential.authentication_options(**options)
end

#passkey_authentication_params(param: :passkey) ⇒ Object

Returns strong parameters for the passkey authentication ceremony.



64
65
66
 
# File 'lib/unmagic/passkeys/request.rb', line 64

def passkey_authentication_params(param: :passkey)
  params.expect(param => [ :id, :client_data_json, :authenticator_data, :signature ])
end

#passkey_registration_options(**options) ⇒ Object

Returns RegistrationOptions for the registration ceremony.



74
75
76
 
# File 'lib/unmagic/passkeys/request.rb', line 74

def passkey_registration_options(**options)
  Unmagic::Passkeys::Credential.registration_options(**options)
end

#passkey_registration_params(param: :passkey) ⇒ Object

Returns strong parameters for the passkey registration ceremony.



59
60
61
 
# File 'lib/unmagic/passkeys/request.rb', line 59

def passkey_registration_params(param: :passkey)
  params.expect(param => [ :client_data_json, :attestation_object, transports: [] ])
end