// Copyright 2022 Woodpecker Authors // Copyright 2018 Drone.IO Inc. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package github import ( "context" "crypto/tls" "fmt" "net/http" "net/url" "regexp" "strconv" "strings" "github.com/google/go-github/v39/github" "github.com/rs/zerolog/log" "golang.org/x/oauth2" "github.com/woodpecker-ci/woodpecker/server" "github.com/woodpecker-ci/woodpecker/server/model" "github.com/woodpecker-ci/woodpecker/server/remote" "github.com/woodpecker-ci/woodpecker/server/remote/common" "github.com/woodpecker-ci/woodpecker/server/store" "github.com/woodpecker-ci/woodpecker/shared/utils" ) const ( defaultURL = "https://github.com" // Default GitHub URL defaultAPI = "https://api.github.com/" // Default GitHub API URL ) // Opts defines configuration options. type Opts struct { URL string // GitHub server url. Client string // GitHub oauth client id. Secret string // GitHub oauth client secret. SkipVerify bool // Skip ssl verification. MergeRef bool // Clone pull requests using the merge ref. } // New returns a Remote implementation that integrates with a GitHub Cloud or // GitHub Enterprise version control hosting provider. func New(opts Opts) (remote.Remote, error) { r := &client{ API: defaultAPI, URL: defaultURL, Client: opts.Client, Secret: opts.Secret, SkipVerify: opts.SkipVerify, MergeRef: opts.MergeRef, } if opts.URL != defaultURL { r.URL = strings.TrimSuffix(opts.URL, "/") r.API = r.URL + "/api/v3/" } return r, nil } type client struct { URL string API string Client string Secret string SkipVerify bool MergeRef bool } // Name returns the string name of this driver func (c *client) Name() string { return "github" } // Login authenticates the session and returns the remote user details. func (c *client) Login(ctx context.Context, res http.ResponseWriter, req *http.Request) (*model.User, error) { config := c.newConfig(req) // get the OAuth errors if err := req.FormValue("error"); err != "" { return nil, &remote.AuthError{ Err: err, Description: req.FormValue("error_description"), URI: req.FormValue("error_uri"), } } // get the OAuth code code := req.FormValue("code") if len(code) == 0 { // TODO(bradrydzewski) we really should be using a random value here and // storing in a cookie for verification in the next stage of the workflow. http.Redirect(res, req, config.AuthCodeURL("woodpecker"), http.StatusSeeOther) return nil, nil } token, err := config.Exchange(c.newContext(ctx), code) if err != nil { return nil, err } client := c.newClientToken(ctx, token.AccessToken) user, _, err := client.Users.Get(ctx, "") if err != nil { return nil, err } emails, _, err := client.Users.ListEmails(ctx, nil) if err != nil { return nil, err } email := matchingEmail(emails, c.API) if email == nil { return nil, fmt.Errorf("No verified Email address for GitHub account") } return &model.User{ Login: *user.Login, Email: *email.Email, Token: token.AccessToken, Avatar: *user.AvatarURL, }, nil } // Auth returns the GitHub user login for the given access token. func (c *client) Auth(ctx context.Context, token, secret string) (string, error) { client := c.newClientToken(ctx, token) user, _, err := client.Users.Get(ctx, "") if err != nil { return "", err } return *user.Login, nil } // Teams returns a list of all team membership for the GitHub account. func (c *client) Teams(ctx context.Context, u *model.User) ([]*model.Team, error) { client := c.newClientToken(ctx, u.Token) opts := new(github.ListOptions) opts.Page = 1 var teams []*model.Team for opts.Page > 0 { list, resp, err := client.Organizations.List(ctx, "", opts) if err != nil { return nil, err } teams = append(teams, convertTeamList(list)...) opts.Page = resp.NextPage } return teams, nil } // Repo returns the GitHub repository. func (c *client) Repo(ctx context.Context, u *model.User, id model.RemoteID, owner, name string) (*model.Repo, error) { client := c.newClientToken(ctx, u.Token) if id.IsValid() { intID, err := strconv.ParseInt(string(id), 10, 64) if err != nil { return nil, err } repo, _, err := client.Repositories.GetByID(ctx, intID) if err != nil { return nil, err } return convertRepo(repo), nil } repo, _, err := client.Repositories.Get(ctx, owner, name) if err != nil { return nil, err } return convertRepo(repo), nil } // Repos returns a list of all repositories for GitHub account, including // organization repositories. func (c *client) Repos(ctx context.Context, u *model.User) ([]*model.Repo, error) { client := c.newClientToken(ctx, u.Token) opts := new(github.RepositoryListOptions) opts.PerPage = 100 opts.Page = 1 var repos []*model.Repo for opts.Page > 0 { list, resp, err := client.Repositories.List(ctx, "", opts) if err != nil { return nil, err } repos = append(repos, convertRepoList(list)...) opts.Page = resp.NextPage } return repos, nil } // Perm returns the user permissions for the named GitHub repository. func (c *client) Perm(ctx context.Context, u *model.User, r *model.Repo) (*model.Perm, error) { client := c.newClientToken(ctx, u.Token) repo, _, err := client.Repositories.Get(ctx, r.Owner, r.Name) if err != nil { return nil, err } return convertPerm(repo.GetPermissions()), nil } // File fetches the file from the GitHub repository and returns its contents. func (c *client) File(ctx context.Context, u *model.User, r *model.Repo, b *model.Pipeline, f string) ([]byte, error) { client := c.newClientToken(ctx, u.Token) opts := new(github.RepositoryContentGetOptions) opts.Ref = b.Commit content, _, _, err := client.Repositories.GetContents(ctx, r.Owner, r.Name, f, opts) if err != nil { return nil, err } if content == nil { return nil, fmt.Errorf("%s is a folder not a file use Dir(..)", f) } data, err := content.GetContent() return []byte(data), err } func (c *client) Dir(ctx context.Context, u *model.User, r *model.Repo, b *model.Pipeline, f string) ([]*remote.FileMeta, error) { client := c.newClientToken(ctx, u.Token) opts := new(github.RepositoryContentGetOptions) opts.Ref = b.Commit _, data, _, err := client.Repositories.GetContents(ctx, r.Owner, r.Name, f, opts) if err != nil { return nil, err } fc := make(chan *remote.FileMeta) errc := make(chan error) for _, file := range data { go func(path string) { content, err := c.File(ctx, u, r, b, path) if err != nil { errc <- err } else { fc <- &remote.FileMeta{ Name: path, Data: content, } } }(f + "/" + *file.Name) } var files []*remote.FileMeta for i := 0; i < len(data); i++ { select { case err := <-errc: return nil, err case fileMeta := <-fc: files = append(files, fileMeta) } } close(fc) close(errc) return files, nil } // Netrc returns a netrc file capable of authenticating GitHub requests and // cloning GitHub repositories. The netrc will use the global machine account // when configured. func (c *client) Netrc(u *model.User, r *model.Repo) (*model.Netrc, error) { login := "" token := "" if u != nil { login = u.Token token = "x-oauth-basic" } host, err := common.ExtractHostFromCloneURL(r.Clone) if err != nil { return nil, err } return &model.Netrc{ Login: login, Password: token, Machine: host, }, nil } // Deactivate deactives the repository be removing registered push hooks from // the GitHub repository. func (c *client) Deactivate(ctx context.Context, u *model.User, r *model.Repo, link string) error { client := c.newClientToken(ctx, u.Token) hooks, _, err := client.Repositories.ListHooks(ctx, r.Owner, r.Name, nil) if err != nil { return err } match := matchingHooks(hooks, link) if match == nil { return nil } _, err = client.Repositories.DeleteHook(ctx, r.Owner, r.Name, *match.ID) return err } // OrgMembership returns if user is member of organization and if user // is admin/owner in this organization. func (c *client) OrgMembership(ctx context.Context, u *model.User, owner string) (*model.OrgPerm, error) { client := c.newClientToken(ctx, u.Token) org, _, err := client.Organizations.GetOrgMembership(ctx, u.Login, owner) if err != nil { return nil, err } return &model.OrgPerm{Member: org.GetState() == "active", Admin: org.GetRole() == "admin"}, nil } // helper function to return the GitHub oauth2 context using an HTTPClient that // disables TLS verification if disabled in the remote settings. func (c *client) newContext(ctx context.Context) context.Context { if !c.SkipVerify { return ctx } return context.WithValue(ctx, oauth2.HTTPClient, &http.Client{ Transport: &http.Transport{ Proxy: http.ProxyFromEnvironment, TLSClientConfig: &tls.Config{ InsecureSkipVerify: true, }, }, }) } // helper function to return the GitHub oauth2 config func (c *client) newConfig(req *http.Request) *oauth2.Config { var redirect string intendedURL := req.URL.Query()["url"] if len(intendedURL) > 0 { redirect = fmt.Sprintf("%s/authorize?url=%s", server.Config.Server.OAuthHost, intendedURL[0]) } else { redirect = fmt.Sprintf("%s/authorize", server.Config.Server.OAuthHost) } return &oauth2.Config{ ClientID: c.Client, ClientSecret: c.Secret, Scopes: []string{"repo", "repo:status", "user:email", "read:org"}, Endpoint: oauth2.Endpoint{ AuthURL: fmt.Sprintf("%s/login/oauth/authorize", c.URL), TokenURL: fmt.Sprintf("%s/login/oauth/access_token", c.URL), }, RedirectURL: redirect, } } // helper function to return the GitHub oauth2 client func (c *client) newClientToken(ctx context.Context, token string) *github.Client { ts := oauth2.StaticTokenSource( &oauth2.Token{AccessToken: token}, ) tc := oauth2.NewClient(ctx, ts) if c.SkipVerify { tc.Transport.(*oauth2.Transport).Base = &http.Transport{ Proxy: http.ProxyFromEnvironment, TLSClientConfig: &tls.Config{ InsecureSkipVerify: true, }, } } client := github.NewClient(tc) client.BaseURL, _ = url.Parse(c.API) return client } // helper function to return matching user email. func matchingEmail(emails []*github.UserEmail, rawURL string) *github.UserEmail { for _, email := range emails { if email.Email == nil || email.Primary == nil || email.Verified == nil { continue } if *email.Primary && *email.Verified { return email } } // github enterprise does not support verified email addresses so instead // we'll return the first email address in the list. if len(emails) != 0 && rawURL != defaultAPI { return emails[0] } return nil } // helper function to return matching hook. func matchingHooks(hooks []*github.Hook, rawurl string) *github.Hook { link, err := url.Parse(rawurl) if err != nil { return nil } for _, hook := range hooks { if hook.ID == nil { continue } v, ok := hook.Config["url"] if !ok { continue } s, ok := v.(string) if !ok { continue } hookURL, err := url.Parse(s) if err == nil && hookURL.Host == link.Host { return hook } } return nil } var reDeploy = regexp.MustCompile(`.+/deployments/(\d+)`) // Status sends the commit status to the remote system. // An example would be the GitHub pull request status. func (c *client) Status(ctx context.Context, user *model.User, repo *model.Repo, pipeline *model.Pipeline, proc *model.Proc) error { client := c.newClientToken(ctx, user.Token) if pipeline.Event == model.EventDeploy { matches := reDeploy.FindStringSubmatch(pipeline.Link) if len(matches) != 2 { return nil } id, _ := strconv.Atoi(matches[1]) _, _, err := client.Repositories.CreateDeploymentStatus(ctx, repo.Owner, repo.Name, int64(id), &github.DeploymentStatusRequest{ State: github.String(convertStatus(pipeline.Status)), Description: github.String(common.GetPipelineStatusDescription(pipeline.Status)), LogURL: github.String(common.GetPipelineStatusLink(repo, pipeline, nil)), }) return err } _, _, err := client.Repositories.CreateStatus(ctx, repo.Owner, repo.Name, pipeline.Commit, &github.RepoStatus{ Context: github.String(common.GetPipelineStatusContext(repo, pipeline, proc)), State: github.String(convertStatus(proc.State)), Description: github.String(common.GetPipelineStatusDescription(proc.State)), TargetURL: github.String(common.GetPipelineStatusLink(repo, pipeline, proc)), }) return err } // Activate activates a repository by creating the post-commit hook and // adding the SSH deploy key, if applicable. func (c *client) Activate(ctx context.Context, u *model.User, r *model.Repo, link string) error { if err := c.Deactivate(ctx, u, r, link); err != nil { return err } client := c.newClientToken(ctx, u.Token) hook := &github.Hook{ Name: github.String("web"), Events: []string{ "push", "pull_request", "deployment", }, Config: map[string]interface{}{ "url": link, "content_type": "form", }, } _, _, err := client.Repositories.CreateHook(ctx, r.Owner, r.Name, hook) return err } // Branches returns the names of all branches for the named repository. func (c *client) Branches(ctx context.Context, u *model.User, r *model.Repo) ([]string, error) { token := "" if u != nil { token = u.Token } client := c.newClientToken(ctx, token) githubBranches, _, err := client.Repositories.ListBranches(ctx, r.Owner, r.Name, &github.BranchListOptions{}) if err != nil { return nil, err } branches := make([]string, 0) for _, branch := range githubBranches { branches = append(branches, *branch.Name) } return branches, nil } // BranchHead returns the sha of the head (lastest commit) of the specified branch func (c *client) BranchHead(ctx context.Context, u *model.User, r *model.Repo, branch string) (string, error) { token := "" if u != nil { token = u.Token } b, _, err := c.newClientToken(ctx, token).Repositories.GetBranch(ctx, r.Owner, r.Name, branch, true) if err != nil { return "", err } return b.GetCommit().GetSHA(), nil } // Hook parses the post-commit hook from the Request body // and returns the required data in a standard format. func (c *client) Hook(ctx context.Context, r *http.Request) (*model.Repo, *model.Pipeline, error) { pull, repo, pipeline, err := parseHook(r, c.MergeRef) if err != nil { return nil, nil, err } if pull != nil && len(pipeline.ChangedFiles) == 0 { pipeline, err = c.loadChangedFilesFromPullRequest(ctx, pull, repo, pipeline) if err != nil { return nil, nil, err } } return repo, pipeline, nil } func (c *client) loadChangedFilesFromPullRequest(ctx context.Context, pull *github.PullRequest, tmpRepo *model.Repo, pipeline *model.Pipeline) (*model.Pipeline, error) { _store, ok := store.TryFromContext(ctx) if !ok { log.Error().Msg("could not get store from context") return pipeline, nil } repo, err := _store.GetRepoNameFallback(tmpRepo.RemoteID, tmpRepo.FullName) if err != nil { return nil, err } user, err := _store.GetUser(repo.UserID) if err != nil { return nil, err } opts := &github.ListOptions{Page: 1} fileList := make([]string, 0, 16) for opts.Page > 0 { files, resp, err := c.newClientToken(ctx, user.Token).PullRequests.ListFiles(ctx, repo.Owner, repo.Name, pull.GetNumber(), opts) if err != nil { return nil, err } for _, file := range files { fileList = append(fileList, file.GetFilename(), file.GetPreviousFilename()) } opts.Page = resp.NextPage } pipeline.ChangedFiles = utils.DedupStrings(fileList) return pipeline, nil }