Kibotos
API referencekibotos.operator.v1

EnrollmentGrantService

This page lists the methods of EnrollmentGrantService in kibotos.operator.v1 with the messages and enums each one uses, generated from operator.proto and its comments. Those that several services use are on kibotos.operator.v1 types.

ctrl APICalled with an Operator certificate.How to call it

EnrollmentGrantService lets an authenticated Operator create one-time enrollment grants for other Operators or for exact node IDs, and revoke a principal. The enrollment key is returned exactly once; ctrl keeps only the grant record, the bootstrap certificate serial, and the key fingerprint.

CreateEnrollmentGrant

POST/kibotos.operator.v1.EnrollmentGrantService/CreateEnrollmentGrantUnary
RequestCreateEnrollmentGrantRequest

CreateEnrollmentGrantRequest names the exact principal the grant admits. ttl is bounded by ctrl (one minute to twenty-four hours, default one hour). data_plane_extra_hosts is allowed only on a node grant: extra lowercase DNS names or IP addresses (an IP, a loopback address, or an external DNS name) the node's data-plane certificate must also name, beyond the derived <node_id>.<suffix> node host ctrl always signs. Enroll copies them into the node admission. None of them may be the ctrl host.

ResponseCreateEnrollmentGrantResponse

CreateEnrollmentGrantResponse carries the opaque enrollment key only on the first response for a command_id. A replay returns the same grant with an empty key and replayed set, because ctrl never stores the key.

RevokeEnrollment

POST/kibotos.operator.v1.EnrollmentGrantService/RevokeEnrollmentUnary
RequestRevokeEnrollmentRequest

RevokeEnrollmentRequest ends a principal: its admission becomes terminal, its pending grants are revoked, and for a node its control session closes.

ResponseRevokeEnrollmentResponse

Messages and enums

Several methods of EnrollmentGrantService use these messages and enums.

EnrollmentKind

  • ENROLLMENT_KIND_UNSPECIFIED= 0
  • ENROLLMENT_KIND_OPERATOR= 1
  • ENROLLMENT_KIND_NODE= 2

On this page