{"meta":{"title":"GitHub 앱 등록 수정","intro":"GitHub App을(를) 등록한 후 변경할 수 있습니다.","product":"앱","breadcrumbs":[{"href":"/ko/apps","title":"앱"},{"href":"/ko/apps/maintaining-github-apps","title":"GitHub Apps의 유지 관리"},{"href":"/ko/apps/maintaining-github-apps/modifying-a-github-app-registration","title":"앱 설정 수정"}],"documentType":"article"},"body":"# GitHub 앱 등록 수정\n\nGitHub App을(를) 등록한 후 변경할 수 있습니다.\n\n## GitHub App 수정에 관한 정보\n\n앱을 처음 등록할 때 선택한 설정을 변경하려면 GitHub App 등록 정보를 수정할 수 있습니다. 등록하는 동안 선택할 수 있는 설정에 대한 자세한 내용은 GitHub App을 [](/ko/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)참조하세요.\n\n예를 들어 앱의 이름 및 설명, 앱에 부여된 권한, 앱이 구독하는 웹후크 또는 앱의 표시 여부를 변경할 수 있습니다.\n\nGitHub App에 대한 새로운 선택 기능을 테스트하도록 선택할 수도 있습니다.\n[GitHub 앱에 대한 선택적 기능 활성화](/ko/apps/maintaining-github-apps/activating-optional-features-for-github-apps)을(를) 참조하세요.\n\n<!-- Anchor to maintain links to this heading -->\n\n<a name=\"navigating-to-your-github-app-settings\"></a>\n\n## 내 GitHub App 설정으로 이동\n\nGitHub App을 수정하려면 먼저 앱 설정 페이지로 이동하세요.\n\n1. GitHub의 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.\n2. 계정 설정으로 이동합니다.\n   * 개인 계정 소유한 앱의 경우 **설정**을 클릭합니다.\n   * 조직이 소유한 앱의 경우:\n     1. **사용자의 조직**을 클릭합니다.\n     2. 조직 오른쪽에서 **설정**을 클릭합니다.\n3. 왼쪽 사이드바에서 **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Developer settings**를 클릭합니다.\n4. 왼쪽 사이드바에서 **GitHub Apps** 을 클릭합니다.\n5. 수정하려는 GitHub App의 오른쪽에서 **Edit**(편집)을 클릭합니다.\n\n## 의 기본 정보 변경 GitHub App\n\n앱 이름, 앱 설명 및 앱의 GitHub App홈페이지 URL과 같은 기본 정보를 변경할 수 있습니다.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. \"기본 정보\"에서 변경하려는 GitHub App 정보를 수정합니다.\n3. **변경 내용 저장**을 클릭합니다.\n\n## 설치하는 동안 사용자 권한 부여(OAuth) 요청\n\n사용자가 설치할 때 GitHub App에 대한 권한을 부여하도록 요청하고 사용자 액세스 토큰을 생성할 수 있습니다. 설치 중에 사용자 권한 부여(OAuth)를 요청하는 경우 설치 권한을 부여한 후 사용자가 리디렉션되는 콜백 URL도 제공해야 합니다.\n[GitHub 앱에 대한 사용자 액세스 토큰 생성](/ko/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)을(를) 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. 설치하는 동안 \"사용자 식별 및 권한 부여\"에서 **사용자 권한 부여(OAuth) 요청**을 선택하거나 선택 취소합니다.\n3. \"콜백 URL\"에서 사용자가 설치를 승인한 후 리디렉션할 전체 URL을 입력합니다.\n\n## 디바이스 흐름 활성화 또는 비활성화\n\n디바이스 플로우를 사용하여 CLI 도구 또는 Git 자격 증명 관리자와 같은 헤드리스 앱의 사용자에게 권한을 부여할 수 있습니다. 디바이스 흐름을 GitHub Apps사용하는 방법에 대한 자세한 내용은 [GitHub 앱에 대한 사용자 액세스 토큰 생성](/ko/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app#using-the-device-flow-to-generate-a-user-access-token)을 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. \"사용자 식별 및 권한 부여\"에서 **디바이스 흐름 사용**을 선택하거나 선택 취소합니다.\n\n## 설치 URL 추가 또는 업데이트\n\n앱을 설치한 후 사용자를 특정 URL로 리디렉션할 수 있습니다.\n[GitHub 앱 등록](/ko/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)을(를) 참조하세요.\n\n**설치하는 동안 사용자 권한 부여(OAuth) 요청**을 선택하면 설치 URL을 입력할 수 없습니다. 대신 사용자는 추가 설정을 설명할 수 있는 권한 부여 흐름의 일부로 콜백 URL로 리디렉션됩니다.\n[사용자 인증 콜백 URL에 대한 정보](/ko/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url)을(를) 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. \"설치 후\"의 \"설치 URL\" 필드에 앱을 설치한 후 사용자를 리디렉션할 URL을 입력합니다.\n3. 필요에 따라 설치를 업데이트한 후 설치 URL로 사용자를 리디렉션하려면 **업데이트 시 리디렉션**을 선택합니다. 업데이트에는 설치를 위한 리포지토리 추가 또는 제거가 포함됩니다. \"설치 URL\"이 비어 있으면 무시됩니다.\n\n## GitHub App의 사용 권한 변경\n\n다음 단계에 따라 귀하의 GitHub App에 부여된 액세스 권한을 변경할 수 있습니다.\n\n앱에 대한 새 **리포지** 또는 **조직** 권한을 추가하는 경우 앱이 설치된 각 계정은 새 권한을 승인해야 합니다. 앱에 **계정** 권한을 추가하면 앱에 권한을 부여한 각 사용자가 권한 변경을 승인해야 합니다. 두 경우 GitHub 모두 각 조직 소유자 또는 사용자에게 앱의 사용 권한을 업데이트하라는 요청을 알리는 이메일을 보냅니다. 업데이트된 권한은 새 권한이 승인될 때까지 설치 또는 사용자 권한 부여에 적용되지 않습니다.\n[설치 웹후크](/ko/webhooks/webhook-events-and-payloads?actionType=new_permissions_accepted#installation)를 사용하여 사용자가 앱에 대한 새 권한을 수락하는 시점을 확인할 수 있습니다.\n\n사용 권한 또는 웹후크를 GitHub App제거하면 변경 내용이 즉시 적용됩니다. 이전에 앱에 부여된 권한을 제거하면 앱은 더 이상 해당 리소스에 액세스할 수 없습니다.\n\n앱의 권한을 변경하면 앱이 구독할 수 있는 웹후크가 변경되고 앱이 API를 사용하여 수행할 수 있는 작업이 변경됩니다.\n[GitHub 앱에 대한 권한 선택](/ko/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)을(를) 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. 설정 사이드바에서 GitHub Apps**사용 권한 및 이벤트를** 클릭합니다.\n3. \"리포지토리 권한\", \"조직 권한\" 및 \"계정 권한\" 섹션에서 변경하려는 권한을 수정합니다. 각 사용 권한 유형에 대해 드롭다운에서 \"읽기 전용\", \"읽기 및 쓰기\" 또는 \"액세스 권한 없음\"을 선택합니다.\n   [GitHub 앱에 대한 권한 선택](/ko/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)을(를) 참조하세요.\n4. 필요에 따라 \"사용자에게 메모 추가\"에서 사용자에게 요청하는 사용 권한을 변경하는 이유를 알려주는 GitHub App 메모를 추가합니다.\n5. **변경 내용 저장**을 클릭합니다.\n\n## 웹후크 활성화 또는 비활성화 GitHub App\n\nGitHub App를 구성하여 GitHub의 특정 이벤트에 대한 웹후크를 수신하고 이에 대해 자동으로 조치를 취할 수 있습니다.\n[GitHub 앱에서 웹후크 사용](/ko/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)을(를) 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. \"웹후크\"에서 웹후크를 활성화하거나 비활성화하려면 **활성**을 선택하거나 선택 취소합니다.\n3. 이전 단계에서 **활성** 을 선택한 경우 \"웹후크 URL\"에서 웹후크 이벤트를 보낼 URL GitHub 을 입력합니다.\n4. 필요에 따라 이전 단계에서 **활성**을 선택한 경우 \"웹후크 암호\"에서 비밀 토큰을 입력하여 웹후크를 보호합니다.\n   GitHub 웹후크 비밀을 설정하는 것이 좋습니다.\n\n## GitHub App의 웹후크 이벤트 구독 변경하기\n\n다음 단계를 사용하여 구독하는 GitHub App 웹후크 이벤트를 변경할 수 있습니다.\n\nGitHub App 등록에 대해 선택할 수 있는 특정 웹후크 이벤트는 앱에 대해 선택한 사용 권한 유형에 따라 결정됩니다. 먼저 앱에 부여할 사용 권한을 선택한 다음 해당 사용 권한 집합과 관련된 웹후크 이벤트에 앱을 구독할 수 있습니다.\n[GitHub 앱에서 웹후크 사용](/ko/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)을 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. GitHub App 웹후크를 활성화합니다. 이 문서의 [웹후크 활성화 또는 비활성화를 GitHub App](/ko/apps/maintaining-github-apps/modifying-a-github-app-registration#activating-or-deactivating-the-github-app-webhook) 참조하세요.\n3. 설정 사이드바에서 GitHub Apps**사용 권한 및 이벤트를** 클릭합니다.\n4. \"리포지토리 권한\", \"조직 권한\", \"계정 권한\" 섹션에서 앱이 구독할 이벤트에 필요한 권한을 선택합니다. 의 [사용 권한 GitHub App변경을](#changing-the-permissions-of-a-github-app) 참조하세요.\n5. \"이벤트 구독\"에서 GitHub App이 수신할 웹후크 이벤트를 선택합니다.\n6. **변경 내용 저장**을 클릭합니다.\n\n## GitHub App의 표시 여부 변경\n\nGitHub App의 공개 범위 설정을 변경하여 누가 이를 설치할 수 있는지 제어할 수 있습니다. 공개 앱은 다른 계정에 설치되어 있는 경우 비공개로 설정할 수 없습니다.\n[GitHub 앱 공개 또는 비공개 만들기](/ko/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private)을(를) 참조하세요.\n\n1. 수정하려는 앱의 설정 페이지로 이동합니다. 자세한 내용은 이 문서의 [GitHub App 설정으로 이동](#navigating-to-your-github-app-settings)을 참조하세요.\n2. 왼쪽 사이드바에서 **고급**을 클릭합니다.\n3. 현재 표시 유형 GitHub App에 따라 \"위험 영역\"에서 **공개** 또는 **비공개로 만들기**를 클릭합니다."}