httpntlm

README

go-http-ntlm

go-http-ntlm is a Go package that contains NTLM transport (http.RoundTripper implementation) for http.Client to make NTLM auth protected http requests.

Usage example

package main

import (
    "io/ioutil"
    "log"
    "net/http"
    "strings"

    "github.com/vadimi/go-http-ntlm/v2"
)

func main() {

    // configure http client
    client := http.Client{
        Transport: &httpntlm.NtlmTransport{
            Domain:   "mydomain",
            User:     "testuser",
            Password: "fish",
            // Configure RoundTripper if necessary, otherwise DefaultTransport is used
            RoundTripper: &http.Transport{
                // provide tls config
                TLSClientConfig: &tls.Config{},
                // other properties RoundTripper, see http.DefaultTransport
            },
        },
    }

    req, err := http.NewRequest("GET", "http://server/ntlm-auth-resource", strings.NewReader(""))
    resp, err := client.Do(req)

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

    defer func() {
        err := resp.Body.Close()
        if err != nil {
            log.Fatal(err)
        }
    }()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }

    log.Println(body)
}

Documentation

Index

• type NtlmTransport
  • func (t NtlmTransport) RoundTrip(req *http.Request) (res *http.Response, err error)

Types

type NtlmTransport

type NtlmTransport struct {
	Domain   string
	User     string
	Password string
	http.RoundTripper
	Jar http.CookieJar

	// Headers to copy from the original request onto the NTLM negotiation
	// request, this can be useful when extra authentication is required,
	// for example when you use Azure Relay.
	CopyHeaders []string
}

NtlmTransport is implementation of http.RoundTripper interface

func (NtlmTransport) RoundTrip

func (t NtlmTransport) RoundTrip(req *http.Request) (res *http.Response, err error)

RoundTrip method send http request and tries to perform NTLM authentication