Duende Storage

Preview documentation

Duende Storage and the documentation in this section are previews. APIs, packages, database schemas and behavior are subject to change before general availability.

Duende Storage is a relational persistence layer shared by Duende products. IdentityServer adapters connect its configuration and operational store interfaces to the storage layer, so IdentityServer continues to use the same abstractions during protocol processing.

How Duende Storage Works

The provider has four parts:

1. A database-specific package connects Duende Storage to SQL Server, PostgreSQL, Oracle or SQLite.
2. The storage layer persists entities with versioning, indexing and expiration support.
3. IdentityServer adapters implement its configuration and operational store interfaces.
4. Optional administration APIs and schemas let your application manage and extend configuration data.

One Registration for Configuration and Operational Storage

AddStorage(...) registers configuration and operational storage together against one database provider and schema. To replace one specific store, call an explicit registration such as AddInMemoryClients() or AddInMemoryPersistedGrants() after AddStorage(...). The later registration replaces only that store and leaves the rest of the Duende Storage wiring in place.

Why Use Duende Storage?

Choose Duende Storage when you need one or more of these capabilities:

• Configuration administration through supported service APIs, without writing directly to database tables.
• Schema-validated custom properties on clients and resources.
• Consistent querying and optimistic concurrency across supported databases.
• Storage pools that isolate data for Spaces.
• A shared persistence model across Duende products.

The Entity Framework Core provider remains a good choice when your application already uses EF Core and your team wants to manage DbContext types, mappings and migrations directly. In-memory stores remain useful for development or deployment-controlled configuration. A custom store gives you complete control when neither built-in approach matches your requirements.

Supported Databases

Choose the package that matches your database:

Database	Package	Registration
SQL Server	Duende.Storage.MsSql	AddMsSqlStore
PostgreSQL	Duende.Storage.PostgreSql	AddPostgreSqlStore
Oracle	Duende.Storage.Oracle	AddOracleStore
SQLite	Duende.Storage.Sqlite	AddSqliteStore

Getting StartedConfigure storage for IdentityServer configuration and operational data.

Configuration Admin APIsCreate and manage configuration through dependency-injected services.

Data Extension SchemasAdd validated custom properties to supported configuration entities.

Storage SampleStore and administer IdentityServer configuration and operational data with Duende Storage.

Migrate from Entity Framework CorePlan configuration transfer, secret rotation and operational cutover.

SpacesRun isolated security domains from one IdentityServer deployment.