上一篇文章把專案建好了，現在要進行一些必要配置。由於IdentityServer4需要使用到3.2.5的包，而專案預設使用的是3.2.4的包，因而，我們需要先升級一下解決方案的包。在解決方案上單擊右鍵，在右鍵選單中選擇管理解決方案的NuGet包。在NuGet的標籤頁內，切換到更新標籤頁，會看到6個更新，選擇全部包，然後單擊更新按鈕。

包更新完以後，我們先做一次資料庫遷移。在EntityFrameworkCore專案中新增Pomelo.EntityFrameworkCore.MySql和Pomelo.EntityFrameworkCore.MySql.Design兩個包，以便支援MySql。為什麼不用Oracle提供的MySql.Data.EntityFrameworkCore呢？在微軟的文件《

MySQL EF Core Database Provider》中，該包只支援MySql，且還是預覽版狀態，而在Pomelo EF Core Database Provider for MySQL中，該包不單支援MySQL，還支援MariaDB，所以，怎麼選擇已經很明顯，可以說，筆者是毫不猶豫的選擇了Pomelo包。至於兩者的效能，筆者目前無法給出答案，只有等大神們的測試了。

至於測試資料庫，筆者選擇的是XAMMP帶的MySql，版本是10.1.13-MariaDB。資料庫所選的字符集為utf8_general_ci。雖然Pomelo建議選擇utf8mb4作為字符集（詳細資訊請參閱Pomelo《

Getting Started》），但建議不要選擇，因為“max key length is 767 bytes”這個錯誤會把你折磨死的。出現這個錯誤的原因是utf8以3位元組方式儲存一個字元的，而一列的索引長度最大值只能是767位元組，如果欄位的長度是256，那麼，索引的長度就是768了，正好超過1位元組，遷移就出問題了。如果使用utf8mb4，那麼，一個字元的長度就是4位元組，欄位的最大長度只能是191了，而這要修改的欄位就有很多了，所以在這練習了還是採用utf8算了。在實際專案中，建議使用utf8mb4，但要考慮帶索引的欄位的長度是191是否足夠。要想徹底解決這個問題，需要將欄位的索引擴大到3072欄位，但實現這個需要執行以下4個步驟：

• SET GLOBAL innodb_file_format=Barracuda;
• SET GLOBAL innodb_file_per_table=ON;
• ROW_FORMAT=DYNAMIC; – or COMPRESSED (goes on end of CREATE)
• innodb_large_prefix=1

以上4個步驟，1、2和4都可以在資料庫中直接修改。第3步則有點難度了，因為實現這個需要在建立表格時在CREATE語句中新增附加資訊，而這個在遷移程式碼中暫時沒找到解決方案，除非是使用Database First的方式來實現。

MySql的驅動準備好以後，需要修改資料庫連結，開啟Migrations專案和Web.Host專案中的appsettings.json檔案，將ConnectionStrings的Default值修改為“Server=localhost;database=simplecmswithabp;uid=root;pwd=abcd-1234;charset=UTF8;”。在生產環境中，不要使用root作為資料庫的連線使用者，這個大家應該都懂的。

修改資料庫連線後，還需要修改EntityFrameworkCore專案中的SimpleCmsWithAbpDbContextConfigurer.cs檔案，將方法中的UseSqlServer方法修改為UseMySql方法，完成後的程式碼如下：

    public static class SimpleCmsWithAbpDbContextConfigurer
    {
        public static void Configure(DbContextOptionsBuilder<SimpleCmsWithAbpDbContext> builder, string connectionString)
        {
            //builder.UseSqlServer(connectionString);
            builder.UseMySql(connectionString);           
        }

        public static void Configure(DbContextOptionsBuilder<SimpleCmsWithAbpDbContext> builder, DbConnection connection)
        {
            //builder.UseSqlServer(connection);
            builder.UseMySql(connection);
        }
    }

下一步要修改欄位長度為256，且需要建立索引的欄位的長度。開啟20170424115119_Initial_Migrations.cs檔案，然後使用搜索功能尋找256，經過一輪搜尋和索引欄位對比後，最終需要修改的欄位包括：

• AbpLanguageTexts表：Key
• AbpUsers表：EmailAddress和NormalizedEmailAddress
• AbpUserLogins表：ProviderKey
• AbpSettings表：Name

長度修改為255就行了。如果使用utf8mb4，需要修改為191。欄位修改完成後，將Migrator專案設定為啟動專案，然後執行，會看到如下圖所示的結果：

在視窗中輸入y，等待以後後出現以下資訊，說明遷移已經完成了，按回車退出程式。

2017-12-16 09:54:29 | HOST database migration started...
2017-12-16 09:54:34 | HOST database migration completed.
2017-12-16 09:54:34 | --------------------------------------------------------
2017-12-16 09:54:34 | All databases have been migrated.
Press ENTER to exit...

使用資料庫工具開啟資料庫，會看到下圖所示的表格：

首先要做的是在EntityFrameworkCore專案中新增 Abp.ZeroCore.IdentityServer4和 Abp.ZeroCore.IdentityServer4.EntityFrameworkCore的引用。然後開啟SimpleCmsWithAbpEntityFrameworkModule.cs檔案，在類定義上新增依賴項，具體程式碼如下：

    [DependsOn(
        typeof(SimpleCmsWithAbpCoreModule), 
        typeof(AbpZeroCoreEntityFrameworkCoreModule),
        typeof(AbpZeroCoreIdentityServerEntityFrameworkCoreModule))]
    public class SimpleCmsWithAbpEntityFrameworkModule : AbpModule
    ……

下面要配置Startup Class，開啟SimpleCmsWithAbp.Web.Host專案下Startup檔案的Startup.cs檔案，在IdentityRegistrar.Register(services)這句下新增以下程式碼：

            services.AddIdentityServer()
                .AddDeveloperSigningCredential()
                .AddInMemoryIdentityResources(IdentityServerConfig.GetIdentityResources())
                .AddInMemoryApiResources(IdentityServerConfig.GetApiResources())
                .AddInMemoryClients(IdentityServerConfig.GetClients())
                .AddAbpPersistedGrants<IAbpPersistedGrantDbContext>()
                .AddAbpIdentityServer<User>();

在Configure方法內，註釋掉app.UseAuthentication這句，因為UseIdentityServer方法會自動呼叫UseAuthentication方法。在app.UseJwtTokenMiddleware下

app.UseIdentityServer();

為什麼不像文章中那樣在呼叫UseJwtTokenMiddleware方法時將IdentityBearer作為引數呢？主要原因是這個引數是在授權客戶端與應用程式是同一應用程式才使用，而我們預想的情況是在不同應用程式，因而不用採用這個引數。

如果打算使用記憶體來提供資源，可以參考文章在SimpleCmsWithAbp.Web.Host專案中新增一個名為IdentityServerConfig的靜態類，用來指定資源，程式碼請參考《Identity Server Integration》一文。如果打算使用資料庫來管理資源，可以忽略這一步。

下面要做的是SimpleCmsWithAbpDbContext新增IAbpPersistedGrantDbContext介面。切換到EntityFrameworkCore專案，開啟SimpleCmsWithAbpDbContext.cs檔案，在類定義的後面新增IAbpPersistedGrantDbContext介面，以實現授權操作：

public class SimpleCmsWithAbpDbContext : AbpZeroDbContext<Tenant, Role, User, SimpleCmsWithAbpDbContext>, IAbpPersistedGrantDbContext

新增IAbpPersistedGrantDbContext介面後，需要在類內實現介面功能，程式碼如下：

    public DbSet<PersistedGrantEntity> PersistedGrants { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);

        modelBuilder.ConfigurePersistedGrantEntity();
    }

好了，IdentityServer的配置基本完成了，但在《Identity Server Integration》一文中，資源的定義使用的是記憶體定義模式（AddInMemoryIdentityResources），對於專案來說，這不便於資源的管理，因而，一般會通過資料庫來實現管理，而要實現這個，就要參考Using EntityFramework Core for configuration and operational data一文來實現。

本來打算從IConfigurationDbContext介面派生，將ConfigurationDbContext合併到SimpleCmsWithAbpDbContext，但水平有限，嘗試了不少方法都不行，只能按照文章的步驟的去實現了。先在EntityFrameworkCore專案新增IdentityServer4.EntityFramework包，再將以上呼叫AddIdentityServer方法的程式碼替換為以下程式碼：

            var connectionString = _appConfiguration.GetConnectionString("Default");
            services.AddIdentityServer()
                .AddDeveloperSigningCredential()
                .AddConfigurationStore(options =>
                {
                    options.ConfigureDbContext = builder =>
                        builder.UseMySql(connectionString, sql => sql.MigrationsAssembly("SimpleCmsWithAbp.EntityFrameworkCore"));
                })
                //.AddInMemoryIdentityResources(IdentityServerConfig.GetIdentityResources())
                //.AddInMemoryApiResources(IdentityServerConfig.GetApiResources())
                //.AddInMemoryClients(IdentityServerConfig.GetClients())
                .AddAbpPersistedGrants<IAbpPersistedGrantDbContext>()
                .AddAbpIdentityServer<User>(); 

程式碼添加了AddConfigurationStore方法來配置ConfigurationDbContext，並註釋掉了使用記憶體資源的程式碼。在ConfigurationDbContext方法內，指定了ConfigurationDbContext將使用MySql資料庫，而它的遷移模組在EntityFrameworkCore專案內。

接下來要新增遷移，我們不需要採用文章所介紹的方法。先將Web.Host專案設定為啟動專案，不然會出現“No DbContext named ‘ConfigurationDbContext’ was found”的錯誤，，原先是遷移需要根據上下文來尋找Context。在IDE中，切換到程式包管理器控制器，將預設專案設定為SimpleCmsWithAbp.Web.Host，然後輸入以下命名：

Add-Migration -Name InitialIdentityServerConfigurationDbMigration -Context ConfigurationDbContext  -OutputDir Migrations/IdentityServer/ConfigurationDb -Project SimpleCmsWithAbp.EntityFrameworkCore

命令將使用ConfigurationDbContext建立一個名為InitialIdentityServerConfigurationDbMigration 的遷移。遷移檔案將輸出到SimpleCmsWithAbp.EntityFrameworkCore專案的Migrations/IdentityServer/ConfigurationDb資料夾。

命令執行後，會在EntityFrameworkCore專案的Migrations資料夾內看到下圖所示資料夾和檔案：

餘下的工作是初始化資料庫，這裡也不採用文章所使用的方法，將參考EntityFrameworkCore專案中的遷移方式來實現。先要做的是在EntityFrameworkCore\Seed資料夾下建立IdentityServer資料夾，並新增以下4個類檔案：

• DefaultApiResourceCreator.cs

    public class DefaultApiResourceCreator
    {
        private readonly ConfigurationDbContext _context;

        public DefaultApiResourceCreator(ConfigurationDbContext context)
        {
            _context = context;
        }

        public void Create()
        {
            CreateDefaultApiResource();
        }

        private void CreateDefaultApiResource()
        {
            if (_context.ApiResources.Any()) return;
            var defaultApiResource = new ApiResource() { Name = "default-api", DisplayName = "Default (all) API" };
            _context.ApiResources.Add(defaultApiResource);
            _context.SaveChanges();
        }
    }

• DefaultClientCreator.cs

    public class DefaultClentCreator
    {
        private readonly ConfigurationDbContext _context;

        public DefaultClentCreator(ConfigurationDbContext context)
        {
            _context = context;
        }

        public void Create()
        {
            CreateDefaultClient();
        }

        private void CreateDefaultClient()
        {
            if (_context.Clients.Any()) return;
            foreach (var client in GetClients())
            {
                _context.Clients.Add(client.ToEntity());
            }
            _context.SaveChanges();
        }

        private static IEnumerable<IdentityServer4.Models.Client> GetClients() => new List<IdentityServer4.Models.Client>
            {
                new IdentityServer4.Models.Client
                {
                    ClientId = "client",
                    AllowedGrantTypes =
                    {
                        GrantType.ResourceOwnerPassword,
                        GrantType.ClientCredentials
                    },
                    AllowedScopes = {"default-api"},
                    ClientSecrets =
                    {
                        new IdentityServer4.Models.Secret("secret".Sha256())
                    }
                }
            };
    }

• DefaultIdentityResourceCreator.cs

    public class DefaultIdentityResourceCreator
    {
        private readonly ConfigurationDbContext _context;

        public DefaultIdentityResourceCreator(ConfigurationDbContext context)
        {
            _context = context;
        }

        public void Create()
        {
            CreateDefaultIdentityResource();
        }

        private void CreateDefaultIdentityResource()
        {
            if (_context.IdentityResources.Any()) return;
            foreach (var resource in GetIdentityResource())
            {
                _context.IdentityResources.Add(resource.ToEntity());
            }
            _context.SaveChanges();
        }

        private static IEnumerable<IdentityServer4.Models.IdentityResource> GetIdentityResource()
        {
            return new List<IdentityServer4.Models.IdentityResource>
            {
                new IdentityResources.OpenId(),
                new IdentityResources.Profile(),
                new IdentityResources.Email(),
                new IdentityResources.Phone()
            };

        }
    }

• InitialIConfigurationDbBuilder.cs

    public class InitialIConfigurationDbBuilder
    {
        private readonly ConfigurationDbContext _context;

        public InitialIConfigurationDbBuilder(ConfigurationDbContext context)
        {
            _context = context;
        }

        public void Create()
        {
            new DefaultApiResourceCreator(_context).Create();
            new DefaultIdentityResourceCreator(_context).Create();
            new DefaultClentCreator(_context).Create();

            _context.SaveChanges();
        }
    }

這4個類新增完成後，在SeedHelper類內新增以下兩個方法用來初始化資源：

        public static void SeedIdentityServerDb(IIocResolver iocResolver)
        {
            WithDbContext<ConfigurationDbContext>(iocResolver, SeedIdentityServerDb);
        }

        public static void SeedIdentityServerDb(ConfigurationDbContext context)
        {
            new InitialIConfigurationDbBuilder(context).Create();
        }

在EntityFrameworkCore專案的EntityFrameworkCore資料夾內，參考AbpZeroDbMigrator建立一個AbpZeroIdentityServerDbMigrator類用來遷移配置庫，具體程式碼如下：

    public class AbpZeroIdentityServerDbMigrator : AbpZeroDbMigrator<ConfigurationDbContext>
    {
        public AbpZeroIdentityServerDbMigrator(
            IUnitOfWorkManager unitOfWorkManager,
            IDbPerTenantConnectionStringResolver connectionStringResolver,
            IDbContextResolver dbContextResolver)
            : base(
                unitOfWorkManager,
                connectionStringResolver,
                dbContextResolver)
        {
        }
    }

AbpZeroIdentityServerDbMigrator與AbpZeroDbMigrator主要的不同在派生於AbpZeroDbMigrator時，實體類是ConfigurationDbContext而不是SimpleCmsWithAbpDbContext。

試了一下看能不能在Migrator專案內遷移資料庫，但老是出現“No component for supporting the service IdentityServer4.EntityFramework.DbContexts.ConfigurationDbContext was found”的錯誤，放棄了，還是在Start類內初始化吧。在Configure方法內，app.UseAbp程式碼下，新增以下遷移程式碼：

            using (var serviceScope = app.ApplicationServices.GetService<IServiceScopeFactory>().CreateScope())
            {
                var migrator = serviceScope.ServiceProvider.GetRequiredService<AbpZeroIdentityServerDbMigrator>();
                migrator.CreateOrMigrateForHost(SeedHelper.SeedIdentityServerDb);

            }

IdentiyServer現在基本上是配置好了，但要使應用程式跑起來，還得修改個地方，切換到Web.Core專案，開啟Controllers資料夾下的TokenAuthController.cs檔案，找到215行以下這句：

var nameIdClaim = claims.First(c => c.Type == ClaimTypes.NameIdentifier);

將它修改為：

var nameIdClaim = claims.First(c => c.Type == AbpClaimTypes.UserId);

使用ClaimTypes.NameIdentifier作為比較，nameIdClaim 永遠返回空的列表，導致不能生成token，這應該是ABP的bug。修改後就可以使用postman來測試了。

開啟postman，在位址列輸入地址：http://localhost:21021/api/TokenAuth/Authenticate。提交方式選擇POST。在Headers中輸入以下兩個引數：
- Content-Type:application/json
- Abp.TenantId:1

在body中輸入以下資料：

{
  "userNameOrEmailAddress": "[email protected]",
  "password": "123qwe",
  "rememberClient": false
}

單擊Send按鈕後，會看到如下圖所示輸出：

將圖中的accessToken複製出來。新建一個頁面標籤，提交方式設定為GET，地址輸入：http://localhost:21021/api/services/app/User/GetAll?SkipCount=0&MaxResultCount=100。在Headers中，在Key中輸入Authorization，在value中，先輸入Bearer加一個空格，然後在空格後把剛才複製的accessToken貼上在後面。再加上Abp.TenantId後，單擊Send，將看到如下圖所示的結果：

從圖中可以看到，通過accessToken可以順利獲取資料了，這說明IdentityServer執行正常。

今天就說到這裡了。