本文介紹自訂網域名的配置和常見用法。
基礎介紹
通過自訂網域名能力,您可以將IDaaS EIAM的登入頁、使用者門戶等IDaaS EIAM頁面的地址替換為屬於您的網域名稱,從而保持企業品牌的一致性。
通過搭建網域名稱代理服務,您也可以系統管理使用者訪問IDaaS EIAM的許可權,例如只有指定IP的使用者才可登入應用門戶。
基本概念
概念 | 說明 |
初始化網域名稱 | 建立IDaaS EIAM執行個體時由系統產生的網域名稱,即xxxx.aliyunidaas.com。 |
自訂網域名 | 屬於您的添加到IDaaS EIAM執行個體的網域名稱,如xxxx.example.com。 |
預設網域名稱 | IDaaS EIAM執行個體預設使用的網域名稱,需選擇一個初始化網域名稱或自訂網域名。此外,開啟自動跳轉後,訪問初始化網域名稱時將自動跳轉到預設網域名稱。 |
影響範圍
以下是受自訂網域名影響的功能點,如有需要,請在配置自訂網域名之前或之後調整相關配置。
影響對象 | 功能點 | 說明 |
使用者門戶 | 登入頁 | 登入頁地址涉及網域名稱。 |
應用門戶 | 應用門戶地址涉及網域名稱。 | |
DingTalk身份提供方-出方向 | 掃碼登入/工作台免登 | DingTalk回調網域名稱涉及網域名稱,請始終使用初始化網域名稱。 |
免登到IDaaS應用門戶或應用 | 應用首頁地址涉及網域名稱。 | |
企業微信身份提供方-入方向 | 掃碼登入 | 使用者訪問的網域名稱(使用者門戶、直接存取自研/OIDC/SAML應用時的地址)和企業微信授權回調域必須一致,否則將無法使用企業微信掃碼登入。 |
網頁授權登入(工作台免登)和敏感性資料同步 | 使用者訪問的網域名稱(使用者門戶、直接存取自研/OIDC/SAML應用時的地址)和企業微信可信網域名稱必須一致,否則將無法使用企業微信網頁授權登入和敏感性資料同步。 | |
OIDC應用/自研應用 | 授權端點 | 如果執行個體僅需使用一個自訂網域名,則建議使用初始化網域名稱,將自訂網域名設為預設網域名稱並開啟自動跳轉;如不開啟,使用者在單點登入時可能需要重新登入一次。 如果執行個體需要使用多個自訂網域名,則需和使用者的登入頁網域名稱保持一致,否則使用者在單點登入時可能需要重新登入一次。 |
退出端點 | ||
SAML應用 | IdP Meta地址 | 如果執行個體僅需使用一個自訂網域名,則建議使用初始化網域名稱,將自訂網域名設為預設網域名稱並開啟自動跳轉;如不開啟,使用者在單點登入時可能需要重新登入一次。 如果執行個體需要使用多個自訂網域名,則需和使用者的登入頁網域名稱保持一致,否則使用者在單點登入時可能需要重新登入一次。 |
SSO地址 | ||
WebAuthn | 註冊認證器 | WebAuthn僅在註冊認證器的網域名稱中生效。例如,使用者在A網域名稱註冊了WebAuthn認證器A1,訪問B網域名稱進行登入時不可使用認證器A1,需在B網域名稱中重新註冊認證器。使用者可以擁有多個不同網域名稱的認證器。 |
開始前準備
為了更順暢地完成自訂網域名的配置,建議您提前準備如下內容:
準備內容 | 說明 |
網域名稱 | 您需要準備一個供IDaaS EIAM專用的網域名稱,建議使用頂層網域或次層網域。 |
網域名稱所在DNS的操作許可權 | 您需要在網域名稱所在的DNS(如:阿里雲DNS)中添加1~2次DNS記錄,以驗證您對網域名稱的所有權。 |
備案號 | 如果您的網站託管在中國內地,則必須填寫網域名稱的備案號。 |
網域名稱所在代理服務的操作許可權 | 您需要在網域名稱所在的代理服務(如:阿里雲DCDN)中佈建網域名的HTTPS認證、回源HOST等資訊。 |
試用或升級執行個體 |
添加自訂網域名 - 網域名稱配置
單擊即可開始添加。

自訂網域名可能影響登入、單點登入、資料同步等功能,為了避免影響您的業務,請在開啟前瞭解自訂網域名的影響範圍。
步驟一:填寫網域名稱
輸入自訂網域名(如:login.example.com),這個網域名稱在所有IDaaS EIAM執行個體中全域唯一。僅需填寫網域名稱本身,無需填寫路徑、參數等。支援小寫字母、數字、中劃線、英文點,最大字元長度128。

IDaaS團隊將全力保障您執行個體的安全性,但理論上如果攻擊者對您的IDaaS EIAM執行個體成功實施XSS攻擊,將可能導致向同一網域名稱下的不同子網域名稱發起CSRF攻擊。因此我們建議屏蔽從自訂網域名發起的CORS請求,或者使用獨立的頂層網域作為自訂網域名。
步驟二:添加DNS記錄
請前往您的網域名稱做在的DNS(如:阿里雲DNS)添加記錄,該步驟旨在驗證您對網域名稱的所有權。針對同一IDaaS EIAM執行個體、同一自訂網域名,記錄類型、記錄名稱和記錄值固定不變,因此如果您無DNS的操作許可權,可交由他人代為添加DNS記錄,在完成添加後再添加自訂網域名。

下面是在部分DNS服務商中添加解析記錄的協助文檔:
步驟三:填寫備案號
根據《互連網資訊服務管理辦法》,如果您的網站託管在中國內地,則必須填寫主體備案號或網站備案號。為滿足合規要求,如需使用自訂網域名能力,在阿里雲中國內地region的IDaaS EIAM執行個體均需填寫。備案號將顯示在執行個體的登入頁。
步驟四:完成添加
確認資訊填寫無誤後,點擊完成添加,即可添加自訂網域名。您還需要完成代理配置,才可正常使用自訂網域名。
添加自訂網域名 - 代理配置
您的使用者或應用通過自訂網域名訪問IDaaS EIAM時,將由您的網域名稱代理服務轉寄請求,您需要確保代理的可用性。以下是代理服務的配置方式。
阿里雲DCDN
步驟一:添加網域名稱
您需要在阿里雲DCDN的網域名稱管理頁中添加網域名稱。

加速網域名稱:即您的自訂網域名。
來源站點資訊:
來源站點類型選擇來源站點網域名稱。
填寫代理配置-來源站點資訊的網域名稱(不包含協議頭https://),即您的IDaaS EIAM執行個體的初始化網域名稱。
連接埠選擇443。
完成添加後,您需要在DCDN中複製網域名稱的CNAME記錄,並前往網域名稱DNS服務位址進行解析。詳情可查看文檔:配置CNAME。
步驟二:配置HTTPS認證
在阿里雲DCDN的網域名稱管理頁中進入網域名稱詳情頁,在配置 HTTPS中配置HTTPS認證。詳情可查看文檔:配置HTTPS認證。

步驟三:開啟回源HOST
依然在網域名稱詳情頁,在回源配置中開啟回源HOST。

網域名稱類型選擇來源站點網域名稱,此時會自動選擇IDaaS EIAM執行個體的初始化網域名稱。

步驟四:添加回源HTTP頭
依然在網域名稱詳情頁,在回源配置中單擊自訂回源HTTPS頭,添加IP、Host、Token等資訊。這些資訊可以防止IP地址欺騙,以提高訪問的安全性。

完成配置後,您可以通過測試連接功能,讓IDaaS EIAM執行個體類比訪問您的自訂網域名。請注意,由於網域名稱本身可設定存取原則(例如辦公網IP才可訪問網域名稱),因此 IDaaS EIAM的測試結果僅供參考,建議您類比使用者的使用環境進行測試。

測試無誤後,您需要根據影響範圍確認和調整相關配置,並將自訂網域名分發給您的使用者(如果使用者依然使用初始化網域名稱,則建議開啟自動跳轉)。
Nginx 配置指引
步驟一:安裝自建nginx服務
源碼編譯安裝
#下載安裝包
wget http://nginx.org/download/nginx-1.18.0.tar.gz
#解壓
tar -zxvf nginx-1.18.0.tar.gz
cd nginx-1.18.0
#配置:指定Nginx的安裝目錄
./configure --prefix=/usr/local/nginx
#編譯和安裝
make && make install
#安裝完後驗證是否安裝成功
cd /usr/local/nginx/sbin
./nginx -t 安裝完成後,出現如下內容為安裝成功:
nginx: the configuration file /usr/local/nginx//conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx//conf/nginx.conf test is successful
CentOS/AlmaLinux/RHEL 系統安裝
# 安裝 EPEL 倉庫(部分系統需要)
sudo yum install epel-release -y
# 安裝 Nginx
sudo yum install nginx -y
# 啟動 Nginx 服務
sudo systemctl start nginx
# 設定開機自啟
sudo systemctl enable nginx
# 檢查服務狀態
sudo systemctl status nginxUbuntu/Debian 系統安裝
# 更新包列表
sudo apt update
# 安裝 Nginx
sudo apt install nginx -y
# 啟動 Nginx 服務
sudo systemctl start nginx
# 設定開機自啟
sudo systemctl enable nginx
# 檢查服務狀態
sudo systemctl status nginx步驟二:修改 Nginx 設定檔
查看nginx設定檔路徑。
nginx -t佈建網域名代理。
修改
nginx.conf設定檔 HTTP 節點下的 server 節點。修改反向 Proxy配置,將自訂網域名例如
www.example.com請求轉寄到*****.aliyunidaas.comIDaaS 的網域名稱。server { # 監聽 HTTPS 連接埠並啟用 SSL listen 443 ssl; # 網域名稱配置(需要被轉寄的網域名稱即使用者的自訂網域名) server_name www.example.com; location / { # 反向 Proxy目標地址(配置的IDaaS使用者門戶網域名稱地址) proxy_pass https://*****.aliyunidaas.com; } }
配置http請求轉寄https。
實現自訂網域名HTTP訪問自動重新導向HTTPS 的方式,訪問您的服務。提升安全性及SEO最佳化。
# HTTP 伺服器塊(監聽 80 連接埠) server { listen 80; server_name www.example.com; # 配置 HTTP 要求重新導向到 HTTPS location / { return 301 https://$host$request_uri; } }配置 SSL 憑證。
準備認證檔案並上傳到 nginx 伺服器。
修改 Nginx 設定檔。
server { # HTTPS 伺服器塊(監聽 443 連接埠) listen 443 ssl; server_name www.example.com; # SSL 憑證路徑(需替換為實際路徑) ssl_certificate /usr/local/nginx/ssl/www.example.com.crt; ssl_certificate_key /usr/local/nginx/ssl/www.example.com.key; # SSL 配置(可選最佳化) ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; }
配置 IDaaS回源要求標頭。

修改 nginx.conf 設定檔,http 節點下的 server 節點。
通過 proxy_set_header 設定回源要求標頭。
# 配置IDaaS回源要求標頭 location / { proxy_pass http://***.aliyunidaas.com; # 傳遞用戶端真實 IP proxy_set_header X-IDaas-Client-IP $remote_addr; # 傳遞主機頭(需確認目標服務期望的 Host 值) proxy_set_header X-IDaas-Host eiam-idaas.idpsso.net; # Proxy 驗證令牌(需保持與 IDaas 服務端配置一致) proxy_set_header X-IDaas-Proxy-Token PTC*****************************6j; # 保留原始 Host 頭(可選) proxy_set_header Host $host; }
步驟三:重啟 Nginx 服務
源碼編譯安裝方式重啟
sudo /usr/local/nginx/sbin/nginx -s reloadCentOS/AlmaLinux/RHEL 安裝方式重啟
sudo service nginx restartUbuntu/Debian 安裝方式重啟
sudo systemctl restart nginx網域名稱狀態
由於網域名稱本身可設定存取原則(例如辦公網IP才可訪問網域名稱),因此IDaaS EIAM無法確認自訂網域名是否在正常運行,因此網域名稱的可用狀態僅表示執行個體的網域名稱功能可被使用,不代表網域名稱可被正常訪問。您需自行確認自訂網域名是否正常運行。

修改預設網域名稱
預設網域名稱指的是執行個體預設使用的網域名稱,作用有兩個:
如果開啟了自動跳轉功能,您的使用者或應用在訪問初始化網域名稱時,自動跳轉到預設網域名稱。
在控制台的多處展示,例如使用者門戶地址、登入地址。

如果選擇了自訂網域名作為預設網域名稱且開啟了自動跳轉,當自訂網域名不可用(例如執行個體到期)時,需手動修改預設網域名稱,否則可能影響您的使用者或應用對執行個體的訪問。
開啟自動跳轉
自動跳轉指的是使用者或應用訪問執行個體的初始化網域名稱時,將自動跳轉到預設網域名稱。訪問自訂網域名時不會跳轉到預設網域名稱。如果您僅需要使用一個自訂網域名,建議將其設定為預設網域名稱並開啟自動跳轉,此時您的使用者無論是訪問初始化網域名稱或該自訂網域名,都可以順暢地完成應用的單點登入,而無需修改應用的單點登入配置。
如果沒有開啟該能力或者需要使用多個自訂網域名,則需要將應用的單點登入等配置(詳見影響範圍)調整為自訂網域名,否則可能影響您的正常使用,例如:使用者在單點登入時可能需要重新登入一次、無法掃碼登入企業微信等。
刪除自訂網域名
刪除自訂網域名前,請檢查該網域名稱是否正在被使用(如身份提供方、應用的單點登入配置等),彈窗中的網域名稱最後使用時間可為您提供參考;該時間也是proxy_token的最後使用時間,您可以在代理配置中直接查看。

刪除自訂網域名後,無法立即使用該網域名稱訪問IDaaS EIAM執行個體。建議清除本文檔中涉及的網域名稱DNS服務商和代理服務的相關配置,以防在後續的使用中造成網域名稱轉寄的錯亂。