dns

Documentation

Index

• type Config
  • func (c *Config) CredentialsId() string
  • func (c *Config) Environment() string
  • func (c *Config) Name() string
  • func (c *Config) OauthClientID() string
  • func (c *Config) OauthClientScopes() []string
  • func (c *Config) OauthClientSecret() string
  • func (c *Config) OauthTokenURL() string
  • func (c *Config) PintoApiURL() string
  • func (c *Config) Provider() string
• type ProviderConfig
• type ProviderSolver
  • func (p *ProviderSolver) CleanUp(ch *v1alpha1.ChallengeRequest) error
  • func (p *ProviderSolver) Initialize(kubeClientConfig *rest.Config, _ <-chan struct{}) error
  • func (p *ProviderSolver) Name() string
  • func (p *ProviderSolver) Present(ch *v1alpha1.ChallengeRequest) error

Types

type Config

type Config struct {
	// contains filtered or unexported fields
}

func (*Config) CredentialsId

func (c *Config) CredentialsId() string

func (*Config) Environment

func (c *Config) Environment() string

Environment is referencing the environment of the Pinto API. Defaults to the prod1 environment

func (*Config) Name

func (c *Config) Name() string

Name is used as the name for this DNS solver when referencing it on the ACME Issuer resource. The Provider Name is used here

func (*Config) OauthClientID

func (c *Config) OauthClientID() string

func (*Config) OauthClientScopes

func (c *Config) OauthClientScopes() []string

func (*Config) OauthClientSecret

func (c *Config) OauthClientSecret() string

func (*Config) OauthTokenURL

func (c *Config) OauthTokenURL() string

func (*Config) PintoApiURL

func (c *Config) PintoApiURL() string

PintoApiURL returns the URL to ACME instance. Defaults to Pinto Primary

func (*Config) Provider

func (c *Config) Provider() string

type ProviderConfig

type ProviderConfig struct {
	AccessKey     *v1.SecretKeySelector `json:"accessKeySecretRef,omitempty"`
	SecretKey     *v1.SecretKeySelector `json:"secretKeySecretRef,omitempty"`
	PintoProvider string                `json:"pintoProvider,omitempty"`
	PintoApiUrl   string                `json:"pintoApiUrl,omitempty"`
	OauthTokenUrl string                `json:"oauthTokenUrl,omitempty"`
	CredentialsId string                `json:"credentialsId,omitempty"`
}

ProviderConfig represents the config used for pinto DNS

type ProviderSolver

type ProviderSolver struct {
	// contains filtered or unexported fields
}

ProviderSolver is the struct implementing the webhook.Solver interface for pinto DNS

func (*ProviderSolver) CleanUp

func (p *ProviderSolver) CleanUp(ch *v1alpha1.ChallengeRequest) error

CleanUp should delete the relevant TXT record from the DNS provider console. If multiple TXT records exist with the same record name (e.g. _acme-challenge.example.com) then **only** the record with the same `key` value provided on the ChallengeRequest should be cleaned up. This is in order to facilitate multiple DNS validations for the same domain concurrently.

func (*ProviderSolver) Initialize

func (p *ProviderSolver) Initialize(kubeClientConfig *rest.Config, _ <-chan struct{}) error

Initialize will be called when the webhook first starts. This method can be used to instantiate the webhook, i.e. initialising connections or warming up caches. Typically, the kubeClientConfig parameter is used to build a Kubernetes k8Client that can be used to fetch resources from the Kubernetes API, e.g. Secret resources containing credentials used to authenticate with DNS provider accounts. The stopCh can be used to handle early termination of the webhook, in cases where a SIGTERM or similar signal is sent to the webhook process.

func (*ProviderSolver) Name

func (p *ProviderSolver) Name() string

func (*ProviderSolver) Present

func (p *ProviderSolver) Present(ch *v1alpha1.ChallengeRequest) error

Present is responsible for actually presenting the DNS record with the DNS provider. This method should tolerate being called multiple times with the same value. cert-manager itself will later perform a self check to ensure that the solver has correctly configured the DNS provider.