https://github.com/cert-manager/istio-csr

istio-csr is an agent that allows for Istio workload and control plane components to be secured using cert-manager.
https://github.com/cert-manager/istio-csr

certificate istio kubernetes tls

Last synced: 1 day ago
JSON representation

istio-csr is an agent that allows for Istio workload and control plane components to be secured using cert-manager.

• Host: GitHub
• URL: https://github.com/cert-manager/istio-csr
• Owner: cert-manager
• License: apache-2.0
• Created: 2020-09-28T13:04:47.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-04-14T01:12:09.000Z (9 months ago)
• Last Synced: 2024-04-14T02:23:09.566Z (9 months ago)
• Topics: certificate, istio, kubernetes, tls
• Language: Go
• Homepage: https://cert-manager.io/docs/usage/istio-csr/
• Size: 1 MB
• Stars: 152
• Watchers: 6
• Forks: 55
• Open Issues: 43
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-repositories - cert-manager/istio-csr - istio-csr is an agent that allows for Istio workload and control plane components to be secured using cert-manager. (Go)

README

        


  





  

    

  

  

    

  

  

    

  



# istio-csr

istio-csr is an agent that allows for [Istio](https://istio.io) workload and

control plane components to be secured using

[cert-manager](https://cert-manager.io).

Certificates facilitating mTLS — both inter

and intra-cluster — will be signed, delivered and renewed using [cert-manager

issuers](https://cert-manager.io/docs/concepts/issuer).

istio-csr supports Istio v1.10+ and cert-manager v1.3+

---

## Documentation

Please follow the documentation at

[cert-manager.io](https://cert-manager.io/docs/usage/istio/) for installing and

using istio-csr.

## Release Process

The release process is documented in [RELEASE.md](RELEASE.md).

## Inner workings

istio-csr has 3 main components: the TLS certificate obtainer, the gRPC server and the CA bundle distributor.

1. The TLS certificate obtainer is responsible for obtaining the TLS certificate for the gRPC server.

It uses the cert-manager API to create a CertificateRequest resource, which will be picked up by cert-manager and signed by the configured issuer.

2. The gRPC server is responsible for receiving certificate signing requests from istiod and sending back the signed certificate.

Herefore, it uses the cert-manager CertificateRequest API to obtain the signed certificate.

3. The CA bundle distributor is responsible for creating and updating istio-ca-root-cert ConfigMaps in all namespaces (filtered using namespaceSelector).

## Istio Ambient

When istio-csr is being deployed into Istio Ambient, the `--ca-trusted-node-accounts` flag must be set with the `/` of ztunnel, eg. `istio-system/ztunnel`.

This allows ztunnel to authenticate using its own identity, then request certificates for the identity it will impersonate. For more information on how ztunnel handles certificate, see the Istio Ambient [docs](https://github.com/istio/istio/blob/master/architecture/ambient/ztunnel.md).