# 엔터프라이즈에 GitHub 앱 설치

엔터프라이즈에 설치 GitHub Apps 하여 엔터프라이즈 계정을 관리하고 엔터프라이즈 수준 작업을 수행할 수 있습니다.

> \[!NOTE]
> 엔터프라이즈에 설치된 GitHub Apps는 공개 미리 보기 상태이며 변경될 수 있습니다.

## 엔터프라이즈에 GitHub Apps 설치 정보

엔터프라이즈 설치 GitHub Apps 는 엔터프라이즈 수준 권한을 요청하고 엔터프라이즈 계정에서 작업을 수행할 수 있는 앱입니다. 조직 또는 사용자 설치와 달리 조직 또는 리포지토리 권한에 액세스할 수 없으며 엔터프라이즈 자체만 관리합니다.

엔터프라이즈 소유자가 엔터프라이즈에 A GitHub App 를 설치하면 앱에 요청한 엔터프라이즈 권한이 부여됩니다. 이러한 권한을 통해 앱은 엔터프라이즈에서 조직 만들기, 조직 전반에 애플리케이션 설치, SCIM 프로비전 관리 등의 작업을 수행할 수 있습니다.

## 엔터프라이즈에 A GitHub App 를 설치하기 위한 요구 사항

GitHub App 엔터프라이즈 수준 권한을 요청해야 합니다. 다른 사용 권한도 요청할 수 있지만 설치하는 동안에는 엔터프라이즈 권한만 부여됩니다.

앱은 엔터프라이즈, 엔터프라이즈 내 조직 또는 타사 개발자가 소유할 수 있습니다. 타사에서 퍼블릭 앱을 설치하려면 앱 개발자가 제공하는 설치 링크를 사용합니다. 엔터프라이즈 외부의 계정에서 소유한 프라이빗 앱을 설치할 수 없습니다.

> \[!NOTE]
> 기업 전체에 타사 앱을 설치하는 한 가지 예외가 있습니다. 앱이 "엔터프라이즈 조직 설치" 권한을 요청하는 경우 앱을 소유한 엔터프라이즈에만 설치할 수 있습니다. 이 앱이 엔터프라이즈 외부에 있는 경우 엔터프라이즈에 설치할 수 없습니다. EMU 엔터프라이즈 및 GHES에서 엔터프라이즈의 사용자는 엔터프라이즈 내에 있는 것으로 간주하므로 엔터프라이즈에 앱을 설치할 수 있습니다.

## 귀사의 엔터프라이즈에 GitHub App 설치

엔터프라이즈에 앱을 설치하려면 설치 페이지로 GitHub App 이동합니다. 앱 개발자가 설치 링크로 제공할 수도 있고, 앱 등록 시 찾을 수도 있습니다. URL은 다음과 같이 표시됩니다. 여기서 `http(s)://HOSTNAME/apps/APP-NAME/installations/new``APP-NAME`이름은 다음과 같습니다GitHub App.

앱을 설치할 수 있는 경우, 설치 가능한 위치 목록에 엔터프라이즈가 포함됩니다. 앱을 설치할 엔터프라이즈를 선택할 수 있습니다.

설치가 완료되면, 해당 앱은 사용자의 엔터프라이즈에 대한 설치 토큰을 생성하거나 엔터프라이즈 구성원을 로그인시켜 엔터프라이즈 수준에서 구성원을 대신해 작업을 수행할 수 있습니다. 사용자를 대신하여 작업하려면 사용자가 엔터프라이즈 내에서 원하는 작업을 수행할 수 있어야 합니다. 예를 들어, 앱에서 사용자를 엔터프라이즈에 초대해야 하는 경우 사용자에게도 엔터프라이즈에 구성원을 초대할 수 있는 권한이 있어야 합니다.

## 엔터프라이즈에 설치된 앱이 수행할 수 있는 기능

엔터프라이즈에 설치된 GitHub Apps는 모든 엔터프라이즈 API를 호출할 수 없지만, 이미 여러 API가 GitHub Apps를 지원하도록 업데이트되었습니다. 이러한 API 및 GraphQL 변형에는 다음이 포함됩니다.

* [엔터프라이즈에서 조직 나열 및 만들기](/ko/enterprise-server@3.22/graphql/reference/enterprise-admin#mutation-createenterpriseorganization)
* [엔터프라이즈에서 사용자 관리](/ko/enterprise-server@3.22/graphql/reference/enterprise-admin#object-enterprise)
* 조직에서 GitHub App 설치를 생성하고 관리하기
* 엔터프라이즈 사용자 지정 리포지토리 속성 관리
* 엔터프라이즈 SCIM API 호출

새 API에 대한 업데이트 및 사용 권한에 대한 [변경 로그](https://github.blog/changelog/) 를 GitHub Apps확인합니다.

사용 가능한 권한 및 API 엔드포인트에 대한 자세한 내용은 [GitHub 앱에 필요한 권한](/ko/enterprise-server@3.22/rest/authentication/permissions-required-for-github-apps)을(를) 참조하세요.

## 현재 제한 사항

엔터프라이즈에 설치된 GitHub Apps는 현재 공개 미리 보기 상태이며, 다음과 같은 제한 사항이 있습니다.

### API 지원

아직 모든 API가 엔터프라이즈에 설치된 GitHub Apps를 지원하는 것은 아닙니다. 더 많은 권한이 구축되고 API가 업데이트됨에 따라 지원 범위가 더 광범위해집니다. 엔터프라이즈 설치 GitHub Apps를 지원하는 API 및 권한에 대한 자세한 내용은 [GitHub 앱에 필요한 권한](/ko/enterprise-server@3.22/rest/authentication/permissions-required-for-github-apps)을 참조하세요.

### 웹후크 지원

엔터프라이즈 설치에서는 현재 웹후크를 지원하지 않습니다. 엔터프라이즈 수준에 설치된 앱은 엔터프라이즈 수준 활동에 대한 웹후크 이벤트를 받을 수 없습니다. 리소스의 웹후크 이벤트를 수신하려면 조직이나 리포지토리에 설치하세요.

### 조직 액세스

엔터프라이즈 설치에는 조직 설치 API를 제외하고 엔터프라이즈 내의 조직 또는 리포지토리에 대한 액세스 권한이 부여되지 않습니다. 조직 또는 리포지토리 리소스에 액세스하려면 액세스가 필요한 각 조직에 앱을 별도로 설치해야 합니다.

많은 조직에서 동일한 앱을 설치해야 하는 경우 API를 사용하여 이를 자동화할 수 있습니다.
[엔터프라이즈 조직에서 앱 설치 자동화](/ko/enterprise-server@3.22/admin/managing-github-apps-for-your-enterprise/automate-installations)을(를) 참조하세요.

## 다음 단계

* 특정 조직에 앱 액세스 권한을 부여하려면 해당 조직에 앱을 설치하세요. 자세한 내용은 [타사로부터 GitHub 앱 설치하기](/ko/enterprise-server@3.22/apps/using-github-apps/installing-a-github-app-from-a-third-party)을(를) 참조하세요.
* 조직에 설치된 앱을 관리하는 방법을 알아보세요. 자세한 내용은 [설치된 GitHub 앱 검토 및 수정](/ko/enterprise-server@3.22/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)을(를) 참조하세요.