Skip to content

Cofide Connect API Reference (v0.47.0)

Top

FieldTypeLabelDescription
idstringoptional
cluster_idstringoptional
trust_zone_idstringoptional

FieldTypeLabelDescription
statusAgentStatusCodeoptional
status_messagestringoptional
last_updatedint64optional

NameNumberDescription
AGENT_STATUS_CODE_UNSPECIFIED0
AGENT_STATUS_CODE_RUNNING1
AGENT_STATUS_CODE_STOPPED2
AGENT_STATUS_CODE_ERROR3
AGENT_STATUS_CODE_STARTING4

Top

proto/ap_binding/v1alpha1/ap_binding.proto

Section titled “proto/ap_binding/v1alpha1/ap_binding.proto”

FieldTypeLabelDescription
idstringoptional
org_idstringoptional
trust_zone_idstringoptional
policy_idstringoptional
federationsAPBindingFederationrepeated

FieldTypeLabelDescription
trust_zone_idstringoptional

Top

FieldTypeLabelDescription
typestringThe type of the selector. This is typically the name of the plugin that produces the selector.
valuestringThe value of the selector.

FieldTypeLabelDescription
selectorsSelectorrepeatedThe set of selectors to match on.
matchSelectorMatch.MatchBehaviorHow to match the selectors.

NameNumberDescription
MATCH_BEHAVIOR_EXACT_UNSPECIFIED0Indicates that the selectors in this match are equal to the candidate selectors, independent of ordering. Example: Given: - ‘e1 { Selectors: [“a:1”, “b:2”, “c:3”]}’ - ‘e2 { Selectors: [“a:1”, “b:2”]}’ - ‘e3 { Selectors: [“a:1”]}’ Operation: - MATCH_EXACT [“a:1”, “b:2”] Entries that match: - ‘e2’
MATCH_BEHAVIOR_SUBSET1Indicates that all candidates which have a non-empty subset of the provided set of selectors will match. Example: Given: - ‘e1 { Selectors: [“a:1”, “b:2”, “c:3”]}’ - ‘e2 { Selectors: [“a:1”, “b:2”]}’ - ‘e3 { Selectors: [“a:1”]}’ Operation: - MATCH_SUBSET [“a:1”] Entries that match: - ‘e1’
MATCH_BEHAVIOR_SUPERSET2Indicates that all candidates which are a superset of the provided selectors will match. Example: Given: - ‘e1 { Selectors: [“a:1”, “b:2”, “c:3”]}’ - ‘e2 { Selectors: [“a:1”, “b:2”]}’ - ‘e3 { Selectors: [“a:1”]}’ Operation: - MATCH_SUPERSET [“a:1”, “b:2”] Entries that match: - ‘e1’ - ‘e2’
MATCH_BEHAVIOR_ANY3Indicates that all candidates which have at least one of the provided set of selectors will match. Example: Given: - ‘e1 { Selectors: [“a:1”, “b:2”, “c:3”]}’ - ‘e2 { Selectors: [“a:1”, “b:2”]}’ - ‘e3 { Selectors: [“a:1”]}’ Operation: - MATCH_ANY [“a:1”] Entries that match: - ‘e1’ - ‘e2’ - ‘e3’

Top

proto/attestation_policy/v1alpha1/attestation_policy.proto

Section titled “proto/attestation_policy/v1alpha1/attestation_policy.proto”

FieldTypeLabelDescription
namespace_selectorAPLabelSelectoroptional
pod_selectorAPLabelSelectoroptional
dns_name_templatesstringrepeated
spiffe_id_path_templatestringoptionalCustom SPIFFE ID path format for Connect identity issuance This defines the identity path appended to domain of the trust zone it is bound to

An example spiffe_id_path_template and corresponding SPIFFE ID: ns/{{ .PodMeta.Namespace }}/sa/{{ .PodSpec.ServiceAccountName }} => spiffe://<trust_domain_of_trust_zone>/ns/…/sa/…

This is supported in both Connect and OSS SPIRE via spire-controller-manager Note that the supported templates are a subset of those in the SCM

Valid template components: {{ .ClusterName }} - Name of cluster {{ .PodMeta.Namespace }} - Namespace of the pod {{ index .PodMeta.Labels “key” }} - Pod label value of a provided key {{ index .PodMeta.Annotations “key” }} - Pod annotation value of a provided key {{ .PodSpec.ServiceAccountName }} - Service account of the pod |

This definition has been adapted from the LabelSelector message in Kubernetes. https://github.com/kubernetes/apimachinery/blob/master/pkg/apis/meta/v1/generated.proto

FieldTypeLabelDescription
match_labelsAPLabelSelector.MatchLabelsEntryrepeated
match_expressionsAPMatchExpressionrepeated

FieldTypeLabelDescription
keystring
valuestring

FieldTypeLabelDescription
keystring
operatorstring
valuesstringrepeated

APStatic represents a static attestation policy

FieldTypeLabelDescription
spiffe_idstringoptionalDeprecated.
spiffe_id_pathstringoptional
parent_id_pathstringoptional
selectorsspire.api.types.Selectorrepeated
dns_namesstringrepeated

APTPMNode represents a node (agent) attesting using a Trusted Platform Module (TPM).

FieldTypeLabelDescription
attestationTPMAttestation
selector_valuesstringrepeatedselector_values are the values of node selectors to use for this node. The key of the selectors will be “tpm”.

FieldTypeLabelDescription
idstringoptional
namestring
org_idstringoptional
kubernetesAPKubernetes
staticAPStatic
tpm_nodeAPTPMNode

TPMAttestation represents attestation requirements for a node (agent) attesting using a Trusted Platform Module (TPM).

FieldTypeLabelDescription
ek_hashstringoptionalek_hash is the SHA256 hash of the TPM’s Endorsement Key (EK).

Top

proto/trust_provider/v1alpha1/trust_provider.proto

Section titled “proto/trust_provider/v1alpha1/trust_provider.proto”

FieldTypeLabelDescription
enabledboolWhether to enable the k8s psat node attestor plugin with a Connect datasource.
allowed_service_accountsK8sPsatConfig.ServiceAccountrepeatedNamespace and name of service accounts agents can use tokens from to attest nodes in this cluster. At least 1 must be provided if the SPIRE server is outside the cluster.
allowed_node_label_keysstringrepeatedNode labels that can be used as selectors in this cluster.
allowed_pod_label_keysstringrepeatedPod labels that can be used as selectors in this cluster.
api_server_ca_certbytesCA certificate of the cluster’s API server. Optional, but required if the SPIRE server is outside the cluster and the cluster’s API server CA is not already trusted by the SPIRE server (very likely).
api_server_urlstringCluster’s API server URL. Required if the SPIRE server is outside the cluster.
api_server_tls_server_namestringAlternative TLS server name to verify the presented certificate with if the hostname of the API server URL is not in the presented certificate.
api_server_proxy_urlstringProxy URL of the API server (if running behind a proxy).
spire_server_audiencestringAudience the SPIRE server should use in the JWT presented to the cluster’s API server. Required if the SPIRE server is outside the cluster.

FieldTypeLabelDescription
namespacestring
service_account_namestring

FieldTypeLabelDescription
kindstringoptional
k8s_psat_configK8sPsatConfigConfiguration for the k8s psat node attestor plugin when using a Connect datasource with remote clusters.

Configuration for additional server plugins goes here. More than one may be enabled, to allow node attestation in a cluster to be done in multiple different ways. |

NameNumberDescription
TRUST_PROVIDER_KIND_UNSPECIFIED0
TRUST_PROVIDER_KIND_KUBERNETES1

Top

FieldTypeLabelDescription
idstringoptional
namestringoptional
org_idstringoptional
trust_zone_idstringoptional
kubernetes_contextstringoptional
trust_providerproto.trust_provider.v1alpha1.TrustProvideroptional
extra_helm_valuesgoogle.protobuf.Structoptional
profilestringoptional
external_serverbooloptional
oidc_issuer_urlstringoptional
oidc_issuer_ca_certbytesoptional

Top

proto/federation/v1alpha1/federation.proto

Section titled “proto/federation/v1alpha1/federation.proto”

FieldTypeLabelDescription
idstringoptional
org_idstringoptional
trust_zone_idstringoptional
remote_trust_zone_idstringoptional

Top

FieldTypeLabelDescription
trust_domainstringThe name of the trust domain the bundle belongs to (e.g., “example.org”).
x509_authoritiesX509CertificaterepeatedX.509 authorities for authenticating X509-SVIDs.
jwt_authoritiesJWTKeyrepeatedJWT authorities for authenticating JWT-SVIDs.
refresh_hintint64A hint on how often the bundle should be refreshed from the bundle provider, in seconds. Can be zero (meaning no hint available).
sequence_numberuint64The sequence number of the bundle.

FieldTypeLabelDescription
x509_authoritiesboolx509_authorities field mask.
jwt_authoritiesbooljwt_authorities field mask.
refresh_hintboolrefresh_hint field mask.
sequence_numberboolsequence_number field mask.

FieldTypeLabelDescription
public_keybytesThe PKIX encoded public key.
key_idstringThe key identifier.
expires_atint64When the key expires (seconds since Unix epoch). If zero, the key does not expire.
taintedboolThis authority is no longer secure and must not be used

FieldTypeLabelDescription
asn1bytesThe ASN.1 DER encoded bytes of the X.509 certificate.
taintedboolThis authority is no longer secure and must not be used.

Top

proto/trust_zone/v1alpha1/trust_zone.proto

Section titled “proto/trust_zone/v1alpha1/trust_zone.proto”

FieldTypeLabelDescription
namestring
trust_domainstring
bundle_endpoint_urlstringoptional
bundlespire.api.types.Bundleoptional
jwt_issuerstringoptional
bundle_endpoint_profileBundleEndpointProfileoptional
idstringoptional
is_management_zonebool
org_idstringoptional

NameNumberDescription
BUNDLE_ENDPOINT_PROFILE_UNSPECIFIED0
BUNDLE_ENDPOINT_PROFILE_HTTPS_SPIFFE1
BUNDLE_ENDPOINT_PROFILE_HTTPS_WEB2

Top

proto/cofidectl/datasource_plugin/v1alpha2/plugin.proto

Section titled “proto/cofidectl/datasource_plugin/v1alpha2/plugin.proto”

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federationoptional

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federationoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicy

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicy

FieldTypeLabelDescription
namestringoptional
trust_zone_idstringoptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
idstringoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
filterListAPBindingsRequest.Filteroptional

FieldTypeLabelDescription
trust_zone_idstringoptional
policy_idstringoptional

FieldTypeLabelDescription
bindingsproto.ap_binding.v1alpha1.APBindingrepeated

FieldTypeLabelDescription
policiesproto.attestation_policy.v1alpha1.AttestationPolicyrepeated

FieldTypeLabelDescription
filterListClustersRequest.Filteroptional

FieldTypeLabelDescription
trust_zone_idstringoptional

FieldTypeLabelDescription
clustersproto.cluster.v1alpha1.Clusterrepeated

FieldTypeLabelDescription
filterListFederationsRequest.Filteroptional

FieldTypeLabelDescription
trust_zone_idstringoptional

FieldTypeLabelDescription
federationsproto.federation.v1alpha1.Federationrepeated

FieldTypeLabelDescription
trust_zonesproto.trust_zone.v1alpha1.TrustZonerepeated

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

Method NameRequest TypeResponse TypeDescription
ValidateValidateRequestValidateResponse
AddTrustZoneAddTrustZoneRequestAddTrustZoneResponse
DestroyTrustZoneDestroyTrustZoneRequestDestroyTrustZoneResponse
GetTrustZoneGetTrustZoneRequestGetTrustZoneResponse
GetTrustZoneByNameGetTrustZoneByNameRequestGetTrustZoneByNameResponse
ListTrustZonesListTrustZonesRequestListTrustZonesResponse
UpdateTrustZoneUpdateTrustZoneRequestUpdateTrustZoneResponse
AddClusterAddClusterRequestAddClusterResponse
DestroyClusterDestroyClusterRequestDestroyClusterResponse
GetClusterGetClusterRequestGetClusterResponse
GetClusterByNameGetClusterByNameRequestGetClusterByNameResponse
ListClustersListClustersRequestListClustersResponse
UpdateClusterUpdateClusterRequestUpdateClusterResponse
AddAttestationPolicyAddAttestationPolicyRequestAddAttestationPolicyResponse
DestroyAttestationPolicyDestroyAttestationPolicyRequestDestroyAttestationPolicyResponse
GetAttestationPolicyGetAttestationPolicyRequestGetAttestationPolicyResponse
GetAttestationPolicyByNameGetAttestationPolicyByNameRequestGetAttestationPolicyByNameResponse
ListAttestationPoliciesListAttestationPoliciesRequestListAttestationPoliciesResponse
AddAPBindingAddAPBindingRequestAddAPBindingResponse
DestroyAPBindingDestroyAPBindingRequestDestroyAPBindingResponse
ListAPBindingsListAPBindingsRequestListAPBindingsResponse
AddFederationAddFederationRequestAddFederationResponse
DestroyFederationDestroyFederationRequestDestroyFederationResponse
ListFederationsListFederationsRequestListFederationsResponse

Top

proto/cofidectl/provision_plugin/v1alpha2/plugin.proto

Section titled “proto/cofidectl/provision_plugin/v1alpha2/plugin.proto”

FieldTypeLabelDescription
data_sourceuint32optional
kube_cfg_filestringoptional
trust_zone_idsstringrepeated

FieldTypeLabelDescription
statusStatusoptional

FieldTypeLabelDescription
data_sourceuint32optional
cluster_idstringoptional

FieldTypeLabelDescription
helm_valuesgoogle.protobuf.Structoptional

FieldTypeLabelDescription
stagestringoptional
messagestringoptional
donebooloptional
errorstringoptional

FieldTypeLabelDescription
data_sourceuint32optional
kube_cfg_filestringoptional
trust_zone_idsstringrepeated

FieldTypeLabelDescription
statusStatusoptional

Method NameRequest TypeResponse TypeDescription
ValidateValidateRequestValidateResponse
DeployDeployRequestDeployResponse stream
TearDownTearDownRequestTearDownResponse stream
GetHelmValuesGetHelmValuesRequestGetHelmValuesResponse

Top

proto/cofidectl_plugin/v1alpha1/plugin.proto

Section titled “proto/cofidectl_plugin/v1alpha1/plugin.proto”

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federationoptional

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federationoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
namestringoptional
trust_zonestringoptional

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federationoptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicy

FieldTypeLabelDescription
namestringoptional
trust_zonestringoptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
filterListAPBindingsRequest.Filteroptional

FieldTypeLabelDescription
trust_zone_namestringoptional
policy_namestringoptional

FieldTypeLabelDescription
bindingsproto.ap_binding.v1alpha1.APBindingrepeated

FieldTypeLabelDescription
policiesproto.attestation_policy.v1alpha1.AttestationPolicyrepeated

FieldTypeLabelDescription
trust_zonestringoptional

FieldTypeLabelDescription
clustersproto.cluster.v1alpha1.Clusterrepeated

FieldTypeLabelDescription
trust_zone_namestringoptional

FieldTypeLabelDescription
federationsproto.federation.v1alpha1.Federationrepeated

FieldTypeLabelDescription
federationsproto.federation.v1alpha1.Federationrepeated

FieldTypeLabelDescription
trust_zonesproto.trust_zone.v1alpha1.TrustZonerepeated

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

Method NameRequest TypeResponse TypeDescription
ValidateValidateRequestValidateResponse
AddTrustZoneAddTrustZoneRequestAddTrustZoneResponse
DestroyTrustZoneDestroyTrustZoneRequestDestroyTrustZoneResponse
GetTrustZoneGetTrustZoneRequestGetTrustZoneResponse
ListTrustZonesListTrustZonesRequestListTrustZonesResponse
UpdateTrustZoneUpdateTrustZoneRequestUpdateTrustZoneResponse
AddClusterAddClusterRequestAddClusterResponse
DestroyClusterDestroyClusterRequestDestroyClusterResponse
GetClusterGetClusterRequestGetClusterResponse
ListClustersListClustersRequestListClustersResponse
UpdateClusterUpdateClusterRequestUpdateClusterResponse
AddAttestationPolicyAddAttestationPolicyRequestAddAttestationPolicyResponse
DestroyAttestationPolicyDestroyAttestationPolicyRequestDestroyAttestationPolicyResponse
GetAttestationPolicyGetAttestationPolicyRequestGetAttestationPolicyResponse
ListAttestationPoliciesListAttestationPoliciesRequestListAttestationPoliciesResponse
AddAPBindingAddAPBindingRequestAddAPBindingResponse
DestroyAPBindingDestroyAPBindingRequestDestroyAPBindingResponse
ListAPBindingsListAPBindingsRequestListAPBindingsResponse
AddFederationAddFederationRequestAddFederationResponse
DestroyFederationDestroyFederationRequestDestroyFederationResponse
ListFederationsListFederationsRequestListFederationsResponse
ListFederationsByTrustZoneListFederationsByTrustZoneRequestListFederationsByTrustZoneResponse

Top

FieldTypeLabelDescription
data_sourcestringoptional
provisionstringoptional

Top

FieldTypeLabelDescription
trust_zonesproto.trust_zone.v1alpha1.TrustZonerepeated
clustersproto.cluster.v1alpha1.Clusterrepeated
attestation_policiesproto.attestation_policy.v1alpha1.AttestationPolicyrepeated
plugin_configConfig.PluginConfigEntryrepeated
pluginsproto.plugins.v1alpha1.Pluginsoptional
federationsproto.federation.v1alpha1.Federationrepeated
ap_bindingsproto.ap_binding.v1alpha1.APBindingrepeated

FieldTypeLabelDescription
keystring
valuegoogle.protobuf.Struct

Top

proto/federated_service/v1alpha1/federated_service.proto

Section titled “proto/federated_service/v1alpha1/federated_service.proto”

FieldTypeLabelDescription
idstring
namestring
namespacestring
cluster_namestring
trust_domainstring
workload_labelsFederatedService.WorkloadLabelsEntryrepeated
exported_trust_domainsstringrepeated
portuint32
gateway_entriesGatewayEntryrepeated
gateway_specsGatewaySpecrepeated
tls_modeTLSMode

FieldTypeLabelDescription
keystring
valuestring

FieldTypeLabelDescription
hostnamestring
typestring
ipstring
portint32

FieldTypeLabelDescription
hostnamestring
typestring
ipstring
portint32

NameNumberDescription
TLS_MODE_UNSPECIFIED0
TLS_MODE_MTLS1
TLS_MODE_ISTIO_MTLS2

Top

proto/connect/agent_service/v1alpha1/agent_service.proto

Section titled “proto/connect/agent_service/v1alpha1/agent_service.proto”

FieldTypeLabelDescription
trust_zone_idstringoptional
cluster_idstringoptional

FieldTypeLabelDescription
agent_tokenstringoptional

FieldTypeLabelDescription
service_idstring

FieldTypeLabelDescription
service_idstring

FieldTypeLabelDescription
service_idstring

FieldTypeLabelDescription
serviceproto.federated_service.v1alpha1.FederatedService

FieldTypeLabelDescription
org_idstring

FieldTypeLabelDescription
servicesproto.federated_service.v1alpha1.FederatedServicerepeated

FieldTypeLabelDescription
serviceproto.federated_service.v1alpha1.FederatedService

FieldTypeLabelDescription
service_idstring

FieldTypeLabelDescription
statusproto.agent.v1alpha1.AgentStatus

FieldTypeLabelDescription
serviceproto.federated_service.v1alpha1.FederatedService

FieldTypeLabelDescription
service_idstring

Method NameRequest TypeResponse TypeDescription
CreateAgentJoinTokenCreateAgentJoinTokenRequestCreateAgentJoinTokenResponse
UpdateAgentStatusUpdateAgentStatusRequestUpdateAgentStatusResponse
RegisterFederatedServiceRegisterFederatedServiceRequestRegisterFederatedServiceResponse
DeregisterFederatedServiceDeregisterFederatedServiceRequestDeregisterFederatedServiceResponse
UpdateFederatedServiceUpdateFederatedServiceRequestUpdateFederatedServiceResponse
GetFederatedServiceGetFederatedServiceRequestGetFederatedServiceResponse
ListFederatedServicesListFederatedServicesRequestListFederatedServicesResponse

Top

proto/connect/ap_binding_service/v1alpha1/ap_binding_service.proto

Section titled “proto/connect/ap_binding_service/v1alpha1/ap_binding_service.proto”

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
binding_idstringoptional

FieldTypeLabelDescription
binding_idstringoptional

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
filterListAPBindingsRequest.Filteroptional

FieldTypeLabelDescription
org_idstringoptional
trust_zone_idstringoptional
policy_idstringoptional

FieldTypeLabelDescription
bindingsproto.ap_binding.v1alpha1.APBindingrepeated

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

FieldTypeLabelDescription
bindingproto.ap_binding.v1alpha1.APBindingoptional

Method NameRequest TypeResponse TypeDescription
CreateAPBindingCreateAPBindingRequestCreateAPBindingResponse
DestroyAPBindingDestroyAPBindingRequestDestroyAPBindingResponse
GetAPBindingGetAPBindingRequestGetAPBindingResponse
ListAPBindingsListAPBindingsRequestListAPBindingsResponse
UpdateAPBindingUpdateAPBindingRequestUpdateAPBindingResponse

Top

proto/connect/attestation_policy_service/v1alpha1/attestation_policy_service.proto

Section titled “proto/connect/attestation_policy_service/v1alpha1/attestation_policy_service.proto”

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
policy_idstringoptional

FieldTypeLabelDescription
policy_idstringoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
filterListAttestationPoliciesRequest.Filteroptional

FieldTypeLabelDescription
namestringoptional
org_idstringoptional
trust_zone_idstringoptional
kindAttestationPolicyKindoptional
tpm_nodeListAttestationPoliciesRequest.TPMNodeFilteroptional

ListAttestationPoliciesRequest.TPMNodeFilter

Section titled “ListAttestationPoliciesRequest.TPMNodeFilter”
FieldTypeLabelDescription
ek_hashstringoptional

FieldTypeLabelDescription
policiesproto.attestation_policy.v1alpha1.AttestationPolicyrepeated

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

FieldTypeLabelDescription
policyproto.attestation_policy.v1alpha1.AttestationPolicyoptional

NameNumberDescription
ATTESTATION_POLICY_KIND_UNSPECIFIED0
ATTESTATION_POLICY_KIND_KUBERNETES1
ATTESTATION_POLICY_KIND_STATIC2
ATTESTATION_POLICY_KIND_TPM_NODE3

Method NameRequest TypeResponse TypeDescription
CreateAttestationPolicyCreateAttestationPolicyRequestCreateAttestationPolicyResponse
DestroyAttestationPolicyDestroyAttestationPolicyRequestDestroyAttestationPolicyResponse
GetAttestationPolicyGetAttestationPolicyRequestGetAttestationPolicyResponse
ListAttestationPoliciesListAttestationPoliciesRequestListAttestationPoliciesResponse
UpdateAttestationPolicyUpdateAttestationPolicyRequestUpdateAttestationPolicyResponse

Top

proto/connect/cluster_service/v1alpha1/cluster_service.proto

Section titled “proto/connect/cluster_service/v1alpha1/cluster_service.proto”

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
cluster_idstringoptional

FieldTypeLabelDescription
cluster_idstringoptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
filterListClustersRequest.Filteroptional

FieldTypeLabelDescription
namestringoptional
org_idstringoptional
trust_zone_idstringoptional

FieldTypeLabelDescription
clustersproto.cluster.v1alpha1.Clusterrepeated

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

FieldTypeLabelDescription
clusterproto.cluster.v1alpha1.Clusteroptional

Method NameRequest TypeResponse TypeDescription
CreateClusterCreateClusterRequestCreateClusterResponse
DestroyClusterDestroyClusterRequestDestroyClusterResponse
GetClusterGetClusterRequestGetClusterResponse
ListClustersListClustersRequestListClustersResponse
UpdateClusterUpdateClusterRequestUpdateClusterResponse

Top

proto/connect/datastore_service/v1alpha1/datastore.proto

Section titled “proto/connect/datastore_service/v1alpha1/datastore.proto”

Represents an attested SPIRE agent

FieldTypeLabelDescription
org_idstringOrganisation ID
trust_zone_idstringTrust zone ID
spiffe_idstringNode SPIFFE ID
attestation_data_typestringAttestation data type
cert_serial_numberstringNode certificate serial number
cert_not_afterint64Node certificate not_after (seconds since unix epoch)
new_cert_serial_numberstringNode certificate serial number
new_cert_not_afterint64Node certificate not_after (seconds since unix epoch)
selectorsSelectorrepeatedNode selectors
can_reattestboolCanReattest field (can the attestation safely be deleted and recreated automatically)

A type which describes the conditions under which a registration entry is matched.

FieldTypeLabelDescription
typestringA selector type represents the type of attestation used in attesting the entity (Eg: AWS, K8).
valuestringThe value to be attested.

Represents a type with a list of Selector.

FieldTypeLabelDescription
entriesSelectorrepeatedA list of Selector.

Top

proto/connect/datastore_service/v1alpha1/datastore_service.proto

Section titled “proto/connect/datastore_service/v1alpha1/datastore_service.proto”

FieldTypeLabelDescription
attestation_data_typebool
cert_serial_numberbool
cert_not_afterbool
new_cert_serial_numberbool
new_cert_not_afterbool
can_reattestbool

Node operations request/response messages

FieldTypeLabelDescription
trust_zone_idstringoptional

FieldTypeLabelDescription
countint32

FieldTypeLabelDescription
nodeAttestedNode
trust_zone_idstringoptional

FieldTypeLabelDescription
nodeAttestedNode

FieldTypeLabelDescription
spiffe_idstring
trust_zone_idstringoptional

FieldTypeLabelDescription
nodeAttestedNodeoptional

FieldTypeLabelDescription
spiffe_idstring
trust_zone_idstringoptional

FieldTypeLabelDescription
nodeAttestedNodeoptional

Node Selector operations request/response messages

FieldTypeLabelDescription
spiffe_idstring
trust_zone_idstringoptional

FieldTypeLabelDescription
spiffe_idstring
selectorsSelectorrepeated

FieldTypeLabelDescription
by_attestation_typestringoptionalFilters nodes by attestation type
by_bannedbooloptionalFilters nodes by banned status
by_expires_beforeint64optionalFilters nodes that expire before the specified timestamp
by_selector_matchListAttestedNodesRequest.BySelectorsoptional
fetch_selectorsbooloptionalWhether to fetch selectors with nodes
by_can_reattestbooloptionalFilters nodes by ability to re-attest
trust_zone_idstringoptional

Filters nodes by selectors

FieldTypeLabelDescription
selectorsSelectorrepeated
matchListAttestedNodesRequest.MatchBehavior

FieldTypeLabelDescription
nodesAttestedNoderepeated

FieldTypeLabelDescription
valid_atint64optional
trust_zone_idstringoptional

FieldTypeLabelDescription
selectorsListNodeSelectorsResponse.SelectorsEntryrepeated

FieldTypeLabelDescription
selectorsSelectorrepeated

FieldTypeLabelDescription
keystring
valueListNodeSelectorsResponse.NodeSelectors

FieldTypeLabelDescription
trust_zone_idstring
expired_beforegoogle.protobuf.Timestamp
include_non_reattestablebool

FieldTypeLabelDescription
spiffe_idstring
selectorsSelectorrepeated
trust_zone_idstringoptional

FieldTypeLabelDescription
nodeAttestedNode
maskAttestedNodeMask
trust_zone_idstringoptional

FieldTypeLabelDescription
nodeAttestedNodeoptional

NameNumberDescription
MATCH_BEHAVIOR_EXACT_UNSPECIFIED0
MATCH_BEHAVIOR_SUBSET1
MATCH_BEHAVIOR_SUPERSET2
MATCH_BEHAVIOR_MATCH_ANY3

DataStoreService defines the gRPC service for the SPIRE server DataStore interface

Method NameRequest TypeResponse TypeDescription
CountAttestedNodesCountAttestedNodesRequestCountAttestedNodesResponseNode operations
CreateAttestedNodeCreateAttestedNodeRequestCreateAttestedNodeResponse
DeleteAttestedNodeDeleteAttestedNodeRequestDeleteAttestedNodeResponse
FetchAttestedNodeFetchAttestedNodeRequestFetchAttestedNodeResponse
UpdateAttestedNodeUpdateAttestedNodeRequestUpdateAttestedNodeResponse
ListAttestedNodesListAttestedNodesRequestListAttestedNodesResponse
PruneAttestedExpiredNodesPruneAttestedExpiredNodesRequestPruneAttestedExpiredNodesResponse
GetNodeSelectorsGetNodeSelectorsRequestGetNodeSelectorsResponseNode Selector operations
SetNodeSelectorsSetNodeSelectorsRequestSetNodeSelectorsResponse
ListNodeSelectorsListNodeSelectorsRequestListNodeSelectorsResponse

Top

proto/exchange_policy/v1alpha1/exchange_policy.proto

Section titled “proto/exchange_policy/v1alpha1/exchange_policy.proto”

ExchangePolicy defines a rule for permitting or denying Credex token exchanges within a trust zone

FieldTypeLabelDescription
idstringThe unique ID of the exchange policy. Generated by the server.
org_idstringOrganization to which the exchange policy belongs. Derived from the trust zone by the API service.
namestring
trust_zone_idstringTrust zone to which this policy applies. Immutable after creation.
actionExchangePolicyActionoptionalAction to take when all conditions match. Defaults to ALLOW when unset.
subject_identityStringSetMatch conditions on the inbound subject token
subject_issuerStringSet
actor_identityStringSetMatch conditions on the optional inbound actor
actor_issuerStringSet
client_idStringSetMatch condition on the OAuth client_id presenting the exchange request
target_audienceStringSetMatch condition on the requested target audience
outbound_scopesstringrepeatedOutbound scopes to grant. Only relevant when action is ALLOW.

FieldTypeLabelDescription
exactstringExact string equality.
globstringGlob pattern (e.g. spiffe://trust.domain/ns//sa/).

StringSet holds a collection of StringMatchers evaluated with OR semantics.

FieldTypeLabelDescription
matchersStringMatcherrepeated

NameNumberDescription
EXCHANGE_POLICY_ACTION_UNSPECIFIED0treated as ALLOW
EXCHANGE_POLICY_ACTION_ALLOW1
EXCHANGE_POLICY_ACTION_DENY2

Top

proto/connect/exchange_policy_service/v1alpha1/exchange_policy_service.proto

Section titled “proto/connect/exchange_policy_service/v1alpha1/exchange_policy_service.proto”

FieldTypeLabelDescription
exchange_policyproto.exchange_policy.v1alpha1.ExchangePolicy

FieldTypeLabelDescription
exchange_policyproto.exchange_policy.v1alpha1.ExchangePolicy

FieldTypeLabelDescription
exchange_policy_idstring

FieldTypeLabelDescription
exchange_policy_idstring

FieldTypeLabelDescription
exchange_policyproto.exchange_policy.v1alpha1.ExchangePolicyoptional

FieldTypeLabelDescription
filterListExchangePoliciesRequest.Filter

FieldTypeLabelDescription
namestring
org_idstring
trust_zone_idstring

FieldTypeLabelDescription
exchange_policiesproto.exchange_policy.v1alpha1.ExchangePolicyrepeated

FieldTypeLabelDescription
exchange_policyproto.exchange_policy.v1alpha1.ExchangePolicy
update_maskUpdateExchangePolicyRequest.UpdateMaskoptionalThe list of fields to be updated. If not provided a full replacement will be made.

FieldTypeLabelDescription
nameboolSet to true to update the name field.
actionboolSet to true to update the action field.
subject_identityboolSet to true to update the subject_identity field.
subject_issuerboolSet to true to update the subject_issuer field.
actor_identityboolSet to true to update the actor_identity field.
actor_issuerboolSet to true to update the actor_issuer field.
client_idboolSet to true to update the client_id field.
target_audienceboolSet to true to update the target_audience field.
outbound_scopesboolSet to true to update the outbound_scopes field.

FieldTypeLabelDescription
exchange_policyproto.exchange_policy.v1alpha1.ExchangePolicy

Method NameRequest TypeResponse TypeDescription
CreateExchangePolicyCreateExchangePolicyRequestCreateExchangePolicyResponse
DestroyExchangePolicyDestroyExchangePolicyRequestDestroyExchangePolicyResponse
GetExchangePolicyGetExchangePolicyRequestGetExchangePolicyResponse
ListExchangePoliciesListExchangePoliciesRequestListExchangePoliciesResponse
UpdateExchangePolicyUpdateExchangePolicyRequestUpdateExchangePolicyResponse

Top

proto/connect/federation_service/v1alpha1/federation_service.proto

Section titled “proto/connect/federation_service/v1alpha1/federation_service.proto”

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federation

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federation

FieldTypeLabelDescription
federation_idstringoptional

FieldTypeLabelDescription
federation_idstring

FieldTypeLabelDescription
federationproto.federation.v1alpha1.Federation

FieldTypeLabelDescription
filterListFederationsRequest.Filteroptional

FieldTypeLabelDescription
org_idstringoptional
trust_zone_idstringoptional
remote_trust_zone_idstringoptional

FieldTypeLabelDescription
federationsproto.federation.v1alpha1.Federationrepeated

Method NameRequest TypeResponse TypeDescription
CreateFederationCreateFederationRequestCreateFederationResponse
DestroyFederationDestroyFederationRequestDestroyFederationResponse
ListFederationsListFederationsRequestListFederationsResponse
GetFederationGetFederationRequestGetFederationResponse

Top

FieldTypeLabelDescription
idstring
org_idstring
trust_zone_idstring
cluster_idstring
attestation_policy_idstring
ap_binding_idstring
workload_idstring
spiffe_idstring
parent_idstring
selectorsSelectorrepeated
dns_namesstringrepeated
federationsIdentityFederationrepeated
created_atgoogle.protobuf.Timestamp

FieldTypeLabelDescription
trust_zone_idstring
trust_domainstring

FieldTypeLabelDescription
typestring
valuestring

Top

proto/connect/identity_service/v1alpha1/identity_service.proto

Section titled “proto/connect/identity_service/v1alpha1/identity_service.proto”

FieldTypeLabelDescription
identity_idstring

FieldTypeLabelDescription
identityproto.identity.v1alpha1.Identity

FieldTypeLabelDescription
filterListIdentitiesRequest.Filteroptional

FieldTypeLabelDescription
org_idstringoptional
trust_zone_idstringoptional
cluster_idstringoptional
attestation_policy_idstringoptional
ap_binding_idstringoptional
workload_idstringoptional
spiffe_idstringoptional

FieldTypeLabelDescription
identitiesproto.identity.v1alpha1.Identityrepeated

Method NameRequest TypeResponse TypeDescription
GetIdentityGetIdentityRequestGetIdentityResponse
ListIdentitiesListIdentitiesRequestListIdentitiesResponse

Top

proto/organization/v1alpha1/organization.proto

Section titled “proto/organization/v1alpha1/organization.proto”

FieldTypeLabelDescription
idstring
namestring

Top

proto/connect/organization_service/v1alpha1/organization_service.proto

Section titled “proto/connect/organization_service/v1alpha1/organization_service.proto”

FieldTypeLabelDescription
org_idstringoptional

FieldTypeLabelDescription
organizationproto.organization.v1alpha1.Organizationoptional

FieldTypeLabelDescription
filterListOrganizationsRequest.Filteroptional

FieldTypeLabelDescription
namestringoptional

FieldTypeLabelDescription
organizationsproto.organization.v1alpha1.Organizationrepeated

Method NameRequest TypeResponse TypeDescription
GetOrganizationGetOrganizationRequestGetOrganizationResponse
ListOrganizationsListOrganizationsRequestListOrganizationsResponse

Top

proto/role_binding/v1alpha1/role_binding.proto

Section titled “proto/role_binding/v1alpha1/role_binding.proto”

FieldTypeLabelDescription
claim_valuestringFor users this is matched against the list of values in the “groups” claim of the JWT presented by a user.

FieldTypeLabelDescription
typestringtype can be one of the following: AttestationPolicyBinding AttestationPolicy Cluster FederatedService Federation Organization System TrustZone
idstring

FieldTypeLabelDescription
idstring
role_idstring
userUser
groupGroup
resourceResource

FieldTypeLabelDescription
subjectstringThis is matched against the “sub” claim of the JWT presented by a user.

Top

proto/connect/role_binding_service/v1alpha1/role_binding_service.proto

Section titled “proto/connect/role_binding_service/v1alpha1/role_binding_service.proto”

FieldTypeLabelDescription
role_bindingproto.role_binding.v1alpha1.RoleBinding

FieldTypeLabelDescription
role_bindingproto.role_binding.v1alpha1.RoleBinding

FieldTypeLabelDescription
role_binding_idstring

FieldTypeLabelDescription
role_binding_idstring

FieldTypeLabelDescription
role_bindingproto.role_binding.v1alpha1.RoleBindingoptional

FieldTypeLabelDescription
filterListRoleBindingsRequest.Filteroptional

FieldTypeLabelDescription
role_idstringoptional
user_subjectstringoptional
group_claim_valuestringoptional
resource_typestringoptional
resource_idstringoptional

FieldTypeLabelDescription
role_bindingsproto.role_binding.v1alpha1.RoleBindingrepeated

FieldTypeLabelDescription
role_bindingproto.role_binding.v1alpha1.RoleBinding

FieldTypeLabelDescription
role_bindingproto.role_binding.v1alpha1.RoleBinding

Method NameRequest TypeResponse TypeDescription
CreateRoleBindingCreateRoleBindingRequestCreateRoleBindingResponse
DestroyRoleBindingDestroyRoleBindingRequestDestroyRoleBindingResponse
GetRoleBindingGetRoleBindingRequestGetRoleBindingResponse
ListRoleBindingsListRoleBindingsRequestListRoleBindingsResponse
UpdateRoleBindingUpdateRoleBindingRequestUpdateRoleBindingResponse

Top

proto/trust_zone_server/v1alpha1/trust_zone_server.proto

Section titled “proto/trust_zone_server/v1alpha1/trust_zone_server.proto”

FieldTypeLabelDescription
audiencesstringrepeatedAudiences that can be presented by SPIRE agents in remote clusters to perform node attestation when this server is using the k8s psat plugin with the Connect datasource. At least 1 must be provided if there are remote clusters in the trust zone.
spire_server_spiffe_id_pathstringPath to use for the SPIFFE ID in the JWT presented by the SPIRE server to the cluster’s API server when this server is using the k8s psat plugin with the Connect datasource. This must be configured to be an allowed subject in the remote cluster’s API server.

TrustZoneServer defines how the server managing a trust zone should be deployed.

FieldTypeLabelDescription
idstringThe unique ID of the server. Generated by the server.
trust_zone_idstringTrust Zone managed by this server. Immutable after creation.
cluster_idstringCluster in which the server should be deployed. Immutable after creation.
kubernetes_namespacestringKubernetes namespace in which the server should be deployed. If not provided the API service should set this.
kubernetes_service_accountstringName of kubernetes service account to deploy with the server. If not provided the API service should set this.
org_idstringOrganization to which the server belongs. Derived from the trust zone by the API service.
helm_valuesgoogle.protobuf.StructHelm values to configure the server install with.
statusTrustZoneServer.StatusCurrent status of the trust zone server
created_atgoogle.protobuf.TimestampTime of resource creation by user.
last_updated_atgoogle.protobuf.TimestampTimes of last resource update by user.
deleted_atgoogle.protobuf.TimestampTime of resource deletion by user.
connect_k8s_psat_configConnectK8sPsatConfigConfiguration for the k8s psat node attestor plugin when using a Connect datasource with remote clusters.

FieldTypeLabelDescription
statusTrustZoneServerStatusLast reported status of the trust zone server.
last_transition_timegoogle.protobuf.TimestampWhen the status of the trust zone server last changed.

Status of a trust zone server

NameNumberDescription
TRUST_ZONE_SERVER_STATUS_UNSPECIFIED0
TRUST_ZONE_SERVER_STATUS_PROVISIONING1Provisioning / Deleting statuses are only applicable for managed trust zone servers
TRUST_ZONE_SERVER_STATUS_PROVISIONED2
TRUST_ZONE_SERVER_STATUS_PROVISIONING_ERROR3
TRUST_ZONE_SERVER_STATUS_DELETING4
TRUST_ZONE_SERVER_STATUS_DELETED5
TRUST_ZONE_SERVER_STATUS_DELETING_ERROR6

Top

proto/connect/trust_zone_server_service/v1alpha1/trust_zone_server_service.proto

Section titled “proto/connect/trust_zone_server_service/v1alpha1/trust_zone_server_service.proto”

FieldTypeLabelDescription
trust_zone_serverproto.trust_zone_server.v1alpha1.TrustZoneServer

FieldTypeLabelDescription
trust_zone_serverproto.trust_zone_server.v1alpha1.TrustZoneServer

FieldTypeLabelDescription
trust_zone_server_idstring

FieldTypeLabelDescription
trust_zone_server_idstring

FieldTypeLabelDescription
trust_zone_serverproto.trust_zone_server.v1alpha1.TrustZoneServeroptional

FieldTypeLabelDescription
filterListTrustZoneServersRequest.Filter

FieldTypeLabelDescription
trust_zone_idstring
cluster_idstring
org_idstring

FieldTypeLabelDescription
trust_zone_serversproto.trust_zone_server.v1alpha1.TrustZoneServerrepeated

FieldTypeLabelDescription
trust_zone_serverproto.trust_zone_server.v1alpha1.TrustZoneServer
update_maskUpdateTrustZoneServerRequest.UpdateMaskoptionalThe list of fields to be updated. If not provided a full replacement will be made.

FieldTypeLabelDescription
helm_valuesboolSet to true to update helm values of trust zone server to those provided.

FieldTypeLabelDescription
trust_zone_serverproto.trust_zone_server.v1alpha1.TrustZoneServer

FieldTypeLabelDescription
trust_zone_server_idstring
statusproto.trust_zone_server.v1alpha1.TrustZoneServerStatus

TrustZoneServerService manages TrustZoneServers.

Method NameRequest TypeResponse TypeDescription
CreateTrustZoneServerCreateTrustZoneServerRequestCreateTrustZoneServerResponseCreate a TrustZoneServer for the given trust zone in the specified cluster. In the submitted resource the ID should not be set and will be generated by the server API.
DestroyTrustZoneServerDestroyTrustZoneServerRequestDestroyTrustZoneServerResponseDestroy a TrustZoneServer. For managed TrustZoneServers this should soft delete the API resource until the managed server is deprovisioned.
GetTrustZoneServerGetTrustZoneServerRequestGetTrustZoneServerResponseGet a TrustZoneServer by ID.
ListTrustZoneServersListTrustZoneServersRequestListTrustZoneServersResponseList TrustZoneServers.
UpdateTrustZoneServerUpdateTrustZoneServerRequestUpdateTrustZoneServerResponseUpdate a TrustZoneServer. Server implementations may prevent some fields from being updated.
UpdateTrustZoneServerStatusUpdateTrustZoneServerStatusRequestUpdateTrustZoneServerStatusResponseUpdate the status of a trust zone server.

Top

proto/connect/trust_zone_service/v1alpha1/trust_zone_service.proto

Section titled “proto/connect/trust_zone_service/v1alpha1/trust_zone_service.proto”

FieldTypeLabelDescription
agent_idstring
cluster_idstring
trust_zone_idstring

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZone

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZone

FieldTypeLabelDescription
trust_zone_idstringoptional

FieldTypeLabelDescription
trust_zone_idstringoptional

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZoneoptional

FieldTypeLabelDescription
filterListTrustZonesRequest.Filteroptional

FieldTypeLabelDescription
namestringoptional
org_idstringoptional
trust_domainstringoptional

FieldTypeLabelDescription
trust_zonesproto.trust_zone.v1alpha1.TrustZonerepeated

FieldTypeLabelDescription
agentAgent
agent_tokenstring
bundlespire.api.types.Bundle

FieldTypeLabelDescription
agent_idstring

FieldTypeLabelDescription
trust_zone_serverTrustZoneServerTo be deprecated, registration of a trust zone server by just specifying the cluster ID Consumers should provide a trust zone server ID instead
bundlespire.api.types.Bundle
trust_zone_server_idstring

Empty for the moment

FieldTypeLabelDescription
cluster_idstring

FieldTypeLabelDescription
bundlespire.api.types.Bundle
trust_zone_idstring

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZone

FieldTypeLabelDescription
trust_zoneproto.trust_zone.v1alpha1.TrustZone

Method NameRequest TypeResponse TypeDescription
CreateTrustZoneCreateTrustZoneRequestCreateTrustZoneResponse
DestroyTrustZoneDestroyTrustZoneRequestDestroyTrustZoneResponse
GetTrustZoneGetTrustZoneRequestGetTrustZoneResponse
ListTrustZonesListTrustZonesRequestListTrustZonesResponse
UpdateTrustZoneUpdateTrustZoneRequestUpdateTrustZoneResponse
RegisterAgentRegisterAgentRequestRegisterAgentResponse
RegisterTrustZoneServerRegisterTrustZoneServerRequestRegisterTrustZoneServerResponse
UpdateTrustZoneBundleUpdateTrustZoneBundleRequestUpdateTrustZoneBundleResponse

Top

FieldTypeLabelDescription
namestring
imagestring

FieldTypeLabelDescription
uidstring
namestring
namespacestring
labelsKubernetesMetadata.LabelsEntryrepeated
annotationsKubernetesMetadata.AnnotationsEntryrepeated
creation_timestampgoogle.protobuf.Timestamp

FieldTypeLabelDescription
keystring
valuestring

FieldTypeLabelDescription
keystring
valuestring

FieldTypeLabelDescription
metadataKubernetesMetadata
service_account_namestring
node_namestring
node_uidstring
containersKubernetesContainerrepeated
start_timegoogle.protobuf.Timestamp

FieldTypeLabelDescription
type_urlstring
valuegoogle.protobuf.Value

FieldTypeLabelDescription
idstring
org_idstring
trust_zone_idstring
cluster_idstring
typeWorkloadType
kubernetes_podKubernetesPod
observationsObservationrepeated
observed_timestampgoogle.protobuf.Timestamp
deletedbool

NameNumberDescription
WORKLOAD_TYPE_UNSPECIFIED0
WORKLOAD_TYPE_KUBERNETES_POD1

Top

proto/connect/workload_service/v1alpha1/workload_service.proto

Section titled “proto/connect/workload_service/v1alpha1/workload_service.proto”

FieldTypeLabelDescription
filterListWorkloadsRequest.Filteroptional

FieldTypeLabelDescription
org_idstringoptional
trust_zone_idstringoptional
cluster_idstringoptional
max_agegoogle.protobuf.Durationoptionalmax_age filters workloads to those last observed within this duration.

FieldTypeLabelDescription
workloadsproto.workload.v1alpha1.Workloadrepeated

FieldTypeLabelDescription
workloadsproto.workload.v1alpha1.Workloadrepeated

Method NameRequest TypeResponse TypeDescription
ListWorkloadsListWorkloadsRequestListWorkloadsResponse
PublishWorkloadsPublishWorkloadsRequest streamPublishWorkloadsResponse

Top

proto/provision_plugin/v1alpha1/plugin.proto

Section titled “proto/provision_plugin/v1alpha1/plugin.proto”

FieldTypeLabelDescription
data_sourceuint32optional
kube_cfg_filestringoptional
trust_zone_namesstringrepeated

FieldTypeLabelDescription
statusStatusoptional

FieldTypeLabelDescription
data_sourceuint32optional
trust_zone_namestringoptional
cluster_namestringoptional

FieldTypeLabelDescription
helm_valuesgoogle.protobuf.Structoptional

FieldTypeLabelDescription
stagestringoptional
messagestringoptional
donebooloptional
errorstringoptional

FieldTypeLabelDescription
data_sourceuint32optional
kube_cfg_filestringoptional
trust_zone_namesstringrepeated

FieldTypeLabelDescription
statusStatusoptional

Method NameRequest TypeResponse TypeDescription
ValidateValidateRequestValidateResponse
DeployDeployRequestDeployResponse stream
TearDownTearDownRequestTearDownResponse stream
GetHelmValuesGetHelmValuesRequestGetHelmValuesResponse
.proto TypeNotesC++JavaPythonGoC#PHPRuby
doubledoubledoublefloatfloat64doublefloatFloat
floatfloatfloatfloatfloat32floatfloatFloat
int32Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.int32intintint32intintegerBignum or Fixnum (as required)
int64Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.int64longint/longint64longinteger/stringBignum
uint32Uses variable-length encoding.uint32intint/longuint32uintintegerBignum or Fixnum (as required)
uint64Uses variable-length encoding.uint64longint/longuint64ulonginteger/stringBignum or Fixnum (as required)
sint32Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.int32intintint32intintegerBignum or Fixnum (as required)
sint64Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.int64longint/longint64longinteger/stringBignum
fixed32Always four bytes. More efficient than uint32 if values are often greater than 2^28.uint32intintuint32uintintegerBignum or Fixnum (as required)
fixed64Always eight bytes. More efficient than uint64 if values are often greater than 2^56.uint64longint/longuint64ulonginteger/stringBignum
sfixed32Always four bytes.int32intintint32intintegerBignum or Fixnum (as required)
sfixed64Always eight bytes.int64longint/longint64longinteger/stringBignum
boolboolbooleanbooleanboolboolbooleanTrueClass/FalseClass
stringA string must always contain UTF-8 encoded or 7-bit ASCII text.stringStringstr/unicodestringstringstringString (UTF-8)
bytesMay contain any arbitrary sequence of bytes.stringByteStringstr[]byteByteStringstringString (ASCII-8BIT)