generator

Documentation

Overview

Package generator provides an interface and implementation to provision certificates.

Create an instance of CertGenerator.

cg := SelfSignedCertGenerator{}

Generate the certificates.

certs, err := cg.Generate("foo.bar.com")
if err != nil {
	// handle error
}

Index

• func ServiceToCommonName(serviceNamespace, serviceName string) string
• type Artifacts
• type CertGenerator
• type SelfSignedCertGenerator
  • func (cp *SelfSignedCertGenerator) Generate(commonName string) (*Artifacts, error)

Examples

• ServiceToCommonName

Functions

func ServiceToCommonName

func ServiceToCommonName(serviceNamespace, serviceName string) string

ServiceToCommonName generates the CommonName for the certificate when using a k8s service.

Example

fmt.Println(ServiceToCommonName("myservicenamespace", "myservicename"))

Output:

myservicename.myservicenamespace.svc

Types

type Artifacts

type Artifacts struct {
	// PEM encoded private key
	Key []byte
	// PEM encoded serving certificate
	Cert []byte
	// PEM encoded CA certificate
	CACert []byte
}

Artifacts hosts a private key, its corresponding serving certificate and the CA certificate that signs the serving certificate.

type CertGenerator

type CertGenerator interface {
	// Generate returns a Artifacts struct.
	Generate(CommonName string) (*Artifacts, error)
}

CertGenerator is an interface to provision the serving certificate.

type SelfSignedCertGenerator

type SelfSignedCertGenerator struct{}

SelfSignedCertGenerator implements the CertGenerator interface. It provisions self-signed certificates.

func (*SelfSignedCertGenerator) Generate

func (cp *SelfSignedCertGenerator) Generate(commonName string) (*Artifacts, error)

Generate creates and returns a CA certificate, certificate and key for the server. serverKey and serverCert are used by the server to establish trust for clients, CA certificate is used by the client to verify the server authentication chain. The cert will be valid for 365 days.