Skip to content

ibm-skills-network/cert-manager-webhook-ibm-cis

 
 

Repository files navigation

Cert Manager IBM Cloud Internet Services Webhook Solver

Cert Manager's ACME (automated certificate management environment) issuer type supports an optional 'webhook' solver, which can be used to implement custom DNS01 challenge solving logic.

IBM Cloud Internet Services is not officially supported in cert-manager core, so if you want to automatically provision certificates with cert-manager using DNS challenges, you can use this repository to do so.

Usage

Prerequisites

You must have cert-manager already installed in your cluster.

See installation instructions here.

Installation

You can install this webhook using helm:

helm install cert-manager-ibm-cis-webhook --set ibmCloudApiKey="<your IBM Cloud API key>"

Issuer

Create or update an Issuer (or ClusterIssuer) to reference the newly installed solver:

apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: acme-dns-issuer
spec:
  acme:
    email: you@your.email.domain.com
    privateKeySecretRef:
      name: letsencrypt
    server: https://acme-v02.api.letsencrypt.org/directory
    solvers:
    - dns01:
        webhook:
          config:
            ibmCloudCisCrns:
            - 'crn:v1:bluemix:public:internet-svcs:global:a/***:***::'
          groupName: acme.skills.network
          solverName: ibm-cloud-cis
      selector:
        dnsZones:
        - your.site.domain.com

After update your issuer, cert-manager should be able to automatically complete challenges for your certificates on IBM CIS-managed domains.

Contributing

Contributions are welcome. Please see docs/CONTRIBUTING.md to get started.

About

A cert-manager webhook implementing a ACME DNS01 solver webhook for IBM Cloud Internet Services

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Languages

  • Go 58.8%
  • Makefile 18.8%
  • Mustache 17.4%
  • Dockerfile 5.0%