GitHub 앱 등록 수정

GitHub App 수정 사항에 대하여

GitHub App 등록을 수정하여 앱을 처음 등록할 때 선택한 설정을 변경할 수 있습니다. GitHub App을 등록 시 선택할 수 있는 설정에 대한 자세한 내용은 GitHub 앱 등록을(를) 참조하세요.

예를 들어 앱의 이름 및 설명, 앱에 부여된 권한, 앱이 구독하는 웹후크 또는 앱의 표시 여부를 변경할 수 있습니다.

GitHub App의 새로운 선택적 기능을 테스트하도록 선택할 수도 있습니다. GitHub 앱에 대한 선택적 기능 활성화을(를) 참조하세요.

GitHub App 설정으로 이동

GitHub App을(를) 수정하려면 먼저 앱 설정 페이지로 이동합니다.

GitHub의 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
계정 설정으로 이동합니다.
- 개인 계정 소유한 앱의 경우 설정을 클릭합니다.
- 조직이 소유한 앱의 경우:
  1. 사용자의 조직을 클릭합니다.
  2. 조직 오른쪽에서 설정을 클릭합니다.
- 엔터프라이즈가 소유한 앱의 경우:
  1. 엔터프라이즈 설정을 클릭합니다.
GitHub App 설정으로 이동합니다.
- 개인 계정 또는 조직이 소유한 앱의 경우:
  1. 왼쪽 사이드바에서 개발자 설정을 클릭하고 GitHub Apps 를 클릭합니다.
- 엔터프라이즈가 소유한 앱의 경우:
  1. 왼쪽 사이드바의 설정을 클릭한 다음 GitHub Apps 을(를) 클릭합니다.
수정하려는 GitHub App의 오른쪽에서 Edit(편집)을 클릭합니다.

GitHub App의 기본 정보 변경

앱 이름, 앱 설명, 앱의 홈 페이지 URL 등, GitHub App의 기본 정보를 변경할 수 있습니다.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
"기본 정보"에서 변경하려는 GitHub App 정보를 수정합니다.

       **변경 내용 저장**을 클릭합니다.

설치하는 동안 사용자 권한 부여(OAuth) 요청

사용자가 GitHub App을(를) 설치하고 사용자 액세스 토큰을 생성할 때 이 앱에 권한을 부여하라는 메시지를 표시할 수 있습니다. 설치 중에 사용자 권한 부여(OAuth)를 요청하는 경우 설치 권한을 부여한 후 사용자가 리디렉션되는 콜백 URL도 제공해야 합니다. GitHub 앱에 대한 사용자 액세스 토큰 생성을(를) 참조하세요.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
설치하는 동안 "사용자 식별 및 권한 부여"에서 사용자 권한 부여(OAuth) 요청을 선택하거나 선택 취소합니다.
"콜백 URL"에서 사용자가 설치를 승인한 후 리디렉션할 전체 URL을 입력합니다.

디바이스 흐름 활성화 또는 비활성화

디바이스 플로우를 사용하여 CLI 도구 또는 Git 자격 증명 관리자와 같은 헤드리스 앱의 사용자에게 권한을 부여할 수 있습니다. GitHub Apps에 디바이스 흐름을 사용하는 방법에 대한 자세한 내용은 GitHub 앱에 대한 사용자 액세스 토큰 생성을(를) 참조하세요.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
"사용자 식별 및 권한 부여"에서 디바이스 흐름 사용을 선택하거나 선택 취소합니다.

설치 URL 추가 또는 업데이트

앱을 설치한 후 사용자를 특정 URL로 리디렉션할 수 있습니다. GitHub 앱 등록을(를) 참조하세요.

          **설치하는 동안 사용자 권한 부여(OAuth) 요청**을 선택하면 설치 URL을 입력할 수 없습니다. 대신 사용자는 추가 설정을 설명할 수 있는 권한 부여 흐름의 일부로 콜백 URL로 리디렉션됩니다. 
          [AUTOTITLE](/apps/creating-github-apps/creating-github-apps/about-the-user-authorization-callback-url)을(를) 참조하세요.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
"설치 후"의 "설치 URL" 필드에 앱을 설치한 후 사용자를 리디렉션할 URL을 입력합니다.
필요에 따라 설치를 업데이트한 후 설치 URL로 사용자를 리디렉션하려면 업데이트 시 리디렉션을 선택합니다. 업데이트에는 설치를 위한 리포지토리 추가 또는 제거가 포함됩니다. "설치 URL"이 비어 있으면 무시됩니다.

GitHub App의 권한 변경

다음 단계를 사용하여 GitHub App에 부여된 액세스 권한을 변경할 수 있습니다.

앱에 대한 새로운 리포지토리 또는 조직 권한을 추가하는 경우 앱이 설치된 각 계정에서 새 권한을 승인해야 합니다. 앱에 계정 권한을 추가하면 앱에 권한을 부여한 각 사용자가 권한 변경을 승인해야 합니다. 두 경우 모두 GitHub은(는) 각 조직 소유자 또는 사용자에게 앱의 권한을 업데이트해 달라는 요청을 알리는 이메일을 보냅니다. 업데이트된 권한은 새 권한이 승인될 때까지 설치 또는 사용자 권한 부여에 적용되지 않습니다. 설치 웹후크를 사용하여 사용자가 앱에 대한 새 권한을 수락하는 시점을 확인할 수 있습니다.

GitHub App에서 권한이나 웹후크를 제거하면 변경 내용이 즉시 적용됩니다. 이전에 앱에 부여된 권한을 제거하면 앱은 더 이상 해당 리소스에 액세스할 수 없습니다.

엔터프라이즈가 소유한 앱의 권한을 변경하는 경우, 해당 변경 내용은 엔터프라이즈 내 모든 앱 설치에 대해 즉시 적용됩니다. 단, 사용자가 엔터프라이즈 소유자인 경우에만 그렇습니다. 사용자가 앱 관리자인 경우, 변경 내용은 사용자가 조직 소유자인 조직에서만 자동으로 승인됩니다.

처음으로 앱에 리포지토리 권한을 추가하는 경우, 업데이트를 자동으로 수락할 수 없습니다. 이 경우 각 조직 소유자는 앱이 액세스할 수 있는 리포지토리를 선택할 수 있도록 업데이트를 승인해야 합니다.

앱의 권한을 변경하면 앱이 구독할 수 있는 웹후크가 변경되고 앱이 API를 사용하여 수행할 수 있는 작업이 변경됩니다. GitHub 앱에 대한 권한 선택을(를) 참조하세요.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
GitHub Apps 설정 사이드바에서 권한 및 이벤트를 클릭합니다.
"리포지토리 권한", "조직 권한" 및 "계정 권한" 섹션에서 변경하려는 권한을 수정합니다. 각 사용 권한 유형에 대해 드롭다운에서 "읽기 전용", "읽기 및 쓰기" 또는 "액세스 권한 없음"을 선택합니다. GitHub 앱에 대한 권한 선택을(를) 참조하세요.
필요에 따라 "사용자에게 메모 추가"에서 GitHub App이(가) 요청하는 사용 권한을 변경하는 이유를 사용자에게 알리는 메모를 추가합니다.

       **변경 내용 저장**을 클릭합니다.

GitHub App 웹후크 활성화 또는 비활성화

GitHub App에서 특정 이벤트에 대한 웹후크를 수신하고 자동으로 작업을 수행하도록 GitHub을(를) 구성할 수 있습니다. GitHub 앱에서 웹후크 사용을(를) 참조하세요.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
"웹후크"에서 웹후크를 활성화하거나 비활성화하려면 활성을 선택하거나 선택 취소합니다.
이전 단계에서 활성을 선택한 경우 "웹후크 URL"에서 GitHub이(가) 웹후크 이벤트를 보내야 하는 URL을 입력합니다.
필요에 따라 이전 단계에서 활성을 선택한 경우 "웹후크 암호"에서 비밀 ��큰을 입력하여 웹후크를 보호합니다. GitHub은(는) 웹후크 암호를 설정할 것을 권장합니다.

GitHub App의 웹후크 이벤트 구독 변경

다음 단계를 사용하여 GitHub App이(가) 구독하는 웹후크 이벤트를 변경할 수 있습니다.

GitHub App 등록에 대해 선택할 수 있는 특정 웹후크 이벤트는 앱에 대해 선택한 사용 권한 유형에 따라 결정됩니다. 먼저 앱에 부여할 사용 권한을 선택한 다음 해당 사용 권한 집합과 관련된 웹후크 이벤트에 앱을 구독할 수 있습니다. GitHub 앱에서 웹후크 사용을 참조하세요.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
GitHub App 웹후크를 활성화합니다. 이 문서의 GitHub App 웹후크 활성화 또는 비활성화를 참조하세요.
GitHub Apps 설정 사이드바에서 권한 및 이벤트를 클릭합니다.
"리포지토리 권한", "조직 권한", "계정 권한" 섹션에서 앱이 구독할 이벤트에 필요한 권한을 선택합니다. GitHub App의 권한 변경을 참조하세요.
"이벤트 구독"에서 GitHub App가 수신할 웹후크 이벤트를 선택합니다.

       **변경 내용 저장**을 클릭합니다.

GitHub App의 표시 여부 변경

GitHub App의 표시 여부 설정을 변경하여 이 앱을 설치할 수 있는 사용자를 제어할 수 있습니다. 공개 앱은 다른 계정에 설치되어 있는 경우 비공개로 설정할 수 없습니다. GitHub 앱 공개 또는 비공개 만들기을(를) 참조하세요.

엔터프라이즈가 소유한 GitHub App의 표시 유형은 변경할 수 없습니다. 엔터프라이즈가 소유한 GitHub Apps는 엔터프라이즈 내 조직에만 설치할 수 있습니다.

수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 GitHub App 설정으로 이동을 참조하세요.
왼쪽 사이드바에서 고급을 클릭합니다.
GitHub App의 현재 표시 여부에 따라 "위험 영역"에서 공개 또는 비공개를 클릭합니다.

이 기사에서