綁定域名
更新時間 2024-11-24 16:52:13
最近更新時間: 2024-11-24 16:52:13
分享文章
本章主要介紹綁定域名。
在開放API前,您需要為API分組綁定獨立域名,API調用者通過獨立域名訪問分組內的API。您也可以使用系統分配的調試域名訪問API分組內的API。
- 調試域名(子域名):API分組創建后,系統為分組自動分配一個內部測試用的調試域名,此調試域名唯一且不可更改,每天最多可以訪問1000次。
- 獨立域名:您自定義的域名。最多可以添加5個獨立域名,不限訪問次數。API調用者通過訪問獨立域名來調用您開放的API。
說明
?同一實例下的不同分組不能綁定相同的獨立域名。
?調試域名默認只能在與實例相同VPC內的服務器上解析和訪問,如果調試域名要支持公網解析與訪問,請在實例上綁定公網入口彈性IP。
?當獨立域名為泛域名(例如*.aaa.com)時,用戶可以通過泛域名的所有子域名(例如default.aaa.com,1.aaa.com)訪問所綁定分組下的所有API。
前提條件
- 已有獨立域名。
- 已將獨立域名A記錄解析到實例的入口地址上。
- 如果API分組中的API支持HTTPS請求協議,那么在獨立域名中需要添加SSL證書,請您提前獲取SSL證書的內容和密鑰,并創建SSL證書。
操作步驟
步驟 1 進入API網關控制臺頁面。
步驟 2 根據實際業務在左側導航欄上方選擇實例。
步驟 3 在左側導航欄選擇“API管理 > API分組”。
步驟 4 單擊 分組名稱 。
步驟 5 單擊“分組信息”頁簽。
步驟 6 在“域名管理”區域,單擊“綁定獨立域名”,并在彈窗中配置域名信息。
表 獨立域名配置
| 信息項 | 描述 |
|---|---|
| 域名 | 填寫要綁定的域名。 |
| 支持最小TLS版本 | 選擇域名訪問所使用的最小TLS版本,TLS1.1或TLS1.2,推薦使用TLS1.2。 該配置僅對HTTPS生效,不影響HTTP或者其他訪問方式。 |
| 支持http to https自動重定向 | 支持獨立域名開啟http to https自動重定向。 |
步驟 7 單擊“確定”,將獨立域名與API分組綁定。
如果不再需要此域名時,在域名所在行,單擊“解綁域名”。
步驟 8 (可選)如果API分組中的API支持HTTPS請求協議,則需要為獨立域名綁定SSL證書。否則跳過此步驟。
- 在域名所在行單擊“選擇SSL證書”。
- 在選擇SSL證書彈窗中勾選要綁定的SSL證書,然后單擊“確定”,完成SSL證書的綁定。
- 如果選擇的SSL證書上傳過CA證書,可以勾選“開啟客戶端認證”即開啟HTTPS雙向認證。注意,開啟/關閉客戶端認證會對現有業務有影響,請謹慎操作。
- 如果證書列表中無可用的SSL證書,可單擊“創建SSL證書”,新增SSL證書。
常見問題
- 綁定域名失敗常見原因:未將獨立域名CNAME解析到分組的調試域名上或域名重復。
- 添加SSL證書失敗常見原因:生成證書的域名和實際添加證書所用的域名不一致。
支持http to https自動重定向
約束限制
由于瀏覽器限制,非GET或非HEAD方法的重定向可能導致數據丟失,因此API請求方法限定為GET或HEAD。
開啟重定向需滿足以下條件:
- 創建API時,前端配置的請求協議選擇“HTTPS”或“HTTP&HTTPS”。
- API所屬API分組已綁定獨立域名和SSL證書。
獨立域名綁定完成后,在“支持http to https自動重定向”列開啟重定向功能。