{"id":19039902,"url":"https://github.com/cert-manager/webhook-example","last_synced_at":"2025-04-04T16:13:31.709Z","repository":{"id":39584138,"uuid":"181364127","full_name":"cert-manager/webhook-example","owner":"cert-manager","description":"A cert-manager sample repository for creating an ACME DNS01 solver webhook","archived":false,"fork":false,"pushed_at":"2024-04-28T11:55:00.000Z","size":228,"stargazers_count":92,"open_issues_count":17,"forks_count":387,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-05-21T20:07:32.345Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cert-manager.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-14T20:18:24.000Z","updated_at":"2024-05-06T08:32:45.000Z","dependencies_parsed_at":"2023-01-27T18:01:23.114Z","dependency_job_id":"8fba57f8-1169-4cf0-9bdf-fb3e31e21b6d","html_url":"https://github.com/cert-manager/webhook-example","commit_stats":{"total_commits":44,"total_committers":16,"mean_commits":2.75,"dds":0.8409090909090909,"last_synced_commit":"e57412778df6bab67651b0ba7b0da1c7dd273991"},"previous_names":["jetstack/cert-manager-webhook-example"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cert-manager%2Fwebhook-example","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cert-manager%2Fwebhook-example/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cert-manager%2Fwebhook-example/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cert-manager%2Fwebhook-example/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cert-manager","download_url":"https://codeload.github.com/cert-manager/webhook-example/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246457967,"owners_count":20780676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T22:19:26.652Z","updated_at":"2025-04-04T16:13:31.687Z","avatar_url":"https://github.com/cert-manager.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/cert-manager/cert-manager/d53c0b9270f8cd90d908460d69502694e1838f5f/logo/logo-small.png\" height=\"256\" width=\"256\" alt=\"cert-manager project logo\" /\u003e\n\u003c/p\u003e\n\n# ACME webhook example\n\nThe ACME issuer type supports an optional 'webhook' solver, which can be used\nto implement custom DNS01 challenge solving logic.\n\nThis is useful if you need to use cert-manager with a DNS provider that is not\nofficially supported in cert-manager core.\n\n## Why not in core?\n\nAs the project \u0026 adoption has grown, there has been an influx of DNS provider\npull requests to our core codebase. As this number has grown, the test matrix\nhas become un-maintainable and so, it's not possible for us to certify that\nproviders work to a sufficient level.\n\nBy creating this 'interface' between cert-manager and DNS providers, we allow\nusers to quickly iterate and test out new integrations, and then packaging\nthose up themselves as 'extensions' to cert-manager.\n\nWe can also then provide a standardised 'testing framework', or set of\nconformance tests, which allow us to validate that a DNS provider works as\nexpected.\n\n## Creating your own webhook\n\nWebhook's themselves are deployed as Kubernetes API services, in order to allow\nadministrators to restrict access to webhooks with Kubernetes RBAC.\n\nThis is important, as otherwise it'd be possible for anyone with access to your\nwebhook to complete ACME challenge validations and obtain certificates.\n\nTo make the set up of these webhook's easier, we provide a template repository\nthat can be used to get started quickly.\n\n### Creating your own repository\n\n### Running the test suite\n\nAll DNS providers **must** run the DNS01 provider conformance testing suite,\nelse they will have undetermined behaviour when used with cert-manager.\n\n**It is essential that you configure and run the test suite when creating a\nDNS01 webhook.**\n\nAn example Go test file has been provided in [main_test.go](https://github.com/cert-manager/webhook-example/blob/master/main_test.go).\n\nYou can run the test suite with:\n\n```bash\n$ TEST_ZONE_NAME=example.com. make test\n```\n\nThe example file has a number of areas you must fill in and replace with your\nown options in order for tests to pass.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcert-manager%2Fwebhook-example","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcert-manager%2Fwebhook-example","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcert-manager%2Fwebhook-example/lists"}