Skip to main content

엔터프라이즈를 위한 GitHub 앱 만들기

엔터프라이즈를 위한 GitHub App을 만드는 방법을 알아보세요.

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

Enterprise owners.

엔터프라이즈 계정에서 GitHub App을(를) 만들 수 있습니다. 이 앱은 엔터프라이즈 내 엔터프라이즈 또는 조직에만 설치할 수 있으며 엔터프라이즈 구성원만 권한을 부여할 수 있습니다. 이 앱은 사용자 계정에 설치할 수 없습니다.

1단계: GitHub App 등록하기

GitHub App을(를) 만들려면 먼저 앱을 등록해야 합니다. GitHub 앱 등록을(를) 참조하세요.

앱은 구성원이나 조직으로부터 엔터프라이즈로 이전될 수도 있습니다. 앱을 전송하려면 GitHub 앱의 소유권 이전을(를) 참조하세요.

1a단계: 엔터프라이즈 앱 관리자 추가

엔터프라이즈 소유자는 앱 관리자로서 앱에 엔터프라이즈 구성원을 추가할 수 있습니다. 앱 관리자는 앱의 설정 및 자격 증명을 관리할 수 있지만 앱을 설치할 수는 없습니다. 자세한 내용은 GitHub 앱 관리자 정보을(를) 참조하세요.

2단계: GitHub App 빌드하기

GitHub App을(를) 등록한 후에는 GitHub App이(가) 작업을 수행하도록 코드를 작성해야 합니다. 코드 작성 방법을 보여 주는 예시는 다음을 참조하세요.

모범 사례를 따르는 것을 목표로 해야 합니다. 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 앱 설치을(를) 참조하세요.