receptor_v1

type Credential struct {

	// Receptor_object_id is Trustero's receptor record identifier.  This identifier is typically provided to the
	// receptor as part of a reporting findings or discover services request.
	ReceptorObjectId string `protobuf:"bytes,1,opt,name=receptor_object_id,json=receptorObjectId,proto3" json:"receptor_object_id,omitempty"`
	// Credential is the service provider credential being verified.
	Credential string `protobuf:"bytes,2,opt,name=credential,proto3" json:"credential,omitempty"`
	// Is_credential_valid report whether the service provider credential provided to the receptor verify request
	// is valid.
	IsCredentialValid bool `protobuf:"varint,3,opt,name=is_credential_valid,json=isCredentialValid,proto3" json:"is_credential_valid,omitempty"`
	// Message contains the reason for why the service provider credential in this message is invalid.
	Message string `protobuf:"bytes,4,opt,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

type Document struct {

	// Mime is the document type defined using [MIME].
	// [MIME]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types
	Mime string `protobuf:"bytes,2,opt,name=mime,proto3" json:"mime,omitempty"`
	// Body is the opaque document body.  The document body must match the type defined by the mime attribute.
	Body []byte `protobuf:"bytes,3,opt,name=body,proto3" json:"body,omitempty"`
	// contains filtered or unexported fields
}

type Evidence struct {

	// Caption is a human readable English string that identifies this evidence.  Caption must be stable for
	// all scans of the same evidence type.  Trustero uses the caption to associate this evidence with a
	// set of relevant controls.
	Caption string `protobuf:"bytes,1,opt,name=caption,proto3" json:"caption,omitempty"`
	// Description is a human readable English string describing the content of this evidence.  Description
	// tells Trustero and users contents of the evidence and how
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	// Service_name is the name of service this evidence was collected from.  For example, "S3" or "GitLab"
	ServiceName string `protobuf:"bytes,3,opt,name=service_name,json=serviceName,proto3" json:"service_name,omitempty"`
	// Entity_type specifies the row type and should correspond to a ServiceEntity.  An entity_type typically
	// represents a specific configurable entity such as AWS ECS "Cluster".
	EntityType string `protobuf:"bytes,4,opt,name=entity_type,json=entityType,proto3" json:"entity_type,omitempty"`
	// Sources are raw service provider API requests and responses used to generate this evidence.  The raw API requests
	// and responses serve as proof the evidence correlates to real service configurations.
	Sources []*Source `protobuf:"bytes,5,rep,name=sources,proto3" json:"sources,omitempty"`
	// Evidence_type can be either an unstructured (Document) or structured (Struct) type.
	//
	// Types that are assignable to EvidenceType:
	//
	//	*Evidence_Doc
	//	*Evidence_Struct
	EvidenceType isEvidence_EvidenceType `protobuf_oneof:"evidence_type"`
	// Service_account_id is the member account of the organization. For example, an AWS account number in an organization
	// that has more than one account.
	ServiceAccountId string `protobuf:"bytes,8,opt,name=service_account_id,json=serviceAccountId,proto3" json:"service_account_id,omitempty"`
	// contains filtered or unexported fields
}

type Evidence_Doc struct {
	// Document is an unstructured evidence.
	Doc *Document `protobuf:"bytes,6,opt,name=doc,proto3,oneof"`
}

type Evidence_Struct struct {
	// Struct is a structured evidence.
	Struct *Struct `protobuf:"bytes,7,opt,name=struct,proto3,oneof"`
}

type Finding struct {

	// Unique receptor identifier.  A receptor is expected to report findings from only one service provider type.  A
	// stable identifier that represent the type of receptor reporting this finding.  The identifier is a simple URL
	// encoded string that includes an organization name and the service provider name.  For example: "trustero_gitlab".
	ReceptorType string `protobuf:"bytes,1,opt,name=receptor_type,json=receptorType,proto3" json:"receptor_type,omitempty"`
	// The receptor's evidence source.
	ServiceProviderAccount string `` /* 129-byte string literal not displayed */
	// Entities is a list of service entity configurations in the service provider account.
	Entities []*ServiceEntity `protobuf:"bytes,3,rep,name=entities,proto3" json:"entities,omitempty"`
	// One or more evidence collected by a typical receptor scan.
	Evidences []*Evidence `protobuf:"bytes,4,rep,name=evidences,proto3" json:"evidences,omitempty"`
	// contains filtered or unexported fields
}

type JobResult struct {

	// Tracer_id is used to track the progress of the receptor request.
	TracerId string `protobuf:"bytes,1,opt,name=tracer_id,json=tracerId,proto3" json:"tracer_id,omitempty"`
	// Command is the receptor request that completed.  One of "verify", "scan", or "discover"
	Command string `protobuf:"bytes,2,opt,name=command,proto3" json:"command,omitempty"`
	// Result is receptor request result.  One of "success", "fail", or "error".
	Result string `protobuf:"bytes,3,opt,name=result,proto3" json:"result,omitempty"`
	// Receptor_object_id is Trustero's receptor record identifier.
	ReceptorObjectId string `protobuf:"bytes,4,opt,name=receptor_object_id,json=receptorObjectId,proto3" json:"receptor_object_id,omitempty"`
	// contains filtered or unexported fields
}

type ReceptorClient interface {
	// Verified reports whether the provided credential is a valid service provider credential for purpose of
	// discovering service entities and reporting findings.  This rpc call is typically made as callback by a
	// receptor to Trustero from a check-credential receptor request.
	Verified(ctx context.Context, in *Credential, opts ...grpc.CallOption) (*emptypb.Empty, error)
	// GetConfiguration for the receptor and service provider credential using the provided receptor object identifier.
	// This rpc call is typically made as a callback by a receptor prior to making a report findings or discover
	// service entities receptor request.
	GetConfiguration(ctx context.Context, in *ReceptorOID, opts ...grpc.CallOption) (*ReceptorConfiguration, error)
	// Discovered reports known service entities.  A receptor or a Trustero client application reports its known
	// service entities on request.  A service entity is a configurable asset of a service such as an S3 bucket.  This
	// call returns a string value discovery ID or an error.
	Discovered(ctx context.Context, in *ServiceEntities, opts ...grpc.CallOption) (*wrapperspb.StringValue, error)
	// Report a finding to Trustero.  A receptor or a Trustero client application reports its findings to Trustero on
	// a periodic basis.  This call returns a string value collection ID or an error.
	Report(ctx context.Context, in *Finding, opts ...grpc.CallOption) (*wrapperspb.StringValue, error)
	// Notify Trustero a long running report finding or discover service entities receptor-request has completed.
	// JobResult contains information about the receptor-request and it's corresponding result.
	Notify(ctx context.Context, in *JobResult, opts ...grpc.CallOption) (*emptypb.Empty, error)
}

type ReceptorConfiguration struct {

	// Receptor_object_id is Trustero's receptor record identifier.
	ReceptorObjectId string `protobuf:"bytes,1,opt,name=receptor_object_id,json=receptorObjectId,proto3" json:"receptor_object_id,omitempty"`
	// Credential required to access a service provider for report finding and discover services purposes.
	Credential string `protobuf:"bytes,2,opt,name=credential,proto3" json:"credential,omitempty"`
	// Config holds additional receptor configuration to access a service provider account.
	Config string `protobuf:"bytes,3,opt,name=config,proto3" json:"config,omitempty"`
	// Service_provider_account is the service provider account name.
	ServiceProviderAccount string `` /* 129-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ReceptorOID struct {

	// Receptor_object_id is the string representation of a Trustero persistent record.
	ReceptorObjectId string `protobuf:"bytes,1,opt,name=receptor_object_id,json=receptorObjectId,proto3" json:"receptor_object_id,omitempty"`
	// contains filtered or unexported fields
}

type ReceptorServer interface {
	// Verified reports whether the provided credential is a valid service provider credential for purpose of
	// discovering service entities and reporting findings.  This rpc call is typically made as callback by a
	// receptor to Trustero from a check-credential receptor request.
	Verified(context.Context, *Credential) (*emptypb.Empty, error)
	// GetConfiguration for the receptor and service provider credential using the provided receptor object identifier.
	// This rpc call is typically made as a callback by a receptor prior to making a report findings or discover
	// service entities receptor request.
	GetConfiguration(context.Context, *ReceptorOID) (*ReceptorConfiguration, error)
	// Discovered reports known service entities.  A receptor or a Trustero client application reports its known
	// service entities on request.  A service entity is a configurable asset of a service such as an S3 bucket.  This
	// call returns a string value discovery ID or an error.
	Discovered(context.Context, *ServiceEntities) (*wrapperspb.StringValue, error)
	// Report a finding to Trustero.  A receptor or a Trustero client application reports its findings to Trustero on
	// a periodic basis.  This call returns a string value collection ID or an error.
	Report(context.Context, *Finding) (*wrapperspb.StringValue, error)
	// Notify Trustero a long running report finding or discover service entities receptor-request has completed.
	// JobResult contains information about the receptor-request and it's corresponding result.
	Notify(context.Context, *JobResult) (*emptypb.Empty, error)
}

type Row struct {

	// Entity_instance_id of a discovered entity instance.  For example, an AWS "ECS" cluster UUID or GitLab
	// "repository" ID.
	EntityInstanceId string `protobuf:"bytes,1,opt,name=entity_instance_id,json=entityInstanceId,proto3" json:"entity_instance_id,omitempty"`
	// Cols are columns of the row in column name to value pairs.  All rows in a struct must have the same column
	// names and corresponding value types.  In addition, one of the key-value pair in the cols map must be the
	// entity_instance_id, a unique instance of this row's Struct.entity_type.
	Cols map[string]*Value `` /* 149-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ServiceEntities struct {

	// Receptor_type is a unique receptor type.  A stable string identifier that represent the type of receptor
	// reporting this finding.  The identifier is a simple URL encode string that includes the organization name
	// and a service provider name.  For example "trustero_gitlab".
	ReceptorType string `protobuf:"bytes,1,opt,name=receptor_type,json=receptorType,proto3" json:"receptor_type,omitempty"`
	// Service_provider_account is the service provider account where the services are configured in.
	ServiceProviderAccount string `` /* 129-byte string literal not displayed */
	// Entities is a list of service instances configured in the service provider account.
	Entities []*ServiceEntity `protobuf:"bytes,3,rep,name=entities,proto3" json:"entities,omitempty"`
	// contains filtered or unexported fields
}

type ServiceEntity struct {

	// Service_name of the entity source.  This is a Trustero assigned identifier for a known service such as
	// "GitLab" or AWS "ECS".
	ServiceName string `protobuf:"bytes,1,opt,name=service_name,json=serviceName,proto3" json:"service_name,omitempty"`
	// Entity_type is a service configurable object type such as a GitLab "repository" or AWS ECS "cluster".  The
	// entity_instance_name and entity_instance_id must represent an instance of the subtype.  For example,
	// "Java 1.5" maybe a valid GitLab repository name or "Elastic front end cluster" maybe a valid AWS ECS
	// cluster name.
	EntityType string `protobuf:"bytes,2,opt,name=entity_type,json=entityType,proto3" json:"entity_type,omitempty"`
	// Entity_instance_name of a discovered service entity instance.  For example, an AWS ECS cluster name or a
	// GitLab repository name.  Entity_instance_name of an entity may change for a given entity instance but
	// it's entity_instance_id is stable.
	EntityInstanceName string `protobuf:"bytes,3,opt,name=entity_instance_name,json=entityInstanceName,proto3" json:"entity_instance_name,omitempty"`
	// Entity_instance_id of a discovered entity instance.  For example, an AWS ECS cluster UUID or GitLab
	// repository ID.
	EntityInstanceId string `protobuf:"bytes,4,opt,name=entity_instance_id,json=entityInstanceId,proto3" json:"entity_instance_id,omitempty"`
	// Service_account_id is the member account of the organization. For example, an AWS account number in a an organization
	// that has more than one account.
	ServiceAccountId string `protobuf:"bytes,5,opt,name=service_account_id,json=serviceAccountId,proto3" json:"service_account_id,omitempty"`
	// contains filtered or unexported fields
}

type Source struct {

	// Raw_api_request is the raw API request used to generate this evidence.
	RawApiRequest string `protobuf:"bytes,1,opt,name=raw_api_request,json=rawApiRequest,proto3" json:"raw_api_request,omitempty"`
	// Raw_api_response is the raw API response used to generate this evidence.
	RawApiResponse string `protobuf:"bytes,2,opt,name=raw_api_response,json=rawApiResponse,proto3" json:"raw_api_response,omitempty"`
	// contains filtered or unexported fields
}

type Struct struct {

	// Rows of key-value pairs.  Each row typically represents the configuration of a service instance or an data
	// type such as a member of GitLab group.
	Rows []*Row `protobuf:"bytes,2,rep,name=rows,proto3" json:"rows,omitempty"`
	// Col_display_names is a map of row column name to it's corresponding display name.  Display names are used
	// by the user interface to render a field in a struct's rows.
	ColDisplayNames map[string]string `` /* 196-byte string literal not displayed */
	// Col_display_order is an ordered list of row column names.  The order of the column names are used by the user
	// interface to render the column order of a struct's rows.
	ColDisplayOrder []string `protobuf:"bytes,4,rep,name=col_display_order,json=colDisplayOrder,proto3" json:"col_display_order,omitempty"`
	// Col_tags is a map of column tag to row column name. These tags are used by Trustero's evidence testing interface
	// to identify relevant evidence.
	ColTags map[string]string `` /* 170-byte string literal not displayed */
	// contains filtered or unexported fields
}

type UnimplementedReceptorServer struct {
}

type UnsafeReceptorServer interface {
	// contains filtered or unexported methods
}

type Value struct {

	// Types that are assignable to ValueType:
	//
	//	*Value_DoubleValue
	//	*Value_FloatValue
	//	*Value_Int32Value
	//	*Value_Int64Value
	//	*Value_Uint32Value
	//	*Value_Uint64Value
	//	*Value_BoolValue
	//	*Value_StringValue
	//	*Value_TimestampValue
	ValueType isValue_ValueType `protobuf_oneof:"value_type"`
	// contains filtered or unexported fields
}

type Value_BoolValue struct {
	BoolValue bool `protobuf:"varint,7,opt,name=bool_value,json=boolValue,proto3,oneof"`
}

type Value_DoubleValue struct {
	DoubleValue float64 `protobuf:"fixed64,1,opt,name=double_value,json=doubleValue,proto3,oneof"`
}

type Value_FloatValue struct {
	FloatValue float32 `protobuf:"fixed32,2,opt,name=float_value,json=floatValue,proto3,oneof"`
}

type Value_Int32Value struct {
	Int32Value int32 `protobuf:"varint,3,opt,name=int32_value,json=int32Value,proto3,oneof"`
}

type Value_Int64Value struct {
	Int64Value int64 `protobuf:"varint,4,opt,name=int64_value,json=int64Value,proto3,oneof"`
}

type Value_StringValue struct {
	StringValue string `protobuf:"bytes,8,opt,name=string_value,json=stringValue,proto3,oneof"`
}

type Value_TimestampValue struct {
	TimestampValue *timestamppb.Timestamp `protobuf:"bytes,9,opt,name=timestamp_value,json=timestampValue,proto3,oneof"`
}

type Value_Uint32Value struct {
	Uint32Value uint32 `protobuf:"varint,5,opt,name=uint32_value,json=uint32Value,proto3,oneof"`
}

type Value_Uint64Value struct {
	Uint64Value uint64 `protobuf:"varint,6,opt,name=uint64_value,json=uint64Value,proto3,oneof"`
}