Reference#

Reference guides are technical descriptions of the machinery and how to operate it. Reference material is information-oriented.

Look things up here. For directions toward a result, read How-to guides. For the reasoning behind any of it, read Concepts.

Writing Python against this package#

🐍 Python API

One import path for the interfaces, events, content classes, and functions a downstream package needs.

Python API

Configuration#

⚙️ Settings

Every registry record the package reads, with type and default.

Settings
📝 The provider form

Every field on the provider form, by tab, and which drivers show it.

The provider form
🔌 Shipped drivers

The six drivers that ship with the package, their defaults, and the settings each one offers.

Shipped drivers
📦 Install profiles and upgrades

Every GenericSetup profile the package ships, what it installs, and the upgrade situation.

Install profiles and upgrades

Interfaces#

🌐 Endpoints

Every REST endpoint and browser view the package publishes.

Endpoints
🖥️ Frontend

The routes, settings, and components the volto-identity add-on registers.

Frontend
📣 Events

The events the package fires, and the normalized claim keys they carry.

Events
🏷️ Claims released by the server layer

Endpoints, scopes, and claims released when a Plone site acts as an authorization server.

Claims released by the server layer
📜 Driver contract

The IDriver interface and the rules a driver must satisfy.

Driver contract

Data and storage#

🗒️ The audit log

Event names, endpoints, recorded fields, retention settings, and the sink interfaces.

The audit log
👥 Users and groups as content

Registry records, marker contracts, and plugin behavior for keeping users and groups as content.

Users and groups as content
🪪 Profiles and groups

The UserProfile and UserGroup content types: fields, workflow states, containers, the profile gate, and claims refresh.

Profiles and groups
📄 Principal documents

The JSON format users, groups, and identities are exported as, and read back from.

Principal documents
📊 Migration reports

Every field a migration report carries, and what each one means.

Migration reports

Security and support#

🔐 Permissions

The permissions the package declares and the roles that hold them.

Permissions
🛡️ Security guarantees

The security properties the test suite enforces, and what to know before deploying.

Security guarantees
🧱 Stability

What is settled and what may still change before 1.0.0.

Stability