scmauth

Documentation

Index

• Constants
• type CACert
  • func (_ CACert) Handles(name string) bool
  • func (_ CACert) Name() string
  • func (s CACert) Setup(baseDir string) (*url.URL, error)
• type GitConfig
  • func (_ GitConfig) Handles(name string) bool
  • func (_ GitConfig) Name() string
  • func (_ GitConfig) Setup(baseDir string) (*url.URL, error)
• type SCMAuth
• type SSHPrivateKey
  • func (_ SSHPrivateKey) Handles(name string) bool
  • func (_ SSHPrivateKey) Name() string
  • func (_ SSHPrivateKey) Setup(baseDir string) (*url.URL, error)
• type UsernamePassword
  • func (_ UsernamePassword) Handles(name string) bool
  • func (_ UsernamePassword) Name() string
  • func (u UsernamePassword) Setup(baseDir string) (*url.URL, error)

Constants

const (
	CACertName   = "ca.crt"
	CACertConfig = `# SSL cert
[http]
   sslCAInfo = %[1]s
`
)

const (
	DefaultUsername      = "builder"
	UsernamePasswordName = "password"
	UsernameSecret       = "username"
	PasswordSecret       = "password"
	TokenSecret          = "token"
	UserPassGitConfig    = `# credential git config
[credential]
   helper = store --file=%s
`
)

const GitConfigName = ".gitconfig"

const SSHPrivateKeyMethodName = "ssh-privatekey"

Types

type CACert

type CACert struct {
	SourceURL url.URL
}

CACert implements SCMAuth interface for using a custom certificate authority

func (CACert) Handles

func (_ CACert) Handles(name string) bool

Handles returns true if the secret is a CA certificate

func (CACert) Name

func (_ CACert) Name() string

Name returns the name of this auth method.

func (CACert) Setup

func (s CACert) Setup(baseDir string) (*url.URL, error)

Setup creates a .gitconfig fragment that points to the given ca.crt

type GitConfig

type GitConfig struct{}

GitConfig implements SCMAuth interface for using a custom .gitconfig file

func (GitConfig) Handles

func (_ GitConfig) Handles(name string) bool

Handles returns true if the secret file is a gitconfig

func (GitConfig) Name

func (_ GitConfig) Name() string

Name returns the name of this auth method.

func (GitConfig) Setup

func (_ GitConfig) Setup(baseDir string) (*url.URL, error)

Setup adds the secret .gitconfig as an include to the .gitconfig file to be used in the build

type SCMAuth

type SCMAuth interface {
	// Name is the name of the authentication method for use in log and error messages
	Name() string

	// Handles returns true if this authentication method handles a file with the given name
	Handles(name string) bool

	// Setup lays down the required files for this authentication method to work.
	// Returns the the source URL stripped of credentials.
	Setup(baseDir string) (*url.URL, error)
}

SCMAuth is an interface implemented by different authentication providers which are responsible for setting up the credentials to be used when accessing private repository.

type SSHPrivateKey

type SSHPrivateKey struct{}

SSHPrivateKey implements SCMAuth interface for using SSH private keys.

func (SSHPrivateKey) Handles

func (_ SSHPrivateKey) Handles(name string) bool

Handles returns true if the file is an SSH private key

func (SSHPrivateKey) Name

func (_ SSHPrivateKey) Name() string

Name returns the name of this auth method.

func (SSHPrivateKey) Setup

func (_ SSHPrivateKey) Setup(baseDir string) (*url.URL, error)

Setup creates a wrapper script for SSH command to be able to use the provided SSH key while accessing private repository.

type UsernamePassword

type UsernamePassword struct {
	SourceURL url.URL
}

UsernamePassword implements SCMAuth interface for using Username and Password credentials

func (UsernamePassword) Handles

func (_ UsernamePassword) Handles(name string) bool

Handles returns true if a username, password or token secret is present

func (UsernamePassword) Name

func (_ UsernamePassword) Name() string

Name returns the name of this auth method.

func (UsernamePassword) Setup

func (u UsernamePassword) Setup(baseDir string) (*url.URL, error)

Setup creates a gitconfig fragment that includes a substitution URL with the username/password included in the URL. Returns source URL stripped of username/password credentials.