설치 정보 GitHub Apps
참고
이 설치 흐름은 타사 앱이든 엔터프라이즈가 소유한 앱이든 상관없이 모든 GitHub App앱에 적용됩니다. 앱 소유자가 제공한 링크를 사용하여 앱을 수동으로 설치할 수 있습니다.
리소스에서 GitHub App을 사용하려면 조직 또는 개인 계정에 앱을 설치해야 합니다. 여러 계정에 동일한 GitHub App을(를) 설치할 수 있습니다. 예를 들어 개인 계정 및 소유한 일부 조직에서 앱을 설치하는 경우 개인 리포지토리, 앱을 설치한 조직, 해당 조직이 소유한 리포지토리에서 앱을 사용할 수 있습니다.
앱을 설치할 때 요청한 조직 및 리포지토리 리소스에 액세스할 수 있는 앱 권한을 부여합니다. 설치 프로세스 중 GitHub은(는) GitHub App이(가) 요청한 권한을 알려줍니다. 해당 권한으로 GitHub App에서 수행할 수 있는 REST API 요청에 대한 자세한 내용은 GitHub 앱에 필요한 권한을(를) 참조하세요.
리포지토리 권한을 요청하는 앱을 설치할 때 GitHub App 액세스 권한을 부여할 리포지토리도 선택합니다.
GitHub App을(를) 설치하기 전에 GitHub App의 소유자를 신뢰해야 합니다. 또한 GitHub App이(가) 요청하는 사용 권한을 검토하고 해당 사용 권한을 편안하게 부여해야 합니다. 해당 권한으로 GitHub App에서 수행할 수 있는 REST API 요청에 대한 자세한 내용은 GitHub 앱에 필요한 권한을(를) 참조하세요.
설치할 수 있는 앱 수에는 제한이 없습니다.
설치 및 권한 부여의 차이점
설치한 GitHub App후에는 앱에 권한을 부여하라는 메시지가 표시될 수도 있습니다.
계정 또는 조직에 GitHub App을(를) 설치하는 경우 앱이 요청한 조직 및 리포지토리 리소스에 액세스할 수 있는 권한을 부여합니다. 또한 앱이 액세스할 수 있는 리포지토리를 지정합니다. 설치 프로세스 중에 GitHub App은(는) 부여할 리포지토리 및 조직 권한을 나타냅니다. GitHub App에서 수행할 수 있는 다양한 권한에 대한 자세한 내용은 GitHub 앱에 대한 권한 선택을(를) 참조하세요.
예를 들어 GitHub App 권한을 부여하여 리포지토리 메타데이터를 읽고 문제를 작성할 수 있으며 모든 리포지토리에 대한 GitHub App 액세스 권한을 부여할 수 있습니다.
GitHub App에 권한을 부여하면 앱이 요청한 계정 권한에 따라 GitHub계정에 대한 앱 액세스 권한을 부여합니다. 권한 부여 프로세스 중에 앱은 앱이 계정에서 액세스할 수 있는 리소스를 나타냅니다. GitHub App에 권한을 부여하면 사용자 대신 작업할 수 있는 앱 권한도 부여합니다.
예를 들어 GitHub App 권한을 부여하여 이메일 주소를 읽고 gist를 작성할 수 있습니다.
앱에 권한을 부여하지 않고 GitHub App을(를) 설치할 수 있습니다. 마찬가지로, 앱을 설치하지 않고 앱에 권한을 부여할 수 있습니다.
권한 부여에 대한 자세한 내용은 GitHub Apps을 참조하세요.
GitHub App를 설치하기 위한 요구 사항
개인 계정이 아닌 한 누구나 자신의 개인 계정에 설치할 수 있습니다GitHub Apps
조직 소유자는 조직에 설치 GitHub Apps 할 수 있습니다.
리포지토리 관리자는 앱이 조직 권한이나 "리포지토리 관리" 권한을 요청하지 않는 경우 리포지토리를 소유한 조직에 GitHub Apps를 설치할 수 있습니다. 이렇게 하면 그들이 관리하는 리포지토리에 액세스가 가능한 앱만 설치가 가능합니다. 조직 소유자는 리포지토리 관리자의 GitHub App 설치를 제한할 수 있습니다. 이 제한을 사용하도록 설정하면 리포지토리 관리자는 GitHub Apps을(를) 설치할 수 없으며 대신 조직 소유자에게 원하는 앱을 설치하도록 요청해야 합니다. 자세한 내용은 OAuth 앱 및 GitHub 앱 액세스 요청 및 설치 제한에서 확인할 수 있습니다.
조직에 앱을 설치할 수 없는 조직 구성원 및 외부 협력자는 설치 프로세스 중에 조직을 선택할 수 있습니다. 앱을 설치하는 대신 조직 GitHub 소유자에게 앱을 설치하도록 요청하는 알림을 조직 소유자에게 보냅니다. 이러한 요청을 만드는 기능은 앱 액세스 요청 정책을 사용하여 제어할 수 있습니다. OAuth 앱 및 GitHub 앱 액세스 요청 및 설치 제한을(를) 참조하세요.
"앱 관리자" 역할은 사용자에게 조직GitHub App 또는 엔터프라이즈에 설치할 수 있는 기능을 제공하지 않습니다. GitHub 앱 관리자 정보을(를) 참조하세요.
GitHub App 설치하기
설치 프로세스 중에 앱 소유자가 GitHub URL로 이동하도록 안내하여 GitHub App을 설치합니다. URL은 다음과 같이 표시됩니다. 여기서 http(s)://HOSTNAME/github-apps/APP-NAME/installations/new``APP-NAME이름은 다음과 같습니다GitHub App.
-
를 설치 GitHub App할 위치를 선택합니다. 구성원인 개인 계정 또는 조직을 선택할 수 있습니다.
-
앱이 리포지토리에 대한 권한을 요구하는 경우, 모든 리포지토리 또는 선택한 리포지토리만을 선택하세요. 앱은 항상 GitHub에 있는 모든 공용 리포지토리에 대한 읽기 전용 액세스 권한을 가집니다.
앱이 리포지토리 권한을 요구하지 않는다면, 이러한 옵션은 생략됩니다.
-
이전 단계에서 선택한 리포지토리만을 선택했다면, 선택한 리포지토리 드롭다운에서 앱이 액세스하도록 설정할 리포지토리를 선택하세요.
앱이 리포지토리를 만들면, 해당 리포지토리에 대한 액세스 권한이 자동으로 해당 앱에도 부여됩니다.
-
앱이 요청 중인 권한을 검토하세요. 해당 권한으로 수행할 수 있는 GitHub App REST API 요청에 대한 자세한 내용은 GitHub 앱에 필요한 권한을 참조하세요.
-
**설치**, **설치 및 요청**, 또는 **요청**을 클릭하세요. 표시되는 단추는 조직 소유자가 앱에 대해 요청된 액세스 권한을 승인해야 하는지, 일부만 승인해야 하는지, 또는 모두 승인해야 하는지 여부에 따라 달라집니다. 자세한 내용은 설치 [요구 사항을 참조하세요 GitHub App](#requirements-to-install-a-github-app).