다음을 통해 공유

조직 연결을 다른 Microsoft Entra ID로 변경

  • 아티클

Azure DevOps Services

이 문서에서는 조직의 연결을 한 Microsoft Entra ID에서 다른 ID로 전환하는 방법을 설명합니다. 디렉터리를 변경할 때 프로젝트 리소스는 영향을 받지 않습니다.

합병 또는 인수와 같은 조직의 변경 내용에 맞게 다른 디렉터리로 전환하거나 관리 및 보안을 강화하기 위해 여러 디렉터리를 통합하는 것이 좋습니다.

Azure DevOps에서 Microsoft Entra ID를 사용하는 방법에 대한 자세한 내용은 개념 개요를 참조하세요.

필수 조건

  • 사용 권한: 프로젝트 컬렉션 관리자 그룹의 구성원이 됩니다. 조직 소유자는 자동으로 이 그룹의 구성원입니다.

  • 액세스 수준:

    • 대상 Microsoft Entra ID의 구성원이 됩니다. 자세한 내용은 Microsoft Entra 게스트를 멤버로 변환하는 방법을 참조하세요.
    • 원본 Microsoft Entra ID의 멤버 또는 게스트여야 합니다.

  • 사용자 관리:

    • 조직에 100명 이하의 사용자가 있는지 확인합니다. 조직에 100명 이상의 사용자가 있는 경우 연결이 끊긴 사용자를 해결하려면 지원에 문의하세요. 새 테넌트에서 해당 Microsoft Entra ID에 매핑할 수 있습니다.
    • 대상 Microsoft Entra ID의 사용자를 Azure DevOps 조직에 추가하지 마세요.

  • SSH 키: 디렉터리를 전환하기 전에 지원에서 SSH 키를 수동으로 지우도록 요청합니다. 이 문서에서는 SSH 키를 다시 만드는 방법에 대한 단계를 찾을 수 있습니다. 자세한 내용은 FAQ을 참조하세요.

사용자 지정 도메인

Microsoft Entra 디렉터리에 새 사용자 지정 도메인을 추가하는 경우 이 작업으로 기존 ID에 대한 매핑이 중단되므로 고객을 새 사용자 지정 도메인으로 마이그레이션하기 전에 지원에 문의하세요.

Important

전송 후 Microsoft Entra 그룹에서 멤버 자격 및 권한을 상속하는 사용자 및 그룹은 더 이상 해당 권한을 상속하지 않습니다. Azure DevOps 조직에 추가된 Microsoft Entra 그룹은 전송되지 않으며 Microsoft Entra 연결이 변경될 때 조직에 더 이상 존재하지 않습니다. 이러한 Microsoft Entra 그룹과 연결된 모든 사용 권한 및 멤버 자격 관계도 이전 후에 더 이상 존재하지 않습니다.

Microsoft Entra 연결 변경

  1. 조직에 로그인합니다(https://dev.azure.com/{yourorganization}).

  2. 조직 설정을 선택합니다 기어 아이콘 .

    강조 표시된 조직 설정 단추를 보여 주는 스크린샷

  3. Microsoft Entra ID를 선택한 다음 디렉터리를 전환합니다.

    디렉터리 전환 단추가 강조 표시된 스크린샷

  4. 드롭다운 메뉴에서 디렉터리를 선택한 다음 연결을 선택합니다.

    Microsoft Entra 드롭다운 메뉴와 연결 단추가 강조 표시된 스크린샷

    디렉터리를 찾을 수 없는 경우 Microsoft Entra 관리자에게 문의하여 Microsoft Entra ID에 구성원으로 추가하도록 요청합니다.

  5. 로그아웃을 선택합니다.

    강조 표시된 로그아웃 단추를 보여 주는 스크린샷

    조직에서 Microsoft Entra ID에 연결합니다.

  6. 로그아웃하여 프로세스가 완료되었는지 확인합니다. 비공개 세션에서 브라우저를 열고 Microsoft Entra ID 또는 회사 자격 증명을 사용하여 조직에 로그인합니다.

  7. 이 프로세스 중에 일부 멤버의 연결이 끊어지면 Microsoft Entra 페이지에 다음 예제와 같은 오류 메시지가 표시됩니다. 연결을 끊은 사용자를 매핑하려면 [해결]을 선택합니다. 자세한 내용은 FAQ를 참조 하세요.

    해결 단추가 강조 표시된 스크린샷

    연결이 끊긴 사용자 확인 대화 상자를 보여 주는 스크린샷

완료된 Microsoft Entra 변경 내용에 대해 사용자에게 알릴 수 있습니다.

사용자에게 완료된 변경 내용을 알릴 때 수행할 다음 작업을 제공합니다.

  1. Azure DevOps에서 로그아웃합니다.

  2. 브라우저 캐시를 지웁니다. Visual Studio 또는 Git 명령줄도 사용하는 경우 Git 자격 증명 관리자에 대한 캐시를 지웁다. 각 클라이언트 컴퓨터에서 %LocalAppData%\GitCredentialManager\tenant.cache 파일을 삭제합니다.

  3. Microsoft Entra ID 또는 회사 자격 증명을 사용하여 Azure DevOps에 로그인합니다.

  4. 필요한 경우 PAT(개인용 액세스 토큰) 또는 SSH 키를 다시 구성합니다.

    • PAT: 개인용 액세스 토큰 사용의 단계를 완료합니다.
    • SSH 키:
    1. Azure DevOps에서 프로필을 연 다음 결과 드롭다운 메뉴에서 보안을 선택합니다.

    강조 표시된 보안 선택을 보여 주는 스크린샷

    1. SSH 공개 키를 선택한 다음 추가를 선택합니다.

    SSH 공개 키 추가를 보여 주는 스크린샷

    1. 설명 및 키 데이터를 입력한 다음 저장을 선택합니다.

    SSH 키를 만들기 위한 정보 대화 상자를 보여 주는 스크린샷

    1. 키를 다시 볼 수 없으므로 키를 복사하여 안전한 장소에 배치합니다.

  5. MSA(Microsoft 계정)의 이름을 바꿉니다. MSA 이름을 Microsoft Entra ID와 충돌하지 않는 다른 전자 메일로 바꿉니다. 이렇게 하면 계정 중에서 선택하라는 메시지가 표시되지 않습니다.

  6. (선택 사항) VS(Visual Studio) 구독을 조정합니다. 조직 내에서 사용되는 UPN이 변경된 경우 Visual Studio 구독을 조정합니다. 구독을 새 UPN에 다시 할당하거나 해당 UPN을 구독 내의 대체 계정으로 설정할 수 있습니다. 자세한 내용은 구독에 대체 계정을 추가하는 방법을 참조하세요.