tls

Documentation

Overview

Package tls contains utilities for generating certificates and authorities

Index

• func CertKeyPairExists(name, dir string) (bool, error)
• func NewCACert(csrFile string, commonName string, subject Subject) (key, cert []byte, err error)
• func NewCert(ca *CA, req csr.CertificateRequest) (key, cert []byte, err error)
• func ReadCACert(name, dir string) (key, cert []byte, err error)
• func WriteCert(key, cert []byte, name, dir string) error
• type CA
• type Subject

Functions

func CertKeyPairExists

func CertKeyPairExists(name, dir string) (bool, error)

CertKeyPairExists returns true if a key and matching certificate exist. Matching is defined as having the expected file names. No validation is performed on the actual bytes of the cert/key

func NewCACert

func NewCACert(csrFile string, commonName string, subject Subject) (key, cert []byte, err error)

NewCACert creates a new Certificate Authority and returns it's private key and public certificate.

func NewCert

func NewCert(ca *CA, req csr.CertificateRequest) (key, cert []byte, err error)

NewCert creates a new certificate/key pair using the CertificateAuthority provided

func ReadCACert

func ReadCACert(name, dir string) (key, cert []byte, err error)

ReadCACert read CA file

func WriteCert

func WriteCert(key, cert []byte, name, dir string) error

WriteCert writes cert and key files

Types

type CA

type CA struct {
	// Key is the CA's private key.
	Key []byte
	// Password is the CA's private key password. Can be empty if not password is set.
	Password string
	// Cert is the CA's public certificate.
	Cert []byte
	// ConfigFile contains a cfssl configuration file for the Certificate Authority
	ConfigFile string
	// Profile to be used when signing with this Certificate Authority
	Profile string
}

CA contains information about the Certificate Authority

type Subject

type Subject struct {
	Country            string
	State              string
	Locality           string
	Organization       string
	OrganizationalUnit string
}

The Subject contains the fields of the X.509 Subject