Quartz.NET integration core

Basic configuration

To configure OpenIddict to use Quartz.NET to perform automated cleanup tasks, you'll need to:

• Reference the OpenIddict.Quartz package:

<PackageReference Include="OpenIddict.Quartz" Version="5.8.0" />

• Register the Quartz.NET services and configure it to use dependency injection and an in-memory store:

services.AddQuartz(options =>
{
    options.UseMicrosoftDependencyInjectionJobFactory();
    options.UseSimpleTypeLoader();
    options.UseInMemoryStore();
})

TIP

For more information, read Microsoft DI Integration.

• Register the Quartz.NET hosted service and configure it to block shutdown until all jobs are complete:

services.AddQuartzHostedService(options => options.WaitForJobsToComplete = true);

TIP

For more information, read Hosted Services Integration.

• Configure OpenIddict to use the Quartz.NET integration:

services.AddOpenIddict()
    .AddCore(options =>
    {
        options.UseQuartz();
    });

Advanced configuration

Disable pruning

The default cleanup task of the Quartz.NET integration automatically removes orphaned tokens and authorizations. This behavior can be customized by disabling any (or both) pruning jobs:

services.AddOpenIddict()
    .AddCore(options =>
    {
        options.UseQuartz()
               .DisableAuthorizationPruning()
               .DisableTokenPruning();
    });

Pruning lifetime

All tokens/authorizations will be removed during the pruning job if they are older than 14 days. This lifespan can be changed for tokens and authorizations independently:

services.AddOpenIddict()
    .AddCore(options =>
    {
        options.UseQuartz()
               .SetMinimumAuthorizationLifespan(TimeSpan.FromDays(7))
               .SetMinimumTokenLifespan(TimeSpan.FromHours(12));
    });

WARNING

The mimum lifespan for pruning is 10 minutes.

Retry failed jobs

Any failed Quartz.NET job will be retried twice by default. This retry count can be configured with this setting:

services.AddOpenIddict()
    .AddCore(options =>
    {
        options.UseQuartz()
               .SetMaximumRefireCount(3);
    });