sia

README

SIA for AWS EC2

Configuration

SIA AWS requires a configuration file to be present in the /etc/sia/sia_config with the following required attributes if the property does not want to use the default settings which require the use of the EC2 instance-profile role in the name format of <property-domain-name>.<property-service-name>-service:

{
    "version": "1.0.0",
    "service": "property-service-name",
    "accounts": [
        {
            "domain":  "property-domain-name",
            "account": "account-aws-id"
        }
    ]
}

The AWS Account administrator must create an IAM Role called <property-domain-name>.<property-service-name> and this role must be setup with a trusted relationship with the role that the EC2 instance is configured to run as.

SIA Configuration file is also required if the user wants to change the default user/group settings that the private key is owned by. By default, the private key is owned by user root and readable by group athenz. If the user wants to provide access to their service identity private key to another user, it can be accomplished by adding the user to the group athenz. If the user wants to change the user and group values, a config file must be dropped with the following optional fields:

{
    "version": "1.0.0",
    "service": "property-service-name",
    "accounts": [
        {
            "domain":  "property-domain-name",
            "account": "account-aws-id",
            "user": "unix-username",
            "group": "unix-groupname"
        }
    ]
}

Documentation

Index

• func GetEC2AccessProfile(configFile, profileRestrictToKey, metaEndpoint string, useRegionalSTS bool, ...) (*options.AccessProfileConfig, error)
• func GetEC2Config(configFile, profileConfigFile, profileRestrictToKey, metaEndpoint string, ...) (*options.Config, *options.ConfigAccount, *options.AccessProfileConfig, error)
• func GetEC2DocumentDetails(metaEndPoint string) ([]byte, []byte, string, string, string, string, *time.Time, error)
• func GetECSOnEC2TaskId() string
• type EC2Provider
  • func (ec2 EC2Provider) AttestationData(svc string, key crypto.PrivateKey, sigInfo *signature.SignatureInfo) (string, error)
  • func (eks EC2Provider) CloudAttestationData(base, svc, ztSserverName string) (string, error)
  • func (tp EC2Provider) GetAccessManagementProfileFromMeta(base string) (string, error)
  • func (eks EC2Provider) GetAccountDomainServiceFromMeta(base string) (string, string, string, error)
  • func (tp EC2Provider) GetAdditionalSshHostPrincipals(base string) (string, error)
  • func (ec2 EC2Provider) GetCsrDn() pkix.Name
  • func (ec2 EC2Provider) GetEmail(service string) []string
  • func (ec2 EC2Provider) GetHostname(fqdn bool) string
  • func (ec2 EC2Provider) GetName() string
  • func (ec2 EC2Provider) GetRoleDnsNames(cert *x509.Certificate, service string) []string
  • func (ec2 EC2Provider) GetSanDns(service string, includeHost bool, wildcard bool, cnames []string) []string
  • func (ec2 EC2Provider) GetSanIp(docIp map[string]bool, ips []net.IP, opts ip.Opts) []net.IP
  • func (ec2 EC2Provider) GetSanUri(svc string, opts ip.Opts, spiffeTrustDomain, spiffeNamespace string) []*url.URL
  • func (ec2 EC2Provider) GetSuffix() string
  • func (ec2 EC2Provider) PrepareKey(file string) (crypto.PrivateKey, error)

Functions

func GetEC2AccessProfile

func GetEC2AccessProfile(configFile, profileRestrictToKey, metaEndpoint string, useRegionalSTS bool, region string) (*options.AccessProfileConfig, error)

func GetEC2Config

func GetEC2Config(configFile, profileConfigFile, profileRestrictToKey, metaEndpoint string, useRegionalSTS bool, region, account string) (*options.Config, *options.ConfigAccount, *options.AccessProfileConfig, error)

func GetEC2DocumentDetails

func GetEC2DocumentDetails(metaEndPoint string) ([]byte, []byte, string, string, string, string, *time.Time, error)

func GetECSOnEC2TaskId

func GetECSOnEC2TaskId() string

Types

type EC2Provider

type EC2Provider struct {
	Name string
}

func (EC2Provider) AttestationData

func (ec2 EC2Provider) AttestationData(svc string, key crypto.PrivateKey, sigInfo *signature.SignatureInfo) (string, error)

func (EC2Provider) CloudAttestationData

func (eks EC2Provider) CloudAttestationData(base, svc, ztSserverName string) (string, error)

func (EC2Provider) GetAccessManagementProfileFromMeta

func (tp EC2Provider) GetAccessManagementProfileFromMeta(base string) (string, error)

func (EC2Provider) GetAccountDomainServiceFromMeta

func (eks EC2Provider) GetAccountDomainServiceFromMeta(base string) (string, string, string, error)

func (EC2Provider) GetAdditionalSshHostPrincipals

func (tp EC2Provider) GetAdditionalSshHostPrincipals(base string) (string, error)

func (EC2Provider) GetCsrDn

func (ec2 EC2Provider) GetCsrDn() pkix.Name

func (EC2Provider) GetEmail

func (ec2 EC2Provider) GetEmail(service string) []string

func (EC2Provider) GetHostname

func (ec2 EC2Provider) GetHostname(fqdn bool) string

GetHostname returns the hostname as per the provider

func (EC2Provider) GetName

func (ec2 EC2Provider) GetName() string

GetName returns the name of the current provider

func (EC2Provider) GetRoleDnsNames

func (ec2 EC2Provider) GetRoleDnsNames(cert *x509.Certificate, service string) []string

func (EC2Provider) GetSanDns

func (ec2 EC2Provider) GetSanDns(service string, includeHost bool, wildcard bool, cnames []string) []string

func (EC2Provider) GetSanIp

func (ec2 EC2Provider) GetSanIp(docIp map[string]bool, ips []net.IP, opts ip.Opts) []net.IP

func (EC2Provider) GetSanUri

func (ec2 EC2Provider) GetSanUri(svc string, opts ip.Opts, spiffeTrustDomain, spiffeNamespace string) []*url.URL

func (EC2Provider) GetSuffix

func (ec2 EC2Provider) GetSuffix() string

func (EC2Provider) PrepareKey

func (ec2 EC2Provider) PrepareKey(file string) (crypto.PrivateKey, error)