{"meta":{"title":"웹후크 만들기","intro":"웹후크를 만들어 GitHub에서 발생하는 특정 이벤트를 구독할 수 있습니다.","product":"웹후크","breadcrumbs":[{"href":"/ko/enterprise-cloud@latest/webhooks","title":"웹후크"},{"href":"/ko/enterprise-cloud@latest/webhooks/using-webhooks","title":"웹후크 사용"},{"href":"/ko/enterprise-cloud@latest/webhooks/using-webhooks/creating-webhooks","title":"webhook 만들기"}],"documentType":"article"},"body":"# 웹후크 만들기\n\n웹후크를 만들어 GitHub에서 발생하는 특정 이벤트를 구독할 수 있습니다.\n\n## 웹후크 만들기 알아보기\n\nGitHub에서 발생하는 특정 이벤트를 구독하기 위해 리포지토리, 조직, GitHub Enterprise, GitHub Marketplace 계정, GitHub Sponsors 계정, 또는 GitHub App에 대해 웹후크를 생성할 수 있습니다.\n\n다양한 유형의 웹후크에 대한 자세한 내용은 [웹후크 유형](/ko/enterprise-cloud@latest/webhooks/types-of-webhooks)을(를) 참조하세요.\n\n웹후크 이벤트의 전체 목록은 [웹후크 이벤트 및 페이로드](/ko/enterprise-cloud@latest/webhooks/webhook-events-and-payloads)을(를) 참조하세요.\n\n## 리포지토리 웹후크 만들기\n\n특정 리포지토리에서 발생하는 이벤트를 구독하는 웹후크를 만들 수 있습니다. 리포지토리에서 웹후크를 만들려면 해당 리포지토리의 소유자이거나 리포지토리의 관리자 액세스 권한이 있어야 합니다.\n\nGitHub 웹 인터페이스나 REST API를 사용하여 리포지토리 웹후크를 만들 수 있습니다. REST API를 사용하여 리포지토리 웹후크를 만드는 방법에 대한 자세한 내용은 [리포지토리 웹후크에 대한 REST API 엔드포인트](/ko/enterprise-cloud@latest/rest/webhooks/repos#create-a-repository-webhook)을(를) 참조하세요.\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n2. 리포지토리 이름 아래에서 ** Settings**를 클릭합니다. \"설정\" 탭이 표시되지 않으면 **** 드롭다운 메뉴를 선택한 다음 **설정**을 클릭합니다.\n\n \n3. 왼쪽 사이드바에서 ** Webhooks**를 클릭합니다.\n4. **웹후크 추가**를 클릭합니다.\n5. \"페이로드 URL\"에서 페이로드를 수신하려는 URL을 입력합니다.\n6. 필요에 따라 **콘텐츠 형식** 드롭다운 메뉴를 선택하고 웹후크 페이로드를 수신할 데이터 서식을 클릭합니다.\n * **application/json**은 `POST` 요청의 본문으로 직접 JSON 페이로드를 전달합니다.\n * **application/x-www-form-urlencoded**는 `payload`(이)라는 양식 매개 변수로 JSON 페이로드를 전송합니다.\n7. 필요에 따라 \"비밀\"에서 `secret` 키로 사용할 문자열을 입력합니다. 엔트로피가 높은 임의의 텍스트 문자열을 선택해야 합니다. 웹후크 비밀을 사용하여 들어오는 요청을 GitHub에서 시작된 요청으로만 제한할 수 있습니다. 자세한 내용은 [웹후크 제공 유효성 검사하기](/ko/enterprise-cloud@latest/webhooks/using-webhooks/securing-your-webhooks)을(를) 참조하세요.\n8. \"이 웹후크를 트리거할 이벤트는 무엇인가요?\"에서 수신하려는 웹후크 이벤트를 선택합니다. 필요한 웹후크 이벤트만 구독해야 합니다.\n9. **이벤트를 각각 선택하겠습니다**를 선택했다면 웹후크를 트리거하고자 하는 이벤트를 선택합니다.\n10. 구성을 추가한 다음 웹후크를 즉시 활성화하려면 **활성화**를 선택합니다.\n11. **웹후크 추가**를 클릭합니다.\n\n새 웹후크를 만들고 나면 GitHub에서 웹후크가 올바르게 설정되었음을 알리는 간단한 `ping` 이벤트를 보냅니다. 자세한 내용은 [웹후크 이벤트 및 페이로드](/ko/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#ping)을(를) 참조하세요.\n\n## 조직 웹후크 만들기\n\n특정 조직에서 발생하는 이벤트를 구독하는 웹후크를 만들 수 있습니다. 조직에서 웹후크를 만들려면 해당 조직의 소유자여야야 합니다.\n\nGitHub 웹 인터페이스나 REST API를 사용하여 조직 웹후크를 만들 수 있습니다. REST API를 사용하여 조직 웹후크를 만드는 방법에 대한 자세한 내용은 [조직 웹후크에 대한 REST API 엔드포인트](/ko/enterprise-cloud@latest/rest/orgs/webhooks#create-an-organization-webhook)을(를) 참조하세요.\n\n1. GitHub의 페이지 오른쪽 상단 모서리에서 프로필 사진을 클릭합니다.\n2. **내 조직**을 클릭합니다.\n3. 그런 다음, 조직 오른쪽에 있는 **설정**을 클릭합니다.\n4. 왼쪽 사이드바에서 ** Webhooks**를 클릭합니다.\n5. **웹후크 추가**를 클릭합니다.\n6. \"페이로드 URL\"에서 페이로드를 수신하려는 URL을 입력합니다.\n7. 필요에 따라 **콘텐츠 형식** 드롭다운 메뉴를 선택하고 웹후크 페이로드를 수신할 데이터 서식을 클릭합니다.\n * **application/json**은 `POST` 요청의 본문으로 직접 JSON 페이로드를 전달합니다.\n * **application/x-www-form-urlencoded**는 `payload`(이)라는 양식 매개 변수로 JSON 페이로드를 전송합니다.\n8. 필요에 따라 \"비밀\"에서 `secret` 키로 사용할 문자열을 입력합니다. 엔트로피가 높은 임의의 텍스트 문자열을 선택해야 합니다. 웹후크 비밀을 사용하여 들어오는 요청을 GitHub에서 시작된 요청으로만 제한할 수 있습니다. 자세한 내용은 [웹후크 제공 유효성 검사하기](/ko/enterprise-cloud@latest/webhooks/using-webhooks/securing-your-webhooks)을(를) 참조하세요.\n9. \"이 웹후크를 트리거할 이벤트는 무엇인가요?\"에서 수신하려는 웹후크 유형을 선택합니다. 필요한 웹후크 이벤트만 구독해야 합니다.\n10. **이벤트를 각각 선택하겠습니다**를 선택했다면 웹후크를 트리거할 이벤트를 선택합니다.\n11. 구성을 추가한 다음 웹후크를 즉시 활성화하려면 **활성화**를 선택합니다.\n12. **웹후크 추가**를 클릭합니다.\n\n새 웹후크를 만들고 나면 GitHub에서 웹후크가 올바르게 설정되었음을 알리는 간단한 `ping` 이벤트를 보냅니다. 자세한 내용은 [웹후크 이벤트 및 페이로드](/ko/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#ping)을(를) 참조하세요.\n\n## GitHub Enterprise에 대한 전역 웹후크 만들기\n\n엔터프라이즈 소유자는 전역 웹후크를 만들어 엔터프라이즈 내에서 발생하는 이벤트를 구독할 수 있습니다.\n\n1. 귀하의 기업으로 이동하세요. 예를 들어 GitHub.com의 [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) 페이지에서.\n\n2. 페이지 맨 위에서 클릭합니다\\*\\*\\*\\*.\n\n3. \" 설정\"에서 **후크**를 클릭합니다.\n\n4. **웹후크 추가**를 클릭합니다.\n\n5. \"페이로드 URL\" 필드에 페이로드를 수신하려는 URL을 입력합니다.\n\n6. 필요에 따라 **콘텐츠 형식** 드롭다운 메뉴를 선택하고 웹후크 페이로드를 수신할 데이터 서식을 클릭합니다.\n * **application/json**은 `POST` 요청의 본문으로 직접 JSON 페이로드를 전달합니다.\n * **application/x-www-form-urlencoded**는 `payload`(이)라는 양식 매개 변수로 JSON 페이로드를 전송합니다.\n\n7. 필요에 따라 \"비밀\"에서 `secret` 키로 사용할 문자열을 입력합니다. 엔트로피가 높은 임의의 텍스트 문자열을 선택해야 합니다. 웹후크 비밀을 사용하여 들어오는 요청을 GitHub에서 시작된 요청으로만 제한할 수 있습니다. 자세한 내용은 [웹후크 제공 유효성 검사하기](/ko/enterprise-cloud@latest/webhooks/using-webhooks/securing-your-webhooks)을(를) 참조하세요.\n\n8. 필요에 따라, 페이로드 URL이 HTTPS이고 페이로드를 제공할 때 GitHub Enterprise Server이(가) SSL 인증서를 확인하지 않기를 원하는 경우, \"SSL 확인\"에서 **사용 중지**를 선택합니다. SSL 확인에 대한 정보를 읽은 다음 **비활성화, 내 웹후크가 안전하지 않을 수 있음을 이해합니다**를 클릭합니다.\n\n > \\[!WARNING]\n > SSL 확인은 후크 페이로드가 안전하게 전달되도록 하는 데 도움이 됩니다. SSL 확인을 사용하지 않도록 설정하는 것은 권장하지 않습니다.\n\n9. \"이 웹후크를 트리거할 이벤트는 무엇인가요?\"에서 수신하려는 웹후크 유형을 선택합니다. 필요한 웹후크 이벤트만 구독해야 합니다.\n\n10. **이벤트를 각각 선택하겠습니다**를 선택했다면 웹후크를 트리거할 이벤트를 선택합니다.\n\n11. 구성을 추가한 다음 웹후크를 즉시 활성화하려면 **활성화**를 선택합니다.\n\n12. **웹후크 추가**를 클릭합니다.\n\n## GitHub Marketplace 웹후크 만들기\n\n웹후크를 만들어 GitHub Marketplace에 게시한 앱과 관련된 이벤트를 구독할 수 있습니다. 앱 소유자 또는 앱 관리자만 GitHub Marketplace 웹후크를 만들 수 있습니다.\n\n1. [GitHub Marketplace 목록 페이지](https://github.com/marketplace/manage)로 이동합니다.\n2. 웹후크 전송 내역을 확인하려는 GitHub Marketplace 목록 옆에 있는 **목록 관리**를 클릭합니다.\n3. 사이드바에서 **웹후크**를 클릭합니다.\n4. \"페이로드 URL\"에서 페이로드를 수신하려는 URL을 입력합니다.\n5. 필요에 따라 **콘텐츠 형식** 드롭다운 메뉴를 선택하고 웹후크 페이로드를 수신할 데이터 서식을 클릭합니다.\n * **application/json**은 `POST` 요청의 본문으로 직접 JSON 페이로드를 전달합니다.\n * **application/x-www-form-urlencoded**는 `payload`(이)라는 양식 매개 변수로 JSON 페이로드를 전송합니다.\n6. 필요에 따라 \"비밀\"에서 `secret` 키로 사용할 문자열을 입력합니다. 엔트로피가 높은 임의의 텍스트 문자열을 선택해야 합니다. 웹후크 비밀을 사용하여 들어오는 요청을 GitHub에서 시작된 요청으로만 제한할 수 있습니다. 자세한 내용은 [웹후크 제공 유효성 검사하기](/ko/enterprise-cloud@latest/webhooks/using-webhooks/securing-your-webhooks)을(를) 참조하세요.\n7. 구성을 추가한 다음 웹후크를 즉시 활성화하려면 **활성화**를 선택합니다.\n8. **웹후크 만들기**를 클릭합니다.\n\n새 웹후크를 만들고 나면 GitHub에서 웹후크가 올바르게 설정되었음을 알리는 간단한 `ping` 이벤트를 보냅니다. 자세한 내용은 [웹후크 이벤트 및 페이로드](/ko/enterprise-cloud@latest/webhooks/webhook-events-and-payloads#ping)을(를) 참조하세요.\n\n## GitHub Sponsors 웹훅 생성하기\n\n웹후크를 만들어 스폰서쉽과 관련된 이벤트를 구독할 수 있습니다. 스폰서 계정의 소유자만 해당 계정에 대한 스폰서쉽 웹후크를 만들 수 있습니다. 후원 웹훅이 구독된 이벤트에 대한 자세한 내용은 [`sponsorship` 웹훅 이벤트](/ko/enterprise-cloud@latest/webhooks-and-events/webhooks/webhook-events-and-payloads#sponsorship)를 확인하십시오.\n\n1. 페이지의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, **Your sponsors**를 클릭합니다.\n2. 웹후크를 만들려는 계정 옆에 있는 **대시보드**를 클릭합니다.\n3. 왼쪽 사이드바에서 **웹후크**를 클릭합니다.\n4. **웹후크 추가**를 클릭합니다.\n5. \"페이로드 URL\"에서 페이로드를 수신하려는 URL을 입력합니다.\n6. 필요에 따라 **콘텐츠 형식** 드롭다운 메뉴를 선택하고 웹후크 페이로드를 수신할 데이터 서식을 클릭합니다.\n * **application/json**은 `POST` 요청의 본문으로 직접 JSON 페이로드를 전달합니다.\n * **application/x-www-form-urlencoded**는 `payload`(이)라는 양식 매개 변수로 JSON 페이로드를 전송합니다.\n7. 필요에 따라 \"비밀\"에서 `secret` 키로 사용할 문자열을 입력합니다. 엔트로피가 높은 임의의 텍스트 문자열을 선택해야 합니다. 웹후크 비밀을 사용하여 들어오는 요청을 GitHub에서 시작된 요청으로만 제한할 수 있습니다. 자세한 내용은 [웹후크 제공 유효성 검사하기](/ko/enterprise-cloud@latest/webhooks/using-webhooks/securing-your-webhooks)을(를) 참조하세요.\n8. 구성을 추가한 다음 웹후크를 즉시 활성화하려면 **활성화**를 선택합니다.\n9. **웹후크 만들기**를 클릭합니다.\n\n## GitHub App용 웹후크 생성\n\nGitHub App의 소유자는 특정 이벤트가 발생할 때마다 알림을 받도록 앱을 웹후크 이벤트에 구독할 수 있습니다. 앱 소유자가 GitHub App의 앱 관리자를 지정한 경우, 앱 관리자도 앱을 웹후크 이벤트에 구독할 수 있습니다. 자세한 내용은 [GitHub 앱에서 웹후크 사용](/ko/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps)을(를) 참조하세요.\n\n각 GitHub App에는 하나의 웹후크가 있습니다. GitHub App 등록 시 웹후크를 구성하거나 기존 GitHub App 등록에 대한 웹후크 구성을 편집할 수 있습니다.\n\nGitHub App을 등록 시 웹후크를 구성하는 방법에 대한 자세한 내용은 [GitHub 앱 등록](/ko/enterprise-cloud@latest/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)을(를) 참조하세요.\n\n기존 GitHub App 등록에 대한 웹후크를 구성하려면 다음을 수행합니다.\n\n1. GitHub의 페이지 오른쪽 위 모서리에서 프로필 사진을 클릭합니다.\n\n2. 계정 설정으로 이동합니다.\n * 개인 계정 소유한 앱의 경우 **설정**을 클릭합니다.\n * 조직이 소유한 앱의 경우:\n 1. **사용자의 조직**을 클릭합니다.\n 2. 조직 오른쪽에서 **설정**을 클릭합니다.\n * 엔터프라이즈가 소유한 앱의 경우:\n 1. Enterprise Managed Users을(를) 사용하는 경우 **내 엔터프라이즈**를 클릭하여 엔터프라이즈 계정 설정으로 바로 이동합니다.\n 2. 개인 계정을 사용하는 경우에는 **내 엔터프라이즈**를 클릭한 다음 엔터프라이즈 오른쪽에서 **설정**을 클릭합니다.\n\n3. GitHub App 설정으로 이동합니다.\n * 개인 계정 또는 조직이 소유한 앱의 경우:\n 1. 왼쪽 사이드바에서 ** 개발자 설정**을 클릭하고 **GitHub Apps** 를 클릭합니다.\n * 엔터프라이즈가 소유한 앱의 경우:\n 1. 왼쪽 사이드바의 에서 \"설정\"을 클릭한 다음 **GitHub Apps** 을(를) 클릭합니다.\n\n4. 웹후크를 구성하려는 GitHub App 옆에 있는 **편집**을 클릭합니다.\n\n5. \"웹후크\"에서 **활성화**를 선택합니다.\n\n6. \"웹후크 URL\"에서 페이로드를 수신하려는 URL을 입력합니다.\n\n7. 필요에 따라 \"웹후크 비밀\"에 `secret` 키로 사용할 문자열을 입력합니다. 엔트로피가 높은 임의의 텍스트 문자열을 선택해야 합니다. 웹후크 비밀을 사용하여 들어오는 요청을 GitHub에서 시작된 요청으로만 제한할 수 있습니다. 자세한 내용은 [웹후크 제공 유효성 검사하기](/ko/enterprise-cloud@latest/webhooks/using-webhooks/securing-your-webhooks)을(를) 참조하세요.\n\n8. **변경 내용 저장**을 클릭합니다.\n\n9. 사이드바에서 **권한 및 이벤트**를 클릭합니다.\n\n10. GitHub App 등록에 대해 선택할 수 있는 특정 웹후크 이벤트는 앱에 대해 선택한 사용 권한 유형에 따라 결정됩니다. 먼저 앱에 부여할 사용 권한을 선택한 다음 해당 사용 권한 집합과 관련된 웹후크 이벤트에 앱을 구독할 수 있습니다.\n\n \"리포지토리 권한\", \"조직 권한\", \"계정 권한\" 섹션에서 앱이 구독할 이벤트에 필요한 권한을 선택합니다. 자세한 내용은 [GitHub 앱에 대한 권한 선택](/ko/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app)을(를) 참조하세요. 권한을 변경할 때 고려해야 할 사항에 대한 자세한 내용은 [GitHub App 등록 수정하기](/ko/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app-registration#changing-the-permissions-of-a-github-app)를 참조하세요.\n\n11. \"이벤트 구독\"에서 GitHub App가 수신할 웹후크 이벤트를 선택합니다.\n\n12. **변경 내용 저장**을 클릭합니다.\n\nREST API를 사용하여 GitHub App에 대한 웹후크를 만들 수도 있습니다. 자세한 내용은 [웹후크용 GitHub App REST API 엔드포인트](/ko/enterprise-cloud@latest/rest/apps/webhooks)을(를) 참조하세요.\n\n## 추가 참고 자료\n\n* [웹후크 정보](/ko/enterprise-cloud@latest/webhooks/about-webhooks)\n* [웹후크 배달 처리](/ko/enterprise-cloud@latest/webhooks/using-webhooks/handling-webhook-deliveries)"}