Migrating from IdentityServer to OpenIddict Step by Step Guide
This guide provides layer-by-layer guidance for migrating your existing application to OpenIddict. Since OpenIddict is only available with ABP v6.0, you will need to update your existing application in order to apply OpenIddict changes.
History
We are not removing the Identity Server packages and we will continue to release new versions of IdentityServer-related NuGet/NPM packages. That means you won't have an issue while upgrading to v6.0 when the stable version is released. We will continue to fix bugs in our packages for a while. ABP 7.0 will be based on .NET 7. If Identity Server continues to work with .NET 7, we will also continue to ship NuGet packages for our IDS integration.
On the other hand, Identity Server ends support for the open-source Identity Server at the end of 2022. The Identity Server team has decided to move to Duende IDS and ABP will not be migrated to the commercial Duende IDS. You can see the Duende Identity Server announcement from this link.
OpenIddict Migration Steps
Use the abp update
command to update your existing application. See the Upgrading docs for more info. Apply the required migrations by following the Migration Guides based on your application version.
Domain.Shared Layer
In MyApplication.Domain.Shared.csproj replace the project reference:
with
In MyApplicationDomainSharedModule.cs replace the usings and module dependencies:
with
Domain Layer
In MyApplication.Domain.csproj replace the project references:
with
In MyApplicationDomainModule.cs replace the usings and module dependencies:
with
OpenIddictDataSeedContributor
- Create a folder named OpenIddict under the Domain project and copy the OpenIddictDataSeedContributor.cs under this folder. Rename all the
Ids2OpenId
with your project name. - Delete the IdentityServer folder that contains
IdentityServerDataSeedContributor.cs
which is no longer needed.
You can also create a project with the same name and copy the OpenIddict
folder of the new project into your project.
EntityFrameworkCore Layer
If you are using MongoDB, skip this step and check the MongoDB layer section.
In MyApplication.EntityFrameworkCore.csproj replace the project reference:
with
In MyApplicationEntityFrameworkCoreModule.cs replace the usings and module dependencies:
with
In MyApplicationDbContext.cs replace the usings and fluent api configurations:
with
MongoDB Layer
If you are using EntityFrameworkCore, skip this step and check the EntityFrameworkCore layer section.
In MyApplication.MongoDB.csproj replace the project reference:
with
In MyApplicationMongoDbModule.cs replace the usings and module dependencies:
with
DbMigrator Project
In MyApplication.DbMigrator.csproj add the project reference:
for creating the host builder.
In
appsettings.json
replace the IdentityServer section with OpenIddict:Replace MyApplication with your application name.
Application Contracts Layer
In MyApplication.Application.Contracts.csproj replace the project reference:
with
In MyApplicationApplicationContractsModule.cs replace the usings and module dependencies:
with
Application Layer
In MyApplication.Application.csproj replace the project reference:
with
In MyApplicationApplicationModule.cs replace the usings and module dependencies:
with
HttpApi Layer
In MyApplication.HttpApi.csproj replace the project reference:
with
In MyApplicationHttpApiModule.cs replace the usings and module dependencies:
with
HttpApi.Client Layer
In MyApplication.HttpApi.Client.csproj replace the project reference:
with
In MyApplicationHttpApiModule.cs replace the usings and module dependencies:
with
Test Project
In MyApplicationTestBaseModule.cs remove the IdentityServer related using and PreConfigurations:
and
from
PreConfigureServices
.
Migration
Add a new migration that reflects the underlying changes via dotnet ef migrations add AbpOpenIddictMigration
UI Layer
Source code of the samples and module
- Open source tiered & separate auth server application migrate Identity Server to OpenIddct
- Commercial tiered & separate auth server application migrate Identity Server to OpenIddct
- OpenIddict module document
- OpenIddict module source code