Versions in this module Expand all Collapse all v0 v0.1.0 Oct 14, 2026 Changes in this version + const AlgECDSASHA256 + const AlgRSASHA256 + const AlgRSASHA512 + const AttrNameFormatBasic + const AttrNameFormatURI + const AttrNameFormatUnspecified + const BindingPOST + const BindingRedirect + const ContentTypeMetadata + const DefaultAssertionTTL + const DefaultBasePath + const DefaultClockSkew + const DefaultLoginTTL + const DefaultMaxMessageSize + const DefaultRequestMaxAge + const DefaultReturnParam + const EndpointContinue + const EndpointInitiate + const EndpointSSO + const MaxRelayState + const NameIDEmail + const NameIDPersistent + const NameIDTransient + const NameIDUnspecified + const ParamPrompt + const ParamRelayState + const ParamSAMLRequest + const ParamSAMLResponse + const ParamSigAlg + const ParamSignature + const PluginName + const PromptLogin + const PurposePending + const PurposeRequestID + const StatusNoPassive + const StatusResponder + const StatusSuccess + var DefaultRateLimits = map[auth.EndpointID]int + var ErrACSNotRegistered = auth.NewError("samlidp.acs_not_registered", http.StatusBadRequest, ...) + var ErrAccessDenied = auth.NewError("samlidp.access_denied", http.StatusForbidden, ...) + var ErrBadBasePath = errors.New("samlidp: BasePath must start with / and not end with one") + var ErrBadSP = errors.New("samlidp: invalid service provider") + var ErrBadTTL = errors.New("samlidp: every lifetime is positive") + var ErrIdPInitiatedOff = auth.NewError("samlidp.idp_initiated_disabled", http.StatusForbidden, ...) + var ErrInvalidRequest = auth.NewError("samlidp.invalid_request", http.StatusBadRequest, ...) + var ErrInvalidSignature = auth.NewError("samlidp.invalid_signature", http.StatusBadRequest, ...) + var ErrMessageTooLarge = auth.NewError("samlidp.message_too_large", http.StatusRequestEntityTooLarge, ...) + var ErrMissingRequestParam = auth.NewError("samlidp.missing_request", http.StatusBadRequest, "SAMLRequest is missing.") + var ErrNameIDPolicy = auth.NewError("samlidp.invalid_name_id_policy", http.StatusBadRequest, ...) + var ErrNameIDUnavailable = auth.NewError("samlidp.name_id_unavailable", http.StatusForbidden, ...) + var ErrNoExclusive = errors.New(...) + var ErrNoIssuer = errors.New(...) + var ErrNoLoginPage = errors.New(...) + var ErrNoSigningKey = errors.New(...) + var ErrRelayStateTooLong = auth.NewError("samlidp.relay_state_too_long", http.StatusBadRequest, ...) + var ErrRequestExpired = auth.NewError("samlidp.request_expired", http.StatusBadRequest, ...) + var ErrRequestNotFound = auth.NewError("samlidp.request_not_found", http.StatusBadRequest, ...) + var ErrRequestReplayed = auth.NewError("samlidp.request_replayed", http.StatusBadRequest, ...) + var ErrSignatureRequired = auth.NewError("samlidp.signature_required", http.StatusBadRequest, ...) + var ErrUnknownSP = auth.NewError("samlidp.unknown_service_provider", http.StatusBadRequest, ...) + var ErrUnsupportedBinding = auth.NewError("samlidp.unsupported_binding", http.StatusBadRequest, ...) + var ErrUnsupportedSigAlg = auth.NewError("samlidp.unsupported_signature_algorithm", http.StatusBadRequest, ...) + var ErrWrongDestination = auth.NewError("samlidp.wrong_destination", http.StatusBadRequest, ...) + var NameIDFormats = []string + type AccessFunc func(ctx context.Context, u auth.User, sp ServiceProvider) error + type Attribute struct + FriendlyName string + Name string + NameFormat string + Values []string + func DefaultAttributes(_ context.Context, _ ServiceProvider, s Subject) ([]Attribute, error) + type AttributesFunc func(ctx context.Context, sp ServiceProvider, s Subject) ([]Attribute, error) + type ContinueRequest struct + Request string + type InitiateRequest struct + ACSURL string + RelayState string + ServiceProvider string + type NameIDFunc func(ctx context.Context, sp ServiceProvider, s Subject) (string, error) + type Option func(*Plugin) + func Access(fn AccessFunc) Option + func AssertionTTL(d time.Duration) Option + func BasePath(path string) Option + func ClockSkew(d time.Duration) Option + func EntityID(id string) Option + func Issuer(iss string) Option + func LoginPage(u string) Option + func LoginTTL(d time.Duration) Option + func MaxMessageSize(n int) Option + func RateLimit(endpoint auth.EndpointID, limit int, window time.Duration) Option + func RequestMaxAge(d time.Duration) Option + func ReturnParam(name string) Option + func ServiceProviders(sps ...ServiceProvider) Option + func SigningKey(key crypto.Signer, cert *x509.Certificate) Option + func WantAuthnRequestsSigned() Option + func WithRequestIDGuard(g RequestIDGuard) Option + func WithServiceProviderStore(store ServiceProviderStore) Option + type Plugin struct + func New(opts ...Option) *Plugin + func (p *Plugin) Continue(ctx context.Context, in ContinueRequest) (Result, error) + func (p *Plugin) ContinueURL(handle string) string + func (p *Plugin) Handler(opts ...authhttp.Option) http.Handler + func (p *Plugin) IdPEntityID() string + func (p *Plugin) Init(a *auth.Auth) error + func (p *Plugin) Initiate(ctx context.Context, in InitiateRequest) (Result, error) + func (p *Plugin) Metadata() []byte + func (p *Plugin) MetadataURL() string + func (p *Plugin) Name() string + func (p *Plugin) Operations() []auth.Operation + func (p *Plugin) OptionErr() error + func (p *Plugin) RateLimits() []auth.RateRule + func (p *Plugin) SSO(ctx context.Context, in SSORequest) (Result, error) + func (p *Plugin) SSOURL() string + func (p *Plugin) Validate(*auth.Config) error + type RequestClaim struct + Request string + SP string + Until time.Time + type RequestIDGuard interface + Claim func(ctx context.Context, c RequestClaim) error + type ResponseForm struct + ACSURL string + RelayState string + SAMLResponse string + type Result struct + Form *ResponseForm + RedirectTo string + type SSORequest struct + Binding string + RawQuery string + RelayState string + SAMLRequest string + SigAlg string + Signature string + type ServiceProvider struct + ACSURLs []string + AllowIdPInitiated bool + Attributes AttributesFunc + Certificates []*x509.Certificate + EntityID string + NameID NameIDFunc + NameIDFormat string + RequireSignedRequests bool + UnsignedResponse bool + type ServiceProviderStore interface + ServiceProvider func(ctx context.Context, entityID string) (ServiceProvider, error) + type Subject struct + Email string + Session auth.Session + User auth.User