Skip to main content
Skip to content

앱에 대한 Enterprise-Managed 권한 관리 정보

앱은 대화형 로그인 없이 IdP(ID 공급자) 자격 증명을 사용하여 GitHub로 Single Sign-On하여 로그인할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Enterprise admins can manage Enterprise-Managed Authorization.

참고

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를 사용해야 합니다.

  1. 귀하의 기업으로 이동하세요. 예를 들어 GitHub.com의 Enterprises 페이지에서.
  2. 페이지 맨 위에서 ID 공급자를 클릭합니다.
  3. Single sign-on 섹션에서 Enterprise-Managed 권한 부여를 선택합니다.
  4. 기본 액세스 정책을 활성화 또는 비활성화로 설정합니다.
  5. 엔터프라이즈 팀, 사용자 또는 역할에 대해 선택적으로 EMA를 사용하거나 사용하지 않도록 설정하려면 재정의 추가 를 선택하고 다른 결과를 받아야 하는 대상을 선택합니다. 그런 다음 재정의에 대한 정책을 사용 또는 사용 안 함으로 설정합니다.

사용자에게 여러 재정의가 적용되는 경우(예: 재정의가 있는 서로 다른 두 팀에 속하고 직접 하나의 대상을 지정하기 때문에) 다음 논리가 적용됩니다.

  1. 사용자가 재정의로 직접 대상이 되면 해당 결과가 적용됩니다.
  2. 재정의가 사용자를 직접 대상으로 하지 않는다고 가정하면 기능을 사용하지 않도록 설정하는 적용 가능한 재정의가 적용되며 사용자는 EMA를 사용할 수 없습니다.
  3. 적용 가능한 모든 재정의가 사용자에 대해 기능을 사용하도록 설정하면 사용자는 EMA를 사용할 수 있습니다.
  4. 마지막으로 재정의가 적용되지 않으면 기본 정책이 적용됩니다.

지원되는 애플리케이션

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 사양을 참조하세요. 이 작업에 대한 업데이트에 대한 로드맵 항목 및 변경 로그 를 따를 수 있습니다.