Entra Cloud Sync 에이전트 시간 초과 해결: 네트워크 및 인증서 체크리스트
By Mirko Peters ·
Entra Cloud Sync 에이전트는 설치되는데 동기화가 전혀 시작되지 않고, Microsoft Entra 관리 센터에 HybridIdentityServiceAgentTimeout이 표시되나요? DNS, 방화벽 규칙, TLS 검사, 인증서 신뢰 순서로 하나씩 점검해 보겠습니다.
Automatically translated with AI from the original post. Read the English original
에이전트는 오류 없이 설치됩니다. 서비스도 실행 중입니다. 서버는 인터넷에 연결되어 있습니다. 그럼에도 첫 동기화가 시작되지 않으며, Microsoft Entra 관리 센터에는 HybridIdentityServiceAgentTimeout이 표시됩니다.
핵심 포인트
- 보고된 사례에서 HybridIdentityServiceAgentTimeout은 에이전트가 고장 났다는 뜻이 아니라, 에이전트와 클라우드 서비스 사이의 연결 문제를 의미했습니다. Learn도 에이전트 시간 초과를 연결 실패와 연관짓고 있습니다.
- DNS를 먼저 확인하고, 그다음 .msappproxy.net 및 .servicebus.windows.net에 대한 아웃바운드 TCP 443을 확인하며, 마지막으로 인증서 폐기 목록을 위한 포트 80을 확인하시기 바랍니다.
- 방화벽 규칙은 고정 IP 주소가 아니라 도메인 이름을 기준으로 해야 하며, 이러한 트래픽에 대해서는 TLS 검사를 우회해야 합니다.
- 지원 사례를 열기 전에 에이전트 추적 로그와 AADCloudSyncTools 로그 번들을 수집하시기 바랍니다.
이 증상 패턴은 2026년 Microsoft 커뮤니티 게시글 두 건에서 각각 나타났습니다. 두 경우 모두 에이전트 자체는 정상으로 보였고, 의심되는 문제는 서버와 클라우드 서비스 사이에 있었습니다. 이 글은 두 사례의 공통된 교훈을 순서대로 따라 할 수 있는 체크리스트로 정리한 것입니다. 이 글은 문제 해결 가이드이며 Microsoft의 공식 절차가 아닙니다. 따라서 각 요구 사항은 최신 클라우드 동기화 사전 요구 사항 Microsoft Learn 페이지에서 다시 확인하시기 바랍니다.
증상의 모습
보고된 사례에는 다음과 같은 징후가 혼합되어 나타났습니다.
- Entra 관리 센터에서 에이전트 상태에
HybridIdentityServiceAgentTimeout이 표시됩니다. - 에이전트 추적 폴더
C:\ProgramData\Microsoft\Azure AD Connect Provisioning Agent\Trace에Web socket failed to connect와 같은 줄이 포함되어 있습니다. - 이벤트 로그에는
msappproxy.net주소로 보낸 신뢰 갱신 요청이 시간 초과되어 에이전트 재등록이 실패했다고 기록되어 있습니다. - 에이전트 업데이터가
autoupdate.msappproxy.net과 같은 이름을 확인하지 못합니다. - CAPI2 로그에는 신뢰되지 않는 루트 인증서로 끝나는 인증서 체인이 보고되어 있습니다.
Unable to initialize performance counters라는 추적 줄도 나타났습니다. 한 스레드의 채택된 답변에서는 이를 부차적인 문제로 취급했습니다. 실제 단서는 연결 오류였습니다.
1단계: 에이전트와 서비스 확인
먼저 단순한 원인부터 배제하시기 바랍니다.
- Microsoft Entra 관리 센터에서 Entra ID, Entra Connect, 클라우드 동기화를 차례로 열고, 에이전트가 목록에 있는지 확인하시기 바랍니다.
- 서버에서
services.msc를 열고 Microsoft Entra Connect Agent Updater와 Microsoft Entra Provisioning Agent가 실행 중인지 확인합니다. - Microsoft 요구 사항에서 기본 사항을 확인합니다. 도메인에 가입된 서버여야 하며(Windows Server Core는 지원되지 않습니다), .NET Framework 4.7.1 이상이 필요하고, PowerShell 실행 정책은
Undefined또는RemoteSigned이어야 합니다.
이 항목들에 문제가 없다면 다음 단계로 넘어갑니다. 에이전트가 원인이 아닙니다.
2단계: 이름 확인 테스트
첫 번째 스레드의 채택된 답변은 DNS부터 확인하라고 안내하고, 두 번째 스레드의 답변도 이름 확인 테스트를 요청합니다. 에이전트 서버에서 다음 명령을 실행합니다.
`` nslookup autoupdate.msappproxy.net nslookup login.microsoftonline.com nslookup <your-servicebus-namespace>.servicebus.windows.net ``
msappproxy.net 이름이 확인되지 않으면 다른 작업도 모두 실패합니다. 한 게시자는 전달자(forwarder)가 없고 루트 힌트에 의존하는 도메인 컨트롤러를 DNS 서버로 사용하고 있었습니다. 이런 구성은 문제를 일으킬 가능성이 높으므로, DNS 경로가 공용 이름을 안정적으로 확인할 수 있는지 점검하십시오.
3단계: 올바른 대상에 대한 TCP 443 테스트
login.microsoftonline.com만 확인하고 끝내지 마십시오. 한 스레드에서는 로그인 엔드포인트와 autoupdate.msappproxy.net은 443 포트에서 응답했지만 servicebus.windows.net은 응답하지 않았습니다. 에이전트는 두 계열의 대상 모두에 연결해야 합니다.
Microsoft Learn에 따르면 퍼블릭 클라우드의 아웃바운드 요구 사항은 다음과 같습니다.
| 대상 | 용도 | |---|---| | .msappproxy.net, .servicebus.windows.net | 클라우드 서비스와의 통신 | | .microsoftonline.com, .microsoft.com, .msappproxy.com, .windowsazure.com | 클라우드 서비스와의 통신 | | login.windows.net, login.live.com, aadcdn.msauth.net, aadcdn.msftauth.net | 등록 | | mscrl.microsoft.com:80, crl.microsoft.com:80, ocsp.msocsp.com:80, www.microsoft.com:80 | 인증서 확인 |
PowerShell로 포트를 테스트합니다.
``powershell Test-NetConnection autoupdate.msappproxy.net -Port 443 Test-NetConnection <your-servicebus-namespace>.servicebus.windows.net -Port 443 Test-NetConnection crl.microsoft.com -Port 80 ``
서비스는 사용자 계정으로 실행되지 않습니다. Microsoft는 방화벽이 원본 사용자 기준으로 규칙을 적용하는 경우, 네트워크 서비스로 실행되는 Windows 서비스를 위해 포트를 열어야 한다고 안내합니다. 대화형 관리자 세션에서는 성공하는 테스트도 서비스에서는 실패할 수 있습니다. 두 번째 스레드의 답변도 같은 점을 지적하며, 관리자 세션이 아니라 서비스 계정 컨텍스트에서 테스트하라고 권장합니다.
4단계: IP 주소가 아닌 이름 기반으로 방화벽 규칙 작성
두 답변 모두 IP 기반 규칙을 사용하지 말라고 경고합니다. 엔드포인트는 와일드카드 이름 뒤에 있으며, 주소는 바뀔 수 있기 때문입니다.
- 두 와일드카드 도메인이 확인되는 모든 대상(CNAME 체인 포함)에 대해 TCP 443을 허용합니다.
- 인증서 해지 목록(CRL) 및 OCSP 호스트에 대해 포트 80을 허용합니다.
- "필터링 없음"으로 설정된 방화벽도 장기 실행 WebSocket 연결을 끊을 수 있습니다. 규칙 목록만 보지 말고 거부 로그와 TLS 로그도 확인하십시오.
5단계: 이러한 흐름을 TLS 검사에서 제외
Learn의 클라우드 동기화 문제 해결 페이지에서는 Microsoft Entra 프라이빗 네트워크 커넥터와 Application Proxy 클라우드 서비스 사이의 아웃바운드 TLS에서 모든 형태의 인라인 검사 및 종료를 피하라고 안내합니다. 에이전트는 msappproxy.net 엔드포인트와 통신하며, 2026년 9월 스레드의 한 답변은 .msappproxy.net과 .servicebus.windows.net을 TLS 검사, 인증서 대체, 인증 및 애플리케이션 프록시 처리에서 제외하라고 권장했습니다. 한 스레드에서는 두 도메인에 대해 검사 우회를 적용하는 방향으로 방화벽 변경을 계획했습니다. 그러나 게시자는 이후에도 장애가 계속된다고 보고했으므로, 방화벽만이 유일한 원인이라고 가정하지 말고 다음 단계도 계속 진행하십시오.
6단계: 인증서 체인 확인
"신뢰할 수 없는 루트 인증서에서 종료됨"과 같은 인증서 오류는 TLS를 중단시킬 수 있습니다. 그 결과 웹 소켓 장애나 RenewTrustCertificate 중 시간 초과처럼 보일 수 있습니다. 다음 항목을 확인하십시오.
- 장애가 발생한 시점 전후의 체인 구성 오류를 찾으려면 CAPI2 운영 로그를 여십시오.
- 서버가 Windows Update 인증서 신뢰 목록 호스트
ctldl.windowsupdate.com에 접근할 수 있는지 확인하십시오. 루트 인증서가 업데이트될 수 있어야 합니다. 이 팁은 Learn 사전 요구 사항 페이지가 아니라 커뮤니티 답변에서 나온 것입니다. - 위에 나온 CRL 및 OCSP 호스트에 대해 포트 80이 열려 있는지 확인하십시오.
7단계: TLS 설정과 프록시 확인
Microsoft는 설치 전에 에이전트 서버에서 TLS 1.2를 요구합니다. 구형 서버에서는 TLS 1.2와 .NET용 강력한 암호화를 활성화해야 합니다. Learn 페이지에는 .NET Framework용 SchUseStrongCrypto를 포함한 레지스트리 설정이 나와 있습니다. Microsoft는 TLS 설정 변경이 포리스트 전체에 영향을 준다고 경고하므로 변경 계획을 세우십시오.
반드시 아웃바운드 프록시를 사용해야 한다면, Learn에서는 AADConnectProvisioningAgent.exe.config에 defaultProxy 섹션을 추가하는 방법을 설명합니다. 프록시가 최소한 청크 인코딩을 지원하는 HTTP 1.1을 지원하는지 확인하십시오. 두 게시자 모두 프록시를 사용하지 않았다고 보고했습니다. 그래도 WinHTTP 프록시가 설정되어 있지 않은지 확인하십시오.
8단계: 증거 수집
점검을 모두 통과했는데도 에이전트에서 여전히 시간 초과가 발생한다면, 기다리거나 다시 설치하기 전에 데이터를 수집하십시오.
AADCloudSyncTools모듈을 설치하십시오.- 장애를 재현한 다음
Export-AADCloudSyncToolsLogs를 실행하십시오. 기본 수집은 3분 동안 진행됩니다. - 추적 폴더의 파일을 복사하십시오.
- 시간 초과가 발생한 정확한 UTC 시각을 기록하십시오.
- 같은 시간대의 방화벽 거부 로그와 TLS 로그를 수집하십시오.
이 패키지를 Microsoft 지원팀에 전달하십시오. UTC 타임스탬프와 방화벽 로그가 포함된 지원 사례는 훨씬 쉽게 처리할 수 있습니다.
두 스레드에서 있었던 일
- 첫 번째 스레드에서 관리자는 프록시 설정, 방화벽 로그 검토, TLS 변경, 인증서 저장소 재구성, 복구 명령을 차례로 시도했습니다. 이후 한 답변이 DNS와 인증서 체인을 가리켰습니다. 게시자는 제안된 점검 항목을 담은 스크립트를 작성했습니다. 모든 테스트를 통과했고 이후 동기화가 완료되었습니다. 게시자는 명확한 원인을 찾지 못했으며, 클라우드 쪽에서 무언가 변경되었을 것이라고 의심했습니다.
- 두 번째 스레드에서는 다른 엔드포인트는 정상이었지만
servicebus.windows.net이 TCP 443에서 실패했습니다. 방화벽 변경이 준비되었지만 최종 해결책은 보고되지 않았습니다.
따라서 이 체크리스트는 네트워크 문제를 찾는 방법으로 보고, 보장된 해결책으로 여기지 마십시오. 모든 항목을 통과했는데도 한동안 지나도 상태가 회복되지 않는다면 지원 사례를 여십시오.
관련 자료
데이터 원본
- Microsoft Learn: Cloud sync prerequisites
- Microsoft Learn: Cloud sync troubleshooting
- Microsoft Q&A: Entra Cloud Sync 문제 (2026년 4월)
- Microsoft Community Hub: Entra Connect Cloud Sync의 HybridIdentityServiceAgentTimeout 이상 현상 (2026년 9월)