M365Con 2027 – 무료 온라인 컨퍼런스 · 11–22 Jan 2027 · 120 sessions→ m365con.net

블로그 · Mirko Peters

Entra Connect가 중복 사용자를 만들었거나 속성을 건너뛴 경우: 소프트 매치, 하드 매치, 중복 값

By ·

온프레미스에서 새로 만든 사용자가 onmicrosoft.com UPN을 가진 두 번째 클라우드 계정으로 생성되거나, 메일 주소가 업데이트되지 않는 경우가 있습니다. 매칭이 어떻게 동작하는지, 오류를 어떻게 해석하는지, 그리고 안전하게 다시 연결하는 방법을 설명합니다.

Automatically translated with AI from the original post. Read the English original

Entra Connect 매칭 규칙을 찾아보게 되는 상황은 크게 두 가지입니다. 첫 번째는 온프레미스에서 새로 만든 사용자가 클라우드에 두 번 나타나는 경우입니다. 원하던 계정 외에 .onmicrosoft.com 로그인 이름을 가진 새 동기화 계정이 하나 더 생깁니다. 두 번째는 동기화가 오류 없이 실행되지만, Entra ID의 사용자 mail이나 proxyAddresses에 여전히 이전 주소가 표시되는 경우입니다.

핵심 포인트

  • Entra는 먼저 sourceAnchor와 ImmutableId를 비교하는 하드 매치를 시도하고, 다음으로 userPrincipalName 또는 기본 SMTP 주소를 비교하는 소프트 매치를 시도합니다. 둘 다 일치하지 않으면 새 개체를 만듭니다.
  • 온프레미스 UPN 접미사가 테넌트에서 확인되지 않은 경우, Entra는 mailNickName과 초기 onmicrosoft.com 도메인으로 새 UPN을 만듭니다.
  • 중복 속성 복원력 기능은 충돌하는 proxyAddresses 또는 UPN 값을 실패시키는 대신 격리합니다. 그래서 값 하나가 빠져 있어도 동기화는 정상으로 보일 수 있습니다.
  • Learn에 따르면 2026년 7월 1일부터는 onPremisesObjectIdentifier가 이미 설정되어 있거나 특권 역할을 보유했거나 그 대상이 될 수 있는 클라우드 계정에 대해 하드 매치가 차단될 수 있습니다.

두 사례 모두 Microsoft Q&A 스레드에서 확인했습니다. 하나는 2025년 1월, 다른 하나는 2025년 10월의 글입니다. 각 글에서 질문자가 해결 방법을 보고했습니다. 기술적 배경은 현재 Microsoft Learn 페이지와 대조해 확인했습니다. 이 글은 문제 해결 가이드이며 공식 Microsoft 절차가 아닙니다. 모든 변경은 먼저 사용자 한 명에게 테스트하십시오.

Entra가 개체를 매칭하는 방식

Learn은 AD에서 들어오는 새 개체에 대해 다음 순서를 설명합니다.

  1. 하드 매치. Entra는 sourceAnchor를 기존 클라우드 개체의 ImmutableId와 비교합니다. 기본 sourceAnchor는 구성에 따라 mS-Ds-ConsistencyGUID 또는 ObjectGUID를 Base64로 인코딩한 값입니다.
  2. 소프트 매치. 하드 매치가 없으면 Entra는 userPrincipalName 또는 proxyAddresses의 기본 SMTP: 값을 비교합니다.
  3. 새 개체. 둘 다 일치하지 않으면 Entra는 새 개체를 만듭니다.

Learn은 두 가지 제한을 추가로 설명합니다. 소프트 매치는 새 개체에 대해서만 평가됩니다. 또한 소프트 매치가 일어나면 Entra는 클라우드 개체를 인계받아, 온프레미스에 값이 있는 모든 속성을 덮어씁니다. 클라우드에서만 관리하던 속성은 손실될 수 있으며, 암호 해시 동기화를 사용하는 경우 클라우드 암호 해시도 온프레미스 해시로 대체됩니다.

시나리오 1: onmicrosoft.com UPN을 가진 두 번째 사용자

스레드에서 보고된 내용. 관리자가 온프레미스 AD에서 사용자를 만들었습니다. Entra Connect는 .onmicrosoft.com UPN과 온프레미스 동기화 표시가 있는 두 번째 Entra 사용자를 만들었습니다. 의도한 클라우드 사용자에는 동기화 표시가 없었습니다. 채택된 답변은 소프트 매치와 하드 매치를 모두 설명했습니다. 질문자는 이후 하드 매치 방식으로 문제가 해결되었다고 남겼습니다.

매치가 실패했을 가능성이 있는 이유

해당 스레드에서는 그 이유를 밝히지 않았습니다. Learn에는 onmicrosoft.com 이름이 붙는 이유가 한 가지 문서화되어 있습니다. 온프레미스 UPN 접미사가 테넌트에서 확인되지 않은 경우 Entra는 MailNickName과 초기 도메인을 기준으로 새 UPN을 계산합니다. 이는 UPN이 클라우드 사용자와 일치할 수 없다는 뜻이기도 합니다. 이것은 진단이 아니라 단서일 뿐입니다. 두 계정 모두에서 다음 항목을 비교해 보십시오.

  • UPN 접미사와 해당 접미사가 테넌트의 확인된 도메인인지 여부
  • 기본 SMTP 주소(proxyAddresses의 SMTP: 항목)
  • 클라우드 사용자에 이미 온프레미스 연결이 표시되는지 여부

옵션 A: 소프트 매치 활용하기

해당 스레드에서 처음 제시된 해결 방법은 온프레미스 UPN과 proxy 주소를 클라우드 사용자와 일치시킨 뒤 중복 객체를 삭제하고 다시 동기화하는 것이었습니다. Learn에 따르면 소프트 매치는 새 개체에 대해서만 평가되며, 중복 객체를 삭제한 후 이미 연결된 객체가 다시 평가되는지는 다루지 않습니다. 질문자는 결국 옵션 B를 사용했으므로, 옵션 A는 검증되지 않은 방법으로 보아야 합니다.

옵션 B: 하드 매치

  1. Entra Connect가 sourceAnchor로 사용하는 특성이 무엇인지 확인하십시오. Learn에서는 mS-Ds-ConsistencyGUID 또는 ObjectGUID를 언급합니다.
  2. 온프레미스 GUID를 Base64로 변환합니다. 해당 스레드의 답변에서 사용된 방식은 다음과 같습니다.

``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``

  1. 그 결과를 클라우드 사용자의 ImmutableId로 설정합니다. 해당 스레드의 답변에서는 이전 MSOnline 모듈의 Set-MsolUser를 사용했습니다. 현재 Learn 문서는 Microsoft Graph PowerShell을 사용합니다. Update-MgUser 문서에는 -OnPremisesImmutableId 매개 변수가 나와 있으며, 이 값을 업데이트할 수 있는 역할은 특정 권한 있는 관리자 역할로만 제한된다고 설명되어 있습니다. 실행하기 전에 해당 문서의 매개 변수 참고 사항을 확인하십시오.
  2. 델타 동기화를 실행합니다.

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. 대상 클라우드 사용자에 동기화 플래그가 표시되는지 확인한 다음 남아 있는 중복 객체를 정리하십시오.

Learn에는 이 정확한 경우에 대한 정리 순서가 설명되어 있지 않습니다. 해당 스레드의 답변에서는 먼저 ImmutableId를 설정하고, 동기화한 뒤 확인하고, 그다음에 중복 객체를 제거했습니다. 무엇이든 삭제하기 전에 중복 객체에 할당된 라이선스와 사서함 데이터를 먼저 확인하십시오.

Learn에는 관련 오류인 InvalidSoftMatch도 문서화되어 있습니다. 이 오류는 하드 매치로 찾는 객체가 없고, 소프트 매치로 클라우드 객체가 발견되었지만 해당 객체의 ImmutableId가 들어오는 sourceAnchor와 다를 때 발생합니다. 이는 해당 클라우드 객체가 다른 온프레미스 객체에서 동기화되었을 가능성을 시사합니다. Learn의 해결 방법은 AttributeValueMustBeUnique의 경우와 동일합니다. 중복된 값과 관련 객체를 확인하고, 어느 객체가 그 값을 유지할지 결정한 뒤, 값이 원본으로 동기화되는 디렉터리에서 다른 객체의 값을 제거하십시오.

2026년 7월 이후 새로 적용된 보호 기능

Learn에 따르면 2026년 7월 1일부터 대상 클라우드 계정이 다음 중 하나에 해당하면 하드 매치가 차단될 수 있습니다.

  • 이미 onPremisesObjectIdentifier가 설정되어 있는 경우,
  • 권한 있는 Microsoft Entra 역할이 할당되어 있는 경우,
  • 권한 있는 Microsoft Entra 역할에 대한 자격이 있는 경우.

쓰기 백이 사용하도록 설정된 클라우드 관리 계정은 제외됩니다. Learn에서는 이러한 보호 기능이 안전한 대상에 대한 하드 매치를 비활성화하지는 않는다고 설명합니다. 또한 테넌트 전체 플래그인 BlockSoftMatchEnabled와 BlockCloudObjectTakeoverThroughHardMatchEnabled, 그리고 기본적으로 꺼져 있는 임시 우회 옵션 AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled도 소개합니다. Learn은 이 우회 옵션이 보호 수준을 낮추므로 사용 후에는 끄도록 경고합니다. 기본적으로 Entra는 관리자 역할을 가진 클라우드 사용자와 온프레미스 사용자를 소프트 매치하지 않으며, Microsoft는 기존 관리자 계정이 있는 온프레미스 계정을 동기화하지 않을 것을 강력히 권장합니다.

따라서 2025년 스레드의 하드 매치가 오늘날 실패한다면, 이러한 보호 기능 중 하나가 원인일 수 있습니다.

시나리오 2: 동기화는 조용하지만 주소가 바뀌지 않는 경우

스레드에서 보고된 내용. 외부 계약직 직원들은 회사 주소 대신 자신의 외부 이메일 주소가 필요했습니다. ADUC에서는 온프레미스 계정에 올바른 주소가 표시되었지만, Entra의 mail과 proxyAddresses에는 여전히 회사 주소가 남아 있었습니다. 질문자는 SharePoint 접근을 위해 만들어진 클라우드 전용 게스트 계정이 새 온프레미스 계정과 같은 외부 주소를 사용하고 있다는 원인을 스스로 찾아냈습니다. 질문자는 이것이 충돌의 원인이라고 적었습니다.

해당 스레드에서 채택된 답변은 일반적인 내용이었으며, 진단은 질문자 본인이 내렸다는 점에 유의하십시오.

Learn이 추가로 설명하는 내용

  • Entra ID에서는 mail, proxyAddresses, signInName, userPrincipalName 값이 고유해야 합니다. 다른 개체가 이미 가진 값을 추가하거나 업데이트하면 AttributeValueMustBeUnique 오류가 발생합니다.
  • 중복 특성 복원력은 기본 동작이며 끌 수 없습니다. UPN과 SMTP proxyAddresses 값에만 적용됩니다. 중복된 값이 있으면 내보내기를 실패시키는 대신 Entra가 해당 값을 격리합니다. 데이터 자체를 수정하지는 않으며, Learn 페이지에는 mail이 적용 대상으로 나와 있지 않습니다.
  • 중복된 UPN에는 <OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com 형식의 자리 표시자가 할당됩니다. 격리된 SMTP 프록시 주소는 개체가 생성되거나 업데이트되는 동안 보류됩니다.
  • 내보내기가 성공하므로 동기화 클라이언트는 오류를 기록하지 않으며 재시도하지도 않습니다.

이는 스레드에서 설명된 상황과 일치합니다. 눈에 띄는 실패는 없고 값 하나만 누락된 상황입니다. 채택된 답변은 중복 특성 복원력을 일반적인 수준에서만 언급했고, 실제로 적용되었는지는 아무도 확인하지 않았습니다. 따라서 이는 그럴듯한 설명일 뿐 확인된 원인은 아닙니다.

충돌을 찾는 방법

  1. Microsoft Entra 관리 센터에서 Microsoft Entra Connect Health의 동기화 오류 보고서를 엽니다. Learn에 따르면 이 보고서는 약 30분마다 새로 고쳐지며, 가장 최근 동기화 시도의 오류를 표시합니다.
  2. 격리된 값에 대해 Learn은 다음을 보여 줍니다:

``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``

  1. Learn의 해결 방법은 AttributeValueMustBeUnique와 InvalidSoftMatch에 대해 동일합니다. 중복된 값과 관련 개체를 확인하고, 어느 개체가 그 값을 유지할지 결정한 다음, 해당 개체의 원본 디렉터리에서 다른 개체의 값을 제거하고 Entra Connect가 동기화하도록 합니다. 경우에 따라서는 충돌하는 개체 중 하나를 삭제해야 할 수도 있습니다.
  2. 충돌이 해소되면 백그라운드 작업이 격리된 특성을 제거합니다. Learn에 따르면 이 작업은 매시간 실행됩니다.

게스트 사례라면 클라우드 전용 게스트의 주소를 변경하거나 제거한 다음 다음 동기화를 기다리면 됩니다.

확인

  1. Entra ID에서 사용자를 찾아 mail, proxyAddresses, UPN을 AD와 비교합니다.
  2. Start-ADSyncSyncCycle -PolicyType Delta를 실행한 다음 다시 확인합니다.
  3. 오류 보고서에 해당 개체가 더 이상 나타나지 않는지 확인합니다.

대량 변경의 경우, Learn의 스테이징 서버 문서에서 csexport와 CSExportAnalyzer로 대기 중인 내보내기를 미리 확인하는 방법을 설명합니다. 활성 모드로 전환하기 전에 참고하십시오.

한계

  • 스레드만으로는 어떤 단계가 문제를 해결했는지 확인할 수 없습니다.
  • 스레드의 hard match 명령은 이전 모듈을 사용합니다. 최신 Learn 안내를 따르십시오.
  • Learn은 잘못 생성된 중복 개체를 정리하는 순서를 문서화하지 않습니다. 사용자 한 명으로 먼저 테스트해 보십시오.

관련 자료

데이터 원본

쇼 팔로우하기Spotify

Entities in this article

Microsoft Entra Connect Microsoft Entra ID Microsoft Entra Connect Health Microsoft Graph PowerShell

Related articles

RSS