다음을 통해 공유

사용자 ID 규칙

  • 아티클

SDS(학교 데이터 동기화)를 구성할 때 원본 데이터(API 또는 CSV 파일)에서 대상 디렉터리(Microsoft Entra ID 또는 Microsoft Entra ID)의 사용자 개체로 학생 및 교직원 ID를 정의해야 합니다.

교직원 및 학생 역할 모두를 선택하여 사용자 ID 규칙 옵션을 선택합니다.

이러한 규칙은 SIS/SMS에서 Microsoft Entra ID 기존 사용자를 일치시키는 데 사용됩니다.

중요

Microsoft 365 사용자 관리 흐름을 구성할 때 옵션이 일치하지 않는 사용자 만들기로 활성화된 경우 이러한 규칙이 사용됩니다. 규칙 구성은 Microsoft Entra UserPrincipalName 속성의 구문을 정의하고 이후 실행이 동일한 사용자와 일치하도록 하는 데 사용됩니다.

참고

사용자 일치는 인바운드 흐름으로 수행되며 Microsoft Entra ID 사용자 개체를 작성하거나 업데이트하지 않습니다. 일치가 수행되고 Education 데이터 레이크에 저장됩니다. 자세한 내용은 아웃바운드 흐름과 일치 링크의 작성에 대한 Microsoft 365 사용자 관리를 참조하세요.

  • 사용자에게 여러 역할이 있는 경우 다음 규칙을 사용하여 사용자 레코드와 Microsoft Entra 사용자 개체 간에 사용해야 하는 교직원 또는 학생 일치 규칙을 결정합니다.
  • 모든 학생 역할에 대해 isPrimary가 설정된 경우 교직원 역할에 대한 연결이 있더라도 학생 역할에 따라 일치가 수행됩니다.
  • 모든 교직원 역할에 대해 isPrimary가 설정된 경우 학생 역할에 대한 연결이 있더라도 교직원 역할에 따라 일치가 이루어집니다.
  • 교직원 및 학생 역할 모두에 대해 isPrimary가 설정된 경우 교직원 역할에 따라 일치가 이루어집니다.
  • isPrimary가 어떤 역할, 특히 교직원 및 학생 역할 모두에 대한 혼합으로 설정되지 않은 경우 경기는 교직원 역할을 기반으로 합니다.

중요

사용자가 여러 조직과도 연결된 경우 테넌트가 "Microsoft 365 사용자 관리" 아웃바운드 흐름을 설치한 경우 Microsoft Entra 사용자 개체에 역할을 쓸 때 값을 결정하는 데도 다음이 사용됩니다.

원본의 값: SIS/SMS에서 제공되는 데이터를 기반으로 하는 사용자 값입니다. 규칙 구성은 선택한 값을 단순 문자열 값으로 사용하거나 공백이 없는 알파 숫자 문자로 사용합니다. 문자열 값은 선택한 대상에 포함된 정확한 값과 일치해야 해당 사용자를 찾을 수 있습니다.

  • 사용 가능한 소스 옵션은 다음과 같습니다.

    • 사용자 이름(v1/v2.1 CSV 및 OneRoster API)
    • Email(v1/v2.1 CSV 및 OneRoster API)
    • ActiveDirectoryMatchId(v2.1 CSV)

  • 선택한 원본 옵션에 @domain 값을 추가하는 도메인(선택 사항) 선택입니다.

    경고

    도메인을 선택하는 것은 선택 사항이며 원본에서 선택한 특성 에 따라 들어오는 데이터에 @domain 값이 포함되지 않은 경우에만 사용해야 합니다. 레코드에 값이 누락된 경우 SDS는 검사 않고 추가하지 않습니다. SDS는 @domain@domain 발생할 수 있는 모든 레코드에 도메인 선택을 추가하고 Microsoft Entra ID 사용자와 기존 사용자 매핑에 대한 일치 항목을 해당 인스턴스에서 찾을 수 없습니다.

    주의

    SIS/SMS 사용자(예: 직원 역할 그룹의 사용자)가 @domain1 또는 @domain2 또는 @domain3 연결할 수 있는 경우 원본 선택에서 선택한 특성(예: prefix@domain )에 따라 원본 데이터에 포함된 @domain 있어야 합니다. 일치하는 특성을 찾으려면 UserPrincipalName 또는 Mail에서 일치시킬 올바른 Microsoft Entra 사용자를 찾는 데 필요합니다.

일치시킬 특성: 일치시킬 Microsoft Entra ID 사용자 속성입니다.

  • 사용 가능한 Microsoft Entra ID 일치 옵션은 다음과 같습니다.
    • UserPrincipalName
    • 메일

팁

특성이 일치하는 경우: UserPrincipalName 또는 Mail, 예 - prefix@domain 원본 데이터에 포함되거나 추가된 @domain 값이 있어야 합니다.