{"meta":{"title":"엔터프라이즈에 GitHub 앱 설치","intro":"엔터프라이즈에 설치 GitHub Apps 하여 엔터프라이즈 계정을 관리하고 엔터프라이즈 수준 작업을 수행할 수 있습니다.","product":"앱","breadcrumbs":[{"href":"/ko/enterprise-cloud@latest/apps","title":"앱"},{"href":"/ko/enterprise-cloud@latest/apps/using-github-apps","title":"GitHub Apps 사용"},{"href":"/ko/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-on-your-enterprise","title":"엔터프라이즈에 앱 설치"}],"documentType":"article"},"body":"# 엔터프라이즈에 GitHub 앱 설치\n\n엔터프라이즈에 설치 GitHub Apps 하여 엔터프라이즈 계정을 관리하고 엔터프라이즈 수준 작업을 수행할 수 있습니다.\n\n> \\[!NOTE]\n> 엔터프라이즈에 설치된 GitHub Apps는 공개 미리 보기 상태이며 변경될 수 있습니다.\n\n## 엔터프라이즈에 GitHub Apps 설치 정보\n\n엔터프라이즈 설치 GitHub Apps 는 엔터프라이즈 수준 권한을 요청하고 엔터프라이즈 계정에서 작업을 수행할 수 있는 앱입니다. 조직 또는 사용자 설치와 달리 조직 또는 리포지토리 권한에 액세스할 수 없으며 엔터프라이즈 자체만 관리합니다.\n\n엔터프라이즈 소유자가 엔터프라이즈에 A GitHub App 를 설치하면 앱에 요청한 엔터프라이즈 권한이 부여됩니다. 이러한 권한을 통해 앱은 엔터프라이즈에서 조직 만들기, 조직 전반에 애플리케이션 설치, SCIM 프로비전 관리 등의 작업을 수행할 수 있습니다.\n\n## 엔터프라이즈에 A GitHub App 를 설치하기 위한 요구 사항\n\nGitHub App 엔터프라이즈 수준 권한을 요청해야 합니다. 다른 사용 권한도 요청할 수 있지만 설치하는 동안에는 엔터프라이즈 권한만 부여됩니다.\n\n앱은 엔터프라이즈, 엔터프라이즈 내 조직 또는 타사 개발자가 소유할 수 있습니다. 타사에서 퍼블릭 앱을 설치하려면 앱 개발자가 제공하는 설치 링크를 사용합니다. 엔터프라이즈 외부의 계정에서 소유한 프라이빗 앱을 설치할 수 없습니다.\n\n> \\[!NOTE]\n> 기업 전체에 타사 앱을 설치하는 한 가지 예외가 있습니다. 앱이 \"엔터프라이즈 조직 설치\" 권한을 요청하는 경우 앱을 소유한 엔터프라이즈에만 설치할 수 있습니다. 이 앱이 엔터프라이즈 외부에 있는 경우 엔터프라이즈에 설치할 수 없습니다. EMU 엔터프라이즈 및 GHES에서 엔터프라이즈의 사용자는 엔터프라이즈 내에 있는 것으로 간주하므로 엔터프라이즈에 앱을 설치할 수 있습니다.\n\n## 귀사의 엔터프라이즈에 GitHub App 설치\n\n엔터프라이즈에 앱을 설치하려면 설치 페이지로 GitHub App 이동합니다. 앱 개발자가 설치 링크로 제공할 수도 있고, 앱 등록 시 찾을 수도 있습니다. URL은 다음과 같이 표시됩니다. 여기서 `https://github.com/apps/APP-NAME/installations/new``APP-NAME`이름은 다음과 같습니다GitHub App.\n\n앱을 설치할 수 있는 경우, 설치 가능한 위치 목록에 엔터프라이즈가 포함됩니다. 앱을 설치할 엔터프라이즈를 선택할 수 있습니다.\n\n설치가 완료되면, 해당 앱은 사용자의 엔터프라이즈에 대한 설치 토큰을 생성하거나 엔터프라이즈 구성원을 로그인시켜 엔터프라이즈 수준에서 구성원을 대신해 작업을 수행할 수 있습니다. 사용자를 대신하여 작업하려면 사용자가 엔터프라이즈 내에서 원하는 작업을 수행할 수 있어야 합니다. 예를 들어, 앱에서 사용자를 엔터프라이즈에 초대해야 하는 경우 사용자에게도 엔터프라이즈에 구성원을 초대할 수 있는 권한이 있어야 합니다.\n\n## 엔터프라이즈에 설치된 앱이 수행할 수 있는 기능\n\n엔터프라이즈에 설치된 GitHub Apps는 모든 엔터프라이즈 API를 호출할 수 없지만, 이미 여러 API가 GitHub Apps를 지원하도록 업데이트되었습니다. 이러한 API 및 GraphQL 변형에는 다음이 포함됩니다.\n\n* [엔터프라이즈에서 조직 나열 및 만들기](/ko/enterprise-cloud@latest/graphql/reference/enterprise-admin#mutation-createenterpriseorganization)\n* [엔터프라이즈에서 사용자 관리](/ko/enterprise-cloud@latest/graphql/reference/enterprise-admin#object-enterprise)\n* 조직에서 GitHub App 설치를 생성하고 관리하기\n* 엔터프라이즈 사용자 지정 리포지토리 속성 관리\n* 예산, 비용 센터 및 사용 현황 보고서를 포함하여 엔터프라이즈 청구를 관리합니다. 자세한 내용은 [청구에 대한 REST API 엔드포인트](/ko/enterprise-cloud@latest/rest/billing)을(를) 참조하세요.\n* 엔터프라이즈 SCIM API 호출\n\n새 API에 대한 업데이트 및 사용 권한에 대한 [변경 로그](https://github.blog/changelog/) 를 GitHub Apps확인합니다.\n\n사용 가능한 권한 및 API 엔드포인트에 대한 자세한 내용은 [GitHub 앱에 필요한 권한](/ko/enterprise-cloud@latest/rest/authentication/permissions-required-for-github-apps)을(를) 참조하세요.\n\n## 엔터프라이즈 설치용 속도 제한 GitHub Apps\n\n엔터프라이즈에 설치된 GitHub Apps의 설치 토큰에는 GitHub Enterprise Cloud 조직과 동일한 속도 제한이 적용됩니다. 속도 제한은 설치별로 적용됩니다. 예를 들어, 어떤 앱이 하나의 엔터프라이즈와 두 개의 조직에 설치되어 있다면, 이 앱은 각각의 리소스에 액세스하기 위해 3개의 설치 토큰이 필요하며, 각 설치에 대해 독립적인 속도 제한 할당량을 갖습니다. 자세한 내용은 [REST API에 대한 트래픽률 제한](/ko/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api) 및 [GraphQL API에 대한 속도 제한 및 쿼리 제한](/ko/enterprise-cloud@latest/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api)을(를) 참조하세요.\n\n## 현재 제한 사항\n\n엔터프라이즈에 설치된 GitHub Apps는 현재 공개 미리 보기 상태이며, 다음과 같은 제한 사항이 있습니다.\n\n### API 지원\n\n아직 모든 API가 엔터프라이즈에 설치된 GitHub Apps를 지원하는 것은 아닙니다. 더 많은 권한이 구축되고 API가 업데이트됨에 따라 지원 범위가 더 광범위해집니다. 엔터프라이즈 설치 GitHub Apps를 지원하는 API 및 권한에 대한 자세한 내용은 [GitHub 앱에 필요한 권한](/ko/enterprise-cloud@latest/rest/authentication/permissions-required-for-github-apps)을 참조하세요.\n\n### 웹후크 지원\n\n엔터프라이즈 설치에서는 현재 웹후크를 지원하지 않습니다. 엔터프라이즈 수준에 설치된 앱은 엔터프라이즈 수준 활동에 대한 웹후크 이벤트를 받을 수 없습니다. 리소스의 웹후크 이벤트를 수신하려면 조직이나 리포지토리에 설치하세요.\n\n### 조직 액세스\n\n엔터프라이즈 설치에는 조직 설치 API를 제외하고 엔터프라이즈 내의 조직 또는 리포지토리에 대한 액세스 권한이 부여되지 않습니다. 조직 또는 리포지토리 리소스에 액세스하려면 액세스가 필요한 각 조직에 앱을 별도로 설치해야 합니다.\n\n많은 조직에서 동일한 앱을 설치해야 하는 경우 API를 사용하여 이를 자동화할 수 있습니다.\n[엔터프라이즈 조직에서 앱 설치 자동화](/ko/enterprise-cloud@latest/admin/managing-github-apps-for-your-enterprise/automate-installations)을(를) 참조하세요.\n\n## 다음 단계\n\n* 특정 조직에 앱 액세스 권한을 부여하려면 해당 조직에 앱을 설치하세요. 자세한 내용은 [타사로부터 GitHub 앱 설치하기](/ko/enterprise-cloud@latest/apps/using-github-apps/installing-a-github-app-from-a-third-party)을(를) 참조하세요.\n* 조직에 설치된 앱을 관리하는 방법을 알아보세요. 자세한 내용은 [설치된 GitHub 앱 검토 및 수정](/ko/enterprise-cloud@latest/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)을(를) 참조하세요."}