token

Documentation

Index

• Constants
• func GenerateKeyID(priv interface{}) (string, error)
• type AWSAmazonPayload
• type AWSInstanceIdentityDocument
• type AzurePayload
• type Claims
  • func DefaultClaims() *Claims
  • func NewClaims(opts ...Options) (*Claims, error)
  • func (c *Claims) Set(key string, value interface{})
  • func (c *Claims) SetHeader(key string, value interface{})
  • func (c *Claims) Sign(alg jose.SignatureAlgorithm, key interface{}) (string, error)
• type GCPComputeEnginePayload
• type GCPGooglePayload
• type JSONWebToken
  • func Parse(token string, key interface{}) (*JSONWebToken, error)
  • func ParseInsecure(token string) (*JSONWebToken, error)
• type Options
  • func WithAudience(s string) Options
  • func WithClaim(name string, value interface{}) Options
  • func WithIssuer(s string) Options
  • func WithJWTID(s string) Options
  • func WithKid(s string) Options
  • func WithRootCA(path string) Options
  • func WithSANS(sans []string) Options
  • func WithSHA(sum string) Options
  • func WithSSH(v interface{}) Options
  • func WithStep(v interface{}) Options
  • func WithSubject(s string) Options
  • func WithValidity(notBefore, expiration time.Time) Options
• type Payload
  • func (p Payload) Type() Type
• type Token
• type Type

Constants

const (
	// DefaultIssuer when generating tokens.
	DefaultIssuer = "step-cli"
	// DefaultAudience when generating tokens.
	DefaultAudience = "https://ca/sign"
	// MinValidity token validity token duration.
	MinValidity = 10 * time.Second
	// MaxValidity token validity token duration.
	MaxValidity = 1 * time.Hour
	// DefaultValidity token validity duration.
	DefaultValidity = 5 * time.Minute
	// MaxValidityDelay allowable delay between Now and beginning of token validity period.
	MaxValidityDelay = 30 * time.Minute
)

const RootSHAClaim = "sha"

RootSHAClaim is the property name for a JWT claim that stores the SHA256 of a root certificate.

const SANSClaim = "sans"

SANSClaim is the property name for a JWT claim that stores the list of required subject alternative names.

const StepClaim = "step"

StepClaim is the property name for a JWT claim the stores the custom information in the certificate.

Functions

func GenerateKeyID

func GenerateKeyID(priv interface{}) (string, error)

GenerateKeyID returns the SHA256 of a public key.

Types

type AWSAmazonPayload

type AWSAmazonPayload struct {
	Document                 []byte                       `json:"document"`
	Signature                []byte                       `json:"signature"`
	InstanceIdentityDocument *AWSInstanceIdentityDocument `json:"-"`
}

AWSAmazonPayload represents the Amazon payload for a AWS token.

type AWSInstanceIdentityDocument

type AWSInstanceIdentityDocument struct {
	AccountID          string    `json:"accountId"`
	Architecture       string    `json:"architecture"`
	AvailabilityZone   string    `json:"availabilityZone"`
	BillingProducts    []string  `json:"billingProducts"`
	DevpayProductCodes []string  `json:"devpayProductCodes"`
	ImageID            string    `json:"imageId"`
	InstanceID         string    `json:"instanceId"`
	InstanceType       string    `json:"instanceType"`
	KernelID           string    `json:"kernelId"`
	PendingTime        time.Time `json:"pendingTime"`
	PrivateIP          string    `json:"privateIp"`
	RamdiskID          string    `json:"ramdiskId"`
	Region             string    `json:"region"`
	Version            string    `json:"version"`
}

AWSInstanceIdentityDocument is the JSON representation of the instance identity document.

type AzurePayload

type AzurePayload struct {
	SubscriptionID string
	ResourceGroup  string
	VirtualMachine string
}

AzurePayload contains the information in the xms_mirid claim.

type Claims

type Claims struct {
	jose.Claims
	ExtraClaims  map[string]interface{}
	ExtraHeaders map[string]interface{}
}

Claims represents the claims that a token might have.

func DefaultClaims

func DefaultClaims() *Claims

DefaultClaims returns the default claims of any token.

func NewClaims

func NewClaims(opts ...Options) (*Claims, error)

NewClaims returns the default claims with the given options added.

func (*Claims) Set

func (c *Claims) Set(key string, value interface{})

Set adds the given key and value to the map of extra claims.

func (*Claims) SetHeader

func (c *Claims) SetHeader(key string, value interface{})

SetHeader adds the given key and value to the map of extra headers.

func (*Claims) Sign

func (c *Claims) Sign(alg jose.SignatureAlgorithm, key interface{}) (string, error)

Sign creates a JWT with the claims and signs it with the given key.

type GCPComputeEnginePayload

type GCPComputeEnginePayload struct {
	InstanceID                string            `json:"instance_id"`
	InstanceName              string            `json:"instance_name"`
	InstanceCreationTimestamp *jose.NumericDate `json:"instance_creation_timestamp"`
	ProjectID                 string            `json:"project_id"`
	ProjectNumber             int64             `json:"project_number"`
	Zone                      string            `json:"zone"`
	LicenseID                 []string          `json:"license_id"`
}

GCPComputeEnginePayload represents the Google ComputeEngine payload in GCP.

type GCPGooglePayload

type GCPGooglePayload struct {
	ComputeEngine GCPComputeEnginePayload `json:"compute_engine"`
}

GCPGooglePayload represents the Google payload in GCP.

type JSONWebToken

type JSONWebToken struct {
	*jose.JSONWebToken
	Payload Payload
}

JSONWebToken represents a JSON Web Token (as specified in RFC7519). Using the Parse or ParseInsecure it will contain the payloads supported on step ca.

func Parse

func Parse(token string, key interface{}) (*JSONWebToken, error)

Parse parses the given token verifying the signature with the key.

func ParseInsecure

func ParseInsecure(token string) (*JSONWebToken, error)

ParseInsecure parses the given token.

type Options

type Options func(c *Claims) error

Options is a function that set claims.

func WithAudience

func WithAudience(s string) Options

WithAudience returns a Options that sets the audience to use in the token claims. If Audience is not used the default audience will be used.

func WithClaim

func WithClaim(name string, value interface{}) Options

WithClaim is an Options function that adds a custom claim to the JWT.

func WithIssuer

func WithIssuer(s string) Options

WithIssuer returns an Options function that sets the issuer to use in the token claims. If Issuer is not used the default issuer will be used.

func WithJWTID

func WithJWTID(s string) Options

WithJWTID returns a Options that sets the jwtID to use in the token claims. If WithJWTID is not used a random identifier will be used.

func WithKid

func WithKid(s string) Options

WithKid returns a Options that sets the header kid claims. If WithKid is not used a thumbprint using SHA256 will be used.

func WithRootCA

func WithRootCA(path string) Options

WithRootCA returns an Options function that calculates the SHA256 of the given root certificate to be used in the token claims. If this method it's not used the default root certificate in the $STEPPATH secrets directory will be used.

func WithSANS

func WithSANS(sans []string) Options

WithSANS returns an Options function that sets the list of required SANs in the token claims.

func WithSHA

func WithSHA(sum string) Options

WithSHA returns an Options function that sets the SHA claim to the given value.

func WithSSH

func WithSSH(v interface{}) Options

WithSSH returns an Options function that sets the step claim with the ssh property in the value.

func WithStep

func WithStep(v interface{}) Options

WithStep returns an Options function that sets the step claim in the payload.

func WithSubject

func WithSubject(s string) Options

WithSubject returns an Options that sets the subject to use in the token claims.

func WithValidity

func WithValidity(notBefore, expiration time.Time) Options

WithValidity validates boundary inputs and sets the 'nbf' (NotBefore) and 'exp' (expiration) options.

type Payload

type Payload struct {
	jose.Claims
	SHA              string            `json:"sha"`     // JWK token claims
	SANs             []string          `json:"sans"`    // ...
	AtHash           string            `json:"at_hash"` // OIDC token claims
	AuthorizedParty  string            `json:"azp"`     // ...
	Email            string            `json:"email"`
	EmailVerified    bool              `json:"email_verified"`
	Hd               string            `json:"hd"`
	Nonce            string            `json:"nonce"`
	AppID            string            `json:"appid"`    // Azure token claims
	AppIDAcr         string            `json:"appidacr"` // ...
	IdentityProvider string            `json:"idp"`
	ObjectID         string            `json:"oid"`
	TenantID         string            `json:"tid"`
	Version          string            `json:"ver"`
	XMSMirID         string            `json:"xms_mirid"`
	Google           *GCPGooglePayload `json:"google"` // GCP token claims
	Amazon           *AWSAmazonPayload `json:"amazon"` // AWS token claims
	Azure            *AzurePayload     `json:"azure"`  // Azure token claims
}

Payload represents public claim values (as specified in RFC 7519). In addition to the standard claims it contains the ones supported in step ca.

func (Payload) Type

func (p Payload) Type() Type

Type returns the type of the payload.

type Token

type Token interface {
	SignedString(sigAlg string, priv interface{}) (string, error)
}

Token interface which all token types should attempt to implement.

type Type

type Type int

Type indicates the token Type.

const (
	Unknown Type = iota
	JWK          // Smallstep JWK
	OIDC         // OpenID Connect
	GCP          // Google Cloud Platform
	AWS          // Amazon Web Services
	Azure        // Microsoft Azure
)

Token types supported.