mirror of https://github.com/dexidp/dex.git
42 changed files with 1245 additions and 58 deletions
@ -0,0 +1,295 @@
|
||||
package server |
||||
|
||||
import ( |
||||
"bytes" |
||||
"context" |
||||
"crypto/hmac" |
||||
"crypto/sha256" |
||||
"encoding/base64" |
||||
"fmt" |
||||
"image/png" |
||||
"net/http" |
||||
"strings" |
||||
|
||||
"github.com/pquerna/otp" |
||||
"github.com/pquerna/otp/totp" |
||||
|
||||
"github.com/dexidp/dex/storage" |
||||
) |
||||
|
||||
// MFAProvider is a pluggable multi-factor authentication method.
|
||||
type MFAProvider interface { |
||||
// Type returns the authenticator type identifier (e.g., "TOTP").
|
||||
Type() string |
||||
// EnabledForConnectorType returns true if this provider applies to the given connector type.
|
||||
// If no connector types are configured, the provider applies to all.
|
||||
EnabledForConnectorType(connectorType string) bool |
||||
} |
||||
|
||||
// TOTPProvider implements TOTP-based multi-factor authentication.
|
||||
type TOTPProvider struct { |
||||
issuer string |
||||
connectorTypes map[string]struct{} |
||||
} |
||||
|
||||
// NewTOTPProvider creates a new TOTP MFA provider.
|
||||
func NewTOTPProvider(issuer string, connectorTypes []string) *TOTPProvider { |
||||
m := make(map[string]struct{}, len(connectorTypes)) |
||||
for _, t := range connectorTypes { |
||||
m[t] = struct{}{} |
||||
} |
||||
return &TOTPProvider{issuer: issuer, connectorTypes: m} |
||||
} |
||||
|
||||
func (p *TOTPProvider) EnabledForConnectorType(connectorType string) bool { |
||||
if len(p.connectorTypes) == 0 { |
||||
return true |
||||
} |
||||
_, ok := p.connectorTypes[connectorType] |
||||
return ok |
||||
} |
||||
|
||||
func (p *TOTPProvider) Type() string { return "TOTP" } |
||||
|
||||
func (p *TOTPProvider) generate(connID, email string) (*otp.Key, error) { |
||||
return totp.Generate(totp.GenerateOpts{ |
||||
Issuer: p.issuer, |
||||
AccountName: fmt.Sprintf("(%s) %s", connID, email), |
||||
}) |
||||
} |
||||
|
||||
func (s *Server) handleMFAVerify(w http.ResponseWriter, r *http.Request) { |
||||
macEncoded := r.FormValue("hmac") |
||||
if macEncoded == "" { |
||||
s.renderError(r, w, http.StatusUnauthorized, "Unauthorized request.") |
||||
return |
||||
} |
||||
mac, err := base64.RawURLEncoding.DecodeString(macEncoded) |
||||
if err != nil { |
||||
s.renderError(r, w, http.StatusUnauthorized, "Unauthorized request.") |
||||
return |
||||
} |
||||
|
||||
ctx := r.Context() |
||||
|
||||
authReq, err := s.storage.GetAuthRequest(ctx, r.FormValue("req")) |
||||
if err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to get auth request", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Database error.") |
||||
return |
||||
} |
||||
if !authReq.LoggedIn { |
||||
s.logger.ErrorContext(ctx, "auth request does not have an identity for MFA verification") |
||||
s.renderError(r, w, http.StatusInternalServerError, "Login process not yet finalized.") |
||||
return |
||||
} |
||||
|
||||
// Verify HMAC
|
||||
h := hmac.New(sha256.New, authReq.HMACKey) |
||||
h.Write([]byte(authReq.ID)) |
||||
if !hmac.Equal(mac, h.Sum(nil)) { |
||||
s.renderError(r, w, http.StatusUnauthorized, "Unauthorized request.") |
||||
return |
||||
} |
||||
|
||||
authenticatorID := r.FormValue("authenticator") |
||||
provider, ok := s.mfaProviders[authenticatorID] |
||||
if !ok { |
||||
s.renderError(r, w, http.StatusBadRequest, "Unknown authenticator.") |
||||
return |
||||
} |
||||
|
||||
totpProvider, ok := provider.(*TOTPProvider) |
||||
if !ok { |
||||
s.renderError(r, w, http.StatusInternalServerError, "Unsupported authenticator type.") |
||||
return |
||||
} |
||||
|
||||
identity, err := s.storage.GetUserIdentity(ctx, authReq.Claims.UserID, authReq.ConnectorID) |
||||
if err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to get user identity", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Database error.") |
||||
return |
||||
} |
||||
|
||||
returnURL := strings.Replace(r.URL.String(), "/totp/verify", "/approval", 1) |
||||
|
||||
if authReq.MFAValidated { |
||||
http.Redirect(w, r, returnURL, http.StatusSeeOther) |
||||
return |
||||
} |
||||
|
||||
secret := identity.MFASecrets[authenticatorID] |
||||
|
||||
switch r.Method { |
||||
case http.MethodGet: |
||||
if secret == nil { |
||||
// First-time enrollment: generate a new TOTP key.
|
||||
generated, err := totpProvider.generate(authReq.ConnectorID, authReq.Claims.Email) |
||||
if err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to generate TOTP key", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Internal server error.") |
||||
return |
||||
} |
||||
|
||||
secret = &storage.MFASecret{ |
||||
AuthenticatorID: authenticatorID, |
||||
Type: "TOTP", |
||||
Secret: generated.String(), |
||||
Confirmed: false, |
||||
CreatedAt: s.now(), |
||||
} |
||||
|
||||
if err := s.storage.UpdateUserIdentity(ctx, authReq.Claims.UserID, authReq.ConnectorID, func(old storage.UserIdentity) (storage.UserIdentity, error) { |
||||
if old.MFASecrets == nil { |
||||
old.MFASecrets = make(map[string]*storage.MFASecret) |
||||
} |
||||
old.MFASecrets[authenticatorID] = secret |
||||
return old, nil |
||||
}); err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to store MFA secret", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Internal server error.") |
||||
return |
||||
} |
||||
} |
||||
|
||||
s.renderTOTPPage(secret, false, totpProvider.issuer, authReq.ConnectorID, w, r) |
||||
|
||||
case http.MethodPost: |
||||
if secret == nil || secret.Secret == "" { |
||||
s.renderError(r, w, http.StatusBadRequest, "MFA not enrolled.") |
||||
return |
||||
} |
||||
|
||||
code := r.FormValue("totp") |
||||
generated, err := otp.NewKeyFromURL(secret.Secret) |
||||
if err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to load TOTP key", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Internal server error.") |
||||
return |
||||
} |
||||
|
||||
if !totp.Validate(code, generated.Secret()) { |
||||
s.renderTOTPPage(secret, true, totpProvider.issuer, authReq.ConnectorID, w, r) |
||||
return |
||||
} |
||||
|
||||
// Mark MFA secret as confirmed.
|
||||
if !secret.Confirmed { |
||||
if err := s.storage.UpdateUserIdentity(ctx, authReq.Claims.UserID, authReq.ConnectorID, func(old storage.UserIdentity) (storage.UserIdentity, error) { |
||||
if s := old.MFASecrets[authenticatorID]; s != nil { |
||||
s.Confirmed = true |
||||
} |
||||
return old, nil |
||||
}); err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to confirm MFA secret", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Internal server error.") |
||||
return |
||||
} |
||||
} |
||||
|
||||
// Mark auth request as MFA-validated.
|
||||
if err := s.storage.UpdateAuthRequest(ctx, authReq.ID, func(old storage.AuthRequest) (storage.AuthRequest, error) { |
||||
old.MFAValidated = true |
||||
return old, nil |
||||
}); err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to update auth request", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Internal server error.") |
||||
return |
||||
} |
||||
|
||||
// Skip approval if configured.
|
||||
if s.skipApproval && !authReq.ForceApprovalPrompt { |
||||
authReq, err = s.storage.GetAuthRequest(ctx, authReq.ID) |
||||
if err != nil { |
||||
s.logger.ErrorContext(ctx, "failed to get finalized auth request", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Login error.") |
||||
return |
||||
} |
||||
s.sendCodeResponse(w, r, authReq) |
||||
return |
||||
} |
||||
|
||||
http.Redirect(w, r, returnURL, http.StatusSeeOther) |
||||
|
||||
default: |
||||
s.renderError(r, w, http.StatusBadRequest, "Unsupported request method.") |
||||
} |
||||
} |
||||
|
||||
func (s *Server) renderTOTPPage(secret *storage.MFASecret, lastFail bool, issuer, connectorID string, w http.ResponseWriter, r *http.Request) { |
||||
var qrCode string |
||||
if !secret.Confirmed { |
||||
var err error |
||||
qrCode, err = generateTOTPQRCode(secret.Secret) |
||||
if err != nil { |
||||
s.logger.ErrorContext(r.Context(), "failed to generate QR code", "err", err) |
||||
s.renderError(r, w, http.StatusInternalServerError, "Internal server error.") |
||||
return |
||||
} |
||||
} |
||||
if err := s.templates.totpVerify(r, w, r.URL.String(), issuer, connectorID, qrCode, lastFail); err != nil { |
||||
s.logger.ErrorContext(r.Context(), "server template error", "err", err) |
||||
} |
||||
} |
||||
|
||||
func generateTOTPQRCode(keyURL string) (string, error) { |
||||
generated, err := otp.NewKeyFromURL(keyURL) |
||||
if err != nil { |
||||
return "", fmt.Errorf("failed to load TOTP key: %w", err) |
||||
} |
||||
|
||||
qrCodeImage, err := generated.Image(300, 300) |
||||
if err != nil { |
||||
return "", fmt.Errorf("failed to generate TOTP QR code: %w", err) |
||||
} |
||||
|
||||
var buf bytes.Buffer |
||||
if err := png.Encode(&buf, qrCodeImage); err != nil { |
||||
return "", fmt.Errorf("failed to encode TOTP QR code: %w", err) |
||||
} |
||||
|
||||
return base64.StdEncoding.EncodeToString(buf.Bytes()), nil |
||||
} |
||||
|
||||
// mfaChainForClient returns the MFA chain for a client filtered by connector type,
|
||||
// falling back to the server's defaultMFAChain if the client has none.
|
||||
// Returns nil if no MFA is configured/applicable.
|
||||
func (s *Server) mfaChainForClient(ctx context.Context, clientID, connectorID string) ([]string, error) { |
||||
if len(s.mfaProviders) == 0 { |
||||
return nil, nil |
||||
} |
||||
|
||||
client, err := s.storage.GetClient(ctx, clientID) |
||||
if err != nil { |
||||
return nil, err |
||||
} |
||||
|
||||
// nil means "not set" — fall back to default.
|
||||
// Explicit empty slice ([]string{}) means "no MFA" — don't fall back.
|
||||
source := client.MFAChain |
||||
if source == nil { |
||||
source = s.defaultMFAChain |
||||
} |
||||
|
||||
// Resolve connector type from connector ID.
|
||||
connectorType := s.getConnectorType(connectorID) |
||||
|
||||
var chain []string |
||||
for _, authID := range source { |
||||
provider, ok := s.mfaProviders[authID] |
||||
if ok && provider.EnabledForConnectorType(connectorType) { |
||||
chain = append(chain, authID) |
||||
} |
||||
} |
||||
return chain, nil |
||||
} |
||||
|
||||
// getConnectorType returns the type of the connector with the given ID.
|
||||
func (s *Server) getConnectorType(connectorID string) string { |
||||
conn, err := s.storage.GetConnector(context.Background(), connectorID) |
||||
if err != nil { |
||||
return "" |
||||
} |
||||
return conn.Type |
||||
} |
||||
@ -0,0 +1,5 @@
|
||||
export DEX_POSTGRES_DATABASE=dex |
||||
export DEX_POSTGRES_USER=postgres |
||||
export DEX_POSTGRES_PASSWORD=postgres |
||||
export DEX_POSTGRES_HOST=0.0.0.0 |
||||
export DEX_POSTGRES_PORT=5432 |
||||
@ -0,0 +1,35 @@
|
||||
{{ template "header.html" . }} |
||||
|
||||
<div class="theme-panel"> |
||||
<h2 class="theme-heading">Two-factor authentication</h2> |
||||
{{ if not (eq .QRCode "") }} |
||||
<p>Scan the QR code below using your authenticator app, then enter the code.</p> |
||||
<div style="text-align: center; margin: 1em 0;"> |
||||
<img src="data:image/png;base64,{{ .QRCode }}" alt="QR code" width="200" height="200"/> |
||||
</div> |
||||
{{ else }} |
||||
<p>Enter the code from your authenticator app for <b>{{ .Issuer }}</b>.</p> |
||||
{{ end }} |
||||
<form method="post" action="{{ .PostURL }}"> |
||||
<div class="theme-form-row"> |
||||
<div class="theme-form-label"> |
||||
<label for="totp">One-time code</label> |
||||
</div> |
||||
<input tabindex="1" required id="totp" name="totp" type="text" |
||||
inputmode="numeric" pattern="[0-9]*" maxlength="6" |
||||
autocomplete="one-time-code" |
||||
class="theme-form-input" placeholder="000000" |
||||
autofocus/> |
||||
</div> |
||||
|
||||
{{ if .Invalid }} |
||||
<div id="login-error" class="dex-error-box"> |
||||
Invalid code. Please try again. |
||||
</div> |
||||
{{ end }} |
||||
|
||||
<button tabindex="2" id="submit-login" type="submit" class="dex-btn theme-btn--primary">Verify</button> |
||||
</form> |
||||
</div> |
||||
|
||||
{{ template "footer.html" . }} |
||||
Loading…
Reference in new issue