digest_auth_client

README

go-http-digest-auth-client

Golang Http Digest Authentication Client

This client implements RFC7616 HTTP Digest Access Authentication and by now the basic features should work.

Usage

// import
import dac "github.com/xinsnake/go-http-digest-auth-client"

// create a new digest authentication request
dr := dac.NewRequest(username, password, method, uri, payload)
response1, err := dr.Execute()

// check error, get response

// reuse the existing digest authentication request so no extra request is needed
dr.UpdateRequest(username, password, method, uri, payload)
response2, err := dr.Execute()

// check error, get response

Or you can use it with http.Request

t := dac.NewTransport(username, password)
req, err := http.NewRequest(method, uri, payload)

if err != nil {
    log.Fatalln(err)
}

resp, err := t.RoundTrip(req)
if err != nil {
    log.Fatalln(err)
}
defer resp.Body.Close()

fmt.Println(resp)

Documentation

Index

• type DigestRequest
  • func NewRequest(username, password, method, uri, body string) DigestRequest
  • func (dr *DigestRequest) Execute() (resp *http.Response, err error)
  • func (dr *DigestRequest) UpdateRequest(username, password, method, uri, body string) *DigestRequest
• type DigestTransport
  • func NewTransport(username, password string) DigestTransport
  • func (dt *DigestTransport) RoundTrip(req *http.Request) (resp *http.Response, err error)

Types

type DigestRequest

type DigestRequest struct {
	Body       string
	Method     string
	Password   string
	URI        string
	Username   string
	Header     http.Header
	Auth       *authorization
	Wa         *wwwAuthenticate
	CertVal    bool
	HTTPClient *http.Client
}

func NewRequest

func NewRequest(username, password, method, uri, body string) DigestRequest

NewRequest creates a new DigestRequest object

func (*DigestRequest) Execute

func (dr *DigestRequest) Execute() (resp *http.Response, err error)

Execute initialise the request and get a response

func (*DigestRequest) UpdateRequest

func (dr *DigestRequest) UpdateRequest(username, password, method, uri, body string) *DigestRequest

UpdateRequest is called when you want to reuse an existing

DigestRequest connection with new request information

type DigestTransport

type DigestTransport struct {
	Password   string
	Username   string
	HTTPClient *http.Client
}

func NewTransport

func NewTransport(username, password string) DigestTransport

NewTransport creates a new DigestTransport object

func (*DigestTransport) RoundTrip

func (dt *DigestTransport) RoundTrip(req *http.Request) (resp *http.Response, err error)

RoundTrip implements the http.RoundTripper interface