Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.
All products
앱

GitHub 앱 등록 수정

이 문서의 내용

GitHub App을(를) 등록한 후 변경할 수 있습니다.

GitHub App 수정 정보

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

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

GitHub App에 대한 새로운 선택적 기능을 테스트하도록 선택할 수도 있습니다. 자세한 내용은 "GitHub 앱에 대한 선택적 기능 활성화"을 참조하세요.

GitHub App 설정으로 이동

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

  1. 계정 설정으로 이동합니다.

    • 개인 계정이 소유하는 GitHub App의 경우 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, 설정을 클릭합니다.
    • 조직이 소유하는 GitHub App의 경우 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, 조직을 클릭합니다. 그런 다음, 조직 오른쪽에서 설정을 클릭합니다.

  2. 왼쪽 사이드바에서 개발자 설정을 클릭합니다.

  3. 왼쪽 사이드바에서 GitHub Apps를 클릭합니다. GitHub의 "개발자 설정" 페이지 스크린샷 "GitHub Apps"라는 레이블이 지정된 옵션은 진한 주황색으로 표시됩니다.

  4. 수정하려는 GitHub App의 오른쪽에서 Edit(편집)을 클릭합니다.

GitHub App의 기본 정보 변경

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

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. "기본 정보"에서 변경하려는 GitHub App 정보를 수정합니다.
  3. 변경 내용 저장을 클릭합니다.

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

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

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. "사용자 식별 및 권한 부여"에서 설치하는 동안 OAuth(사용자 권한 부여 요청) 를 선택하거나 선택 취소합니다.
  3. "콜백 URL"에서 사용자가 설치 권한을 부여한 후 리디렉션할 전체 URL을 입력합니다.

디바이스 흐름 사용 또는 사용 안 함

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

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. "사용자 식별 및 권한 부여"에서 디바이스 흐름 사용을 선택하거나 선택 취소합니다.

설치 URL 추가 또는 업데이트

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

설치 중에 OAuth(사용자 권한 부여 요청) 를 선택하면 설치 URL을 입력할 수 없습니다. 대신 사용자는 추가 설정을 설명할 수 있는 권한 부여 흐름의 일부로 콜백 URL로 리디렉션됩니다. 자세한 내용은 "사용자 권한 부여 콜백 URL 정보"을 참조하세요.

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. "설치 후"의 "설치 URL" 필드에 앱을 설치한 후 사용자를 리디렉션할 URL을 입력합니다.
  3. 필요에 따라 설치를 업데이트한 후 설치 URL로 사용자를 리디렉션하려면 업데이트 시 리디렉션을 선택합니다. 업데이트에는 설치를 위한 리포지토리 추가 또는 제거가 포함됩니다. "설치 URL"이 비어 있으면 무시됩니다.

GitHub App의 권한 변경

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

앱의 리포지토리 또는 organization 권한을 변경하는 경우 앱이 설치된 각 계정은 새 권한을 승인해야 합니다. 앱의 계정 권한을 변경하면 앱에 권한을 부여한 각 사용자가 권한 변경을 승인해야 합니다. 업데이트된 권한은 새 권한이 승인될 때까지 설치 또는 사용자 권한 부여에 적용되지 않습니다. 설치 웹후크를 사용하여 사람들이 앱에 대한 새 권한을 수락하는 시기를 확인할 수 있습니다.

앱의 사용 권한을 변경하면 앱이 구독할 수 있는 웹후크와 앱이 API를 사용하여 수행할 수 있는 작업이 변경됩니다. 자세한 내용은 "GitHub 앱 대한 권한 선택"을 참조하세요.

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. GitHub Apps 설정 사이드바에서 권한 & 이벤트를 클릭합니다.
  3. "리포지토리 권한", "조직 권한" 및 "계정 권한" 섹션에서 변경하려는 권한을 수정합니다. 각 권한 유형에 대해 드롭다운에서 "읽기 전용", "읽기 및 쓰기" 또는 "액세스 권한 없음"을 선택합니다. 자세한 내용은 "GitHub 앱 대한 권한 선택"을 참조하세요.
  4. 필요에 따라 "사용자에게 메모 추가"에서 GitHub App 요청 권한을 변경하는 이유를 사용자에게 알리는 메모를 추가합니다.
  5. 변경 내용 저장을 클릭합니다.

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

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

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. "웹후크"에서 웹후크를 사용하거나 사용하지 않도록 설정하려면 활성을 선택하거나 선택 취소합니다.
  3. 이전 단계에서 활성 을 선택한 경우 "웹후크 URL"에서 GitHub에서 웹후크 이벤트를 보내야 하는 URL을 입력합니다.
  4. 필요에 따라 이전 단계에서 활성 을 선택한 경우 "웹후크 비밀"에서 비밀 토큰을 입력하여 웹후크를 보호합니다. GitHub은(는) 웹후크 비밀을 설정하는 것이 좋습니다.

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

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

GitHub App 등록에 대해 선택할 수 있는 특정 웹후크 이벤트는 앱에 대해 선택한 사용 권한 유형에 따라 결정됩니다. 먼저 앱에 부여할 권한을 선택한 다음, 해당 권한 집합과 관련된 웹후크 이벤트에 앱을 구독할 수 있습니다. 자세한 내용은 "Using webhooks with GitHub Apps.

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. GitHub App 웹후크를 활성화합니다. 자세한 내용은 이 문서의 "GitHub App 웹후크 활성화 또는 비활성화"를 참조하세요.
  3. GitHub Apps 설정 사이드바에서 권한 & 이벤트를 클릭합니다.
  4. "리포지토리 권한", "조직 권한" 및 "계정 권한" 섹션에서 앱이 구독할 이벤트에 필요한 권한을 선택합니다. 자세한 내용은 "GitHub App의 권한 변경"을 참조하세요.
  5. "이벤트 구독"에서 GitHub App에서 받을 웹후크 이벤트를 선택합니다.
  6. 변경 내용 저장을 클릭합니다.

GitHub App의 표시 유형 변경

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

  1. Navigate to the settings page for the app you'd like to modify. For more information, see "Navigating to your GitHub App settings" in this article.
  2. 왼쪽 사이드바에서 고급을 클릭합니다.
  3. GitHub App의 현재 표시 유형에 따라 "위험 영역"에서 공개 또는 비공개로 설정을 클릭합니다.****