Files
teleport/lib/auth/join_github.go
T
Noah Stride 78549b88e6 GitHub Enterprise secure joining support (#19330)
* Add support for GHES joining

* Add tests for GHES ID Token validation

* Add test covering Auth server github join with GHES override

* Use correct ctx

* Name interface method parameters for clarity

* Use "scheme" instead of "proto"

* Improve docs, validation and add tests
2022-12-20 14:43:00 +00:00

100 lines
2.8 KiB
Go

/*
Copyright 2022 Gravitational, 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 auth
import (
"context"
"github.com/gravitational/trace"
"github.com/sirupsen/logrus"
"github.com/gravitational/teleport/api/types"
"github.com/gravitational/teleport/lib/githubactions"
)
type ghaIDTokenValidator interface {
Validate(
ctx context.Context, GHESHost string, token string,
) (*githubactions.IDTokenClaims, error)
}
func (a *Server) checkGitHubJoinRequest(ctx context.Context, req *types.RegisterUsingTokenRequest) (*githubactions.IDTokenClaims, error) {
if req.IDToken == "" {
return nil, trace.BadParameter("IDToken not provided for Github join request")
}
pt, err := a.GetToken(ctx, req.Token)
if err != nil {
return nil, trace.Wrap(err)
}
token, ok := pt.(*types.ProvisionTokenV2)
if !ok {
return nil, trace.BadParameter("github join method only supports ProvisionTokenV2, '%T' was provided", pt)
}
claims, err := a.ghaIDTokenValidator.Validate(
ctx, token.Spec.GitHub.EnterpriseServerHost, req.IDToken,
)
if err != nil {
return nil, trace.Wrap(err)
}
log.WithFields(logrus.Fields{
"claims": claims,
"token": pt.GetName(),
}).Info("Github actions run trying to join cluster")
return claims, trace.Wrap(checkGithubAllowRules(token, claims))
}
func checkGithubAllowRules(token *types.ProvisionTokenV2, claims *githubactions.IDTokenClaims) error {
// If a single rule passes, accept the IDToken
for _, rule := range token.Spec.GitHub.Allow {
// Please consider keeping these field validators in the same order they
// are defined within the ProvisionTokenSpecV2Github proto spec.
if rule.Sub != "" && claims.Sub != rule.Sub {
continue
}
if rule.Repository != "" && claims.Repository != rule.Repository {
continue
}
if rule.RepositoryOwner != "" && claims.RepositoryOwner != rule.RepositoryOwner {
continue
}
if rule.Workflow != "" && claims.Workflow != rule.Workflow {
continue
}
if rule.Environment != "" && claims.Environment != rule.Environment {
continue
}
if rule.Actor != "" && claims.Actor != rule.Actor {
continue
}
if rule.Ref != "" && claims.Ref != rule.Ref {
continue
}
if rule.RefType != "" && claims.RefType != rule.RefType {
continue
}
// All provided rules met.
return nil
}
return trace.AccessDenied("id token claims did not match any allow rules")
}