Identity Server 4 從入門到落地（十二）—— 使用Nginx集成認證服務

2021 年 12 月 14 日
筆記
docker, Dot Net, Identity Server, Identity Server 4, Nginx

認證服務和管理的github地址： //github.com/zhenl/IDS4Admin
客戶端及web api示例代碼的github地址：//github.com/zhenl/IDS4ClientDemo

在前面我們將認證服務和管理應用作為容器部署，分別運行在不同的端口，後續的應用模塊和Web Api也可以採用這種方式進行部署。採用這種方式可以將複雜的系統分解為相互獨立的模塊，部署在不同的容器中，這些模塊可以獨立開發、獨立部署、獨立維護。這樣帶來的問題每個模塊或者服務都需要對外的端口，而用戶希望所有的模塊有統一的地址，比如管理服務部署在//demo.jiagoushi.cn:7003,認證服務部署在//demo.jiagoushi.cn:7010,門戶部署在//demo.jiagoushi.cn:8000等等，而從用戶的角度出發，我們希望相應的地址是//demo.jiagoushi.cn/ids4sts,//demo.jiaogoushi.cn/ids4admin和//demo.jiagoushi.cn/protal。這時，反向代理服務器就派上用場了，接下來我們使用反向代理服務器nginx將認證服務和管理應用集成在一起。

首先安裝nginx的容器，在安裝之前，在服務器創建一個目錄，用來映射nginx的配置，在這個例子中，這個目錄是/mydata/nginx/conf/conf.d，在這個目錄中創建一個配置文件default.conf，配置文件的內容如下：

server {
    listen       80;
    listen  [::]:80;
    server_name  localhost;

    #access_log  /var/log/nginx/host.access.log  main;

    location / {
        root   /usr/share/nginx/html;
        index  index.html index.htm;
    }
    

    location ^~/ids4admin/ {
	proxy_pass //demo.jiagoushi.cn:7003;
	proxy_http_version 1.1;
    	proxy_set_header Upgrade $http_upgrade;
    	proxy_set_header Connection keep-alive;
    	proxy_set_header Host $host;
    	proxy_set_header X-Real-IP $remote_addr;
    	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    	proxy_set_header X-Forwarded-Proto $scheme;
    	proxy_cache_bypass $http_upgrade;
  
        proxy_set_header Via    "nginx";
	fastcgi_buffers 16 16k; 
	fastcgi_buffer_size 32k;
	proxy_buffer_size          128k;
	proxy_buffers            4 256k;
	proxy_busy_buffers_size    256k;
       
    }

    location ^~/ids4sts/ {
	proxy_pass //demo.jiagoushi.cn:7010;
        proxy_http_version 1.1;
    	proxy_set_header Upgrade $http_upgrade;
    	proxy_set_header Connection keep-alive;
    	proxy_set_header Host $host;
    	proxy_set_header X-Real-IP $remote_addr;
    	proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    	proxy_set_header X-Forwarded-Proto $scheme;
    	proxy_cache_bypass $http_upgrade;
  
        proxy_set_header Via    "nginx";
	fastcgi_buffers 16 16k; 
	fastcgi_buffer_size 32k;
	proxy_buffer_size          128k;
	proxy_buffers            4 256k;
	proxy_busy_buffers_size    256k;
    }



    #error_page  404              /404.html;

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

從配置文件可以看出，我們將部署在7010的認證服務映射到/ids4sts,將部署在7003的管理應用映射到/ids4admin。然後創建並運行nginx容器

docker create --name=mynginx  --volume=/mydata/nginx/conf/conf.d:/etc/nginx/conf.d -p 80:80 nginx 
docker start mynginx

現在我們需要登錄到認證服務器的管理應用，修改客戶端的配置，將引用端口7003的地址改為/ids4admin。我們克隆現有的客戶端，然後在新的客戶端定義上修改，新的客戶名稱為IDS4AdminClientNew，基本配置如下：

認證和註銷：

令牌：

同意屏幕：

定義修改完成後，還需要修改客戶端的配置文件ids4/admin/appsettings.production.json:

還有認證服務的配置文件ids4/sts/appsettings.production.json：

配置文件修改完成後，需要重新啟動docker 容器：
docker restart ids4sts
docker restart ids4admin
然後就可以通過瀏覽器訪問了：//demo.jiagoushi.cn/ids4admin和//demo.jiagoushi.cn/ids4sts
到這裡，我們基本完成了落地的準備工作，我們使用了一個相對成熟的Identity Server 4 認證服務和管理應用，在此基礎上熟悉和驗證了各種客戶端的編寫，還驗證了認證服務在Docker下的部署以及與反向代理服務器的集成。希望這個系列對大家有所幫助。