엔터프라이즈 계정에서 GitHub App을(를) 만들 수 있습니다. 이 앱은 엔터프라이즈 내 엔터프라이즈 또는 조직에만 설치할 수 있으며 엔터프라이즈 구성원만 권한을 부여할 수 있습니다. 이 앱은 사용자 계정에 설치할 수 없습니다.
1단계: GitHub App 등록하기
GitHub App을(를) 만들려면 먼저 앱을 등록해야 합니다. GitHub 앱 등록을(를) 참조하세요.
앱은 구성원이나 조직으로부터 엔터프라이즈로 이전될 수도 있습니다. 앱을 전송하려면 GitHub 앱의 소유권 이전을(를) 참조하세요.
1a단계: 엔터프라이즈 앱 관리자 추가
엔터프라이즈 소유자는 앱 관리자로서 앱에 엔터프라이즈 구성원을 추가할 수 있습니다. 앱 관리자는 앱의 설정 및 자격 증명을 관리할 수 있지만 앱을 설치할 수는 없습니다. 자세한 내용은 GitHub 앱 관리자 정보을(를) 참조하세요.
2단계: GitHub App 빌드하기
GitHub App을(를) 등록한 후에는 GitHub App이(가) 작업을 수행하도록 코드를 작성해야 합니다. 코드 작성 방법을 보여 주는 예시는 다음을 참조하세요.
- GitHub 앱 빌드에 대한 빠른 시작
- 웹후크 이벤트에 응답하는 GitHub 앱 빌드
- GitHub 앱을 사용하여 "GitHub로 로그인" 단추 빌드
- GitHub 앱을 사용하여 CLI 빌드
- GitHub Actions 워크플로에서 GitHub 앱을 사용하여 인증된 API 요청 만들기
모범 사례를 따르는 것을 목표로 해야 합니다. GitHub App을 만드는 모범 사례을(를) 참조하세요.
3단계: GitHub App 권한 부여 또는 설치
GitHub App이 등록되면 앱의 용도에 따라 인증 또는 설치를 통해 사용할 수 있도록 해야 합니다.
엔터프라이즈 소유자 및 앱 관리자는 언제든지 해당 엔터프라이즈가 소유한 앱의 권한을 수정할 수 있습니다. 해당 변경 내용은 엔터프라이즈 내 조직에서 자동으로 승인됩니다(권한 변경이 엔터프라이즈 소유자에 의해 이루어진 경우). 그 외의 경우, 앱 관리자가 조직 소유자인 경우에만 변경 내용이 승인되며 다른 모든 조직에서는 조직 소유자가 업데이트 요청을 수락해야 합니다.
3a 단계: _apps %} 권한 부여
Copilot 확장 프로그램과 같은 일부 GitHub Apps은(는) 인증이 필요하지만 조직에 설치할 필요는 없습니다. 엔터프라이즈 사용자는 앱이 조직 내 리소스에 액세스할 수 있도록 앱에 권한을 부여할 수 있습니다. 그러나 앱은 설치된 GitHub 리소스에만 액세스할 수 있습니다. GitHub 앱에 권한 부여을(를) 참조하세요.
3b 단계: 설치 링크를 통해 GitHub App 공유
작동하려면 설치가 필요한 앱의 경우 조직 소유자 설치 링크를 제공할 수 있습니다. 앱이 설치되면 조직의 리소스에 액세스할 수 있습니다. GitHub 앱 공유을(를) 참조하세요.
4단계: GitHub App 설치(필요한 경우)
GitHub App에서 권한 부여뿐만 아니라 설치가 필요한 경우 조직 소유자 설치 링크를 사용하여 조직에 앱을 설치할 수 있습니다. 타사에서 GitHub 앱 설치을(를) 참조하세요.
앱에서 엔터프라이즈 권한을 사용하는 경우, 엔터프라이즈에 설치할 수 있습니다. 설치 링크를 찾으려면 엔터프라이즈 계정의 앱 설정 페이지로 이동합니다. 엔터프라이즈에 GitHub 앱 설치을(를) 참조하세요.