package lfsapi import ( "encoding/base64" "fmt" "net" "net/http" "net/url" "os" "strings" "github.com/git-lfs/git-lfs/creds" "github.com/git-lfs/git-lfs/errors" "github.com/git-lfs/git-lfs/lfshttp" "github.com/git-lfs/go-netrc/netrc" "github.com/rubyist/tracerx" ) var ( defaultNetrcFinder = &noFinder{} defaultEndpointFinder = NewEndpointFinder(nil) ) // DoWithAuth sends an HTTP request to get an HTTP response. It attempts to add // authentication from netrc or git's credential helpers if necessary, // supporting basic and ntlm authentication. func (c *Client) DoWithAuth(remote string, access Access, req *http.Request, allowRetry bool) (*http.Response, error) { res, err := c.doWithAuth(remote, access, req, nil) if allowRetry && errors.IsAuthError(err) { if len(req.Header.Get("Authorization")) == 0 { // This case represents a rejected request that // should have been authenticated but wasn't. Do // not count this against our redirection // maximum. newAccess := c.Endpoints.AccessFor(access.url) tracerx.Printf("api: http response indicates %q authentication. Resubmitting...", newAccess.GetMode()) return c.DoWithAuth(remote, newAccess, req, allowRetry) } } return res, err } // DoAPIRequestWithAuth sends an HTTP request to get an HTTP response similarly // to DoWithAuth, but using the LFS API endpoint for the provided remote and // operation to determine the access mode. func (c *Client) DoAPIRequestWithAuth(remote string, req *http.Request) (*http.Response, error) { operation := getReqOperation(req) apiEndpoint := c.Endpoints.Endpoint(operation, remote) access := c.Endpoints.AccessFor(apiEndpoint.Url) return c.DoWithAuth(remote, access, req, true) } func (c *Client) doWithAuth(remote string, access Access, req *http.Request, via []*http.Request) (*http.Response, error) { req.Header = c.client.ExtraHeadersFor(req) credHelper, credsURL, creds, err := c.getCreds(remote, access, req) if err != nil { return nil, err } res, err := c.doWithCreds(req, credHelper, creds, credsURL, access, via) if err != nil { if errors.IsAuthError(err) { newAccess := access.Upgrade(getAuthAccess(res)) if newAccess.GetMode() != access.GetMode() { c.Endpoints.SetAccess(newAccess) } if creds != nil { req.Header.Del("Authorization") credHelper.Reject(creds) } } } if res != nil && res.StatusCode < 300 && res.StatusCode > 199 { credHelper.Approve(creds) } return res, err } func (c *Client) doWithCreds(req *http.Request, credHelper creds.CredentialHelper, creds creds.Creds, credsURL *url.URL, access Access, via []*http.Request) (*http.Response, error) { if access.GetMode() == NTLMAccess { return c.doWithNTLM(req, credHelper, creds, credsURL) } req.Header.Set("User-Agent", lfshttp.UserAgent) redirectedReq, res, err := c.client.DoWithRedirect(c.client.HttpClient(req.Host), req, "", via) if err != nil || res != nil { return res, err } if redirectedReq == nil { return res, errors.New("failed to redirect request") } return c.doWithAuth("", access, redirectedReq, via) } // getCreds fills the authorization header for the given request if possible, // from the following sources: // // 1. NTLM access is handled elsewhere. // 2. Existing Authorization or ?token query tells LFS that the request is ready. // 3. Netrc based on the hostname. // 4. URL authentication on the Endpoint URL or the Git Remote URL. // 5. Git Credential Helper, potentially prompting the user. // // There are three URLs in play, that make this a little confusing. // // 1. The request URL, which should be something like "https://git.com/repo.git/info/lfs/objects/batch" // 2. The LFS API URL, which should be something like "https://git.com/repo.git/info/lfs" // This URL used for the "lfs.URL.access" git config key, which determines // what kind of auth the LFS server expects. Could be BasicAccess, NTLMAccess, // or NoneAccess, in which the Git Credential Helper step is skipped. We do // not want to prompt the user for a password to fetch public repository data. // 3. The Git Remote URL, which should be something like "https://git.com/repo.git" // This URL is used for the Git Credential Helper. This way existing https // Git remote credentials can be re-used for LFS. func (c *Client) getCreds(remote string, access Access, req *http.Request) (creds.CredentialHelper, *url.URL, creds.Creds, error) { ef := c.Endpoints if ef == nil { ef = defaultEndpointFinder } netrcFinder := c.Netrc if netrcFinder == nil { netrcFinder = defaultNetrcFinder } operation := getReqOperation(req) apiEndpoint := ef.Endpoint(operation, remote) if access.GetMode() != NTLMAccess { if requestHasAuth(req) || setAuthFromNetrc(netrcFinder, req) || access.GetMode() == NoneAccess { return creds.NullCreds, nil, nil, nil } credsURL, err := getCredURLForAPI(ef, operation, remote, apiEndpoint, req) if err != nil { return creds.NullCreds, nil, nil, errors.Wrap(err, "creds") } if credsURL == nil { return creds.NullCreds, nil, nil, nil } credHelper, creds, err := c.getGitCreds(ef, req, credsURL) if err == nil { tracerx.Printf("Filled credentials for %s", credsURL) setRequestAuth(req, creds["username"], creds["password"]) } return credHelper, credsURL, creds, err } // NTLM ONLY credsURL, err := url.Parse(apiEndpoint.Url) if err != nil { return creds.NullCreds, nil, nil, errors.Wrap(err, "creds") } if netrcMachine := getAuthFromNetrc(netrcFinder, req); netrcMachine != nil { cred := creds.Creds{ "protocol": credsURL.Scheme, "host": credsURL.Host, "username": netrcMachine.Login, "password": netrcMachine.Password, "source": "netrc", } return creds.NullCreds, credsURL, cred, nil } // NTLM uses creds to create the session credHelper, creds, err := c.getGitCreds(ef, req, credsURL) return credHelper, credsURL, creds, err } func (c *Client) getGitCreds(ef EndpointFinder, req *http.Request, u *url.URL) (creds.CredentialHelper, creds.Creds, error) { credHelper, input := c.credContext.GetCredentialHelper(c.Credentials, u) creds, err := credHelper.Fill(input) if creds == nil || len(creds) < 1 { errmsg := fmt.Sprintf("Git credentials for %s not found", u) if err != nil { errmsg = errmsg + ":\n" + err.Error() } else { errmsg = errmsg + "." } err = errors.New(errmsg) } return credHelper, creds, err } func getAuthFromNetrc(netrcFinder NetrcFinder, req *http.Request) *netrc.Machine { hostname := req.URL.Host var host string if strings.Contains(hostname, ":") { var err error host, _, err = net.SplitHostPort(hostname) if err != nil { tracerx.Printf("netrc: error parsing %q: %s", hostname, err) return nil } } else { host = hostname } return netrcFinder.FindMachine(host) } func setAuthFromNetrc(netrcFinder NetrcFinder, req *http.Request) bool { if machine := getAuthFromNetrc(netrcFinder, req); machine != nil { setRequestAuth(req, machine.Login, machine.Password) return true } return false } func getCredURLForAPI(ef EndpointFinder, operation, remote string, apiEndpoint lfshttp.Endpoint, req *http.Request) (*url.URL, error) { apiURL, err := url.Parse(apiEndpoint.Url) if err != nil { return nil, err } // if the LFS request doesn't match the current LFS url, don't bother // attempting to set the Authorization header from the LFS or Git remote URLs. if req.URL.Scheme != apiURL.Scheme || req.URL.Host != apiURL.Host { return req.URL, nil } if setRequestAuthFromURL(req, apiURL) { return nil, nil } if len(remote) > 0 { if u := ef.GitRemoteURL(remote, operation == "upload"); u != "" { schemedUrl, _ := prependEmptySchemeIfAbsent(u) gitRemoteURL, err := url.Parse(schemedUrl) if err != nil { return nil, err } if gitRemoteURL.Scheme == apiURL.Scheme && gitRemoteURL.Host == apiURL.Host { if setRequestAuthFromURL(req, gitRemoteURL) { return nil, nil } return gitRemoteURL, nil } } } return apiURL, nil } // prependEmptySchemeIfAbsent prepends an empty scheme "//" if none was found in // the URL in order to satisfy RFC 3986 §3.3, and `net/url.Parse()`. // // It returns a string parse-able with `net/url.Parse()` and a boolean whether // or not an empty scheme was added. func prependEmptySchemeIfAbsent(u string) (string, bool) { if hasScheme(u) { return u, false } colon := strings.Index(u, ":") slash := strings.Index(u, "/") if colon >= 0 && (slash < 0 || colon < slash) { // First path segment has a colon, assumed that it's a // scheme-less URL. Append an empty scheme on top to // satisfy RFC 3986 §3.3, and `net/url.Parse()`. return fmt.Sprintf("//%s", u), true } return u, true } var ( // supportedSchemes is the list of URL schemes the `lfsapi` package // supports. supportedSchemes = []string{"ssh", "http", "https"} ) // hasScheme returns whether or not a given string (taken to represent a RFC // 3986 URL) has a scheme that is supported by the `lfsapi` package. func hasScheme(what string) bool { for _, scheme := range supportedSchemes { if strings.HasPrefix(what, fmt.Sprintf("%s://", scheme)) { return true } } return false } func requestHasAuth(req *http.Request) bool { // The "Authorization" string constant is safe, since we assume that all // request headers have been canonicalized. if len(req.Header.Get("Authorization")) > 0 { return true } return len(req.URL.Query().Get("token")) > 0 } func setRequestAuthFromURL(req *http.Request, u *url.URL) bool { if u.User == nil { return false } if pass, ok := u.User.Password(); ok { fmt.Fprintln(os.Stderr, "warning: current Git remote contains credentials") setRequestAuth(req, u.User.Username(), pass) return true } return false } func setRequestAuth(req *http.Request, user, pass string) { // better not be NTLM! if len(user) == 0 && len(pass) == 0 { return } token := fmt.Sprintf("%s:%s", user, pass) auth := "Basic " + strings.TrimSpace(base64.StdEncoding.EncodeToString([]byte(token))) req.Header.Set("Authorization", auth) } func getReqOperation(req *http.Request) string { operation := "download" if req.Method == "POST" || req.Method == "PUT" { operation = "upload" } return operation } var ( authenticateHeaders = []string{"Lfs-Authenticate", "Www-Authenticate"} ) func getAuthAccess(res *http.Response) AccessMode { for _, headerName := range authenticateHeaders { for _, auth := range res.Header[headerName] { pieces := strings.SplitN(strings.ToLower(auth), " ", 2) if len(pieces) == 0 { continue } switch AccessMode(pieces[0]) { case NegotiateAccess, NTLMAccess: // When server sends Www-Authentication: Negotiate, it supports both Kerberos and NTLM. // Since git-lfs current does not support Kerberos, we will return NTLM in this case. return NTLMAccess } } } return BasicAccess }