Skip to content

Modern Docker Management, Designed for Everyone

7.1 KB
Raw Blame
package passkey

import (
	"net/http"

	"github.com/danielgtaylor/huma/v2"

	"github.com/getarcaneapp/arcane/backend/v2/internal/auth"
	"github.com/getarcaneapp/arcane/backend/v2/internal/user"
)

func RegisterPasskeys(api huma.API, passkeyService *PasskeyService, authService *auth.AuthService, userService *user.UserService) {
	h := &PasskeyHandler{passkeyService: passkeyService, authService: authService, userService: userService}
	public := []map[string][]string{}
	interactive := []map[string][]string{{"BearerAuth": {}}}

	huma.Register(api, huma.Operation{
		OperationID: "get-passkey-login-availability",
		Method:      http.MethodGet,
		Path:        "/auth/passkey/login/availability",
		Summary:     "Get passkey login availability",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    public,
		Middlewares: huma.Middlewares{func(ctx huma.Context, next func(huma.Context)) {
			ctx.SetHeader("Cache-Control", "no-store")
			next(ctx)
		}},
	}, h.getLoginAvailabilityInternal)

	huma.Register(api, huma.Operation{
		OperationID: "begin-passkey-login",
		Method:      http.MethodPost,
		Path:        "/auth/passkey/login/begin",
		Summary:     "Begin passkey login",
		Description: "Begin a discoverable WebAuthn passkey login ceremony",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    public,
	}, h.BeginPasskeyLogin)
	huma.Register(api, huma.Operation{
		OperationID: "finish-passkey-login",
		Method:      http.MethodPost,
		Path:        "/auth/passkey/login/finish",
		Summary:     "Finish passkey login",
		Description: "Validate a discoverable WebAuthn assertion and create a session",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    public,
	}, h.FinishPasskeyLogin)
	huma.Register(api, huma.Operation{
		OperationID: "finish-mobile-passkey-login",
		Method:      http.MethodPost,
		Path:        "/auth/passkey/mobile/finish",
		Summary:     "Finish mobile passkey login",
		Description: "Validate a browser assertion and create a one-time mobile exchange",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    public,
	}, h.FinishMobilePasskeyLogin)
	huma.Register(api, huma.Operation{
		OperationID: "exchange-mobile-passkey-login",
		Method:      http.MethodPost,
		Path:        "/auth/passkey/mobile/exchange",
		Summary:     "Exchange mobile passkey login",
		Description: "Consume a verifier-bound mobile passkey transaction and create a session",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    public,
	}, h.ExchangeMobilePasskeyLogin)

	huma.Register(api, huma.Operation{
		OperationID: "begin-passkey-mfa",
		Method:      http.MethodPost,
		Path:        "/auth/mfa/passkey/begin",
		Summary:     "Begin passkey MFA",
		Description: "Begin a WebAuthn assertion for a pending MFA transaction",
		Tags:        []string{"Auth", "MFA"},
		Security:    public,
	}, h.BeginMFA)
	huma.Register(api, huma.Operation{
		OperationID: "finish-passkey-mfa",
		Method:      http.MethodPost,
		Path:        "/auth/mfa/passkey/finish",
		Summary:     "Finish passkey MFA",
		Description: "Validate a WebAuthn MFA assertion and create the authenticated session",
		Tags:        []string{"Auth", "MFA"},
		Security:    public,
	}, h.FinishMFA)
	huma.Register(api, huma.Operation{
		OperationID: "use-passkey-recovery-code",
		Method:      http.MethodPost,
		Path:        "/auth/mfa/recovery",
		Summary:     "Use an MFA recovery code",
		Description: "Consume one recovery code for a pending MFA transaction",
		Tags:        []string{"Auth", "MFA"},
		Security:    public,
	}, h.UseRecoveryCode)

	huma.Register(api, huma.Operation{
		OperationID: "list-my-passkeys",
		Method:      http.MethodGet,
		Path:        "/auth/me/passkeys",
		Summary:     "List my passkeys",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.ListMyPasskeys)
	huma.Register(api, huma.Operation{
		OperationID: "get-passkey-capabilities",
		Method:      http.MethodGet,
		Path:        "/auth/me/passkeys/capabilities",
		Summary:     "Get passkey capabilities",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.GetCapabilities)
	huma.Register(api, huma.Operation{
		OperationID: "begin-passkey-registration",
		Method:      http.MethodPost,
		Path:        "/auth/me/passkeys/register/begin",
		Summary:     "Begin passkey registration",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.BeginRegistration)
	huma.Register(api, huma.Operation{
		OperationID: "finish-passkey-registration",
		Method:      http.MethodPost,
		Path:        "/auth/me/passkeys/register/finish",
		Summary:     "Finish passkey registration",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.FinishRegistration)
	huma.Register(api, huma.Operation{
		OperationID: "rename-my-passkey",
		Method:      http.MethodPut,
		Path:        "/auth/me/passkeys/{id}",
		Summary:     "Rename my passkey",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.RenamePasskey)
	huma.Register(api, huma.Operation{
		OperationID: "delete-my-passkey",
		Method:      http.MethodDelete,
		Path:        "/auth/me/passkeys/{id}",
		Summary:     "Delete my passkey",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.DeletePasskey)
	huma.Register(api, huma.Operation{
		OperationID: "begin-passkey-step-up",
		Method:      http.MethodPost,
		Path:        "/auth/me/passkeys/reauth/begin",
		Summary:     "Begin passkey step-up",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.BeginStepUp)
	huma.Register(api, huma.Operation{
		OperationID: "finish-passkey-step-up",
		Method:      http.MethodPost,
		Path:        "/auth/me/passkeys/reauth/finish",
		Summary:     "Finish passkey step-up",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.FinishStepUp)
	huma.Register(api, huma.Operation{
		OperationID: "password-step-up",
		Method:      http.MethodPost,
		Path:        "/auth/me/passkeys/reauth/password",
		Summary:     "Reauthenticate with password",
		Tags:        []string{"Auth", "Passkeys"},
		Security:    interactive,
	}, h.PasswordStepUp)

	huma.Register(api, huma.Operation{
		OperationID: "get-passkey-mfa-status",
		Method:      http.MethodGet,
		Path:        "/auth/me/mfa",
		Summary:     "Get passkey MFA status",
		Tags:        []string{"Auth", "MFA"},
		Security:    interactive,
	}, h.GetMFAStatus)
	huma.Register(api, huma.Operation{
		OperationID: "enable-passkey-mfa",
		Method:      http.MethodPost,
		Path:        "/auth/me/mfa/enable",
		Summary:     "Enable passkey MFA",
		Tags:        []string{"Auth", "MFA"},
		Security:    interactive,
	}, h.EnableMFA)
	huma.Register(api, huma.Operation{
		OperationID: "disable-passkey-mfa",
		Method:      http.MethodPost,
		Path:        "/auth/me/mfa/disable",
		Summary:     "Disable passkey MFA",
		Tags:        []string{"Auth", "MFA"},
		Security:    interactive,
	}, h.DisableMFA)
	huma.Register(api, huma.Operation{
		OperationID: "regenerate-passkey-recovery-codes",
		Method:      http.MethodPost,
		Path:        "/auth/me/mfa/recovery-codes/regenerate",
		Summary:     "Regenerate MFA recovery codes",
		Tags:        []string{"Auth", "MFA"},
		Security:    interactive,
	}, h.RegenerateRecoveryCodes)
}