GitHub Apps 설치에 대한 정보
이 문서에서는 GitHub Marketplace 대신에 직접 앱 소유자로부터 GitHub App을(를) 설치하는 방법을 설명합니다. GitHub Marketplace(으)로부터 GitHub Apps을(를) 설치하는 방법에 대한 자세한 내용은 개인 계정을 위해 GitHub 마켓플레이스에서 GitHub 앱 설치 및 GitHub 마켓플레이스로부터 사용자의 조직에 GitHub 앱 설치하기에서 확인할 수 있습니다. 본인이 소유한 GitHub Apps의 설치에 대한 자세한 정보는 고유한 GitHub 앱 설치에서 확인할 수 있습니다.
참고
이 설치 흐름은 타사 앱인지 또는 사용자의 엔터프라이즈가 소유한 앱인지와 관계없이 모든 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 앱 권한 부여에서 확인할 수 있습니다.
GitHub App 설치 시의 요구 사항
누구든지 개인 계정에 GitHub Apps을(를) 설치할 수 있습니다. 하지만, 사용자가 Enterprise Managed User인 경우는 예외입니다.
조직 소유자는 GitHub Apps을(를) 조직에 설치할 수 있습니다.
엔터프라이즈 소유자는 본인의 엔터프라이즈 계정에 GitHub Apps를 설치할 수 있습니다. 이것은 해당 애플리케이션이 엔터프라이즈 권한을 요청하고, 해당 애플리케이션이 해당 엔터프라이즈 또는 그 엔터프라이즈의 조직 중 하나의 소유인 경우에 가능합니다.
데이터 재사용 가능 앱.리포 관리 설치 제한 %}
조직에 앱을 설치할 수 없는 조직 구성원 및 외부 협력자는 설치 프로세스 중에 조직을 선택할 수 있습니다. GitHub은(는) 앱을 설치하는 대신에, 조직 소유자에게 앱 설치를 요청하는 알림을 보낼 것입니다. 이러한 요청을 만드는 기능은 앱 액세스 요청 정책을 사용하여 제어할 수 있습니다. OAuth 앱 및 GitHub 앱 액세스 요청 및 설치 제한을(를) 참조하세요.
"앱 관리자" 역할은 GitHub App을 설치할 수 있는 권한을 조직 또는 엔터프라이즈에 부여하지 않습니다. GitHub 앱 관리자 정보을(를) 참조하세요.
GitHub App 설치하기
설치 프로세스 중에, 앱 소유자가 GitHub App을(를) 설치할 수 있는 GitHub URL을 알려줄 것입니다. 이 URL은 https://github.com/apps/APP-NAME/installations/new과(와) 같은 형식으로 표시됩니다. 여기서 APP-NAME은(는) GitHub App의 이름입니다.
-
GitHub App을(를) 설치하려는 위치를 선택하세요. 본인의 개인 계정이나 본인이 구성원으로서 속해 있는 조직을 선택할 수 있습니다. 본인이 엔터프라이즈 소유자인 경우에는, 해당 앱이 엔터프라이즈를 지원한다면 엔터프라이즈에 앱을 설치할 수도 있습니다.
참고
조직에서 SAML SSO를 사용하며 나열된 조직이 표시되지 않는 경우 조직에 대한 활성 SAML 세션을 시작해야 할 수 있습니다. 자세한 내용은 SAML 및 GitHub 앱을(를) 참조하세요.
-
앱이 리포지토리에 대한 권한을 요구하는 경우, 모든 리포지토리 또는 선택한 리포지토리만을 선택하세요. 이 앱은 항상 GitHub의 모든 공개 리포지토리에 대해 읽기 전용 액세스 또는 그보다 높은 권한을 갖습니다.
앱이 리포지토리 권한을 요구하지 않는다면, 이러한 옵션은 생략됩니다.
-
이전 단계에서 선택한 리포지토리만을 선택했다면, 선택한 리포지토리 드롭다운에서 앱이 액세스하도록 설정할 리포지토리를 선택하세요.
앱이 리포지토리를 만들면, 해당 리포지토리에 대한 액세스 권한이 자동으로 해당 앱에도 부여됩니다.
-
앱이 요청 중인 권한을 검토하세요. 해당 권한으로 GitHub App이(가) 할 수 있는 REST API 요청에 대한 자세한 내용은 GitHub 앱에 필요한 권한에서 확인할 수 있습니다.
-
설치, 설치 및 요청, 또는 요청을 클릭하세요. 어떤 단추가 표시되는지는 조직 소유자가 앱이 요청한 액세스 권한들을 전부 승인하지 않아야 하는지, 일부를 승인해야 하는지, 전부 승인해야 하는지에 따라 달라집니다. 엔터프라이즈 설치는 요청할 수 없으며, 엔터프라이즈 소유자가 직접 앱을 설치해야 합니다. 자세한 내용은 GitHub App 설치 요구 사항에서 확인할 수 있습니다.