identityserver-deployment

Configure Duende IdentityServer deployments behind reverse proxies with health checks and OpenTelemetry.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying Duende IdentityServer to production often suffers from misconfigurations around proxies, data protection keys, health checks, caching, observability, and multi-instance deployments. This guide provides a concise, production-focused set of practices and configurations to address these challenges.

Core Features & Use Cases

  • Reverse proxy and TLS termination guidance to ensure correct issuer URLs and cookies in production environments.
  • Durable Data Protection key storage and shared signing keys to support multi-instance deployments.
  • Health checks for Discovery and JWKS endpoints to validate production readiness.
  • Distributed caching recommendations to improve performance and consistency across instances.
  • OpenTelemetry integration and logging setup to enable end-to-end observability in production.
  • Production readiness checklist and common deployment pitfalls to avoid.

Quick Start

Follow the deployment guide to configure a production-ready IdentityServer deployment behind a reverse proxy.

Frequently Asked Questions about identityserver-deployment

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

FAQPage Schema
How do I configure Duende IdentityServer for production deployment behind a reverse proxy?

Production deployment behind a reverse proxy requires configuring ASP.NET Core ForwardedHeaders to ensure correct issuer URLs and cookies during TLS termination. This Skill provides the necessary proxy configuration guidance to maintain proper endpoint resolution.

Why does my multi-instance IdentityServer deployment fail with data protection errors?

Multi-instance deployments fail without durable Data Protection key storage and shared signing keys. This Skill enforces practical requirements for persistent key storage across instances to prevent token validation failures and cookie authentication breaks.

What health checks do I need to validate IdentityServer production readiness?

Production readiness requires health checks for Discovery and JWKS endpoints to validate endpoint availability. This Skill provides health check configurations to monitor these critical IdentityServer endpoints and confirm deployment readiness.

Does IdentityServer work with OpenTelemetry for production observability?

IdentityServer supports OpenTelemetry integration and logging setup to enable end-to-end observability in production. This Skill offers configurations for distributed tracing and structured logging across ASP.NET Core ecosystems to monitor authentication flows.

What's the best way to configure distributed caching for multi-instance IdentityServer?

Distributed caching for multi-instance deployments improves performance and consistency across instances. This Skill provides caching recommendations to synchronize state across multiple IdentityServer nodes and reduce database load in production.

What are common deployment pitfalls when moving IdentityServer to production?

Common IdentityServer production deployment pitfalls include missing ForwardedHeaders, non-durable data protection keys, absent health checks, and unconfigured distributed caching. This Skill includes a production readiness checklist to identify and avoid these misconfigurations.