loader.go

// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
//
// Contributor: Aaron Meihm ameihm@mozilla.com [:alm]

package mig /* import "github.com/mozilla/mig" */

import (
	"errors"
	"fmt"
	"regexp"
	"time"
)

// LoaderEntry describes a loader entry stored in the database
type LoaderEntry struct {
	ID        float64   `json:"id"`        // Loader ID
	Name      string    `json:"name"`      // Loader name
	Prefix    string    `json:"prefix"`    // Loader key prefix
	Key       string    `json:"key"`       // Loader key (only populated during creation)
	AgentName string    `json:"agentname"` // Loader environment, agent name
	LastSeen  time.Time `json:"lastseen"`  // Last time loader was used
	Enabled   bool      `json:"enabled"`   // Loader entry is active
	ExpectEnv string    `json:"expectenv"` // Expected environment
}

// Validate validates a loader entry
func (le *LoaderEntry) Validate() (err error) {
	if le.Key != "" {
		err = ValidateLoaderPrefixAndKey(le.Prefix + le.Key)
	}
	return nil
}

// LoaderAuthDetails is a small helper type used primarily during the loader
// authentication process between the API and database code, temporarily stores
// authentication information
type LoaderAuthDetails struct {
	ID   float64
	Hash []byte
	Salt []byte
}

// Validate validates a LoaderAuthDetails type
func (lad *LoaderAuthDetails) Validate() error {
	if len(lad.Hash) != LoaderHashedKeyLength ||
		len(lad.Salt) != LoaderSaltLength {
		return fmt.Errorf("contents of LoaderAuthDetails are invalid")
	}
	return nil
}

// GenerateLoaderPrefix will generate a new loader prefix value
func GenerateLoaderPrefix() string {
	return RandAPIKeyString(LoaderPrefixLength)
}

// GenerateLoaderKey will generate a new loader key value
func GenerateLoaderKey() string {
	return RandAPIKeyString(LoaderKeyLength)
}

// LoaderPrefixAndKeyLength is the key length for a loader key including the prefix
const LoaderPrefixAndKeyLength = 40

// LoaderPrefixLength is the length of the loader prefix
const LoaderPrefixLength = 8

// LoaderKeyLength is the length of the loader key
const LoaderKeyLength = 32

// LoaderHashedKeyLength is the length of the hashed loader key in the database
const LoaderHashedKeyLength = 32

// LoaderSaltLength is the length of the salt applied to loader keys
const LoaderSaltLength = 16

// ValidateLoaderKey validates a loader key, returns nil if it is valid
func ValidateLoaderKey(key string) error {
	repstr := fmt.Sprintf("^[A-Za-z0-9]{%v}$", LoaderKeyLength)
	ok, err := regexp.MatchString(repstr, key)
	if err != nil || !ok {
		return errors.New("loader key format is invalid")
	}
	return nil
}

// ValidateLoaderPrefix validates a loader prefix value, returns nil if it is valid
func ValidateLoaderPrefix(prefix string) error {
	repstr := fmt.Sprintf("^[A-Za-z0-9]{%v}$", LoaderPrefixLength)
	ok, err := regexp.MatchString(repstr, prefix)
	if err != nil || !ok {
		return errors.New("loader prefix format is invalid")
	}
	return nil
}

// ValidateLoaderPrefixAndKey validates a loader key that includes the prefix
func ValidateLoaderPrefixAndKey(pk string) error {
	if len(pk) != LoaderPrefixAndKeyLength {
		return fmt.Errorf("loader key is incorrect length")
	}
	err := ValidateLoaderPrefix(pk[:LoaderPrefixLength])
	if err != nil {
		return err
	}
	err = ValidateLoaderKey(pk[LoaderPrefixLength:])
	if err != nil {
		return err
	}
	return nil
}