dialer

Documentation

Overview

Package dialer provides a grpc dialer that can be used to create grpc client connections with different levels of ATLS encryption / verification.

Index

• type Dialer
  • func New(issuer atls.Issuer, validator atls.Validator, netDialer NetDialer) *Dialer
  • func NewWithKey(issuer atls.Issuer, validator atls.Validator, netDialer NetDialer, ...) *Dialer
  • func (d *Dialer) Dial(_ context.Context, target string) (*grpc.ClientConn, error)
  • func (d *Dialer) DialInsecure(_ context.Context, target string) (*grpc.ClientConn, error)
  • func (d *Dialer) DialNoVerify(_ context.Context, target string) (*grpc.ClientConn, error)
• type NetDialer

Types

type Dialer

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

Dialer can open grpc client connections with different levels of ATLS encryption / verification.

func New

func New(issuer atls.Issuer, validator atls.Validator, netDialer NetDialer) *Dialer

New creates a new Dialer.

func NewWithKey

func NewWithKey(issuer atls.Issuer, validator atls.Validator, netDialer NetDialer, privKey *ecdsa.PrivateKey) *Dialer

NewWithKey creates a new Dialer with the given private key.

func (*Dialer) Dial

func (d *Dialer) Dial(_ context.Context, target string) (*grpc.ClientConn, error)

Dial creates a new grpc client connection to the given target using the atls validator.

func (*Dialer) DialInsecure

func (d *Dialer) DialInsecure(_ context.Context, target string) (*grpc.ClientConn, error)

DialInsecure creates a new grpc client connection to the given target without using encryption or verification. Only use this method when using another kind of encryption / verification (VPN, etc).

func (*Dialer) DialNoVerify

func (d *Dialer) DialNoVerify(_ context.Context, target string) (*grpc.ClientConn, error)

DialNoVerify creates a new grpc client connection to the given target without verifying the server's attestation.

type NetDialer

type NetDialer interface {
	DialContext(ctx context.Context, network, address string) (net.Conn, error)
}

NetDialer implements the net Dialer interface.