오류 106(으)로 인해 보안 액세스 리소스 커넥터 등록 실패

문제

Ubuntu의 Docker 기반 Secure Access Resource Connector가 시작되었지만 Cisco SSE(Secure Service Edge)에 등록하지 못했습니다. 인스턴스 ID 길이 검증으로 인해 오류 106이 발생했으며 대시보드에 커넥터 가시성이 없습니다.

리소스 커넥터가 성공적으로 실행되었지만 "리소스 커넥터가 성공적으로 실행되었습니다."라는 메시지가 표시되었지만 커넥터가 SSE 대시보드에 표시되지 않았으며 진단 검사에서 등록 실패가 발견되었습니다.

진단 출력에서 SSE 서비스에 대한 DNS 확인 실패 및 특정 데몬 오류를 비롯한 여러 네트워크 연결 문제가 나타났습니다.

daemon init state
106

진단 상태 확인에 다음이 표시됩니다.

error: 106 fail to register, the provision key could be expired

프로비저닝 키를 여러 번 재생성하고 방화벽 규칙을 확인했음에도 불구하고 등록에 계속 실패했으며 대시보드에 커넥터가 표시되지 않았습니다.

환경

• Cisco Secure Access - 리소스 커넥터

• Ubuntu에서 Docker 기반 구축

해결

등록 실패를 일으키는 인스턴스 ID 길이 유효성 검사 오류를 해결하여 문제를 해결했습니다. 실제 근본 원인은 만료된 프로비저닝 키 또는 네트워크 연결 문제가 아니라 리소스 커넥터 호스트 이름이 너무 길어 생성된 인스턴스 ID가 50자 제한을 초과하게 되었습니다.

1단계: 인스턴스 ID 길이 문제 식별

리소스 커넥터 로그를 검토하여 '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

2단계: 리소스 커넥터 호스트 이름 수정

생성된 인스턴스 ID가 10자에서 50자 사이로 유지되도록 리소스 커넥터 호스트 이름이 짧아야 합니다. 인스턴스 ID는 호스트 이름과 해시 접미사를 결합하여 생성됩니다.

더 짧은 호스트 이름으로 리소스 커넥터를 시작합니다.

sudo /opt/connector/install/connector.sh launch --name [shorter-name] --key [provisioning-key]

3단계: IP 전달 사용

호스트 시스템에서 IP 전달이 활성화되었는지 확인합니다.

echo "net.ipv4.ip_forward=1" | sudo tee /etc/sysctl.d/99-docker-forwarding.conf

4단계: 컨테이너 또는 VM 다시 시작

IP 포워딩 컨피그레이션을 적용하고 리소스 커넥터가 새 호스트 이름으로 시작되도록 하려면 컨테이너 또는 가상 머신을 다시 시작합니다.

5단계: 등록 확인

diagnostic 명령을 실행하여 성공적인 등록을 확인합니다.

/opt/connector/data/bin/diagnostic

데몬 init 상태가 더 이상 오류 106을 표시하지 않고 리소스 커넥터가 SSE 대시보드에 나타나는지 확인합니다.

원인

인스턴스 ID 길이 유효성 검사 오류로 인해 리소스 커넥터 등록 오류가 발생했습니다. 리소스 커넥터 호스트 이름이 너무 길면 생성된 인스턴스 ID(호스트 이름과 해시 접미사를 결합)가 최대 허용 길이인 50자를 초과합니다. SSE API는 인스턴스 ID 길이를 검증하고 인스턴스 ID가 1~50자 범위를 벗어나는 등록 요청을 거부하므로 400자 검증 오류가 발생하고 커넥터가 대시보드에 표시되지 않습니다.

오류 106 "등록하지 못했습니다. 프로비저닝 키가 만료될 수 있습니다." 메시지가 잘못된 것입니다. 실제 문제가 프로비저닝 키 만료와 관련이 없고 인스턴스 ID 검증 실패와 관련이 있기 때문입니다.

관련 콘텐츠

• Cisco 기술 지원 및 다운로드

개정 이력

개정	게시 날짜	의견
1.0	06-Oct-2026	최초 릴리스