{"id":25343875,"url":"https://github.com/appscode-cloud/cert-manager-webhook-ace","last_synced_at":"2025-04-08T14:45:59.200Z","repository":{"id":100757635,"uuid":"586317240","full_name":"appscode-cloud/cert-manager-webhook-ace","owner":"appscode-cloud","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-07T06:36:25.000Z","size":9370,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T11:05:32.497Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/appscode-cloud.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":"2023-01-07T17:53:25.000Z","updated_at":"2025-02-07T06:36:16.000Z","dependencies_parsed_at":"2024-08-14T15:24:49.686Z","dependency_job_id":"96e4160b-5c01-4229-b39c-dac05b58195b","html_url":"https://github.com/appscode-cloud/cert-manager-webhook-ace","commit_stats":null,"previous_names":["bytebuilders/cert-manager-webhook-appscode","appscode-cloud/cert-manager-webhook-ace"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appscode-cloud%2Fcert-manager-webhook-ace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appscode-cloud%2Fcert-manager-webhook-ace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appscode-cloud%2Fcert-manager-webhook-ace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appscode-cloud%2Fcert-manager-webhook-ace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appscode-cloud","download_url":"https://codeload.github.com/appscode-cloud/cert-manager-webhook-ace/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247866114,"owners_count":21009238,"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":"2025-02-14T10:59:16.646Z","updated_at":"2025-04-08T14:45:59.176Z","avatar_url":"https://github.com/appscode-cloud.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cert-Manager ACME DNS01 Webhook Solver for AppsCode DNS Proxy for Cloudfare\n\nThis solver can be used when you want to use [cert-manager](https://github.com/cert-manager/cert-manager) with AppsCode DNS Proxy for Cloudfare. \n\n## Installation\n\n### cert-manager\n\nFollow the [instructions](https://cert-manager.io/docs/installation/) using the cert-manager documentation to install it within your cluster.\n\n### Webhook\n\n#### Using public helm chart\n\n```bash\nhelm repo add appscode https://charts.appscode.com/stable/\nhelm repo update\nhelm upgrade -i cert-manager-webhook-ace appscode/cert-manager-webhook-ace \\\n  --namespace cert-manager --create-namespace\n```\n\n**Note**: The kubernetes resources used to install the Webhook should be deployed within the same namespace as the cert-manager.\n\nTo uninstall the webhook run\n```bash\nhelm uninstall --namespace cert-manager cert-manager-webhook-ace\n```\n\n## Usage\n\n### Credentials\n\nIn order to access the DNS Proxy, the webhook needs an [API token] from ByteBuilders.\n\n```\nkubectl create secret generic ace-secret --from-literal=api-token=\u003cYOUR_TOKEN\u003e\n```\n\n### Create Issuer\n\nCreate a `ClusterIssuer` or `Issuer` resource as following:\n\n#### Cluster-wide Issuer\n```\napiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\n  name: letsencrypt-staging\nspec:\n  acme:\n    # The ACME server URL\n    server: https://acme-staging-v02.api.letsencrypt.org/directory\n    \n    # Email address used for ACME registration\n    email: mail@example.com # REPLACE THIS WITH YOUR EMAIL\n    \n    # Name of a secret used to store the ACME account private key\n    privateKeySecretRef:\n      name: letsencrypt-staging\n\n    solvers:\n    - dns01:\n        webhook:\n          solverName: \"ace\"\n          groupName: webhook.dns.appscode.com\n          config:\n            baseURL: \"https://dns.byte.builders\"\n            apiTokenSecretRef:\n              name: ace-secret\n              key: api-token\n```\n\nBy default, the API token used will be obtained from the secret in the same namespace as the webhook.\n\n### Create a certificate\n\nCreate your certificate resource as follows:\n\n```\napiVersion: cert-manager.io/v1\nkind: Certificate\nmetadata:\n  name: example-cert\n  namespace: cert-manager\nspec:\n  commonName: example.com\n  dnsNames:\n  - example.com # REPLACE THIS WITH YOUR DOMAIN\n  issuerRef:\n   name: letsencrypt-staging\n   kind: ClusterIssuer\n  secretName: example-cert\n```\n\n# Acknowledgement\n\nThis project was forked from [okteto/cert-manager-webhook-civo](https://github.com/okteto/cert-manager-webhook-civo). The cloudflare package was copied from [cert-manager project](https://github.com/cert-manager/cert-manager/tree/master/pkg/issuer/acme/dns/cloudflare). \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappscode-cloud%2Fcert-manager-webhook-ace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappscode-cloud%2Fcert-manager-webhook-ace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappscode-cloud%2Fcert-manager-webhook-ace/lists"}