Modern Docker Management, Designed for Everyone
Go composecontainer-managementcontainersdockerdocker-composedocker-managementgoself-hostedsveltekittypescriptweb-ui
package auth
import (
"time"
"github.com/getarcaneapp/arcane/types/v2/user"
)
// Login represents the login request body.
type Login struct {
Username string `json:"username" minLength:"1" maxLength:"255" doc:"Username of the user" example:"admin"`
Password string `json:"password" minLength:"1" doc:"Password of the user"`
}
// Refresh represents the token refresh request body.
type Refresh struct {
RefreshToken string `json:"refreshToken,omitempty" doc:"Refresh token used to obtain a new access token; browsers send it as a cookie instead"`
}
type Logout struct {
RefreshToken string `json:"refreshToken,omitempty" doc:"Refresh token whose session is revoked even when the access token has expired"`
}
// PasswordChange represents the password change request body.
type PasswordChange struct {
CurrentPassword string `json:"currentPassword,omitempty" doc:"Current password of the user (required for non-OIDC users)"`
NewPassword string `json:"newPassword" minLength:"8" doc:"New password for the user"`
}
// SessionMeta captures request metadata associated with an authenticated session.
type SessionMeta struct {
UserAgent string
IPAddress string
Source string
MFAMethod string
MFAVerifiedAt *time.Time
}
type AuthenticationStatus string
const (
AuthenticationStatusAuthenticated AuthenticationStatus = "authenticated"
AuthenticationStatusMFARequired AuthenticationStatus = "mfa_required"
)
// MFAChallenge describes a pending server-side second-factor transaction.
// Options contains the WebAuthn public-key request options and is safe to
// expose; the matching SessionData is retained by the backend.
type MFAChallenge struct {
TransactionID string `json:"transactionId" doc:"Opaque MFA transaction identifier"`
Method string `json:"method" doc:"MFA method"`
Options any `json:"options" doc:"WebAuthn assertion options"`
ExpiresAt time.Time `json:"expiresAt" doc:"MFA transaction expiration time"`
}
// AuthenticationResponse is returned by local, OIDC, and passkey login
// endpoints. An authenticated response contains tokens and user data; an MFA
// response contains only status and a pending challenge.
type AuthenticationResponse struct {
Success bool `json:"success" doc:"Whether the authentication request was accepted"`
Status AuthenticationStatus `json:"status" doc:"Authentication state"`
Token string `json:"token,omitempty" doc:"JWT access token"`
RefreshToken string `json:"refreshToken,omitempty" doc:"Refresh token for obtaining new access tokens"`
ExpiresAt *time.Time `json:"expiresAt,omitempty" doc:"Expiration time of the access token"`
User *user.User `json:"user,omitempty" doc:"Authenticated user information"`
MFA *MFAChallenge `json:"mfa,omitempty" doc:"Pending MFA challenge"`
}
// MobilePasskeyCompletion identifies a validated passkey login waiting for
// its initiating mobile client to perform the one-time verifier exchange.
type MobilePasskeyCompletion struct {
TransactionID string `json:"transactionId" doc:"Opaque mobile passkey transaction identifier"`
ExpiresAt time.Time `json:"expiresAt" doc:"Mobile passkey transaction expiration time"`
}
// TokenRefreshResponse represents the successful token refresh response data.
type TokenRefreshResponse struct {
Token string `json:"token" doc:"New JWT access token"`
RefreshToken string `json:"refreshToken" doc:"New refresh token"`
ExpiresAt time.Time `json:"expiresAt" doc:"Expiration time of the new access token"`
}
// AutoLoginConfig represents the auto-login configuration for the frontend.
// Password is intentionally excluded from this response.
type AutoLoginConfig struct {
Enabled bool `json:"enabled" doc:"Whether auto-login is enabled"`
Username string `json:"username" doc:"Username for auto-login (only returned if enabled)"`
}
// PasskeyLoginAvailability reports whether the instance has a usable passkey.
type PasskeyLoginAvailability struct {
Available bool `json:"available" doc:"Whether a passkey is registered for the current WebAuthn domain"`
}