GitHub App 수정에 관한 정보
앱을 처음 등록할 때 선택한 설정을 변경하려면 GitHub App 등록 정보를 수정할 수 있습니다. 등록하는 동안 선택할 수 있는 설정에 대한 자세한 내용은 GitHub App을 참조하세요.
예를 들어 앱의 이름 및 설명, 앱에 부여된 권한, 앱이 구독하는 웹후크 또는 앱의 표시 여부를 변경할 수 있습니다.
GitHub App에 대한 새로운 선택 기능을 테스트하도록 선택할 수도 있습니다. GitHub 앱에 대한 선택적 기능 활성화을(를) 참조하세요.
내 GitHub App 설정으로 이동
GitHub App을 수정하려면 먼저 앱 설정 페이지로 이동하세요.
- GitHub의 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
- 계정 설정으로 이동합니다.
- 개인 계정 소유한 앱의 경우 설정을 클릭합니다.
- 조직이 소유한 앱의 경우:
- 사용자의 조직을 클릭합니다.
- 조직 오른쪽에서 설정을 클릭합니다.
- 왼쪽 사이드바에서 Developer settings를 클릭합니다.
- 왼쪽 사이드바에서 GitHub Apps 을 클릭합니다.
- 수정하려는 GitHub App의 오른쪽에서 Edit(편집)을 클릭합니다.
의 기본 정보 변경 GitHub App
앱 이름, 앱 설명 및 앱의 GitHub App홈페이지 URL과 같은 기본 정보를 변경할 수 있습니다.
- 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 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로 리디렉션됩니다. 사용자 인증 콜백 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"에서 웹후크 이벤트를 보낼 URL GitHub 을 입력합니다.
- 필요에 따라 이전 단계에서 활성을 선택한 경우 "웹후크 암호"에서 비밀 토큰을 입력하여 웹후크를 보호합니다. 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 App에 따라 "위험 영역"에서 공개 또는 비공개로 만들기를 클릭합니다.