GitHub Enterprise Cloud 리포지토리를 Azure SRE 에이전트에 연결

BYO(Bring Your Own) GitHub 앱을 사용하여 GitHub Enterprise Cloud(<TENANT>.ghe.com) 또는 github.com 호스팅되는 리포지토리를 Azure SRE 에이전트에 연결합니다. 에이전트는 Azure Key Vault 저장되고 복사되지 않는 앱의 프라이빗 키에서 단기 설치 토큰을 발행합니다.

BYO GitHub 앱 인증을 사용하는 경우

다음과 같은 경우 BYO 앱을 사용합니다.

• 조직에는 앱 기반 인증 및 키 양육권 제어가 필요합니다.
• *.ghe.com 리포지토리를 연결하고 있습니다(GHE 호스트에서는 OAuth 및 PAT를 사용할 수 없으므로 필요함).
• 사용자 토큰 대신 설치 토큰 기반 액세스를 원합니다.

사전 요구 사항

GitHub 앱 만들기

이미 올바른 권한이 있는 GitHub 앱이 있다면 Azure Key Vault에 개인 키 저장으로 이동하세요.

1. GitHub 호스트로 이동합니다.
   • github.com: 조직 >설정>개발자 설정>GitHub 앱>새 GitHub 앱으로 이동합니다
   • <TENANT>.ghe.com: GHE 인스턴스에서 동일한 경로
2. 앱 세부 정보를 입력합니다.
   • GitHub 앱 이름: 예: sre-agent-reader
   • 홈페이지 URL: https://sre.azure.com
   • 웹후크: 활성 선택 취소(에이전트가 웹후크를 사용하지 않음)
3. 사용 권한에서 다음을 설정합니다.
   • 리포지토리 권한 > 내용: 읽기 전용 (필수)
   • 리포지토리 권한 > 메타데이터: 읽기 전용 (자동 선택)
   • 선택적으로 Issues 및 Pull requests 읽기 권한을 추가합니다
4. 이 GitHub 앱을 설치할 수 있는 위치는 어디인가요? 아래에서 이 계정에서만을 선택합니다.
5. GitHub 앱 만들기를 선택합니다.
6. 앱 설정 페이지에 표시된 클라이언트 ID 를 확인합니다.

GitHub 앱 설치

1. GitHub 앱 설정 페이지의 왼쪽 사이드바에서 앱 설치를 선택합니다.
2. 조직을 선택합니다.
3. 모든 리포지토리를 선택하거나 특정 리포지토리를 선택합니다.
4. 설치를 선택합니다.

GitHub 앱 프라이빗 키 생성

1. GitHub 앱 설정 페이지에서 Private keys까지 스크롤합니다.
2. 프라이빗 키 생성을 선택합니다.
3. .pem 파일이 다운로드됩니다. 이 파일은 에이전트가 인증하는 데 사용하는 RSA 프라이빗 키입니다.

프라이빗 키를 Azure Key Vault 저장

1. Azure 포털 열고 Key Vault 이동합니다.
2. 비밀>생성/가져오기로 이동합니다.
3. 이름(예: sre-agent-github-app-key)을 설정하고 전체 PEM 콘텐츠를 값(포함 -----BEGIN RSA PRIVATE KEY----- 및 -----END RSA PRIVATE KEY----- 헤더)으로 붙여넣습니다.
4. Create를 선택합니다.
5. 비밀을 열고, 현재 버전을 선택하고, 비밀 식별자 URI를 복사합니다.

https://myvault.vault.azure.net/secrets/my-github-app-key/<VERSION>

에이전트 ID에 대한 Key Vault 액세스 권한 부여

1. Azure 포털에서 Key Vault>AAM(액세스 제어) 엽니다.
2. 에이전트 관리 ID에 Key Vault 비밀 사용자 할당합니다.
3. 역할 할당이 적용되기를 기다립니다.

코드 액세스에서 BYO 앱 구성

1. 포털에서 에이전트를 엽니다.
2. 작성기>코드 액세스로 이동합니다.
3. 리포지토리 추가를 선택합니다.
4. GitHub 선택하고 호스트를 입력합니다.
   • github.com 공개 GitHub용
   • <TENANT>.ghe.com 엔터프라이즈 클라우드용
5. 인증을 계속 합니다.
6. 자체 GitHub 앱 사용을 선택합니다.
7. 입력
   • 클라이언트 ID
   • 프라이빗 키 비밀 URI (Key Vault)
   • 선택적 Key Vault ID(또는 시스템 할당 유지)
8. 연결을 선택합니다.

마법사에서 자격 증명의 유효성을 검사합니다. 성공하면 GitHub 앱으로 연결됨 녹색 확인 표시가 표시됩니다.

리포지토리 추가 및 연결 확인

1. 리포지토리를 선택하고 저장합니다.
2. 코드 액세스 카드에 연결된 호스트 및 인증 유형 GitHubApp이 표시되는지 확인합니다.
3. 채팅에서 테스트:

Get me recent issues from owner/repo.

여러 GitHub 앱에 대한 앱별 관리 ID

기본적으로 에이전트는 system 할당 관리 ID를 사용하여 Key Vault 프라이빗 키를 읽습니다. 여러 GitHub 앱을 관리하는 경우(예: GHE 인스턴스당 하나씩) 각 앱에 다른 사용자 할당 관리 ID 할당할 수 있습니다. 이 방법은 각 ID가 고유한 Key Vault 비밀에만 액세스할 수 있기 때문에 보안 격리를 제공합니다.

구성 단계 중 Key Vault ID 드롭다운에서 ID를 선택합니다.

GitHub 연결에 대한 다중 호스트 지원

여러 GitHub 호스트를 동일한 에이전트에 연결할 수 있습니다. 각 호스트에는 독립적인 인증이 있습니다.

• github.com OAuth, PAT 또는 BYO 앱 →
• contoso.ghe.com BYO 앱 →
• engineering.ghe.com → BYO 앱(다른 GitHub 앱 사용)

한 호스트의 연결을 끊는 것은 다른 호스트에 영향을 주지 않습니다.

Troubleshooting

다음 단계:

관련 콘텐츠

• GitHub 커넥터
• GitHub 커넥터(OAuth 또는 PAT)
• MCP 커넥터 설정