Skip to main content

HealthChecks.OpenIdConnectServer is the health check package for OpenIdConnect servers

Total Downloads
15.5M
15,506,767
Published
Dec 19, 2024
1y ago

Get Started

dotnet add package AspNetCore.HealthChecks.OpenIdConnectServer --version 9.0.0
ProductVersions
.NET
net8.0
.NET Standard
netstandard2.0

README

OpenID Connect Server Health Check

This health check verifies that an OpenID Connect server (like Duende IdentityServer, Microsoft Entra ID, etc.) is responding. Internally, it downloads the discovery document and checks existence of document's properties.

Example Usage

Use the following snippet to register an OpenID Connect server accessible at https://myoidcserver.com.

public void ConfigureServices(IServiceCollection services)
{
    services
        .AddHealthChecks()
        .AddOpenIdConnectServer(oidcSvrUri: new Uri("https://myoidcserver.com"));
}

Use the following snippet to additionally specify a different discovery endpoint path. The default value if not specified is .well-known/openid-configuration.

public void ConfigureServices(IServiceCollection services)
{
    services
        .AddHealthChecks()
        .AddOpenIdConnectServer(
            oidcSvrUri: new Uri("https://myoidcserver.com"),
            discoverConfigurationSegment: "discovery/endpoint");
}

You can additionally specify the following parameters:

  • name: The health check name. Default if not specified is oidcserver.
  • failureStatus: The HealthStatus that should be reported when the health check fails. Default is HealthStatus.Unhealthy.
  • tags: A list of tags that can be used to filter sets of health checks.
  • timeout: A System.TimeSpan representing the timeout of the check.

Downloads by Version

Similar & Alternative Packages

Hand-picked matching NuGet libraries based on tags & ecosystem

Depended On By

Find packages that declare this package as a dependency. NuGet does not provide a reverse-dependency endpoint, so candidates are checked on demand.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

Compatibility metadata lists 2 target frameworks; confirm the exact target used by your application.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.