팀에 대한 엔터프라이즈 관리 설정 재정의

특정 팀에 대한 기본 설정을 재정의하여 지나치게 제한적인 구성을 방지합니다.

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

Enterprise owners

이 기사에서

서버 관리형 배포를 사용하면 엔터프라이즈 팀 멤버 자격에 따라 사용자 그룹에 다른 거버넌스 설정을 적용하도록 엔터프라이즈 managed-settings.json 파일을 구성할 수 있습니다. 엔터프라이즈는 중앙 위치의 모든 설정을 정의하고 팀 멤버 자격은 지정된 값 집합을 받는 사용자를 결정합니다. 파일을 아직 만들지 않은 경우 엔터프라이즈 관리 설정 시작을 managed-settings.json 참조하세요.

키를 팀 재정의에 사용할 수 있도록 하려면 managed-settings.json에서 overridable로 표시합니다. 재정의 가능한 키는 팀에 값이 설정되어 있으면 해당 값을 사용하고, 팀에서 값을 설정하지 않으면 귀사의 엔터프라이즈 기본값을 사용합니다.

지원되는 키

구문은 { "overridable": <VALUE> } ,, permissions.deny``permissions.disableBypassPermissionsMode, permissions.allow``permissions.ask``allowedMcpServers, 및 deniedMcpServers 키에 적용됩니다.model

enabledPlugins와 extraKnownMarketplaces는 가산적으로 작동합니다. 엔터프라이즈 managed-settings.json 는 기준을 설정하고 엔터프라이즈 팀 파일은 플러그 인과 마켓플레이스를 더 추가할 수 있습니다.

이러한 키 및 해당 구문에 대한 전체 설명은 엔터프라이즈 관리 설정을 참조하세요.

특정 팀에 대한 설정 재정의

이러한 지침은 서버 관리형 배포(managed-settings.json가 GitHub에 호스팅되는 경우)에 적용됩니다. 다른 배포 방법은 엔터프라이즈 팀 재정의를 지원하지 않으며 MDM 플랫폼을 통해 다른 사용자 그룹에 다른 설정을 배포해야 합니다.

copilot/team-mappings.json 및 copilot/teams/ 디렉터리를 사용하여 기본 copilot/managed-settings.json 값과 다른 설정을 사용할 엔터프라이즈 팀을 구성합니다.

이 섹션 .github-private 을 완료하면 리포지토리의 구조는 다음과 같습니다.

  • .github-private/
    • copilot/

managed-settings.json **: { "model": { "overridable": "auto" } } * ** team-mappings.json **: { "no-auto.json": ["special-team"] } * teams/ * ** no-auto.json **: { "model": "unmanaged" }

단계

  1. 기업의 copilot/managed-settings.json 파일에서 재정의할 수 있도록 하려는 각 키를 { "overridable": <VALUE> } 구문을 사용하여 표시하세요. 팀에 매핑한 json 파일은 재정의할 수 있도록 표시한 키에 대해서만 다른 값을 보낼 수 있습니다.

overridable 팀 파일이 지정된 키에 managed-settings.json 대해 다른 값을 선언하지 않는 경우 제공하는 값은 기본값입니다.

예를 들어, model, disableBypassPermissionsMode, allowedMcpServers를 팀으로 미루려면:

```json
{
  "model": { "overridable": "auto" },
  "permissions": {
    "disableBypassPermissionsMode": { "overridable": "disable" }
  },
  "allowedMcpServers": {
    "overridable": [
      { "serverUrl": "https://mcp.company.com/*" }
    ]
  }
}
```

  1. 엔터프라이즈의 .github-private 리포지토리에서 copilot/team-mappings.json을 만드세요. 각 팀 설정 파일을 하나 이상의 엔터프라이즈 팀 슬러그에 매핑합니다. 키는 설정 파일 이름이며 값은 팀 슬러그 배열이므로 여러 팀에 하나의 파일을 적용할 수 있습니다.

    {
  "devs.json": ["developers-all", "finops-dev"],
  "ai-users.json": ["ai-baseline-trained"],
  "frontier.json": ["ai-pioneers"]
}

  2. copilot/teams/ 아래에 팀 설정 파일을 만듭니다. 재정의 가능으로 표시된 모든 키와 추가 키 enabledPlugins 및 extraKnownMarketplaces를 포함할 수 있습니다. 다른 모든 키는 엔터프라이즈 기본값에 따라 관리됩니다.

    {
  "model": "unmanaged",
  "permissions": {
    "disableBypassPermissionsMode": "unmanaged"
  },
  "allowedMcpServers": [
    { "serverUrl": "https://team-specific-mcp.company.com/*" }
  ]
}

  3. 변경 내용을 커밋하고 기본 분기로 푸시합니다.

GitHub 는 엔터프라이즈 팀 멤버 자격을 평가하고 각 사용자에 대해 일치하는 설정을 적용합니다. 사용자가 여러 팀에 속한 경우 팀 파일은 각 키에 대해 가장 제한적인 값을 사용하여 결합된 다음, 플랫폼 결정이 항상 적용되는 엔터프라이즈 설정 아래에 적용됩니다.