참고
Enterprise-Managed Authorization은 공개 미리 보기 상태이며 변경될 수 있습니다. 선택한 앱만 EMA를 사용할 수 있으며 OIDC 기반 Enterprise Managed Users에서만 사용할 수 있습니다. 엔터프라이즈에서 EMA를 사용하려면 GitHub 및 Microsoft Entra 둘 다에서 이를 사용하도록 설정해야 합니다.
EMA(Enterprise-Managed 권한 부여)는 사용자가 리소스에 직접 로그인하도록 요구하는 대신 앱이 IdP 로그인을 사용하여 리소스에 액세스할 수 있도록 하는 새로운 ID 표준 입니다. EMA는 사용 중인 플랫폼에 따라 ID JAG, XAA(앱 간 액세스) 또는 에이전트 SSO라고도 합니다. MCP 에코시스템에서 가장 인기가 있지만 페더레이션된 설정에 유용합니다.
EMA의 이점은 개발자와 관리자 모두에게 적용됩니다.
- 개발자는 호환되는 클라이언트에서 GitHub에 더 쉽게 액세스할 수 있습니다. MCP JSON을 구성하거나 별도의 OAuth 흐름을 완료할 필요가 없습니다.
- 관리자는 앱과 GitHub 간의 액세스를 보고 제어하여 추가 보안 및 감사 지원을 제공합니다.
- 클라이언트 앱은 수명이 긴 OAuth 앱 토큰 또는 personal access tokens 대신 수명이 짧은 회전 토큰을 받습니다.
엔터프라이즈에서 Enterprise-Managed Authorization 권한 부여 사용
사용자가 EMA를 사용하려면 엔터프라이즈에서 사용하도록 설정해야 합니다. 사용하도록 설정하면 사용자는 Copilot CLI에 대해 OAuth 로그인을 수행하는 대신 Microsoft Entra에 로그인한 후 VS Code 및 GitHub에서 GitHub에 액세스할 수 있습니다. 귀사의 엔터프라이즈는 OpenID Connect(OIDC) 단일 로그인과 함께 Enterprise Managed Users를 사용해야 합니다.
- 귀하의 기업으로 이동하세요. 예를 들어 GitHub.com의 Enterprises 페이지에서.
- 페이지 맨 위에서 ID 공급자를 클릭합니다.
- Single sign-on 섹션에서 Enterprise-Managed 권한 부여를 선택합니다.
- 기본 액세스 정책을 활성화 또는 비활성화로 설정합니다.
- 엔터프라이즈 팀, 사용자 또는 역할에 대해 선택적으로 EMA를 사용하거나 사용하지 않도록 설정하려면 재정의 추가 를 선택하고 다른 결과를 받아야 하는 대상을 선택합니다. 그런 다음 재정의에 대한 정책을 사용 또는 사용 안 함으로 설정합니다.
사용자에게 여러 재정의가 적용되는 경우(예: 재정의가 있는 서로 다른 두 팀에 속하고 직접 하나의 대상을 지정하기 때문에) 다음 논리가 적용됩니다.
- 사용자가 재정의로 직접 대상이 되면 해당 결과가 적용됩니다.
- 재정의가 사용자를 직접 대상으로 하지 않는다고 가정하면 기능을 사용하지 않도록 설정하는 적용 가능한 재정의가 적용되며 사용자는 EMA를 사용할 수 없습니다.
- 적용 가능한 모든 재정의가 사용자에 대해 기능을 사용하도록 설정하면 사용자는 EMA를 사용할 수 있습니다.
- 마지막으로 재정의가 적용되지 않으면 기본 정책이 적용됩니다.
지원되는 애플리케이션
Copilot CLI 및 GitHub은(는) VS Code와 함께 EMA를 지원합니다. 각 앱의 최신 버전은 EMA를 지원하지만 앱에서 기능을 사용하도록 설정하려면 구성이 필요할 수 있습니다. 두 앱 모두 연결을 GitHub허용하려면 Microsoft Entra 구성이 필요합니다.
Microsoft Entra 내에서 로그인 사용
앱 GitHub과 Microsoft Entra 내에서 SSO를 사용하도록 설정하려면 클라이언트 애플리케이션(VS Code 또는 Copilot CLI)이 테넌트에 있고 GitHub Enterprise Managed User (OIDC) 애플리케이션에 액세스할 수 있도록 허용되는지 확인해야 합니다.
테넌트 관리자는 연결을 지원하기 위해 각 애플리케이션에 대한 관리자 동의를 제공해야 합니다.
<TENANT_IDENTIFIER> 대신 테넌트 ID 또는 도메인 이름을 사용하여 각 URL을 방문하여 GitHub에 대한 애플리케이션의 액세스를 승인합니다.
- VS Code의 경우:
https://login.microsoftonline.com/<TENANT_IDENTIFIER>/v2.0/adminconsent?client_id=aebc6443-996d-45c2-90f0-388ff96faa56&scope=12f6db80-0741-4a7e-b9c5-b85d737b3a31/user_impersonation - Copilot CLI의 경우:
https://login.microsoftonline.com/<TENANT_IDENTIFIER>/v2.0/adminconsent?client_id=5ecc71bb-0fa6-4d6b-a31b-de12184c4b1a&scope=12f6db80-0741-4a7e-b9c5-b85d737b3a31/user_impersonation
12f6db80-0741-4a7e-b9c5-b85d737b3a31 범위 쿼리 매개 변수에 포함된 GUID는 GitHub Enterprise Managed User (OIDC) 애플리케이션의 애플리케이션 ID입니다.
user_impersonation 는 사용자로 로그인 중임을 나타내는 표준 범위입니다.
GitHub 내에서는 애플리케이션의 권한은 계속 적용되며 작업은 여전히 애플리케이션에 기인합니다.
관리자 동의 흐름을 거치면 매번 두 가지 승인을 요청받습니다. 한 번은 클라이언트 애플리케이션이 SPN-GITHUB_MANAGED_USER_OIDC에 액세스하는 것에 대한 승인(동의 대화 상자에서는 GitHub라고 함)이고, 또 한 번은 GitHub가 사용자의 데이터에 액세스하는 것에 대한 승인입니다. 애플리케이션을 처음 승인했을 때 사용자 데이터 액세스 권한이 이미 부여되었습니다. 이는 모든 관련 애플리케이션에 대한 승인 프로세스를 실행하는 Entra일 뿐입니다.
Azure Portal에서 Entra 테넌트의 엔터프라이즈 앱 탭으로 이동하여 앱이 테넌트에서 생성되고 승인되었는지 확인할 수 있습니다. 해당 위치에서 애플리케이션 ID가 다음으로 시작 필터를 사용하여 각 애플리케이션을 이름 또는 애플리케이션 ID로 검색합니다. 애플리케이션 유형 필터를 제거하거나 앱이 표시되도록 Microsoft 애플리케이션으로 설정해야 합니다. 각 앱의 애플리케이션 ID는 다음과 같습니다.
- VS Code:
aebc6443-996d-45c2-90f0-388ff96faa56 - Copilot CLI:
5ecc71bb-0fa6-4d6b-a31b-de12184c4b1a
앱을 찾았으면 사용 권한 페이지를 보안 섹션에서 엽니다. 애플리케이션이 있고 GitHub에 대한 액세스 권한이 부여된 경우, 관리자 동의를 통해 부여된 GitHub Enterprise Managed User (OIDC) 및 **** 에 대한 항목이 테이블에 표시됩니다. 이 액세스를 제거하려면 항목 오른쪽에 있는 세 개의 점을 클릭하고 사용 권한 취소를 선택할 수 있습니다.
Copilot CLI
와 함께 Enterprise-Managed 권한 부여를 사용하려면 Copilot CLI을 참조하세요. EMA는 실행할 /login때 버전 1.0.113 이상에서 사용하도록 설정됩니다.
VS Code
버전 1.141.0VS Code부터 사용자는 Microsoft Entra 계정으로 로그인하는 옵션을 볼 수 있습니다. 이렇게 하면 Entra 계정이 OIDC 관리형 사용자 계정에 연결된 경우 GitHub 및 GitHub Copilot 자격에 즉시 액세스할 수 있습니다. Microsoft 옵션을 선택하면 VS Code Entra 계정에 SSO 로그인하기 위해 디바이스 내 브로커를 사용하여 로그인을 시도합니다. 로그인할 수 없는 경우 웹 브라우저를 통해 Entra에 로그인할 수 있습니다.
VS Code에서 Microsoft 인증 사용 설정
VS Code에 로그인하라는 메시지가 표시되면 Microsoft로 계속하기 옵션이 표시되지 않을 수 있습니다. 이는 VS Code 인스턴스에서 해당 기능이 비활성화되었거나, VS Code가 디바이스에서 기존 Microsoft Entra 계정을 감지하지 못했기 때문일 수 있습니다. 기능을 강제로 사용하도록 설정하려면 설정을 변경합니다.
이 기능은 세 가지 값 중 하나의 값을 가지는 chat.microsoftAuthentication.enabled 설정에 의해 제어됩니다.
| 값 | Behavior |
|---|---|
"auto" | 옵션을 표시하기 전에 Microsoft Entra 계정을 검색할 수 있는지 여부를 확인합니다. |
"always" | 항상 Microsoft 로그인 옵션을 표시합니다. |
"never" | Microsoft 로그인 옵션을 숨깁니다. |
예를 들어 항상 옵션을 표시하려면 settings.json에 다음을 추가합니다:
{
"chat.microsoftAuthentication.enabled": "always"
}
VS Code에서 settings.json를 찾고 여는 방법에 대한 도움말은 VS Code 설명서의 "사용자 및 작업 영역 설정"을 참조하세요.
버전 1.141.0의 기본값은 원격 분석 설정에 따라 달라집니다.
- 원격 분석이 활성화되어 있으므로 A/B 실험도 활성화된 경우 기본값은
"auto"입니다. - 원격 분석이 비활성화된 경우 기본값은
"never"입니다. 수동으로 옵트인하려면 값을"auto"또는"always"로 설정합니다.
이후 릴리스에서는 이 설정의 기본값이 "auto"로 설정됩니다.
다른 앱 및 IDP에 대한 EMA 지원
GitHub 에서는 Okta, Ping Claude및 Cursor를 포함하여 프로토콜을 구현하는 모든 범위의 클라이언트 애플리케이션 및 IdP에 대한 EMA 지원을 확장할 계획입니다. 관리형 사용자가 있는 엔터프라이즈가 이러한 IdP 중 하나를 사용하는 경우 호환되는 애플리케이션은 사용자를 대신해 GitHub에 액세스할 수 있습니다.
Enterprise-Managed 권한 부여에 대한 자세한 내용은 MCP 표준 설명서 및 ID JAG 사양을 참조하세요. 이 작업에 대한 업데이트에 대한 로드맵 항목 및 변경 로그 를 따를 수 있습니다.