identityserver-aspire

Coordinate IdentityServer startup readiness within Aspire AppHost dependency graphs.

10|2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/DuendeSoftware/duende-skills --skill identityserver-aspire
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: identityserver-aspire
Source: https://github.com/DuendeSoftware/duende-skills/tree/main/skills/identityserver-aspire
Command: npx skills add https://github.com/DuendeSoftware/duende-skills --skill identityserver-aspire

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate the orchestration of Duende IdentityServer within an Aspire AppHost, ensuring dependent services start only after IdentityServer is healthy, discovered, and properly wired.

Core Features & Use Cases

  • AppHost orchestration: wire IdentityServer as a startup dependency using WithReference() and WaitFor() to enforce startup order.
  • Dependency graphs and health readiness: build explicit dependency graphs so services can discover IdentityServer endpoints safely and wait for readiness.
  • Authority URL & OIDC configuration: propagate IdentityServer authority URL and client IDs to clients via environment variables to enable consistent authentication flows.
  • Shared databases and stores: configure separate databases for IdentityServer and applications, and ensure IdentityServer EF stores use shared connections where appropriate.
  • Health checks and readiness: expose /health, /ready endpoints and optional custom health checks to guarantee IdentityServer readiness before dependents start.
  • Multi-instance considerations: support multiple replicas with shared signing keys, data protection keys, and a shared operational store.

Quick Start

Configure your Aspire AppHost to add the IdentityServer project, wire its references, and enable health checks and replica awareness.

Frequently Asked Questions about identityserver-aspire

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure dependent services start only after IdentityServer is ready in Aspire?

Wire IdentityServer startup dependencies in Aspire using WithReference() and WaitFor() to enforce explicit health readiness before dependent services launch in the AppHost graph.

How do I propagate the IdentityServer authority URL to client applications in Aspire?

Propagate the IdentityServer authority URL and client IDs to client applications in Aspire by configuring environment variables, enabling consistent OIDC authentication flows across the multi-service dependency graph.

Can I run multiple IdentityServer replicas with shared stores in Aspire?

Support multiple IdentityServer replicas in Aspire by configuring shared signing keys, data protection keys, and a shared operational store to maintain session consistency across instances.

What health endpoints does IdentityServer need for Aspire orchestration?

Expose /health and /ready endpoints on IdentityServer for Aspire orchestration, allowing the AppHost to verify service readiness before starting dependent applications.

How do I configure separate databases for IdentityServer and client apps in Aspire?

Configure separate databases for IdentityServer and applications in Aspire, ensuring IdentityServer EF stores use shared connections where appropriate for data isolation and operational consistency.