Skip to main content

이 버전의 GitHub Enterprise Server는 다음 날짜에 중단됩니다. 2024-03-07. 중요한 보안 문제에 대해서도 패치 릴리스가 이루어지지 않습니다. 더 뛰어난 성능, 향상된 보안, 새로운 기능을 위해 최신 버전의 GitHub Enterprise Server로 업그레이드합니다. 업그레이드에 대한 도움말은 GitHub Enterprise 지원에 문의하세요.

웹후크 유형

웹후크를 만들어 특정 리포지토리, 조직, GitHub Enterprise, 또는 GitHub App에서 발생하는 이벤트를 구독할 수 있습니다.

웹후크 유형 정보

웹후크는 웹후크가 설치된 리포지토리, 조직, GitHub Enterprise, 또는 GitHub App에서 사용 가능한 이벤트에만 액세스할 수 있습니다.

개별 사용자 계정 또는 개인 알림이나 멘션 등의 사용자 리소스와 관련된 이벤트에 대한 웹후크를 만들 수 없습니다.

웹후크를 만들고 관리하려면 웹후크가 생성되고 이벤트를 수신 대기하는 리소스에 대한 관리자 액세스 권한을 소유 또는 보유해야 합니다. 예를 들어 조직의 웹후크를 관리하려면 해당 조직에 대한 관리자 권한이 필요합니다.

일부 웹후크 이벤트는 웹후크 유형에 따라 다릅니다. 예를 들어 조직 웹후크는 리포지토리 웹후크가 구독할 수 없는 조직 수준에서만 발생하는 이벤트를 구독할 수 있습니다. 각 웹후크의 사용 가능성에 대한 자세한 내용은 "웹후크 이벤트 및 페이로드"을 참조하세요.

자세한 내용은 "웹후크 정보"을(를) 참조하세요.

리포지토리 웹후크

리포지토리에 웹후크를 만들어 해당 리포지토리에서 발생하는 이벤트를 구독할 수 있습니다. 리포지토리에서 웹후크를 만들고 관리하려면 해당 리포지토리의 소유자이거나 리포지토리의 관리자 액세스 권한이 있어야 합니다. 필수 권한이 없는 리포지토리에서는 웹후크를 생성, 편집 또는 삭제할 수 없습니다.

단일 리포지토리에서 여러 개의 웹후크를 만들 수 있습니다. 그러나 개별 이벤트 유형을 각각 구독하는 최대 250개의 웹후크를 생성할 수 있습니다. 예를 들어 단일 리포지토리에서 각각 push 이벤트를 구독하는 최대 250개의 웹후크를 생성할 수 있습니다.

GitHub 웹 인터페이스 또는 REST API를 사용하여 리포지토리 웹후크를 관리할 수 있습니다. 자세한 내용은 "웹후크 만들기," "웹후크 편집하기," "웹후크 사용 중지하기"을 참조하세요. REST API를 사용하여 리포지토리 웹후크를 관리하는 방법에 대한 자세한 내용은 "리포지토리 웹후크"을 참조하세요.

조직 웹후크

조직에서 웹후크를 만들어 해당 조직에서 발생하는 이벤트를 구독할 수 있습니다. 조직 웹후크는 조직이 소유한 모든 리포지토리에서 발생하는 이벤트를 구독할 수 있습니다. 또한 새 구성원이 조직에 추가되는 경우와 같이 특정 리포지토리 외부에 있는 조직 수준에서 발생하는 이벤트도 구독할 수 있습니다.

조직에서 웹후크를 만들고 관리하려면 해당 조직의 소유자여야 합니다.

단일 조직에서 여러 개의 웹후크를 만들 수 있습니다. 그러나 개별 이벤트 유형을 각각 구독하는 최대 250개의 웹후크를 생성할 수 있습니다. 예를 들어 단일 조직에서 각각 push 이벤트를 구독하는 최대 }250개의 웹후크를 생성할 수 있습니다.

GitHub 웹 인터페이스 또는 REST API를 사용하여 조직 웹후크를 관리할 수 있습니다. 자세한 내용은 "웹후크 만들기," "웹후크 편집하기," "웹후크 사용 중지하기"을 참조하세요. REST API를 사용하여 조직 웹후크를 관리하는 방법에 대한 자세한 내용은 "조직 웹후크"을 참조하세요.

GitHub Enterprise에 대한 전역 웹후크

엔터프라이즈 소유자는 전역 웹후크를 만들어 엔터프라이즈 또는 엔터프라이즈 소유의 조직 및 리포지토리에서 발생하는 이벤트를 구독할 수 있습니다.

단일 엔터프라이즈에서 여러 개의 웹후크를 만들 수 있습니다. 그러나 개별 이벤트 유형을 각각 구독하는 최대 250개의 웹후크를 생성할 수 있습니다. 예를 들어 단일 엔터프라이즈에서 각각 membership 이벤트를 구독하는 최대 250개의 웹후크를 생성할 수 있습니다.

GitHub 웹 인터페이스를 사용하여 전역 웹후크를 관리할 수 있습니다. 자세한 내용은 "웹후크 만들기," "웹후크 편집하기," "웹후크 사용 중지하기"을 참조하세요. REST API를 사용하여 전역 웹후크를 관리할 수도 있습니다. 엔드포인트의 전체 목록은 "전역 webhook"을(를) 참조하세요.

GitHub App 웹후크

앱에 액세스 권한이 부여된 리포지토리 또는 조직에서 특정 이벤트가 발생할 때 웹후크를 수신하도록 GitHub App을(를) 구성할 수 있습니다.

각 GitHub App에는 GitHub에서 자동으로 생성되는 단일 웹후크가 있습니다. 기본적으로 웹후크는 이벤트를 구독하지 않습니다. 웹후크가 구독할 이벤트를 구성할 수 있습니다. GitHub App 웹후크는 삭제할 수 없지만 웹후크 제공 수신을 중지하도록 비활성화할 수 있습니다.

GitHub 웹 인터페이스 또는 REST API를 사용하여 GitHub App 웹후크를 관리할 수 있습니다. 자세한 내용은 "웹후크 만들기," "웹후크 편집하기," "웹후크 사용 중지하기"을 참조하세요. REST API를 사용하여 GitHub App 웹후크를 관리하는 방법에 대한 자세한 내용은 "GitHub 앱 웹후크"을 참조하세요.