Ubuntu上基於Docker的安全訪問資源聯結器已成功啟動,但未能註冊到Cisco Secure Service Edge(SSE),導致錯誤106,原因是例項ID長度驗證以及儀表板中沒有聯結器可見性。
資源聯結器啟動顯示成功,顯示消息「資源聯結器啟動成功」,但聯結器未顯示在SSE控制面板中,並且診斷檢查顯示註冊失敗。
診斷輸出顯示了多個網路連線問題,包括SSE服務的DNS解析故障和特定的守護程式錯誤:
daemon init state
106
診斷運行狀況檢查表明:
error: 106 fail to register, the provision key could be expired
儘管多次重新生成調配金鑰並驗證防火牆規則,註冊仍會失敗,儀表板中不會顯示聯結器。
思科安全存取 — 資源聯結器
基於Ubuntu的Docker部署
通過解決導致註冊失敗的例項ID長度驗證錯誤解決了此問題。實際根本原因不是預配金鑰過期或網路連線問題,而是資源聯結器主機名太長,導致生成的例項ID超過50個字元的限制。
檢視資源聯結器日誌,通過運行「sudo /opt/connector/data/bin/techsupport」來識別實際註冊錯誤:
2026-05-28T17:08:51Z INF requesting registration func=makeACARegistrationRequest parameters={"environment":"container","hostname":"(NAME)","instanceId":"(NAME)-d5d28cd78f24759","originIpAddress":"10.162.129.140","sha1":"9a1146f75071717837eff564e7f950a6e8ff2303","version":"v2.0.99"}
2026-05-28T17:08:51Z ERR registration request failed error="RegisterConnector::failed registration request with code 400 - Validation Error - {InstanceId:Attribute value length should be between 1 to 50 Version: Hostname: Sha1: OriginIpAddress: Environment:}" func=registerAndInitACA
確保資源聯結器主機名足夠短,以便生成的例項ID保留在10到50個字元之間。例項ID通過將主機名與雜湊字尾組合而生成。
使用較短的主機名啟動Resource Connector:
sudo /opt/connector/install/connector.sh launch --name [shorter-name] --key [provisioning-key]
確保在主機系統上啟用了IP轉發:
echo "net.ipv4.ip_forward=1" | sudo tee /etc/sysctl.d/99-docker-forwarding.conf
重新啟動容器或虛擬機器以應用IP轉發配置,並確保資源聯結器以新主機名啟動。
運行診斷命令以驗證註冊是否成功:
/opt/connector/data/bin/diagnostic
檢查守護程式init state 是否不再顯示錯誤106,以及資源聯結器是否出現在SSE控制面板中。
資源聯結器註冊失敗是由例項ID長度驗證錯誤導致的。當Resource Connector主機名太長時,生成的例項ID(將主機名與雜湊字尾相結合)超過了允許的最大長度(50個字元)。SSE API驗證例項ID長度,並拒絕例項ID在1到50個字元範圍之外的註冊請求,從而導致400個驗證錯誤並阻止聯結器出現在儀表板中。
錯誤106「註冊失敗,預配金鑰可能過期」消息具有誤導性,因為實際問題與預配金鑰過期無關,而是與例項ID驗證失敗有關。
| 修訂 | 發佈日期 | 意見 |
|---|---|---|
1.0 |
06-Oct-2026
|
初始版本 |