configuration-registrations

Configuration Registrations

Purpose

Use this skill to configure user signup. Read SQLite enrollment for user registration sqlite <name>: confirmation creates a login account with a fixed policy and requires explicit portal selection. The legacy user registration <name> flow below writes a separate approval dropbox. OAuth client registrations retain their own configuration owner.

Legacy dispatch starts in caddyfile_user.go; registration instructions are collected by caddyfile_user_registration.go. The Caddyfile parser injects name <block-name> and kind local, then forwards the block instructions to authcrunch for validation.

Registration flows attach to the target identity store declared by identity store <name> [<realm>]. During authcrunch validation, portals using that identity store get registration enabled for that store and the registry is attached at runtime. Legacy registrations are selected automatically for eligible portals unless a nonempty explicit enable user registration <name> [<name>...] selection is supplied. The portal must also enable each selected registry's identity store. SQLite workflows require explicit registration selection.

Shape

{
	security {
		user registration signup {
			title "User Registration"
			code {env.REGISTER_CODE}
			dropbox assets/config/registrations_local.json
			require accept terms
			require domain mx
			email provider smtp
			admin email [email protected]
			identity store localdb
			link terms https://example.com/terms
			link privacy https://example.com/privacy
			allow domain example.com
		}

		local identity store localdb {
			realm local
			path assets/config/users.json
		}

		authentication portal myportal {
			enable identity store localdb
		}
	}
}

Required and Defaulted Fields

Authcrunch requires the effective registry config to have name, kind, dropbox, email provider, at least one admin email address, and identity store. In Caddyfile configuration, name comes from the block name and kind local is injected by caddy-security.