# GitHub 앱 설명서

GitHub와 심층적으로 연결하고, API 및 웹후크를 통합하며, GitHub 워크플로를 사용자 지정하고, 커뮤니티와 함께 앱을 만들고 공유하세요.

## Recommended

* [GitHub 앱 개요](/ko/enterprise-server@3.21/apps/overview)

  GitHub Apps를 사용하여 GitHub의 기능을 확장할 수 있습니다.

* [GitHub 앱을 빌드하기 위한 빠른 시작](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)

  풀 리퀘스트에 댓글을 다는 GitHub App를 빠르게 만들 수 있습니다.

* [GitHub 앱 만들기 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)

  GitHub Apps를 사용하면 통합을 구축하여 프로세스를 자동화하고 GitHub의 기능을 확장할 수 있습니다.

* [GitHub 앱 등록](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)

  GitHub App을(를) 개인 계정, 귀하가 소유한 조직, 귀하의 엔터프라이즈 으로 등록할 수 있습니다.

* [GitHub 앱을 사용한 인증 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app)

  GitHub App는 자체적으로, 앱 설치로 또는 사용자를 대신하여 인증할 수 있습니다.

* [GitHub 앱 권한 부여](/ko/enterprise-server@3.21/apps/using-github-apps/authorizing-github-apps)

  GitHub App가 사용자의 GitHub 계정에 대한 정보를 가져오고 사용자를 대신하여 변경할 수 있도록 권한을 부여할 수 있습니다.

* [GitHub 앱과 OAuth 앱 간의 차이점](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)

  일반적으로 GitHub Apps은(는) 세분화된 사용 권한으로 앱이 액세스할 수 있는 리포지토리를 더 잘 제어할 수 있으며 수명이 짧은 토큰을 사용하는 OAuth apps(으)로 기본 설정됩니다.

* [웹후크 이벤트에 응답하는 GitHub 앱 빌드](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events)

  웹후크 이벤트에 응답하여 API 요청을 보내는 GitHub App를 빌드하는 방법을 알아보세요.

* [GitHub 앱을 만들기 위한 모범 사례](/ko/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app)

  GitHub App의 보안 및 성능을 향상시키려면 다음 모범 사례를 따르세요.

## Links

### Getting started

* [GitHub 앱 개요](/ko/enterprise-server@3.21/apps/overview)

  GitHub Apps를 사용하여 GitHub의 기능을 확장할 수 있습니다.

* [GitHub 앱을 빌드하기 위한 빠른 시작](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)

  풀 리퀘스트에 댓글을 다는 GitHub App를 빠르게 만들 수 있습니다.

## Articles

* [GitHub 앱 개요](/ko/enterprise-server@3.21/apps/overview)

  GitHub Apps를 사용하여 GitHub의 기능을 확장할 수 있습니다.

* [GitHub 앱 사용 정보](/ko/enterprise-server@3.21/apps/using-github-apps/about-using-github-apps)

  GitHub App가 무엇이며 왜 GitHub App를 사용하는지 알아봅니다.

* [타사로부터 GitHub 앱 설치하기](/ko/enterprise-server@3.21/apps/using-github-apps/installing-a-github-app-from-a-third-party)

  앱 소유자로부터 직접 GitHub Apps를 설치하여 계정에 사용할 수 있습니다.

* [고유한 GitHub 앱 설치](/ko/enterprise-server@3.21/apps/using-github-apps/installing-your-own-github-app)

  앱을 소유한 계정에 만든 GitHub App을 설치할 수 있습니다. 앱이 공개인 경우 다른 계정에도 GitHub App을(를) 설치할 수 있습니다.

* [GitHub 앱 권한 부여](/ko/enterprise-server@3.21/apps/using-github-apps/authorizing-github-apps)

  GitHub App가 사용자의 GitHub 계정에 대한 정보를 가져오고 사용자를 대신하여 변경할 수 있도록 권한을 부여할 수 있습니다.

* [GitHub 앱에 대한 업데이트된 권한 승인](/ko/enterprise-server@3.21/apps/using-github-apps/approving-updated-permissions-for-a-github-app)

  GitHub App 추가 권한을 요청하는 경우 사용 권한이 사용하도록 설정할 동작을 검토하고 사용 권한을 승인할지 여부를 결정할 수 있습니다.

* [GitHub 앱의 권한 부여 검토 및 해지](/ko/enterprise-server@3.21/apps/using-github-apps/reviewing-and-revoking-authorization-of-github-apps)

  권한을 부여한 GitHub Apps을 검토하고 권한 부여를 취소할 수 있습니다.

* [설치된 GitHub 앱 검토 및 수정](/ko/enterprise-server@3.21/apps/using-github-apps/reviewing-and-modifying-installed-github-apps)

  설치한 GitHub Apps의 권한을 검토하고 리포지토리 액세스 권한을 변경할 수 있습니다. 계정 또는 조직에서 소유한 리소스에 GitHub App 일시적으로 또는 영구적으로 액세스하지 못하도록 할 수도 있습니다.

* [권한 있는 GitHub 앱](/ko/enterprise-server@3.21/apps/using-github-apps/privileged-github-apps)

  일부 GitHub Apps는 GitHub가 소유한, 특별한 기능이 부여된 특권 앱입니다.

* [GitHub 앱 만들기 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps)

  GitHub Apps를 사용하면 통합을 구축하여 프로세스를 자동화하고 GitHub의 기능을 확장할 수 있습니다.

* [GitHub 앱을 빌드할 시기 결정](/ko/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/deciding-when-to-build-a-github-app)

  통합을 구축할 때는 다음과 같은 시나리오에서는 GitHub App, OAuth app 또는 personal access token 대신 GitHub Actions 사용을 고려해야 합니다.

* [GitHub 앱을 만들기 위한 모범 사례](/ko/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app)

  GitHub App의 보안 및 성능을 향상시키려면 다음 모범 사례를 따르세요.

* [OAuth 앱을 GitHub 앱으로 마이그레이션](/ko/enterprise-server@3.21/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps)

  OAuth app를 GitHub App(으)로 마이그레이션할 때의 이점과 OAuth app를 마이그레이션하는 방법을 알아보세요.

* [GitHub 앱 등록](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)

  GitHub App을(를) 개인 계정, 귀하가 소유한 조직, 귀하의 엔터프라이즈 으로 등록할 수 있습니다.

* [사용자 인증 콜백 URL에 대한 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url)

  사용자가 권한을 부여한 후 리디렉션될 URL을 지정할 수 있습니다 GitHub App.

* [설치 URL 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/about-the-setup-url)

  사용자가 설치한 후 리디렉션될 URL을 지정할 수 있습니다 GitHub App.

* [GitHub 앱에 대한 권한 선택](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app)

  GitHub 앱의 권한은 앱이 GitHub의 API로 수행할 수 있는 작업과 앱이 받을 수 있는 웹후크를 결정합니다.

* [GitHub 앱에서 웹후크 사용](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps)

  GitHub App 웹후크 이벤트를 구독하여 특정 활동이 발생할 때마다 알림을 받을 수 있습니다.

* [GitHub 앱 공개 또는 비공개 만들기](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private)

  등록할 GitHub App때 다른 GitHub 계정이 앱을 설치하거나 비공개로 설치할 수 있도록 공개로 설정할 수 있으므로 앱을 소유한 계정에만 설치할 수 있습니다.

* [GitHub 앱에 대한 속도 제한](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps)

  속도 제한은 모든 사용자에게 일관된 액세스를 보장하기 위해 트래픽 속도를 GitHub.com로 제한합니다.

* [GitHub 앱에 대한 사용자 지정 배지 만들기](/ko/enterprise-server@3.21/apps/creating-github-apps/registering-a-github-app/creating-a-custom-badge-for-your-github-app)

  사용자 고유의 로고 이미지를 업로드하고 배경을 사용자 지정하여 GitHub 앱의 기본 배지를 바꿀 수 있습니다.

* [GitHub 앱을 사용한 인증 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app)

  GitHub App는 자체적으로, 앱 설치로 또는 사용자를 대신하여 인증할 수 있습니다.

* [GitHub 앱으로 인증](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app)

  설치 액세스 토큰을 생성하거나 앱을 관리하기 위해 GitHub App으로 인증할 수 있습니다.

* [GitHub 앱 설치로 인증](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation)

  앱이 설치된 계정이 소유한 리소스에 영향을 주는 API 요청을 보내기 위해 GitHub App을(를) 설치로서 인증할 수 있습니다.

* [사용자를 대신하여 GitHub 앱으로 인증](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user)

  GitHub 앱은 사용자를 대신하여 이슈 생성, 댓글 게시 또는 배포 생성 등의 작업을 수행할 수 있습니다.

* [GitHub 앱에 대한 프라이빗 키 관리](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/managing-private-keys-for-github-apps)

  프라이빗 키를 관리하여 인증할 수 있습니다 GitHub App.

* [GitHub 앱에 대한 JWT(JSON 웹 토큰) 생성](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app)

  GitHub App을(를) 사용하여 특정 REST API 엔드포인트에 인증하는 JWT(JSON Web Token)를 만드는 방법을 알아봅니다.

* [GitHub 앱에 대한 설치 액세스 토큰 생성](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/generating-an-installation-access-token-for-a-github-app)

  GitHub App에 대한 설치 액세스 토큰을 생성하는 방법을 알아보세요.

* [GitHub 앱에 대한 사용자 액세스 토큰 생성](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)

  앱 활동을 사용자에게 특성화하기 위해 사용자 GitHub App 에 대한 사용자 액세스 토큰을 생성할 수 있습니다.

* [사용자 액세스 토큰 새로 고침](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens)

  일반 토큰 회전을 적용하고 손상된 토큰의 영향을 줄이려면 GitHub App 만료되는 사용자 액세스 토큰을 사용하도록 구성할 수 있습니다.

* [GitHub Actions 워크플로에서 GitHub 앱을 사용하여 인증된 API 요청 만들기](/ko/enterprise-server@3.21/apps/creating-github-apps/authenticating-with-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow)

  GitHub App의 설치 액세스 토큰을 사용하여 GitHub Actions 워크플로에서 인증된 API 요청을 수행할 수 있습니다. 토큰을 사용자 지정 작업에 전달하여 해당 작업이 인증된 API 요청을 하도록 설정할 수도 있습니다.

* [GitHub 앱에 대한 코드 작성 정보](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/about-writing-code-for-a-github-app)

  GitHub App에 기능을 추가하는 코드를 작성해야 합니다.

* [GitHub 앱을 빌드하기 위한 빠른 시작](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)

  풀 리퀘스트에 댓글을 다는 GitHub App를 빠르게 만들 수 있습니다.

* [웹후크 이벤트에 응답하는 GitHub 앱 빌드](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events)

  웹후크 이벤트에 응답하여 API 요청을 보내는 GitHub App를 빌드하는 방법을 알아보세요.

* [GitHub 앱을 사용하여 "GitHub 사용하여 로그인" 단추 빌드](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-login-with-github-button-with-a-github-app)

  이 자습서에 따라 GitHub App에 대해 웹 애플리케이션 흐름을 통해 사용자 액세스 토큰을 생성하는 Ruby 코드를 작성하세요.

* [GitHub 앱을 사용하여 CLI 빌드](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-a-cli-with-a-github-app)

  이 튜토리얼에 따라 디바이스 흐름을 통해 GitHub App용 사용자 액세스 토큰을 생성하는 Ruby CLI를 작성하세요.

* [GitHub 앱을 사용하여 CI 검사 빌드](/ko/enterprise-server@3.21/apps/creating-github-apps/writing-code-for-a-github-app/building-ci-checks-with-a-github-app)

  테스트를 실행하기 위해 GitHub App와 검사 항목을 사용하는 연속 통합 서버를 구축합니다.

* [GitHub 앱 공유](/ko/enterprise-server@3.21/apps/sharing-github-apps/sharing-your-github-app)

  다른 사용자와 GitHub App을 공유할 수 있습니다.

* [GitHub Enterprise Server에서 GitHub 앱을 사용할 수 있도록 설정](/ko/enterprise-server@3.21/apps/sharing-github-apps/making-your-github-app-available-for-github-enterprise-server)

  GitHub Enterprise Server 인스턴스가 사용자의 GitHub App을 사용하려면 몇 가지 추가 단계를 수행해야 합니다.

* [매니페스트에서 GitHub 앱 등록](/ko/enterprise-server@3.21/apps/sharing-github-apps/registering-a-github-app-from-a-manifest)

  GitHub App 매니페스트는 미리 구성된 GitHub App 등록을 다른 사용자와 공유하는 방법입니다. 매니페스트 흐름을 사용하면 사용자가 신속하게 GitHub App를 등록할 수 있습니다.

* [URL 매개 변수를 사용하여 GitHub 앱 등록](/ko/enterprise-server@3.21/apps/sharing-github-apps/registering-a-github-app-using-url-parameters)

  URL 쿼리 매개 변수를 사용하여 다른 사용자가 미리 선택한 특정 구성으로 새 GitHub App 항목을 신속하게 설정할 수 있습니다.

* [GitHub 앱 등록 수정](/ko/enterprise-server@3.21/apps/maintaining-github-apps/modifying-a-github-app-registration)

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

* [GitHub 앱에 대한 선택적 기능 활성화](/ko/enterprise-server@3.21/apps/maintaining-github-apps/activating-optional-features-for-github-apps)

  GitHub Apps의 새로운 선택 기능을 테스트할 수 있습니다.

* [GitHub 앱 관리자 정보](/ko/enterprise-server@3.21/apps/maintaining-github-apps/about-github-app-managers)

  앱 관리자는 계정이 소유한 GitHub App 등록의 일부 또는 전체를 관리할 수 있습니다.

* [GitHub 앱 설치 일시 중단](/ko/enterprise-server@3.21/apps/maintaining-github-apps/suspending-a-github-app-installation)

  설치한 GitHub App 계정이 소유한 리소스에 대한 GitHub App의 접근을 일시적으로 차단할 수 있습니다.

* [GitHub 앱의 소유권 이전](/ko/enterprise-server@3.21/apps/maintaining-github-apps/transferring-ownership-of-a-github-app)

  GitHub 앱 등록의 소유권을 다른 사용자나 조직으로 이전할 수 있습니다.

* [GitHub 앱 삭제](/ko/enterprise-server@3.21/apps/maintaining-github-apps/deleting-a-github-app)

  앱을 더 이상 사용하거나 유지 관리하지 않으려면 소유한 항목을 삭제 GitHub Apps 할 수 있습니다.

* [OAuth 앱 권한 부여](/ko/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps)

  OAuth를 사용하여 ID를 타사 애플리케이션에 연결할 GitHub 수 있습니다.
  OAuth app에 권한을 부여할 때는 해당 애플리케이션을 신뢰할 수 있는지 확인하고, 누가 개발했는지 검토하며, 애플리케이션이 접근하려는 정보의 유형을 검토해야 합니다.

* [권한 있는 OAuth 앱 검토](/ko/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-oauth-apps)

  권한 있는 애플리케이션을 검토하여 광범위한 권한이 있는 새 애플리케이션이 승인되었는지 확인해야 합니다(예: 프라이빗 리포지토리에 액세스할 수 있는 권한이 있는 애플리케이션).

* [타사 애플리케이션과 연결](/ko/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/connecting-with-third-party-applications)

  OAuth를 사용하여 ID를 타사 애플리케이션에 연결할 GitHub 수 있습니다. 이러한 애플리케이션 중 하나에 권한을 부여하는 경우 애플리케이션을 신뢰하는지 확인하고 애플리케이션 개발자와 애플리케이션에서 액세스하려는 정보 종류를 검토해야 합니다.

* [권한이 있는 OAuth 앱](/ko/enterprise-server@3.21/apps/oauth-apps/using-oauth-apps/privileged-oauth-apps)

  일부 OAuth apps는 GitHub가 소유한, 특별한 기능이 부여된 특권 앱입니다.

* [GitHub 앱과 OAuth 앱 간의 차이점](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)

  일반적으로 GitHub Apps은(는) 세분화된 사용 권한으로 앱이 액세스할 수 있는 리포지토리를 더 잘 제어할 수 있으며 수명이 짧은 토큰을 사용하는 OAuth apps(으)로 기본 설정됩니다.

* [OAuth 앱의 트래픽률 제한](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/rate-limits-for-oauth-apps)

  속도 제한은 모든 사용자에게 일관된 액세스를 보장하기 위해 트래픽 속도를 GitHub.com로 제한합니다.

* [OAuth 앱 만들기](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)

  개인 계정에서 또는 관리자 액세스 권한이 있는 조직에서 OAuth app을(를) 만들고 등록할 수 있습니다. OAuth app을(를) 만드는 동안 퍼블릭으로 간주되는 정보만 사용하여 개인 정보를 보호해야 합니다.

* [OAuth 앱을 사용하여 REST API에 인증하기](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/authenticating-to-the-rest-api-with-an-oauth-app)

  몇 가지 예제를 사용하여 인증하는 다양한 방법에 대해 알아봅니다.

* [OAuth 앱 권한 부여](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps)

  다른 사용자가 OAuth app에 권한을 부여하도록 설정할 수 있습니다.

* [OAuth 앱에 대한 범위](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)

  범위를 사용하면 필요한 액세스 유형을 정확히 지정할 수 있습니다. 범위는 OAuth 토큰에 대한 액세스를 \_제한\_합니다. 사용자가 이미 가지고 있는 것 이상의 추가 권한은 부여하지 않습니다.

* [OAuth 앱에 대한 사용자 지정 배지 만들기](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/creating-a-custom-badge-for-your-oauth-app)

  사용자 고유의 로고 이미지를 업로드하고 배경을 사용자 지정하여 OAuth app의 기본 배지를 바꿀 수 있습니다.

* [OAuth 앱 만들기 모범 사례](/ko/enterprise-server@3.21/apps/oauth-apps/building-oauth-apps/best-practices-for-creating-an-oauth-app)

  OAuth app의 보안 및 성능을 향상시키려면 다음 모범 사례를 따르세요.

* [OAuth 앱 수정](/ko/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/modifying-an-oauth-app)

  OAuth app을(를) 만들고 등록한 후 변경할 수 있습니다.

* [OAuth 앱의 선택적 기능 활성화](/ko/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/activating-optional-features-for-oauth-apps)

  OAuth apps에 대한 새로운 선택적 기능을 테스트할 수 있습니다.

* [OAuth 앱의 소유권 이전](/ko/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/transferring-ownership-of-an-oauth-app)

  OAuth app의 소유권을 다른 사용자나 조직으로 이전할 수 있습니다.

* [권한 부여 요청 오류 문제 해결](/ko/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-authorization-request-errors)

  사용자에 대한 OAuth 토큰을 가져올 때 초기 권한 부여 요청 단계에서 일부 오류가 발생할 수 있습니다.

* [OAuth 앱 액세스 토큰 요청 오류 문제 해결](/ko/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/troubleshooting-oauth-app-access-token-request-errors)

  액세스 토큰에 대한 코드를 교환할 때 발생할 수 있는 추가 오류 집합이 있습니다. 이러한 응답의 형식은 전달하는 수락 머리글에 의해 결정됩니다.

* [OAuth 앱 삭제](/ko/enterprise-server@3.21/apps/oauth-apps/maintaining-oauth-apps/deleting-an-oauth-app)

  더 이상 사용하지 않으면 OAuth apps을(를) 삭제할 수 있습니다.

* [GitHub 인증 검색 엔드포인트](/ko/enterprise-server@3.21/apps/github-authentication-discovery-endpoints)

  GitHub OAuth 2.0 및 OpenID Connect 메타데이터 문서를 게시합니다.