Documentation
¶
Overview ¶
Package configpb holds a config protobuf for the CT personality.
Index ¶
- type LogBackend
- func (*LogBackend) Descriptor() ([]byte, []int)
- func (m *LogBackend) GetBackendSpec() string
- func (m *LogBackend) GetName() string
- func (*LogBackend) ProtoMessage()
- func (m *LogBackend) Reset()
- func (m *LogBackend) String() string
- func (m *LogBackend) XXX_DiscardUnknown()
- func (m *LogBackend) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (dst *LogBackend) XXX_Merge(src proto.Message)
- func (m *LogBackend) XXX_Size() int
- func (m *LogBackend) XXX_Unmarshal(b []byte) error
- type LogBackendSet
- func (*LogBackendSet) Descriptor() ([]byte, []int)
- func (m *LogBackendSet) GetBackend() []*LogBackend
- func (*LogBackendSet) ProtoMessage()
- func (m *LogBackendSet) Reset()
- func (m *LogBackendSet) String() string
- func (m *LogBackendSet) XXX_DiscardUnknown()
- func (m *LogBackendSet) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (dst *LogBackendSet) XXX_Merge(src proto.Message)
- func (m *LogBackendSet) XXX_Size() int
- func (m *LogBackendSet) XXX_Unmarshal(b []byte) error
- type LogConfig
- func (*LogConfig) Descriptor() ([]byte, []int)
- func (m *LogConfig) GetAcceptOnlyCa() bool
- func (m *LogConfig) GetExpectedMergeDelaySec() int32
- func (m *LogConfig) GetExtKeyUsages() []string
- func (m *LogConfig) GetIsMirror() bool
- func (m *LogConfig) GetLogBackendName() string
- func (m *LogConfig) GetLogId() int64
- func (m *LogConfig) GetMaxMergeDelaySec() int32
- func (m *LogConfig) GetNotAfterLimit() *timestamp.Timestamp
- func (m *LogConfig) GetNotAfterStart() *timestamp.Timestamp
- func (m *LogConfig) GetOverrideHandlerPrefix() string
- func (m *LogConfig) GetPrefix() string
- func (m *LogConfig) GetPrivateKey() *any.Any
- func (m *LogConfig) GetPublicKey() *keyspb.PublicKey
- func (m *LogConfig) GetRejectExpired() bool
- func (m *LogConfig) GetRootsPemFile() []string
- func (*LogConfig) ProtoMessage()
- func (m *LogConfig) Reset()
- func (m *LogConfig) String() string
- func (m *LogConfig) XXX_DiscardUnknown()
- func (m *LogConfig) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (dst *LogConfig) XXX_Merge(src proto.Message)
- func (m *LogConfig) XXX_Size() int
- func (m *LogConfig) XXX_Unmarshal(b []byte) error
- type LogConfigSet
- func (*LogConfigSet) Descriptor() ([]byte, []int)
- func (m *LogConfigSet) GetConfig() []*LogConfig
- func (*LogConfigSet) ProtoMessage()
- func (m *LogConfigSet) Reset()
- func (m *LogConfigSet) String() string
- func (m *LogConfigSet) XXX_DiscardUnknown()
- func (m *LogConfigSet) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (dst *LogConfigSet) XXX_Merge(src proto.Message)
- func (m *LogConfigSet) XXX_Size() int
- func (m *LogConfigSet) XXX_Unmarshal(b []byte) error
- type LogMultiConfig
- func (*LogMultiConfig) Descriptor() ([]byte, []int)
- func (m *LogMultiConfig) GetBackends() *LogBackendSet
- func (m *LogMultiConfig) GetLogConfigs() *LogConfigSet
- func (*LogMultiConfig) ProtoMessage()
- func (m *LogMultiConfig) Reset()
- func (m *LogMultiConfig) String() string
- func (m *LogMultiConfig) XXX_DiscardUnknown()
- func (m *LogMultiConfig) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (dst *LogMultiConfig) XXX_Merge(src proto.Message)
- func (m *LogMultiConfig) XXX_Size() int
- func (m *LogMultiConfig) XXX_Unmarshal(b []byte) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type LogBackend ¶ added in v1.0.4
type LogBackend struct {
// name defines the name of the log backend for use in LogConfig messages and must be unique.
Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
// backend_spec defines the RPC endpoint that clients should use to send requests
// to this log backend. These should be in the same format as rpcBackendFlag in the
// CTFE main and must not be an empty string.
BackendSpec string `protobuf:"bytes,2,opt,name=backend_spec,json=backendSpec,proto3" json:"backend_spec,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}
func (*LogBackend) Descriptor ¶ added in v1.0.4
func (*LogBackend) Descriptor() ([]byte, []int)
func (*LogBackend) GetBackendSpec ¶ added in v1.0.4
func (m *LogBackend) GetBackendSpec() string
func (*LogBackend) GetName ¶ added in v1.0.4
func (m *LogBackend) GetName() string
func (*LogBackend) ProtoMessage ¶ added in v1.0.4
func (*LogBackend) ProtoMessage()
func (*LogBackend) Reset ¶ added in v1.0.4
func (m *LogBackend) Reset()
func (*LogBackend) String ¶ added in v1.0.4
func (m *LogBackend) String() string
func (*LogBackend) XXX_DiscardUnknown ¶ added in v1.0.17
func (m *LogBackend) XXX_DiscardUnknown()
func (*LogBackend) XXX_Marshal ¶ added in v1.0.17
func (m *LogBackend) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*LogBackend) XXX_Merge ¶ added in v1.0.17
func (dst *LogBackend) XXX_Merge(src proto.Message)
func (*LogBackend) XXX_Size ¶ added in v1.0.17
func (m *LogBackend) XXX_Size() int
func (*LogBackend) XXX_Unmarshal ¶ added in v1.0.17
func (m *LogBackend) XXX_Unmarshal(b []byte) error
type LogBackendSet ¶ added in v1.0.4
type LogBackendSet struct {
Backend []*LogBackend `protobuf:"bytes,1,rep,name=backend,proto3" json:"backend,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}
LogBackendSet supports a configuration where a single set of frontends handle requests for multiple backends. For example this could be used to run different backends in different geographic regions.
func (*LogBackendSet) Descriptor ¶ added in v1.0.4
func (*LogBackendSet) Descriptor() ([]byte, []int)
func (*LogBackendSet) GetBackend ¶ added in v1.0.4
func (m *LogBackendSet) GetBackend() []*LogBackend
func (*LogBackendSet) ProtoMessage ¶ added in v1.0.4
func (*LogBackendSet) ProtoMessage()
func (*LogBackendSet) Reset ¶ added in v1.0.4
func (m *LogBackendSet) Reset()
func (*LogBackendSet) String ¶ added in v1.0.4
func (m *LogBackendSet) String() string
func (*LogBackendSet) XXX_DiscardUnknown ¶ added in v1.0.17
func (m *LogBackendSet) XXX_DiscardUnknown()
func (*LogBackendSet) XXX_Marshal ¶ added in v1.0.17
func (m *LogBackendSet) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*LogBackendSet) XXX_Merge ¶ added in v1.0.17
func (dst *LogBackendSet) XXX_Merge(src proto.Message)
func (*LogBackendSet) XXX_Size ¶ added in v1.0.17
func (m *LogBackendSet) XXX_Size() int
func (*LogBackendSet) XXX_Unmarshal ¶ added in v1.0.17
func (m *LogBackendSet) XXX_Unmarshal(b []byte) error
type LogConfig ¶
type LogConfig struct {
// The ID of a Trillian tree that stores the log data. The tree type must be
// LOG for regular CT logs. For mirror logs it must be either PREORDERED_LOG
// or LOG, and can change at runtime. CTFE in mirror mode uses only read API
// which is common for both types.
LogId int64 `protobuf:"varint,1,opt,name=log_id,json=logId,proto3" json:"log_id,omitempty"`
// prefix is the name of the log. It will come after the global or
// override handler prefix. For example if the handler prefix is "/logs"
// and prefix is "vogon" the get-sth handler for this log will be
// available at "/logs/vogon/ct/v1/get-sth". The prefix cannot be empty
// and must not include "/" path separator characters.
Prefix string `protobuf:"bytes,2,opt,name=prefix,proto3" json:"prefix,omitempty"`
// override_handler_prefix if set to a non empty value overrides the global
// handler prefix for an individual log. For example this field is set to
// "/otherlogs" then a log with prefix "vogon" will make it's get-sth handler
// available at "/otherlogs/vogon/ct/v1/get-sth" regardless of what the
// global prefix is. Can be set to '/' to make the get-sth handler register
// at "/vogon/ct/v1/get-sth".
OverrideHandlerPrefix string `` /* 127-byte string literal not displayed */
// Paths to the files containing root certificates that are acceptable to the
// log. The certs are served through get-roots endpoint. Optional in mirrors.
RootsPemFile []string `protobuf:"bytes,3,rep,name=roots_pem_file,json=rootsPemFile,proto3" json:"roots_pem_file,omitempty"`
// The private key used for signing STHs etc. Not required for mirrors.
PrivateKey *any.Any `protobuf:"bytes,4,opt,name=private_key,json=privateKey,proto3" json:"private_key,omitempty"`
// The public key matching the above private key (if both are present). It is
// used only by mirror logs for verifying the source log's signatures, but can
// be specified for regular logs as well for the convenience of test tools.
PublicKey *keyspb.PublicKey `protobuf:"bytes,5,opt,name=public_key,json=publicKey,proto3" json:"public_key,omitempty"`
// If reject_expired is true then the certificate validity period will be
// checked against the current time during the validation of submissions.
// This will cause expired certificates to be rejected.
RejectExpired bool `protobuf:"varint,6,opt,name=reject_expired,json=rejectExpired,proto3" json:"reject_expired,omitempty"`
// If set, ext_key_usages will restrict the set of such usages that the
// server will accept. By default all are accepted. The values specified
// must be ones known to the x509 package.
ExtKeyUsages []string `protobuf:"bytes,7,rep,name=ext_key_usages,json=extKeyUsages,proto3" json:"ext_key_usages,omitempty"`
// not_after_start defines the start of the range of acceptable NotAfter
// values, inclusive.
// Leaving this unset implies no lower bound to the range.
NotAfterStart *timestamp.Timestamp `protobuf:"bytes,8,opt,name=not_after_start,json=notAfterStart,proto3" json:"not_after_start,omitempty"`
// not_after_limit defines the end of the range of acceptable NotAfter values,
// exclusive.
// Leaving this unset implies no upper bound to the range.
NotAfterLimit *timestamp.Timestamp `protobuf:"bytes,9,opt,name=not_after_limit,json=notAfterLimit,proto3" json:"not_after_limit,omitempty"`
// accept_only_ca controls whether or not *only* certificates with the CA bit
// set will be accepted.
AcceptOnlyCa bool `protobuf:"varint,10,opt,name=accept_only_ca,json=acceptOnlyCa,proto3" json:"accept_only_ca,omitempty"`
// backend_name if set indicates which backend serves this log. The name must be
// one of those defined in the LogBackendSet.
LogBackendName string `protobuf:"bytes,11,opt,name=log_backend_name,json=logBackendName,proto3" json:"log_backend_name,omitempty"`
// If set, the log is a mirror, i.e. it serves the data of another (source)
// log. It doesn't handle write requests (add-chain, etc.), so it's not a
// fully fledged RFC-6962 log, but the tree read requests like get-entries and
// get-consistency-proof are compatible. A mirror doesn't have the source
// log's key and can't sign STHs. Consequently, the log operator must ensure
// to channel source log's STHs into CTFE.
IsMirror bool `protobuf:"varint,12,opt,name=is_mirror,json=isMirror,proto3" json:"is_mirror,omitempty"`
// The Maximum Merge Delay (MMD) of this log in seconds. See RFC6962 section 3
// for definition of MMD. If zero, the log does not provide an MMD guarantee
// (for example, it is a frozen log).
MaxMergeDelaySec int32 `protobuf:"varint,14,opt,name=max_merge_delay_sec,json=maxMergeDelaySec,proto3" json:"max_merge_delay_sec,omitempty"`
// The merge delay that the underlying log implementation is able/targeting to
// provide. This option is exposed in CTFE metrics, and can be particularly
// useful to catch when the log is behind but has not yet violated the strict
// MMD limit.
ExpectedMergeDelaySec int32 `` /* 130-byte string literal not displayed */
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}
LogConfig describes the configuration options for a log instance.
NEXT_ID: 16
func (*LogConfig) Descriptor ¶
func (*LogConfig) GetAcceptOnlyCa ¶
func (*LogConfig) GetExpectedMergeDelaySec ¶ added in v1.0.21
func (*LogConfig) GetExtKeyUsages ¶
func (*LogConfig) GetIsMirror ¶ added in v1.0.21
func (*LogConfig) GetLogBackendName ¶ added in v1.0.4
func (*LogConfig) GetMaxMergeDelaySec ¶ added in v1.0.21
func (*LogConfig) GetNotAfterLimit ¶
func (*LogConfig) GetNotAfterStart ¶
func (*LogConfig) GetOverrideHandlerPrefix ¶ added in v1.0.21
func (*LogConfig) GetPrivateKey ¶
func (*LogConfig) GetPublicKey ¶
func (*LogConfig) GetRejectExpired ¶
func (*LogConfig) GetRootsPemFile ¶
func (*LogConfig) ProtoMessage ¶
func (*LogConfig) ProtoMessage()
func (*LogConfig) XXX_DiscardUnknown ¶ added in v1.0.17
func (m *LogConfig) XXX_DiscardUnknown()
func (*LogConfig) XXX_Marshal ¶ added in v1.0.17
func (*LogConfig) XXX_Unmarshal ¶ added in v1.0.17
type LogConfigSet ¶
type LogConfigSet struct {
Config []*LogConfig `protobuf:"bytes,1,rep,name=config,proto3" json:"config,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}
LogConfigSet is a set of LogConfig messages.
func (*LogConfigSet) Descriptor ¶
func (*LogConfigSet) Descriptor() ([]byte, []int)
func (*LogConfigSet) GetConfig ¶
func (m *LogConfigSet) GetConfig() []*LogConfig
func (*LogConfigSet) ProtoMessage ¶
func (*LogConfigSet) ProtoMessage()
func (*LogConfigSet) Reset ¶
func (m *LogConfigSet) Reset()
func (*LogConfigSet) String ¶
func (m *LogConfigSet) String() string
func (*LogConfigSet) XXX_DiscardUnknown ¶ added in v1.0.17
func (m *LogConfigSet) XXX_DiscardUnknown()
func (*LogConfigSet) XXX_Marshal ¶ added in v1.0.17
func (m *LogConfigSet) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*LogConfigSet) XXX_Merge ¶ added in v1.0.17
func (dst *LogConfigSet) XXX_Merge(src proto.Message)
func (*LogConfigSet) XXX_Size ¶ added in v1.0.17
func (m *LogConfigSet) XXX_Size() int
func (*LogConfigSet) XXX_Unmarshal ¶ added in v1.0.17
func (m *LogConfigSet) XXX_Unmarshal(b []byte) error
type LogMultiConfig ¶ added in v1.0.4
type LogMultiConfig struct {
// The set of backends that this configuration will use to send requests to.
// The names of the backends in the LogBackendSet must all be distinct.
Backends *LogBackendSet `protobuf:"bytes,1,opt,name=backends,proto3" json:"backends,omitempty"`
// The set of logs that will use the above backends. All the protos in this
// LogConfigSet must set a valid log_backend_name for the config to be usable.
LogConfigs *LogConfigSet `protobuf:"bytes,2,opt,name=log_configs,json=logConfigs,proto3" json:"log_configs,omitempty"`
XXX_NoUnkeyedLiteral struct{} `json:"-"`
XXX_unrecognized []byte `json:"-"`
XXX_sizecache int32 `json:"-"`
}
LogMultiConfig wraps up a LogBackendSet and corresponding LogConfigSet so that they can easily be parsed as a single proto.
func (*LogMultiConfig) Descriptor ¶ added in v1.0.4
func (*LogMultiConfig) Descriptor() ([]byte, []int)
func (*LogMultiConfig) GetBackends ¶ added in v1.0.4
func (m *LogMultiConfig) GetBackends() *LogBackendSet
func (*LogMultiConfig) GetLogConfigs ¶ added in v1.0.4
func (m *LogMultiConfig) GetLogConfigs() *LogConfigSet
func (*LogMultiConfig) ProtoMessage ¶ added in v1.0.4
func (*LogMultiConfig) ProtoMessage()
func (*LogMultiConfig) Reset ¶ added in v1.0.4
func (m *LogMultiConfig) Reset()
func (*LogMultiConfig) String ¶ added in v1.0.4
func (m *LogMultiConfig) String() string
func (*LogMultiConfig) XXX_DiscardUnknown ¶ added in v1.0.17
func (m *LogMultiConfig) XXX_DiscardUnknown()
func (*LogMultiConfig) XXX_Marshal ¶ added in v1.0.17
func (m *LogMultiConfig) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*LogMultiConfig) XXX_Merge ¶ added in v1.0.17
func (dst *LogMultiConfig) XXX_Merge(src proto.Message)
func (*LogMultiConfig) XXX_Size ¶ added in v1.0.17
func (m *LogMultiConfig) XXX_Size() int
func (*LogMultiConfig) XXX_Unmarshal ¶ added in v1.0.17
func (m *LogMultiConfig) XXX_Unmarshal(b []byte) error
Click to show internal directories.
Click to hide internal directories.