upstream-ory-kratos/driver/registry_default.go

// Copyright © 2023 Ory Corp
// SPDX-License-Identifier: Apache-2.0

package driver

import (
	"context"
	"crypto/sha256"
	"net/http"
	"strings"
	"sync"
	"testing"
	"time"

	"github.com/cenkalti/backoff"
	"github.com/dgraph-io/ristretto/v2"
	"github.com/gofrs/uuid"
	"github.com/gorilla/sessions"
	"github.com/hashicorp/go-retryablehttp"
	"github.com/lestrrat-go/jwx/jwk"
	"github.com/pkg/errors"
	"github.com/urfave/negroni"

	"github.com/ory/herodot"
	"github.com/ory/kratos/cipher"
	"github.com/ory/kratos/continuity"
	"github.com/ory/kratos/courier"
	"github.com/ory/kratos/driver/config"
	"github.com/ory/kratos/hash"
	"github.com/ory/kratos/hydra"
	"github.com/ory/kratos/identity"
	"github.com/ory/kratos/persistence"
	"github.com/ory/kratos/persistence/sql"
	"github.com/ory/kratos/schema"
	"github.com/ory/kratos/selfservice/errorx"
	"github.com/ory/kratos/selfservice/flow"
	"github.com/ory/kratos/selfservice/flow/login"
	"github.com/ory/kratos/selfservice/flow/logout"
	"github.com/ory/kratos/selfservice/flow/recovery"
	"github.com/ory/kratos/selfservice/flow/registration"
	"github.com/ory/kratos/selfservice/flow/settings"
	"github.com/ory/kratos/selfservice/flow/verification"
	"github.com/ory/kratos/selfservice/hook"
	"github.com/ory/kratos/selfservice/strategy/code"
	"github.com/ory/kratos/selfservice/strategy/idfirst"
	"github.com/ory/kratos/selfservice/strategy/link"
	"github.com/ory/kratos/selfservice/strategy/lookup"
	"github.com/ory/kratos/selfservice/strategy/oidc"
	"github.com/ory/kratos/selfservice/strategy/passkey"
	"github.com/ory/kratos/selfservice/strategy/password"
	"github.com/ory/kratos/selfservice/strategy/profile"
	"github.com/ory/kratos/selfservice/strategy/totp"
	"github.com/ory/kratos/selfservice/strategy/webauthn"
	"github.com/ory/kratos/session"
	"github.com/ory/kratos/x"
	"github.com/ory/kratos/x/nosurfx"
	"github.com/ory/kratos/x/transaction"
	"github.com/ory/kratos/x/webauthnx"
	"github.com/ory/nosurf"
	"github.com/ory/pop/v6"
	"github.com/ory/x/clock"
	"github.com/ory/x/contextx"
	"github.com/ory/x/dbal"
	"github.com/ory/x/healthx"
	"github.com/ory/x/httprouterx"
	"github.com/ory/x/httpx"
	"github.com/ory/x/jsonnetsecure"
	"github.com/ory/x/jwksx"
	"github.com/ory/x/logrusx"
	"github.com/ory/x/otelx"
	"github.com/ory/x/popx"
	"github.com/ory/x/prometheusx"
	"github.com/ory/x/servicelocatorx"
	"github.com/ory/x/sqlcon"
	"github.com/ory/x/sqlxx"
)

type RegistryDefault struct {
	l *logrusx.Logger
	c *config.Config

	// clock is the time source for time-dependent behavior such as flow expiry.
	// It is set eagerly in initCheapMembers and replaced in tests via SetClock.
	clock clock.Clock

	ctxer contextx.Contextualizer

	injectedSelfserviceHooks map[string]NewHookFn
	extraHandlerFactories    []NewHandler
	extraHandlers            []x.Handler
	slOptions                *servicelocatorx.Options

	nosurf         nosurf.Handler
	trc            *otelx.Tracer
	writer         herodot.Writer
	healthxHandler *healthx.Handler

	persister       persistence.Persister
	migrationStatus popx.MigrationStatuses

	hookVerifier           *hook.Verifier
	hookSessionIssuer      *hook.SessionIssuer
	hookSessionDestroyer   *hook.SessionDestroyer
	hookAddressVerifier    *hook.AddressVerifier
	hookShowVerificationUI *hook.ShowVerificationUIHook
	hookVerifyNewAddress   *hook.VerifyNewAddress

	identityHandler        *identity.Handler
	identityValidator      *identity.Validator
	identityManager        *identity.Manager
	identitySchemaProvider schema.IdentitySchemaProvider

	courierHandler *courier.Handler

	continuityManager *continuity.Manager

	schemaHandler *schema.Handler

	sessionHandler   *session.Handler
	sessionManager   session.Manager
	sessionTokenizer initOnce[*session.Tokenizer]

	passwordHasher    initOnce[hash.Hasher]
	extraHashers      map[string]NewHasherFn
	passwordValidator initOnce[password.Validator]

	crypter initOnce[cipher.Cipher]

	errorHandler *errorx.Handler
	errorManager *errorx.Manager

	selfserviceRegistrationExecutor            *registration.HookExecutor
	selfserviceRegistrationHandler             *registration.Handler
	seflserviceRegistrationErrorHandler        *registration.ErrorHandler
	selfserviceRegistrationRequestErrorHandler *registration.ErrorHandler

	selfserviceLoginExecutor            *login.HookExecutor
	selfserviceLoginHandler             *login.Handler
	selfserviceLoginRequestErrorHandler *login.ErrorHandler

	selfserviceSettingsHandler      *settings.Handler
	selfserviceSettingsErrorHandler *settings.ErrorHandler
	selfserviceSettingsExecutor     *settings.HookExecutor

	selfserviceVerifyErrorHandler   *verification.ErrorHandler
	selfserviceVerifyManager        *identity.Manager
	selfserviceVerifyHandler        *verification.Handler
	selfserviceVerificationExecutor *verification.HookExecutor

	selfserviceLinkSender *link.Sender
	selfserviceCodeSender *code.Sender

	selfserviceRecoveryErrorHandler *recovery.ErrorHandler
	selfserviceRecoveryHandler      *recovery.Handler
	selfserviceRecoveryExecutor     *recovery.HookExecutor

	selfserviceLogoutHandler *logout.Handler

	selfserviceStrategies            []any
	replacementSelfserviceStrategies []NewStrategy

	hydra initOnce[hydra.Hydra]

	csrfTokenGenerator nosurfx.CSRFToken

	jsonnetVMProvider initOnce[jsonnetsecure.VMProvider]
	jsonnetPool       jsonnetsecure.Pool
	jwkFetcher        initOnce[*jwksx.FetcherNext]
}

func (m *RegistryDefault) JsonnetVM(ctx context.Context) (jsonnetsecure.VM, error) {
	return m.jsonnetVMProvider.Get(func() jsonnetsecure.VMProvider {
		return &jsonnetsecure.DefaultProvider{Subcommand: "jsonnet", Pool: m.jsonnetPool}
	}).JsonnetVM(ctx)
}

func (m *RegistryDefault) Audit() *logrusx.Logger {
	return m.Logger().WithField("audience", "audit")
}

func (m *RegistryDefault) RegisterPublicRoutes(ctx context.Context, router *httprouterx.RouterPublic) {
	for _, h := range m.ExtraHandlers() {
		h.RegisterPublicRoutes(router)
	}
	m.LoginHandler().RegisterPublicRoutes(router)
	m.RegistrationHandler().RegisterPublicRoutes(router)
	m.LogoutHandler().RegisterPublicRoutes(router)
	m.SettingsHandler().RegisterPublicRoutes(router)
	m.IdentityHandler().RegisterPublicRoutes(router)
	m.CourierHandler().RegisterPublicRoutes(router)
	m.SessionHandler().RegisterPublicRoutes(router)
	m.SelfServiceErrorHandler().RegisterPublicRoutes(router)
	m.SchemaHandler().RegisterPublicRoutes(router)

	m.RecoveryHandler().RegisterPublicRoutes(router)

	m.VerificationHandler().RegisterPublicRoutes(router)

	m.HealthHandler(ctx).SetHealthRoutes(router, false)
	webauthnx.RegisterWebauthnRoute(router)

	for _, s := range m.selfServiceStrategies() {
		s, ok := s.(x.PublicHandler)
		if ok {
			s.RegisterPublicRoutes(router)
		}
	}
}

func (m *RegistryDefault) RegisterAdminRoutes(ctx context.Context, router *httprouterx.RouterAdmin) {
	for _, h := range m.ExtraHandlers() {
		h.RegisterAdminRoutes(router)
	}
	m.RegistrationHandler().RegisterAdminRoutes(router)
	m.LoginHandler().RegisterAdminRoutes(router)
	m.LogoutHandler().RegisterAdminRoutes(router)
	m.SchemaHandler().RegisterAdminRoutes(router)
	m.SettingsHandler().RegisterAdminRoutes(router)
	m.IdentityHandler().RegisterAdminRoutes(router)
	m.CourierHandler().RegisterAdminRoutes(router)
	m.SelfServiceErrorHandler().RegisterAdminRoutes(router)

	m.RecoveryHandler().RegisterAdminRoutes(router)
	m.SessionHandler().RegisterAdminRoutes(router)

	m.VerificationHandler().RegisterAdminRoutes(router)

	m.HealthHandler(ctx).SetHealthRoutes(router, true)
	m.HealthHandler(ctx).SetVersionRoutes(router)
	router.GET(prometheusx.MetricsPrometheusPath, prometheusx.Handler().ServeHTTP)
	config.RegisterConfigHashRoute(m, router)

	for _, s := range m.selfServiceStrategies() {
		s, ok := s.(x.AdminHandler)
		if ok {
			s.RegisterAdminRoutes(router)
		}
	}
}

func (m *RegistryDefault) HTTPMiddlewares() []negroni.Handler {
	return m.slOptions.HTTPMiddlewares()
}

func NewRegistryDefault() *RegistryDefault {
	r := &RegistryDefault{
		trc:       otelx.NewNoop(),
		slOptions: &servicelocatorx.Options{},
	}
	r.initCheapMembers()

	return r
}

func (m *RegistryDefault) SetLogger(l *logrusx.Logger) {
	m.l = l
}

// Clock returns the registry's time source. It is eagerly initialized in
// initCheapMembers, so this getter never lazily initializes.
func (m *RegistryDefault) Clock() clock.Clock {
	return m.clock
}

// SetClock replaces the registry's time source. Intended for tests that need
// deterministic control over time-dependent behavior such as flow expiry.
func (m *RegistryDefault) SetClock(c clock.Clock) {
	m.clock = c
}

func (m *RegistryDefault) SetJSONNetVMProvider(p jsonnetsecure.VMProvider) {
	m.jsonnetVMProvider.Set(p)
}

func (m *RegistryDefault) LogoutHandler() *logout.Handler {
	if m.selfserviceLogoutHandler == nil {
		m.selfserviceLogoutHandler = logout.NewHandler(m)
	}
	return m.selfserviceLogoutHandler
}

func (m *RegistryDefault) HealthHandler(_ context.Context) *healthx.Handler {
	if m.healthxHandler == nil {
		m.healthxHandler = healthx.NewHandler(m.Writer(), config.Version,
			healthx.ReadyCheckers{
				"database": func(r *http.Request) error {
					return m.PingContext(r.Context())
				},
				"migrations": func(r *http.Request) error {
					if m.migrationStatus != nil && !m.migrationStatus.HasPending() {
						return nil
					}

					status, err := m.Persister().MigrationStatus(r.Context())
					if err != nil {
						return err
					}

					if status.HasPending() {
						return errors.Errorf("migrations have not yet been fully applied")
					}

					m.migrationStatus = status
					return nil
				},
			})
	}

	return m.healthxHandler
}

func (m *RegistryDefault) WithCSRFHandler(c nosurf.Handler) {
	m.nosurf = c
}

func (m *RegistryDefault) CSRFHandler() nosurf.Handler {
	if m.nosurf == nil {
		panic("csrf handler is not set")
	}
	return m.nosurf
}

func (m *RegistryDefault) Config() *config.Config {
	if m.c == nil {
		panic("configuration not set")
	}
	return m.c
}

func (m *RegistryDefault) CourierConfig() config.CourierConfigs {
	return m.Config()
}

func (m *RegistryDefault) selfServiceStrategies() []any {
	if len(m.selfserviceStrategies) == 0 {
		if m.replacementSelfserviceStrategies != nil {
			// Construct self-service strategies from the replacements
			for _, newStrategy := range m.replacementSelfserviceStrategies {
				m.selfserviceStrategies = append(m.selfserviceStrategies, newStrategy(m))
			}
		} else {
			// Construct the default list of strategies
			m.selfserviceStrategies = []any{
				profile.NewStrategy(m), // <- should remain first
				password.NewStrategy(m),
				oidc.NewStrategy(m),
				code.NewStrategy(m),
				link.NewStrategy(m),
				totp.NewStrategy(m),
				passkey.NewStrategy(m),
				webauthn.NewStrategy(m),
				lookup.NewStrategy(m),
				idfirst.NewStrategy(m),
			}
		}
	}

	return m.selfserviceStrategies
}

func (m *RegistryDefault) strategyRegistrationEnabled(ctx context.Context, id string) bool {
	if id == "profile" {
		return true
	}
	return m.Config().SelfServiceStrategy(ctx, id).Enabled
}

func (m *RegistryDefault) strategyLoginEnabled(ctx context.Context, id string) bool {
	return m.Config().SelfServiceStrategy(ctx, id).Enabled
}

func (m *RegistryDefault) RegistrationStrategies(ctx context.Context, filters ...registration.StrategyFilter) (registrationStrategies registration.Strategies) {
nextStrategy:
	for _, strategy := range m.selfServiceStrategies() {
		if s, ok := strategy.(registration.Strategy); ok {
			for _, filter := range filters {
				if !filter(s) {
					continue nextStrategy
				}
			}
			if m.strategyRegistrationEnabled(ctx, s.ID().String()) || supportsOrganizations(strategy) {
				registrationStrategies = append(registrationStrategies, s)
			}
		}
	}
	return
}

func (m *RegistryDefault) AllRegistrationStrategies() registration.Strategies {
	var registrationStrategies []registration.Strategy

	for _, strategy := range m.selfServiceStrategies() {
		if s, ok := strategy.(registration.Strategy); ok {
			registrationStrategies = append(registrationStrategies, s)
		}
	}
	return registrationStrategies
}

func (m *RegistryDefault) LoginStrategies(ctx context.Context, filters ...login.StrategyFilter) (loginStrategies login.Strategies) {
nextStrategy:
	for _, strategy := range m.selfServiceStrategies() {
		if s, ok := strategy.(login.Strategy); ok {
			for _, filter := range filters {
				if !filter(s) {
					continue nextStrategy
				}
			}

			if m.strategyLoginEnabled(ctx, s.ID().String()) || supportsOrganizations(strategy) {
				loginStrategies = append(loginStrategies, s)
			}
		}
	}
	return
}

// TestStrategy returns the OIDC strategy as a login.TestStrategy for
// admin-created test login flows. Only the OIDC strategy implements the
// test-mode single-provider UI. Returns nil if the OIDC strategy is not
// registered or disabled in config; callers must handle that case as a
// misconfiguration rather than crashing the process.
//
// The strategy list may contain several strategies that implement the test
// interface: derivatives of the OIDC strategy registered under a different
// credentials type (e.g. SAML or organization sign-in) inherit it through
// embedding, but they resolve providers from their own method's config
// section. Only the strategy with the OIDC credentials type reads
// selfservice.methods.oidc.config.providers, so select by credentials type
// rather than returning the first match.
func (m *RegistryDefault) TestStrategy(ctx context.Context) login.TestStrategy {
	type testStrategy interface {
		login.TestStrategy
		login.Strategy
	}
	for _, strategy := range m.selfServiceStrategies() {
		if s, ok := strategy.(testStrategy); ok {
			if s.ID() == identity.CredentialsTypeOIDC && m.strategyLoginEnabled(ctx, s.ID().String()) {
				return s
			}
		}
	}

	return nil
}

// supportsOrganizations checks if a strategy implements organization-based authentication.
// Organization strategies manage their own enablement via provider configuration,
// not via the strategy-enabled config flag, so they bypass the strategyLoginEnabled /
// strategyRegistrationEnabled check.
func supportsOrganizations(s any) bool {
	o, ok := s.(flow.OrganizationImplementor)
	return ok && o.SupportsOrganizations()
}

func (m *RegistryDefault) AllLoginStrategies() login.Strategies {
	var loginStrategies []login.Strategy
	for _, strategy := range m.selfServiceStrategies() {
		if s, ok := strategy.(login.Strategy); ok {
			loginStrategies = append(loginStrategies, s)
		}
	}
	return loginStrategies
}

func (m *RegistryDefault) ActiveCredentialsCounterStrategies(_ context.Context) (activeCredentialsCounterStrategies []identity.ActiveCredentialsCounter) {
	for _, strategy := range m.selfServiceStrategies() {
		if s, ok := strategy.(identity.ActiveCredentialsCounter); ok {
			activeCredentialsCounterStrategies = append(activeCredentialsCounterStrategies, s)
		}
	}
	return
}

func (m *RegistryDefault) IdentityValidator() *identity.Validator {
	return m.identityValidator
}

func (m *RegistryDefault) SetConfig(c *config.Config) {
	m.c = c
}

// WithSelfserviceStrategies is only available in testing and overrides the
// selfservice strategies with the given ones.
func (m *RegistryDefault) WithSelfserviceStrategies(t testing.TB, strategies []any) Registry {
	if t == nil {
		panic("Passing selfservice strategies is only supported in testing")
	}
	m.selfserviceStrategies = strategies
	return m
}

func (m *RegistryDefault) Writer() herodot.Writer {
	if m.writer == nil {
		h := herodot.NewJSONWriter(m.Logger())
		m.writer = h
	}
	return m.writer
}

func (m *RegistryDefault) Logger() *logrusx.Logger {
	if m.l == nil {
		m.l = logrusx.New("Ory Kratos", config.Version)
	}
	return m.l
}

func (m *RegistryDefault) IdentityHandler() *identity.Handler {
	if m.identityHandler == nil {
		m.identityHandler = identity.NewHandler(m)
	}
	return m.identityHandler
}

func (m *RegistryDefault) CourierHandler() *courier.Handler {
	if m.courierHandler == nil {
		m.courierHandler = courier.NewHandler(m)
	}
	return m.courierHandler
}

func (m *RegistryDefault) SchemaHandler() *schema.Handler {
	if m.schemaHandler == nil {
		m.schemaHandler = schema.NewHandler(m)
	}
	return m.schemaHandler
}

func (m *RegistryDefault) SessionHandler() *session.Handler {
	if m.sessionHandler == nil {
		m.sessionHandler = session.NewHandler(m)
	}
	return m.sessionHandler
}

func (m *RegistryDefault) Cipher(ctx context.Context) cipher.Cipher {
	return m.crypter.Get(func() cipher.Cipher {
		switch m.c.CipherAlgorithm(ctx) {
		case "xchacha20-poly1305":
			return cipher.NewCryptChaCha20(m.Config())
		case "aes":
			return cipher.NewCryptAES(m.Config())
		default:
			m.l.Logger.Warning("No encryption configuration found. The default algorithm (noop) will be used, resulting in sensitive data being stored in plaintext")
			return cipher.NewNoop()
		}
	})
}

// WithHashers registers additional password hashers, keyed by the
// hashers.algorithm value that selects them. See WithExtraHashers.
func (m *RegistryDefault) WithHashers(hashers map[string]NewHasherFn) {
	m.extraHashers = hashers
}

func (m *RegistryDefault) Hasher(ctx context.Context) hash.Hasher {
	return m.passwordHasher.Get(func() hash.Hasher {
		alg := m.c.HasherPasswordHashingAlgorithm(ctx)
		if newHasher, ok := m.extraHashers[alg]; ok {
			return newHasher(m)
		}
		if alg == "bcrypt" {
			return hash.NewHasherBcrypt(m)
		}
		return hash.NewHasherArgon2(m)
	})
}

func (m *RegistryDefault) PasswordValidator() password.Validator {
	m.passwordValidator.Get(func() password.Validator {
		val, err := password.NewDefaultPasswordValidatorStrategy(m)
		if err != nil {
			m.Logger().WithError(err).Fatal("could not initialize DefaultPasswordValidator")
		}
		return val
	})
	return m.passwordValidator.value
}

func (m *RegistryDefault) SelfServiceErrorHandler() *errorx.Handler {
	if m.errorHandler == nil {
		m.errorHandler = errorx.NewHandler(m)
	}
	return m.errorHandler
}

// cookieStoreKeyPairs derives the (hashKey, blockKey) pairs securecookie
// expects: each secret signs, and its SHA-256 digest encrypts. This way a
// single configured secret yields both signing and encryption, and rotation
// rotates both.
func cookieStoreKeyPairs(secrets [][]byte) [][]byte {
	keys := make([][]byte, 0, 2*len(secrets))
	for _, k := range secrets {
		encrypt := sha256.Sum256(k)
		keys = append(keys, k, encrypt[:])
	}
	return keys
}

func (m *RegistryDefault) CookieManager(ctx context.Context) sessions.StoreExact {
	cs := sessions.NewCookieStore(cookieStoreKeyPairs(m.Config().SecretsSession(ctx))...)
	cs.Options.Secure = m.Config().SessionCookieSecure(ctx)
	cs.Options.HttpOnly = true

	if domain := m.Config().SessionDomain(ctx); domain != "" {
		cs.Options.Domain = domain
	}

	if path := m.Config().SessionPath(ctx); path != "" {
		cs.Options.Path = path
	}

	if sameSite := m.Config().SessionSameSiteMode(ctx); sameSite != 0 {
		cs.Options.SameSite = sameSite
	}

	cs.Options.MaxAge = 0
	if m.Config().SessionPersistentCookie(ctx) {
		cs.Options.MaxAge = int(m.Config().SessionLifespan(ctx).Seconds())
		cs.MaxAge(cs.Options.MaxAge)
	}
	return cs
}

func (m *RegistryDefault) ContinuityCookieManager(ctx context.Context) sessions.StoreExact {
	// To support hot reloading, this can not be instantiated only once.
	secrets := m.Config().SecretsSession(ctx)
	// Cookies issued before the derived-block-key fix used the raw secrets as
	// (hashKey, blockKey) pairs. Appending the raw secrets after the derived
	// pairs keeps those cookies readable as a decode fallback (encoding always
	// uses the first pair). Remove once cookies issued by pre-fix versions
	// have expired.
	cs := sessions.NewCookieStore(append(cookieStoreKeyPairs(secrets), secrets...)...)
	cs.Options.Secure = m.Config().CookieSecure(ctx)
	cs.Options.HttpOnly = true
	cs.Options.SameSite = http.SameSiteLaxMode
	return cs
}

func (m *RegistryDefault) Tracer(context.Context) *otelx.Tracer {
	if m.trc == nil {
		return otelx.NewNoop()
	}
	return m.trc
}

func (m *RegistryDefault) SetTracer(t *otelx.Tracer) {
	m.trc = t
}

func (m *RegistryDefault) SessionManager() session.Manager {
	return m.sessionManager
}

func (m *RegistryDefault) Hydra() hydra.Hydra {
	return m.hydra.Get(func() hydra.Hydra {
		return hydra.NewDefaultHydra(m)
	})
}

func (m *RegistryDefault) SetHydra(h hydra.Hydra) {
	m.hydra.Set(h)
}

func (m *RegistryDefault) SelfServiceErrorManager() *errorx.Manager {
	return m.errorManager
}

func (m *RegistryDefault) Init(ctx context.Context, ctxer contextx.Contextualizer, opts ...RegistryOption) error {
	if m.persister != nil {
		// The DSN connection can not be hot-reloaded!
		panic("RegistryDefault.Init() must not be called more than once.")
	}

	o := newOptions(opts)

	m.jsonnetPool = o.jsonnetPool

	if o.replaceTracer != nil {
		m.trc = o.replaceTracer(m.trc)
	}

	if o.replacementStrategies != nil {
		m.replacementSelfserviceStrategies = o.replacementStrategies
	}

	if o.extraHooks != nil {
		m.WithHooks(o.extraHooks)
	}
	if o.extraHashers != nil {
		m.WithHashers(o.extraHashers)
	}
	if o.extraHandlers != nil {
		m.WithExtraHandlers(o.extraHandlers)
	}

	if o.replaceIdentitySchemaProvider != nil {
		m.identitySchemaProvider = o.replaceIdentitySchemaProvider(m)
	}

	bc := backoff.NewExponentialBackOff()
	bc.MaxElapsedTime = time.Minute * 5
	bc.Reset()
	err := backoff.Retry(func() error {
		m.SetContextualizer(ctxer)

		pool, idlePool, connMaxLifetime, connMaxIdleTime, cleanedDSN := sqlcon.ParseConnectionOptions(m.l, m.Config().DSN(ctx))
		dbOpts := &pop.ConnectionDetails{
			URL:             sqlcon.FinalizeDSN(m.l, cleanedDSN),
			IdlePool:        idlePool,
			ConnMaxLifetime: connMaxLifetime,
			ConnMaxIdleTime: connMaxIdleTime,
			Pool:            pool,
			TracerProvider:  m.Tracer(ctx).Provider(),
		}

		for _, f := range o.dbOpts {
			f(dbOpts)
		}

		scheme, _, _ := sqlxx.ExtractSchemeFromDSN(dbOpts.URL)
		if !dbOpts.AllowMinPool && scheme == "postgres" && strings.Contains(dbOpts.URL, "pool_min_conns=") {
			err := errors.Errorf("attempting to use the option 'pool_min_conns' with Postgres, but the pgxpool connection pool is disabled, this will be rejected by the database: dsn=%s dbOpts.AllowMinPool=%v", dbOpts.URL, dbOpts.AllowMinPool)
			return backoff.Permanent(err)
		}
		if (scheme == "sqlite" || scheme == "mysql") && strings.Contains(dbOpts.URL, "pool_min_conns=") {
			err := errors.Errorf("attempting to use the option 'pool_min_conns' with %s, but connection pooling is not supported for this case: dsn=%s", scheme, dbOpts.URL)
			return backoff.Permanent(err)
		}

		m.Logger().
			WithField("pool", pool).
			WithField("idlePool", idlePool).
			WithField("connMaxLifetime", connMaxLifetime).
			Debug("Connecting to SQL Database")
		c, err := pop.NewConnection(dbOpts)
		if err != nil {
			m.Logger().WithError(err).Warnf("Unable to connect to database, retrying.")
			return errors.WithStack(err)
		}
		if err := c.Open(); err != nil {
			m.Logger().WithError(err).Warnf("Unable to open database, retrying.")
			return errors.WithStack(err)
		}
		p, err := sql.NewPersister(m, c,
			sql.WithExtraMigrations(o.extraMigrations...),
			sql.WithExtraGoMigrations(o.extraGoMigrations...),
			sql.WithDisabledLogging(o.disableMigrationLogging))
		if err != nil {
			m.Logger().WithError(err).Warnf("Unable to initialize persister, retrying.")
			return err
		}

		pingCtx, cancel := context.WithTimeout(ctx, 5*time.Second)
		defer cancel()
		if err := c.Store.SQLDB().PingContext(pingCtx); err != nil {
			m.Logger().WithError(err).Warnf("Unable to ping database, retrying.")
			return err
		}

		// if dsn is memory we have to run the migrations on every start
		if dbal.IsMemorySQLite(m.Config().DSN(ctx)) || m.Config().DSN(ctx) == "memory" {
			m.Logger().Infoln("Ory Kratos is running migrations on every startup as DSN is memory. This means your data is lost when Kratos terminates.")
			if err := p.MigrateUp(ctx); err != nil {
				m.Logger().WithError(err).Warnf("Unable to run migrations, retrying.")
				return err
			}
		}

		if o.skipNetworkInit {
			m.persister = p
			return nil
		}

		net, err := p.DetermineNetwork(ctx)
		if err != nil {
			m.Logger().WithError(err).Warnf("Unable to determine network, retrying.")
			return err
		}

		m.persister = p.WithNetworkID(net.ID)
		return nil
	}, bc)
	if err != nil {
		return err
	}

	if o.inspect != nil {
		if err := o.inspect(m); err != nil {
			return errors.WithStack(err)
		}
	}

	return nil
}

func (m *RegistryDefault) SetPersister(p persistence.Persister) {
	m.persister = p
}

func (m *RegistryDefault) Courier(ctx context.Context) (courier.Courier, error) {
	return courier.NewCourier(ctx, m)
}

func (m *RegistryDefault) ContinuityManager() *continuity.Manager {
	return m.continuityManager
}

func (m *RegistryDefault) Persister() persistence.Persister                { return m.persister }
func (m *RegistryDefault) ContinuityPersister() continuity.Persister       { return m.persister }
func (m *RegistryDefault) IdentityPool() identity.Pool                     { return m.persister }
func (m *RegistryDefault) PrivilegedIdentityPool() identity.PrivilegedPool { return m.persister }
func (m *RegistryDefault) FlowForTokenExchange() session.FlowForTokenExchange {
	return m
}

func (m *RegistryDefault) GetFlowForTokenExchange(ctx context.Context, flowID uuid.UUID) (any, error) {
	rf, err := m.RegistrationFlowPersister().GetRegistrationFlow(ctx, flowID)
	if err == nil {
		return rf, nil
	}
	if !errors.Is(err, sqlcon.ErrNoRows()) {
		return nil, err
	}

	lf, err := m.LoginFlowPersister().GetLoginFlow(ctx, flowID)
	if err == nil {
		return lf, nil
	}
	if !errors.Is(err, sqlcon.ErrNoRows()) {
		return nil, err
	}

	return nil, errors.WithStack(sqlcon.ErrNoRows())
}
func (m *RegistryDefault) RegistrationFlowPersister() registration.FlowPersister { return m.persister }
func (m *RegistryDefault) RecoveryFlowPersister() recovery.FlowPersister         { return m.persister }
func (m *RegistryDefault) LoginFlowPersister() login.FlowPersister               { return m.persister }
func (m *RegistryDefault) SettingsFlowPersister() settings.FlowPersister         { return m.persister }
func (m *RegistryDefault) SelfServiceErrorPersister() errorx.Persister           { return m.persister }
func (m *RegistryDefault) SessionPersister() session.Persister                   { return m.persister }
func (m *RegistryDefault) CourierPersister() courier.Persister                   { return m.persister }
func (m *RegistryDefault) RecoveryTokenPersister() link.RecoveryTokenPersister   { return m.persister }
func (m *RegistryDefault) RecoveryCodePersister() code.RecoveryCodePersister     { return m.persister }
func (m *RegistryDefault) LoginCodePersister() code.LoginCodePersister           { return m.persister }
func (m *RegistryDefault) VerificationTokenPersister() link.VerificationTokenPersister {
	return m.persister
}

func (m *RegistryDefault) VerificationCodePersister() code.VerificationCodePersister {
	return m.persister
}

func (m *RegistryDefault) RegistrationCodePersister() code.RegistrationCodePersister {
	return m.persister
}
func (m *RegistryDefault) PendingTraitsChangePersister() identity.PendingTraitsChangePersister {
	return m.Persister()
}

func (m *RegistryDefault) TransactionalPersisterProvider() transaction.Persister {
	return m.persister
}

func (m *RegistryDefault) PingContext(ctx context.Context) error {
	return m.persister.Ping(ctx)
}

func (m *RegistryDefault) Ping() error {
	return m.persister.Ping(context.Background())
}

func (m *RegistryDefault) WithCSRFTokenGenerator(cg nosurfx.CSRFToken) {
	m.csrfTokenGenerator = cg
}

func (m *RegistryDefault) GenerateCSRFToken(r *http.Request) string {
	if m.csrfTokenGenerator == nil {
		m.csrfTokenGenerator = nosurfx.DefaultCSRFToken
	}
	return m.csrfTokenGenerator(r)
}

func (m *RegistryDefault) IdentityManager() *identity.Manager {
	return m.identityManager
}

func (m *RegistryDefault) HTTPClient(_ context.Context, opts ...httpx.ResilientOptions) *retryablehttp.Client {
	opts = append([]httpx.ResilientOptions{
		httpx.ResilientClientWithLogger(m.Logger()),
		httpx.ResilientClientWithMaxRetry(2),
		httpx.ResilientClientWithConnectionTimeout(30 * time.Second),
	}, opts...)

	// One of the few exceptions, this usually should not be hot reloaded.
	if m.Config().ClientHTTPNoPrivateIPRanges(contextx.RootContext) {
		opts = append(
			opts,
			httpx.ResilientClientDisallowInternalIPs(),
			// One of the few exceptions, this usually should not be hot reloaded.
			httpx.ResilientClientAllowInternalIPRequestsTo(m.Config().ClientHTTPPrivateIPExceptionURLs(contextx.RootContext)...),
		)
	}
	return httpx.NewResilientClient(opts...)
}

func (m *RegistryDefault) SetContextualizer(ctxer contextx.Contextualizer) {
	m.ctxer = ctxer
}

func (m *RegistryDefault) Contextualizer() contextx.Contextualizer {
	if m.ctxer == nil {
		panic("registry Contextualizer not set")
	}
	return m.ctxer
}

func (m *RegistryDefault) JWKSFetcher() *jwksx.FetcherNext {
	return m.jwkFetcher.Get(func() *jwksx.FetcherNext {
		maxItems := int64(10_000_000)
		cache, _ := ristretto.NewCache(&ristretto.Config[[]byte, jwk.Set]{
			NumCounters:        maxItems * 10,
			MaxCost:            maxItems,
			BufferItems:        64,
			Metrics:            true,
			IgnoreInternalCost: true,
			Cost: func(value jwk.Set) int64 {
				return 1
			},
		})
		return jwksx.NewFetcherNext(cache)
	})
}

func (m *RegistryDefault) SessionTokenizer() *session.Tokenizer {
	return m.sessionTokenizer.Get(func() *session.Tokenizer { return session.NewTokenizer(m) })
}

func (m *RegistryDefault) ExtraHandlers() []x.Handler {
	if m.extraHandlers == nil {
		for _, newHandler := range m.extraHandlerFactories {
			m.extraHandlers = append(m.extraHandlers, newHandler(m))
		}
	}
	return m.extraHandlers
}

// initCheapMembers initializes members that are cheap to initialize.
func (m *RegistryDefault) initCheapMembers() {
	m.clock = clock.New()
	m.identityValidator = identity.NewValidator(m)
	m.identitySchemaProvider = schema.NewDefaultIdentityTraitsProvider(m)
	m.identityManager = identity.NewManager(m)
	m.sessionManager = session.NewManagerHTTP(m)
	m.errorManager = errorx.NewManager(m)
	m.continuityManager = continuity.NewManager(m)
}

type initOnce[T any] struct {
	value T
	init  sync.Once
}

// Set sets the value of the initOnce, marking it as initialized.
func (o *initOnce[T]) Set(val T) {
	// We need to both set the value and run the init function to mark the value as
	// initialized.
	o.init.Do(func() { o.value = val })
	o.value = val
}

// Get returns the value of the initOnce, initializing it with newT if it has not
// been initialized yet. `newT` is only called once, even if Get is called
// concurrently from multiple goroutines or with different `newT` functions.
func (o *initOnce[T]) Get(newT func() T) T {
	o.init.Do(func() { o.value = newT() })
	return o.value
}