GitHub App 수정 정보
GitHub App 등록을 수정하여 앱을 처음 등록할 때 선택한 설정을 변경할 수 있습니다. GitHub App 등록 시에 선택할 수 있는 설정에 대한 자세한 내용은 "GitHub 앱 등록"을(를) 참조하세요.
예를 들어 앱의 이름 및 설명, 앱에 부여된 권한, 앱이 구독하는 웹후크 또는 앱의 표시 여부를 변경할 수 있습니다.
GitHub App의 새로운 선택적 기능을 테스트하도록 선택할 수도 있습니다. 자세한 내용은 "GitHub 앱의 선택적 기능 활성화"을(를) 참조하세요.
GitHub App 설정으로 이동
GitHub App을(를) 수정하려면 먼저 앱 설정 페이지로 이동합니다.
- GitHub Enterprise Cloud의 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.
- 계정 설정으로 이동합니다.
- 개인 계정 소유한 앱의 경우 설정을 클릭합니다.
- 조직이 소유한 앱의 경우:
- 사용자의 조직을 클릭합니다.
- 조직 오른쪽에서 설정을 클릭합니다.
- 왼쪽 사이드바에서 개발자 설정을 클릭합니다.
- 왼쪽 사이드바에서 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로 리디렉션됩니다. 자세한 내용은 "사용자 권한 부여 콜백 URL 정보"을(를) 참조하세요.
- 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 “GitHub App 설정으로 이동”을 참조하세요.
- "설치 후"의 "설치 URL" 필드에 앱을 설치한 후 사용자를 리디렉션할 URL을 입력합니다.
- 필요에 따라 설치를 업데이트한 후 설치 URL로 사용자를 리디렉션하려면 업데이트 시 리디렉션을 선택합니다. 업데이트에는 설치를 위한 리포지토리 추가 또는 제거가 포함됩니다. "설치 URL"이 비어 있으면 무시됩니다.
GitHub App의 권한 변경
다음 단계를 사용하여 GitHub App에 부여된 액세스 권한을 변경할 수 있습니다.
앱의 리포지토리 또는 조직 권한을 변경할 때 앱이 설치된 각 계정에서 새 권한을 승인해야 합니다. 앱의 계정 권한을 변경할 때 앱에 권한을 부여한 각 사용자가 권한 변경을 승인해야 합니다. 두 경우 모두 GitHub은(는) 각 조직 소유자 또는 사용자에게 앱의 권한을 업데이트해 달라는 요청을 알리는 이메일을 보냅니다. 업데이트된 권한은 새 권한이 승인될 때까지 설치 또는 사용자 권한 부여에 적용되지 않습니다. 설치 웹후크를 사용하여 사용자가 앱에 대한 새 권한을 수락하는 시점을 확인할 수 있습니다.
앱의 권한을 변경하면 앱이 구독할 수 있는 웹후크가 변경되고 앱이 API를 사용하여 수행할 수 있는 작업이 변경됩니다. 자세한 내용은 "GitHub 앱의 권한 선택"을(를) 참조하세요.
- 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 “GitHub App 설정으로 이동”을 참조하세요.
- GitHub Apps 설정 사이드바에서 권한 및 이벤트를 클릭합니다.
- "리포지토리 권한", "조직 권한" 및 "계정 권한" 섹션에서 변경하려는 권한을 수정합니다. 각 사용 권한 유형에 대해 드롭다운에서 “읽기 전용”, “읽기 및 쓰기” 또는 “액세스 권한 없음”을 선택합니다. 자세한 내용은 "GitHub 앱의 권한 선택"을(를) 참조하세요.
- 필요에 따라 “사용자에게 메모 추가”에서 GitHub App이(가) 요청하는 사용 권한을 변경하는 이유를 사용자에게 알리는 메모를 추가합니다.
- 변경 내용 저장을 클릭합니다.
GitHub App 웹후크 활성화 또는 비활성화
GitHub에서 특정 이벤트에 대한 웹후크를 수신하고 자동으로 작업을 수행하도록 GitHub App을(를) 구성할 수 있습니다. 자세한 내용은 "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 App의 현재 표시 여부에 따라 "위험 영역"에서 공개 또는 비공개를 클릭합니다.