Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions guides/getting-started/creating-your-own-server-instance.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ If you don't want to start from one of the recommended samples, you'll need to:
- **Update your `.csproj` file** to reference the latest `OpenIddict.AspNetCore` and `OpenIddict.EntityFrameworkCore` packages:

```xml
<PackageReference Include="OpenIddict.AspNetCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.AspNetCore" Version="7.2.0" />
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.2.0" />
```

- **Register your Entity Framework Core database context and configure the OpenIddict core services** in `Program.cs`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ If you don't want to start from one of the recommended samples, you'll need to:
- **Reference the `OpenIddict.AspNetCore` package**:

```xml
<PackageReference Include="OpenIddict.AspNetCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.AspNetCore" Version="7.2.0" />
```

- **Configure the OpenIddict validation services** in `Startup.ConfigureServices`:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ in web and desktop applications. If you want to use a non-interactive flow like
- **Update your `.csproj` file** to reference the latest `OpenIddict` package:

```xml
<PackageReference Include="OpenIddict" Version="7.0.0" />
<PackageReference Include="OpenIddict" Version="7.2.0" />
```

- **Configure the OpenIddict client services** in `Program.cs` (or `Startup.cs` if you use the regular ASP.NET Core web host):
Expand Down Expand Up @@ -72,8 +72,8 @@ If you don't want to start from one of the recommended samples, you'll need to:
- **Update your `.csproj` file** to reference the latest `OpenIddict.AspNetCore` and `OpenIddict.EntityFrameworkCore` packages:

```xml
<PackageReference Include="OpenIddict.AspNetCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.AspNetCore" Version="7.2.0" />
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.2.0" />
```

- **Configure the OpenIddict core services** in `Program.cs` (or `Startup.cs`, depending on whether you're using the minimal host or the regular host):
Expand Down
7 changes: 4 additions & 3 deletions guides/migration/60-to-70.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@ For that, update your `.csproj` file to reference the `OpenIddict` 7.x packages.
```xml
<ItemGroup>
<PackageReference Include="OpenIddict.AspNetCore" Version="6.4.0" /> <!-- [!code remove] -->
<PackageReference Include="OpenIddict.AspNetCore" Version="7.0.0" /> <!-- [!code add] -->
<PackageReference Include="OpenIddict.AspNetCore" Version="7.2.0" /> <!-- [!code add] -->

<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="6.4.0" /> <!-- [!code remove] -->
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.0.0" /> <!-- [!code add] -->
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.2.0" /> <!-- [!code add] -->
</ItemGroup>
```

Expand All @@ -34,6 +34,7 @@ For that, update your `.csproj` file to reference the `OpenIddict` 7.x packages.
> | | |
> | ASP.NET Core 8.0 | .NET 8.0 |
> | ASP.NET Core 9.0 | .NET 9.0 |
> | ASP.NET Core 10.0 | .NET 10.0 |
> | | |
> | Microsoft.Owin 4.2 | .NET Framework 4.6.2 |
> | Microsoft.Owin 4.2 | .NET Framework 4.7.2 |
Expand All @@ -43,7 +44,7 @@ For that, update your `.csproj` file to reference the `OpenIddict` 7.x packages.
> The .NET 6.0 TFM has been removed as this version is no longer supported by Microsoft.
>
> While most OpenIddict 7.0 packages can still be used on this version thanks to their .NET Standard 2.0 or 2.1 TFMs,
> doing that is strongly discouraged and users are instead encouraged to migrate to .NET 8.0 or .NET 9.0.
> doing that is strongly discouraged and users are instead encouraged to migrate to .NET 8.0, .NET 9.0 or .NET 10.0.

## Add and apply migrations (if applicable)

Expand Down
7 changes: 4 additions & 3 deletions integrations/aspnet-core.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ ASP.NET Core 2.3+ application, independently of whether they are using MVC contr
| ASP.NET Core 2.3 | .NET Framework 4.8 | :heavy_check_mark: |
| ASP.NET Core 8.0 | .NET 8.0 | :heavy_check_mark: |
| ASP.NET Core 9.0 | .NET 9.0 | :heavy_check_mark: |
| ASP.NET Core 10.0 | .NET 10.0 | :heavy_check_mark: |

> [!NOTE]
> **The following features are not available when targeting .NET Framework 4.6.2**:
Expand All @@ -28,9 +29,9 @@ To configure the ASP.NET Core integration, you'll need to:
(depending on whether you need the client and/or server and/or validation features in your project):

```xml
<PackageReference Include="OpenIddict.Client.AspNetCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.Server.AspNetCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.Validation.AspNetCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.Client.AspNetCore" Version="7.2.0" />
<PackageReference Include="OpenIddict.Server.AspNetCore" Version="7.2.0" />
<PackageReference Include="OpenIddict.Validation.AspNetCore" Version="7.2.0" />
```

- **Call `UseAspNetCore()` for each OpenIddict feature (client, server and validation) you want to add**:
Expand Down
2 changes: 1 addition & 1 deletion integrations/entity-framework-core.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ To configure OpenIddict to use Entity Framework Core as the database for applica
- **Reference the `OpenIddict.EntityFrameworkCore` package**:

```xml
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.0.0" />
<PackageReference Include="OpenIddict.EntityFrameworkCore" Version="7.2.0" />
```

- **Create a database context deriving from `DbContext` (or `IdentityDbContext` when using ASP.NET Core Identity)**:
Expand Down
2 changes: 1 addition & 1 deletion integrations/entity-framework.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ To configure OpenIddict to use Entity Framework 6.x as the database for applicat
- **Reference the `OpenIddict.EntityFramework` package**:

```xml
<PackageReference Include="OpenIddict.EntityFramework" Version="7.0.0" />
<PackageReference Include="OpenIddict.EntityFramework" Version="7.2.0" />
```

- **Create a database context deriving from `DbContext` and register the OpenIddict entities in the model**:
Expand Down
2 changes: 1 addition & 1 deletion integrations/mongodb.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ To configure OpenIddict to use MongoDB as the database for applications, authori
- **Reference the `OpenIddict.MongoDb` package**:

```xml
<PackageReference Include="OpenIddict.MongoDb" Version="7.0.0" />
<PackageReference Include="OpenIddict.MongoDb" Version="7.2.0" />
```

- **Configure OpenIddict to use the MongoDB stores**:
Expand Down
27 changes: 15 additions & 12 deletions integrations/operating-systems.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ care of starting the authorization/logout process and handling the callbacks pos

## Supported platforms

OpenIddict 7.0+ supports the following operating systems:
OpenIddict 7.2 supports the following operating systems:
- Android 5.0+ (Android API 21+)
- iOS 12.2+
- Linux
Expand Down Expand Up @@ -76,23 +76,19 @@ OpenIddict 7.0+ supports the following operating systems:

### Android

The OpenIddict Android integration requires targeting `net8.0-android34.0` or `net9.0-android34.0`
but can be used in any application running on Android 5.0+ (Android API 21).
The OpenIddict Android integration requires targeting `net9.0-android` or `net10.0-android` and can be used in any application running on Android 5.0+ (Android API 21).

### iOS

The OpenIddict iOS integration requires targeting `net8.0-ios18.0` or `net9.0-ios18.0`
but can be used in any application running on iOS 12.2+.
The OpenIddict iOS integration requires targeting `net9.0-ios` or `net10.0-ios` and can be used in any application running on iOS 12.2+.

### Mac Catalyst

The OpenIddict Mac Catalyst integration requires targeting `net8.0-maccatalyst18.0` or `net9.0-maccatalyst18.0`
but can be used in any application running on Mac Catalyst 15.0+.
The OpenIddict Mac Catalyst integration requires targeting `net9.0-maccatalyst` or `net10.0-maccatalyst` and can be used in any application running on Mac Catalyst 15.0+.

### macOS

The OpenIddict macOS integration requires targeting `net8.0-macos15.0` or `net9.0-macos15.0`
but can be used in any application running on macOS 10.15+.
The OpenIddict macOS integration requires targeting `net9.0-macos` or `net10.0-macos` and can be used in any application running on macOS 10.15+.

### Windows

Expand All @@ -101,8 +97,10 @@ The OpenIddict Windows integration can be used in any application running on Win
- `uap10.0.17763` or higher.
- `net8.0-windows7.0`.
- `net9.0-windows7.0`.
- `net10.0-windows7.0`.
- `net8.0-windows10.0.17763` or higher.
- `net9.0-windows10.0.17763` or higher.
- `net10.0-windows10.0.17763` or higher.

> [!IMPORTANT]
> The ability to use the OpenIddict system integration package with a specific application model depends on the .NET runtime version and the Windows version:
Expand All @@ -114,38 +112,43 @@ The OpenIddict Windows integration can be used in any application running on Win
> | Windows 7 SP1 | .NET Framework 4.8 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 7 SP1 | .NET 8.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 7 SP1 | .NET 9.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 7 SP1 | .NET 10.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | | | | | | | | |
> | Windows 8.1 | .NET Framework 4.6.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 8.1 | .NET Framework 4.7.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 8.1 | .NET Framework 4.8 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 8.1 | .NET 8.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 8.1 | .NET 9.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 8.1 | .NET 10.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 8.1 | .NET Native/UAP | :x: | :x: | :x: | :x: | :x: | :x: |
> | | | | | | | | |
> | Windows 10 1507 | .NET Framework 4.6.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 10 1507 | .NET Framework 4.7.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 10 1507 | .NET Framework 4.8 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :x: | :x: |
> | Windows 10 1507 | .NET 8.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 10 1507 | .NET 9.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 10 1507 | .NET 10.0 | :exclamation: | :exclamation: | :exclamation: | :x: | :x: | :x: |
> | Windows 10 1507 | .NET Native/UAP | :x: | :x: | :x: | :x: | :x: | :x: |
> | | | | | | | | |
> | Windows 10 1809 | .NET Framework 4.6.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :x: |
> | Windows 10 1809 | .NET Framework 4.7.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :x: |
> | Windows 10 1809 | .NET Framework 4.8 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :x: |
> | Windows 10 1809 | .NET 8.0 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :warning: |
> | Windows 10 1809 | .NET 9.0 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :warning: |
> | Windows 10 1809 | .NET 10.0 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :warning: |
> | Windows 10 1809 | .NET Native/UAP | :x: | :x: | :x: | :warning: | :x: | :x: |
> | | | | | | | | |
> | Windows 11 21H2 | .NET Framework 4.6.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :x: |
> | Windows 11 21H2 | .NET Framework 4.7.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :x: |
> | Windows 11 21H2 | .NET Framework 4.8 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :x: |
> | Windows 11 21H2 | .NET 8.0 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :warning: |
> | Windows 11 21H2 | .NET 9.0 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :warning: |
> | Windows 11 21H2 | .NET 10.0 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :x: | :warning: | :warning: |
> | Windows 11 21H2 | .NET Native/UAP | :x: | :x: | :x: | :warning: | :x: | :x: |
>
> > [!TIP]
> > WinRT support is only offered when targeting `net461`, `uap10.0.17763`, `net8.0-windows10.0.17763` or `net9.0-windows10.0.17763`:
> > the `net8.0-windows7.0` and `net9.0-windows7.0` target framework monikers don't reference the WinRT APIs.
> > WinRT support is only offered when targeting `net461`, `uap10.0.17763`, `net8.0-windows10.0.17763`, `net9.0-windows10.0.17763` or `net10.0-windows10.0.17763`:
> > the `net8.0-windows7.0`, `net9.0-windows7.0` and `net10.0-windows7.0` target framework monikers don't reference the WinRT APIs.
>
> > [!WARNING]
> > Microsoft officially stopped supporting Windows 7 in .NET 7.0. As such, applications
Expand Down Expand Up @@ -292,7 +295,7 @@ To configure the operating system integration, you'll need to:
- **Reference the `OpenIddict.Client.SystemIntegration` package**:

```xml
<PackageReference Include="OpenIddict.Client.SystemIntegration" Version="7.0.0" />
<PackageReference Include="OpenIddict.Client.SystemIntegration" Version="7.2.0" />
```

- **Call `UseSystemIntegration()` in the client options**:
Expand Down
2 changes: 1 addition & 1 deletion integrations/quartz.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ To configure OpenIddict to use Quartz.NET to perform automated cleanup tasks, yo
- **Reference the `OpenIddict.Quartz` package**:

```xml
<PackageReference Include="OpenIddict.Quartz" Version="7.0.0" />
<PackageReference Include="OpenIddict.Quartz" Version="7.2.0" />
```

- **Register the Quartz.NET services and configure it to use dependency injection and an in-memory store**:
Expand Down
4 changes: 2 additions & 2 deletions integrations/system-net-http.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ To configure the `System.Net.Http` integration, you'll need to:
(depending on whether you need the client and/or validation features in your project):

```xml
<PackageReference Include="OpenIddict.Client.SystemNetHttp" Version="7.0.0" />
<PackageReference Include="OpenIddict.Validation.SystemNetHttp" Version="7.0.0" />
<PackageReference Include="OpenIddict.Client.SystemNetHttp" Version="7.2.0" />
<PackageReference Include="OpenIddict.Validation.SystemNetHttp" Version="7.2.0" />
```

- **Call `UseSystemNetHttp()` for each OpenIddict feature (client and validation) you want to add**:
Expand Down
2 changes: 1 addition & 1 deletion integrations/web-providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -166,7 +166,7 @@ To configure the `System.Net.Http` integration, you'll need to:
- **Reference the `OpenIddict.Client.WebIntegration` package**:

```xml
<PackageReference Include="OpenIddict.Client.WebIntegration" Version="7.0.0" />
<PackageReference Include="OpenIddict.Client.WebIntegration" Version="7.2.0" />
```

- **Call `UseWebProviders()` in the client options**:
Expand Down
Loading