타사에서 GitHub 앱 설치

앱 소유자로부터 직접 GitHub Apps을(를) 설치하여 개인 계정이나 조직에서 사용할 수 있습니다.

이 문서의 내용

GitHub Apps 설치 정보

이 문서에서는 GitHub Marketplace 대신 앱 소유자로부터 직접 GitHub App을(를) 설치하는 방법을 설명합니다. GitHub Marketplace에서 GitHub Apps 설치에 대한 자세한 내용은 "개인 계정을 위해 GitHub 마켓플레이스에서 GitHub 앱 설치" 및 "조직용 GitHub 마켓플레이스에서 GitHub 앱 설치" 항목을 참조하세요. 소유하고 있는 _apps %} 설치에 대한 자세한 내용은 "자신만의 GitHub 앱 설치" 항목을 참조하세요.

Note

이 설치 흐름은 타사 앱 또는 엔터프라이즈 소유 앱인지 여부와 관계없이 모든 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 앱을 설치하는 페이지의 스크린샷. 앱이 메타데이터에 대한 읽기 권한 및 문제에 대한 쓰기 권한을 요청하고 있습니다. 또한 앱은 이메일에 대한 읽기 권한 및 gist에 대한 쓰기 권한에 대한 사용자 권한 부여를 요청할 수 있습니다.

GitHub App에 권한을 부여하면 앱이 요청한 계정 권한에 따라 GitHub계정에 대한 앱 액세스 권한을 부여합니다. 권한 부여 프로세스 중에 앱은 앱이 계정에서 액세스할 수 있는 리소스를 나타냅니다. GitHub App에 권한을 부여하면 사용자 대신 작업할 수 있는 앱 권한도 부여합니다.

예를 들어 GitHub App 권한을 부여하여 이메일 주소를 읽고 gist를 작성할 수 있습니다.

GitHub 앱 권한을 부여하는 페이지의 스크린샷. 앱이 이메일에 대한 읽기 권한 및 gist에 대한 쓰기 권한을 요청하고 있습니다.

앱에 권한을 부여하지 않고 GitHub App을(를) 설치할 수 있습니다. 마찬가지로, 앱을 설치하지 않고 앱에 권한을 부여할 수 있습니다.

GitHub App 권한 부여에 대한 자세한 내용은 "GitHub 앱에 권한 부여" 항목을 참조하세요.

GitHub App 설치 요구 사항

누구나 개인 계정에 GitHub Apps을(를) 설치할 수 있습니다.

조직 소유자는 조직에 GitHub Apps을(를) 설치할 수 있습니다.

조직이 소유한 리포지토리 관리자는 조직에 GitHub Apps을(를) 설치할 수도 있습니다. 이는 자신이 관리자인 리포지토리에 대한 앱 액세스만 허용하고, 앱이 조직 권한이나 "리포지토리 관리" 권한을 요청하지 않는 경우 가능합니다. 조직 소유자는 리포지토리 관리자인 외부 협력자가 GitHub Apps을(를) 설치하지 못하도록 할 수 있습니다.

조직 소유자 또는 리포지토리 관리자가 아닌 조직 멤버도 설치 프로세스 중에 조직을 선택할 수 있습니다. GitHub은(는) 앱을 설치하는 대신 조직 소유자 앱 설치를 요청하는 알림을 보냅니다.

조직의 "앱 관리자" 역할은 조직에 GitHub App을(를) 설치할 수 있는 능력을 부여하지 않습니다. "GitHub 앱 관리자 정보" 항목을 참조하세요.

GitHub App 설치

설치 프로세스 중에 앱 소유자는 GitHub App을(를) 설치할 수 있는 GitHub URL로 안내합니다. URL은 https://github.com/apps/APP-NAME/installations/new과(와) 같이 표시됩니다. 여기서 APP-NAME은(는) GitHub App의 이름입니다.

  1. GitHub App을(를) 설치하려는 위치를 선택합니다. 개인 계정 또는 자신이 멤버로 속해 있는 조직을 선택할 수 있습니다.

    Note

    조직에서 SAML SSO를 사용하며 나열된 조직이 표시되지 않는 경우 조직에 대한 활성 SAML 세션을 시작해야 할 수 있습니다. 자세한 내용은 "SAML 및 GitHub 앱"을(를) 참조하세요.

  2. 앱에 리포지토리에 대한 권한이 필요한 경우, 모든 리포지토리 또는 리포지토리만 선택을 선택합니다. 앱은 항상 GitHub의 모든 공개 리포지토리에 대해 읽기 전용 액세스 이상의 권한을 갖습니다.

    앱에 리포지토리 권한이 필요하지 않은 경우 이러한 옵션은 생략됩니다.

  3. 이전 단계에서 리포지토리만 선택을 선택한 경우, 선택한 리포지토리 드롭다운에서 앱이 액세스하도록 할 리포지토리를 선택합니다.

    앱이 리포지토리를 만드는 경우, 앱에도 해당 리포지토리에 대한 액세스 권한이 자동으로 부여됩니다.

  4. 앱이 요청하는 권한을 검토합니다. 해당 권한으로 GitHub App에서 수행할 수 있는 REST API 요청에 대한 자세한 내용은 "GitHub 앱에 필요한 권한" 항목을 참조하세요.

  5. 설치, 설치 및 요청, 또는 요청을 클릭합니다. 표시되는 단추는 조직 소유자가 앱에 대해 요청된 액세스를 승인하지 않아야 하는지, 일부만 승인해야 하는지, 또는 전부를 승인해야 하는지에 따라 달라집니다. 자세한 내용은 "GitHub App 설치 요구 사항" 항목을 참조하세요.