aws

Documentation

Index

• func CreateAWSLoginURL(sessionId string, sessionKey string, sessionToken string, issuer string) (string, error)
• func CreateRegionalURL(region string, path string) (string, string)
• type Aws
  • func New(config *Config) (*Aws, error)
  • func (a *Aws) CreateSession(accessKey string, secretKey string) error
  • func (a *Aws) GetCredentialPath() (string, error)
  • func (a *Aws) GetFederationToken(name string, duration time.Duration) *sts.Credentials
  • func (a *Aws) MapProfile(name string, profiles ...interface{}) error
  • func (a *Aws) SaveProfile(name string, profile *Profile, setAsDefault bool, ...) error
  • func (a *Aws) WaitForActiveCreds()
• type Config
• type Logger
• type Profile

Functions

func CreateAWSLoginURL

func CreateAWSLoginURL(sessionId string, sessionKey string, sessionToken string, issuer string) (string, error)

CreateAWSLoginURL returns a federation AWS URL used for wev console login This uses AWS Security Token Service (AWS STS) AssumeRole More info at: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html Thanks to Lachlan Donald for the following code: https://github.com/99designs/aws-vault

func CreateRegionalURL

func CreateRegionalURL(region string, path string) (string, string)

CreateRegionalURL creates signin and console URLs based on the region/path provided

Types

type Aws

type Aws struct {
	// contains filtered or unexported fields
}

Aws is the main object

func New

func New(config *Config) (*Aws, error)

New builds a client from the provided config

func (*Aws) CreateSession

func (a *Aws) CreateSession(accessKey string, secretKey string) error

func (*Aws) GetCredentialPath

func (a *Aws) GetCredentialPath() (string, error)

GetCredentialPath gets the filepath to the credential path in the user's home directory

func (*Aws) GetFederationToken

func (a *Aws) GetFederationToken(name string, duration time.Duration) *sts.Credentials

GetFederationToken takes in a name and returns a set of STS Credentials based on the current session

func (*Aws) MapProfile

func (a *Aws) MapProfile(name string, profiles ...interface{}) error

MapProfile gets an AWS profile from the user's credentials file and maps it, if found, to the given interface(s)

func (*Aws) SaveProfile

func (a *Aws) SaveProfile(name string, profile *Profile, setAsDefault bool, additionalProfiles ...interface{}) error

SaveProfile saves the given profile(s)/section(s) to file, optionally also saving it as the default profile. The Profile type is requried and additional profile fields can be added with the additionalProfiles parameter

func (*Aws) WaitForActiveCreds

func (a *Aws) WaitForActiveCreds()

WaitForActiveCreds waits for the current session to become valid This is useful when IAM credentials were just provisioned and we need to wait until they're active to take the next step.

type Config

type Config struct {
	AccessKey string
	SecretKey string
	Log       Logger
}

type Logger

type Logger interface {
	Debug(args ...interface{})
	Info(args ...interface{})
	Fatal(args ...interface{})
}

type Profile

type Profile struct {
	AccessKeyID     string `ini:"aws_access_key_id"`
	SecretAccessKey string `ini:"aws_secret_access_key"`
}

Profile is the base struct for creating new profiles