Documentation ¶
Index ¶
- Constants
- func Claims(sa core.ServiceAccount, pod *core.Pod, secret *core.Secret, ...) (*jwt.Claims, interface{})
- func IsServiceAccountToken(secret *v1.Secret, sa *v1.ServiceAccount) bool
- func JWTTokenAuthenticator(iss string, keys []interface{}, validator Validator) authenticator.Token
- func LegacyClaims(serviceAccount v1.ServiceAccount, secret v1.Secret) (*jwt.Claims, interface{})
- func UserInfo(namespace, name, uid string) user.Info
- type ServiceAccountInfo
- type ServiceAccountTokenGetter
- type TokenGenerator
- type Validator
Constants ¶
const ( // PodNameKey is the key used in a user's "extra" to specify the pod name of // the authenticating request. PodNameKey = "authentication.kubernetes.io/pod-name" // PodUIDKey is the key used in a user's "extra" to specify the pod UID of // the authenticating request. PodUIDKey = "authentication.kubernetes.io/pod-uid" )
const LegacyIssuer = "kubernetes/serviceaccount"
Variables ¶
This section is empty.
Functions ¶
func IsServiceAccountToken ¶ added in v1.2.0
func IsServiceAccountToken(secret *v1.Secret, sa *v1.ServiceAccount) bool
IsServiceAccountToken returns true if the secret is a valid api token for the service account
func JWTTokenAuthenticator ¶
func JWTTokenAuthenticator(iss string, keys []interface{}, validator Validator) authenticator.Token
JWTTokenAuthenticator authenticates tokens as JWT tokens produced by JWTTokenGenerator Token signatures are verified using each of the given public keys until one works (allowing key rotation) If lookup is true, the service account and secret referenced as claims inside the token are retrieved and verified with the provided ServiceAccountTokenGetter
func LegacyClaims ¶ added in v1.10.0
Types ¶
type ServiceAccountInfo ¶ added in v1.12.0
func (*ServiceAccountInfo) UserInfo ¶ added in v1.12.0
func (sa *ServiceAccountInfo) UserInfo() user.Info
type ServiceAccountTokenGetter ¶
type ServiceAccountTokenGetter interface { GetServiceAccount(namespace, name string) (*v1.ServiceAccount, error) GetPod(namespace, name string) (*v1.Pod, error) GetSecret(namespace, name string) (*v1.Secret, error) }
ServiceAccountTokenGetter defines functions to retrieve a named service account and secret
type TokenGenerator ¶
type TokenGenerator interface { // GenerateToken generates a token which will identify the given // ServiceAccount. privateClaims is an interface that will be // serialized into the JWT payload JSON encoding at the root level of // the payload object. Public claims take precedent over private // claims i.e. if both claims and privateClaims have an "exp" field, // the value in claims will be used. GenerateToken(claims *jwt.Claims, privateClaims interface{}) (string, error) }
func JWTTokenGenerator ¶
func JWTTokenGenerator(iss string, privateKey interface{}) (TokenGenerator, error)
JWTTokenGenerator returns a TokenGenerator that generates signed JWT tokens, using the given privateKey. privateKey is a PEM-encoded byte array of a private RSA key. JWTTokenAuthenticator()
type Validator ¶ added in v1.10.0
type Validator interface { // Validate validates a token and returns user information or an error. // Validator can assume that the issuer and signature of a token are already // verified when this function is called. Validate(tokenData string, public *jwt.Claims, private interface{}) (*ServiceAccountInfo, error) // NewPrivateClaims returns a struct that the authenticator should // deserialize the JWT payload into. The authenticator may then pass this // struct back to the Validator as the 'private' argument to a Validate() // call. This struct should contain fields for any private claims that the // Validator requires to validate the JWT. NewPrivateClaims() interface{} }
Validator is called by the JWT token authentictaor to apply domain specific validation to a token and extract user information.
func NewLegacyValidator ¶ added in v1.10.0
func NewLegacyValidator(lookup bool, getter ServiceAccountTokenGetter) Validator
func NewValidator ¶ added in v1.10.0
func NewValidator(audiences []string, getter ServiceAccountTokenGetter) Validator