Browse Source

Updated step by step guide with existing one

pull/13460/head
Galip Tolga Erdem 4 years ago
parent
commit
bb19d63348
  1. 29
      docs/en/Migration-Guides/OpenIddict-Step-by-Step.md

29
docs/en/Migration-Guides/OpenIddict-Step-by-Step.md

@ -1,10 +1,17 @@
# 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.
This guide provides layer-by-layer guidance for migrating your existing application to [OpenIddict](https://github.com/openiddict/openiddict-core) from IdentityServer. ABP startup templates use `OpenIddict` OpenId provider from v6.0.0-rc1 by default and `IdentityServer` projects are renamed to `AuthServer` in tiered/separated solutions. 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 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 releases. 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](https://blog.duendesoftware.com/posts/20220111_fair_trade).
## OpenIddict Migration Steps
Use the `abp update` command to update your existing application. See [Upgrading docs](../Upgrading.md) for more info. Apply required migrations by following the [Migration Guides](Index.md) based on your application version.
## Domain.Shared Layer
### Domain.Shared Layer
- In **MyApplication.Domain.Shared.csproj** replace **project reference**:
```csharp
@ -28,7 +35,7 @@ Use the `abp update` command to update your existing application. See [Upgrading
...
typeof(AbpOpenIddictDomainSharedModule)
## Domain Layer
### Domain Layer
- In **MyApplication.Domain.csproj** replace **project references**:
@ -64,12 +71,12 @@ Use the `abp update` command to update your existing application. See [Upgrading
typeof(AbpPermissionManagementDomainOpenIddictModule),
```
### OpenIddictDataSeedContributor
#### OpenIddictDataSeedContributor
- Create a folder named *OpenIddict* under the Domain project and copy the [OpenIddictDataSeedContributor.cs](https://github.com/abpframework/abp-samples/blob/master/Ids2OpenId/src/Ids2OpenId.Domain/OpenIddict/OpenIddictDataSeedContributor.cs) under this folder. Rename all the `Ids2OpenId` with your project name.
- Delete *IdentityServer* folder that contains `IdentityServerDataSeedContributor.cs` which is no longer needed.
## EntityFrameworkCore Layer
### EntityFrameworkCore Layer
If you are using MongoDB, skip this step and check the *MongoDB* layer section.
@ -133,7 +140,7 @@ If you are using MongoDB, skip this step and check the *MongoDB* layer section.
builder.ConfigureOpenIddict();
```
## MongoDB Layer
### MongoDB Layer
If you are using EntityFrameworkCore, skip this step and check the *EntityFrameworkCore* layer section.
@ -165,7 +172,7 @@ If you are using EntityFrameworkCore, skip this step and check the *EntityFramew
typeof(AbpOpenIddictMongoDbModule),
```
## DbMigrator Project
### DbMigrator Project
- In **MyApplication.DbMigrator.csproj** **add project reference**:
@ -204,13 +211,19 @@ for creating the host builder.
Replace **MyApplication** with your application name.
## UI Layer
### UI Layer
- [Angular UI Migration](OpenIddict-Angular.md)
- [MVC/Razor UI Migration](OpenIddict-Mvc.md)
- [Blazor-Server UI Migration](OpenIddict-Blazor-Server.md)
- [Blazor-Wasm UI Migration](OpenIddict-Blazor.md)
## Source code of samples and module
* [Open source tiered & separate auth server application migrate Identity Server to OpenIddct](https://github.com/abpframework/abp-samples/tree/master/Ids2OpenId)
* [OpenIddict module document](https://docs.abp.io/en/abp/6.0/Modules/OpenIddict)
* [OpenIddict module source code](https://github.com/abpframework/abp/tree/rel-6.0/modules/openiddict)
## See Also
* [ABP Version 6.0 Migration Guide](Abp-6_0.md)
Loading…
Cancel
Save