Gate OIDC Signing-Key Rollovers with a Pinned JWKS
Block a risky OIDC signing-key rollover if the provider no longer publishes key IDs required by your clients.
Audit ZITADEL IAM readiness, validate database connection pooling and OIDC discovery endpoints, classify cluster health, and alert Slack via Kestra.
Continuously audits ZITADEL Identity and Access Management (IAM) clusters by probing database readiness endpoints, container health liveness routes, and OpenID Connect (OIDC) discovery metadata, classifying operational health, and dispatching real-time incident escalation alerts to Slack.
This blueprint was created by Mohit Jeswani.
probe_ready_endpoint (io.kestra.plugin.core.http.Request) queries /debug/ready to verify that the ZITADEL instance has completed initialization and that its backend database connection pool (CockroachDB or PostgreSQL) is healthy and responsive.probe_health_endpoint (io.kestra.plugin.core.http.Request) queries /debug/healthz to confirm process liveness and web server responsiveness.probe_oidc_discovery (io.kestra.plugin.core.http.Request) queries /.well-known/openid-configuration to confirm that the public OpenID Connect discovery document is serving valid JSON with an intact issuer URL and cryptographic key endpoints.classify_zitadel_posture (io.kestra.plugin.core.debug.Return) evaluates endpoint response codes and metadata using a declarative Pebble expression:INSTANCE_UNREACHABLE if endpoints cannot be reached over the network.DATABASE_OR_BACKEND_UNREADY if /debug/ready returns non-200 (database stall or connection exhaustion).SERVICE_UNHEALTHY if /debug/healthz returns non-200.OIDC_DISCOVERY_CORRUPTED if the discovery document is unavailable or the issuer URL prefix does not match expectations.HEALTHY_COMPLIANT when all probes succeed.route_by_posture (io.kestra.plugin.core.flow.Switch) routes execution based on the classification:HEALTHY_COMPLIANT: Logs successful audit confirmation with issuer URL and HTTP status codes.DATABASE_OR_BACKEND_UNREADY: Posts a critical Slack alert flagging database connection exhaustion.SERVICE_UNHEALTHY: Alerts Slack that the core process is degraded.OIDC_DISCOVERY_CORRUPTED: Dispatches an urgent Slack alert warning that downstream SSO authentication will fail.INSTANCE_UNREACHABLE: Notifies on-call teams of total service unavailability.audit_summary (io.kestra.plugin.core.output.OutputValues) exports structured metrics capturing endpoint HTTP status codes and cluster posture for compliance logging.errors sends a priority failure notification to Slack if unhandled workflow execution errors occur.Identity provider outages are critical Sev-0 incidents that cascade into every downstream microservice and enterprise portal. Standard TCP port checks cannot verify whether ZITADEL's backend database connection pool is functional or whether OIDC discovery documents are returning corrupted issuer URLs. Kestra orchestrates multi-stage HTTP inspection, declarative Pebble classification, failure escalation to Slack, and centralized compliance audit trails in a single workflow.
SLACK_WEBHOOK_URL: Incoming Slack webhook URL used by alert_ready_failure_slack, alert_unhealthy_slack, alert_discovery_corrupted_slack, alert_unreachable_slack, and alert_flow_failure.SLACK_WEBHOOK_URL in your Kestra namespace secrets.docker run -d --name zitadel -p 8080:8080 ghcr.io/zitadel/zitadel:latest start-from-init --masterkey "MasterkeyNeedsToHave32Characters"
zitadel_host: "localhost").classify_zitadel_posture classifies HEALTHY_COMPLIANT and inspect the structured telemetry in audit_summary.hourly_canary schedule to automate continuous IAM health monitoring./v2/users using a Personal Access Token (PAT) stored in Kestra secrets.INSTANCE_UNREACHABLE or DATABASE_OR_BACKEND_UNREADY incidents.io.kestra.plugin.core.flow.ForEach.