Kibotos
API referencekibotos.enrollment.v1

EnrollmentService

This page lists the methods of EnrollmentService in kibotos.enrollment.v1 with the messages and enums each one uses, generated from enrollment.proto and its comments.

Operator API and node APIThe principal that connects decides which method it may call.

EnrollmentService is mounted on both the Operator API and the node API. The transport principal decides what a caller may do: a bootstrap principal (spiffe://<trust-domain>/enrollment/<grant-id>) may only call Enroll, and a formal Operator or node principal may only call Renew. The router enforces that rule before it deserializes any request body, and Enroll additionally requires the grant kind to match the endpoint it arrived on.

Enroll

POST/kibotos.enrollment.v1.EnrollmentService/EnrollUnary
RequestEnrollRequest

EnrollRequest proves possession of a client-generated key. The CSR must be a DER PKCS#10 request of at most 8 KiB without requested extensions or names; ctrl ignores its subject and builds the identity from the grant.

ResponseEnrollResponse

Renew

POST/kibotos.enrollment.v1.EnrollmentService/RenewUnary
RequestRenewRequest

RenewRequest carries a CSR for a fresh client-generated key. ctrl issues only for the same active principal that authenticated the call.

ResponseRenewResponse

Messages and enums

Several methods of EnrollmentService use these messages and enums.

IssuedIdentity

IssuedIdentity is the authoritative result of one enrollment or renewal. It never carries a private key.

  • identity_uristring= 1
  • certificatebytes= 2

    certificate is the DER leaf signed by the control-client CA.

  • ca_certificate is the DER control-client CA so the client can verify the chain before persisting anything.

  • serialstring= 4
  • not_beforegoogle.protobuf.Timestamp= 5
  • not_aftergoogle.protobuf.Timestamp= 6

On this page