agent

Documentation

Index

• func RegisterService(s *grpc.Server, service *Service)
• type Config
• type Service
  • func New(config Config) *Service
  • func (s *Service) AttestAgent(stream agentv1.Agent_AttestAgentServer) error
  • func (s *Service) BanAgent(ctx context.Context, req *agentv1.BanAgentRequest) (*emptypb.Empty, error)
  • func (s *Service) CountAgents(ctx context.Context, req *agentv1.CountAgentsRequest) (*agentv1.CountAgentsResponse, error)
  • func (s *Service) CreateJoinToken(ctx context.Context, req *agentv1.CreateJoinTokenRequest) (*types.JoinToken, error)
  • func (s *Service) DeleteAgent(ctx context.Context, req *agentv1.DeleteAgentRequest) (*emptypb.Empty, error)
  • func (s *Service) GetAgent(ctx context.Context, req *agentv1.GetAgentRequest) (*types.Agent, error)
  • func (s *Service) ListAgents(ctx context.Context, req *agentv1.ListAgentsRequest) (*agentv1.ListAgentsResponse, error)
  • func (s *Service) RenewAgent(ctx context.Context, req *agentv1.RenewAgentRequest) (*agentv1.RenewAgentResponse, error)

Functions

func RegisterService

func RegisterService(s *grpc.Server, service *Service)

RegisterService registers the agent service on the gRPC server/

Types

type Config

type Config struct {
	Catalog     catalog.Catalog
	Clock       clock.Clock
	DataStore   datastore.DataStore
	ServerCA    ca.ServerCA
	AgentTTL    time.Duration
	TrustDomain spiffeid.TrustDomain
}

Config is the service configuration

type Service

type Service struct {
	agentv1.UnsafeAgentServer
	// contains filtered or unexported fields
}

Service implements the v1 agent service

func New

func New(config Config) *Service

New creates a new agent service

func (*Service) AttestAgent

func (s *Service) AttestAgent(stream agentv1.Agent_AttestAgentServer) error

AttestAgent attests the authenticity of the given agent.

func (*Service) BanAgent

func (s *Service) BanAgent(ctx context.Context, req *agentv1.BanAgentRequest) (*emptypb.Empty, error)

BanAgent sets the agent with the given SpiffeID to the banned state.

func (*Service) CountAgents

func (s *Service) CountAgents(ctx context.Context, req *agentv1.CountAgentsRequest) (*agentv1.CountAgentsResponse, error)

CountAgents returns the total number of agents.

func (*Service) CreateJoinToken

func (s *Service) CreateJoinToken(ctx context.Context, req *agentv1.CreateJoinTokenRequest) (*types.JoinToken, error)

CreateJoinToken returns a new JoinToken for an agent.

func (*Service) DeleteAgent

func (s *Service) DeleteAgent(ctx context.Context, req *agentv1.DeleteAgentRequest) (*emptypb.Empty, error)

DeleteAgent removes the agent with the given SpiffeID.

func (*Service) GetAgent

func (s *Service) GetAgent(ctx context.Context, req *agentv1.GetAgentRequest) (*types.Agent, error)

GetAgent returns the agent associated with the given SpiffeID.

func (*Service) ListAgents

func (s *Service) ListAgents(ctx context.Context, req *agentv1.ListAgentsRequest) (*agentv1.ListAgentsResponse, error)

ListAgents returns an optionally filtered and/or paginated list of agents.

func (*Service) RenewAgent

func (s *Service) RenewAgent(ctx context.Context, req *agentv1.RenewAgentRequest) (*agentv1.RenewAgentResponse, error)

RenewAgent renews the SVID of the agent with the given SpiffeID.