Files

741 lines
31 KiB
Protocol Buffer

syntax = "proto3";
package pb;
option go_package = "github.com/effective-security/trustyca/api/pb";
import "es/api/annotations.proto";
import "google/protobuf/empty.proto";
import "types.proto";
import "pkix.proto";
// CA is the Certification Authority service of the tenants: the users and
// the API keys of an org, on the wfe listener. Every request is scoped by
// the org of the caller's token and an optional ProjectID; the requests
// carry no OrgID. The service holds no issuer key: it forwards every call
// to privpb.Backend with the org of the token (DESIGN.md section 2.1),
// which is also the API of the service identities (the RA, the operator).
// Methods declare the roles and the API key scopes they require.
service CA {
//
// Issuers
//
// RegisterIssuer creates a new issuing authority for the tenant.
// The private key is generated in the configured crypto provider and
// never leaves it. The certificate is signed by the parent issuer,
// self-signed for Root type, or, when no parent is available, the issuer
// is created in Pending status with a CSR to be signed externally.
rpc RegisterIssuer(RegisterIssuerRequest) returns (Issuer) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
// UpdateIssuer updates the runtime configuration or status of an issuer.
// Status transitions: Active -> Archived -> Destroyed.
rpc UpdateIssuer(UpdateIssuerRequest) returns (Issuer) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
// ImportIssuer registers an issuer from an existing certificate and key.
// The key is either referenced by a crypto provider URI or provided as
// PEM and stored protected. Used for bring-your-own-CA.
rpc ImportIssuer(ImportIssuerRequest) returns (Issuer) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
// ActivateIssuer sets the externally signed certificate for a Pending
// issuer and activates it.
rpc ActivateIssuer(ActivateIssuerRequest) returns (Issuer) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
// GetIssuer returns the issuer by ID, label or IKID
rpc GetIssuer(GetIssuerRequest) returns (Issuer) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "ca:read";
}
// ListIssuers returns the tenant's issuers
rpc ListIssuers(ListIssuersRequest) returns (IssuersResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "ca:read";
}
//
// Root certificates (trust anchors)
//
// RegisterRoot registers an external trust anchor for the tenant.
// Roots created via RegisterIssuer are registered automatically.
rpc RegisterRoot(RegisterRootRequest) returns (RootCertificate) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
// ListRoots returns the tenant's trust anchors
rpc ListRoots(ListRootsRequest) returns (RootsResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "ca:read";
}
//
// Certificate profiles
//
// RegisterProfile creates or replaces a certificate profile, keyed by
// (org, ProjectID, Label)
rpc RegisterProfile(RegisterProfileRequest) returns (CertProfile) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
// GetProfile returns the profile by ID or label
rpc GetProfile(GetProfileRequest) returns (CertProfile) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "ca:read";
}
// ListProfiles returns the tenant's profiles
rpc ListProfiles(ListProfilesRequest) returns (ProfilesResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "ca:read";
}
// DeleteProfile deletes a profile
rpc DeleteProfile(DeleteProfileRequest) returns (google.protobuf.Empty) {
option (es.api.allowed_roles) = "Admin";
option (es.api.scopes) = "ca:write";
}
//
// Certificates
//
// SignCertificate signs a certificate request with the profile's issuer
rpc SignCertificate(SignCertificateRequest) returns (CertificateResponse) {
option (es.api.allowed_roles) = "User,APIKey";
option (es.api.scopes) = "certs:issue";
}
// GetCertificate returns the certificate by ID, SKID, Sha256 or
// issuer and serial number
rpc GetCertificate(GetCertificateRequest) returns (CertificateResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "certs:read";
}
// ListCertificates returns the tenant's certificates, newest first
rpc ListCertificates(ListCertificatesRequest)
returns (CertificatesResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "certs:read";
}
// UpdateCertificateLabel updates the client-provided label and metadata
rpc UpdateCertificateLabel(UpdateCertificateLabelRequest)
returns (CertificateResponse) {
option (es.api.allowed_roles) = "User,APIKey";
option (es.api.scopes) = "certs:issue";
}
// RevokeCertificate revokes the certificate
rpc RevokeCertificate(RevokeCertificateRequest)
returns (RevokedCertificateResponse) {
option (es.api.allowed_roles) = "User,APIKey,Security";
option (es.api.scopes) = "certs:revoke";
}
// ListRevokedCertificates returns the tenant's revoked certificates
rpc ListRevokedCertificates(ListRevokedCertificatesRequest)
returns (RevokedCertificatesResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "certs:read";
}
//
// Revocation status
//
// GetCRL returns the current CRL of the issuer
rpc GetCRL(GetCrlRequest) returns (CrlResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "certs:read";
}
// PublishCrls generates and publishes CRLs on demand: the CRL of the
// issuer of the IKID, or the due CRLs of the issuers in scope. A project
// Admin and an API key restricted to a project publish for their project.
// The scheduled CRL renewal task publishes the due CRLs of every org
// in-process.
rpc PublishCrls(PublishCrlsRequest) returns (CrlsResponse) {
option (es.api.allowed_roles) = "Admin,Security,APIKey";
option (es.api.scopes) = "ca:write";
}
// SignOCSP signs an OCSP response; the AIA OCSP responder calls
// Backend.SignOCSP.
rpc SignOCSP(OCSPRequest) returns (OCSPResponse) {
option (es.api.allowed_roles) = "Admin,Security";
option (es.api.scopes) = "ca:write";
}
//
// Summary
//
// GetSummary returns the counts of the tenant's dashboard: the issuers
// by status, the certificates by status and by expiry, and the issuers
// that publish CRLs by the state of their CRL, for the org or for one
// project. Without a project, a member with project grants only gets
// the org-wide rows and those of its projects, as the lists do.
rpc GetSummary(GetSummaryRequest) returns (SummaryResponse) {
option (es.api.allowed_roles) = "Viewer,APIKey";
option (es.api.scopes) = "ca:read";
}
}
//
// Issuers
//
// RegisterIssuerRequest specifies a request to create a new issuer
message RegisterIssuerRequest {
reserved 1;
reserved "OrgID";
// ProjectID of the owning project; empty for an org-wide issuer
string ProjectID = 2 [json_name = "ProjectID"];
// Label of the issuer, unique per (Org, Project)
string Label = 3
[json_name = "Label", (es.api.required) = true, (es.api.max) = 64];
// Type of the authority
AuthorityType.Enum Type = 4 [json_name = "Type", (es.api.required) = true];
// Subject of the issuer certificate
X509Subject Subject = 5 [json_name = "Subject", (es.api.required) = true];
// KeySpec of the key to generate; defaults to ECDSA P-256
KeySpec KeySpec = 6 [json_name = "KeySpec"];
// KeyProvider selects the crypto provider; empty for the server default
string KeyProvider = 7 [json_name = "KeyProvider"];
// ParentID specifies the signing issuer. It must belong to the same org,
// or be a platform issuer that allows the Profile.
// Empty for Root type, or to create a Pending issuer with a CSR.
string ParentID = 8 [json_name = "ParentID"];
// Profile specifies the CA profile the parent uses to sign the issuer
// certificate. Required when ParentID is set or Type is Root.
string Profile = 9 [json_name = "Profile"];
// Config provides runtime settings
IssuerConfig Config = 10 [json_name = "Config"];
// SAN specifies Subject Alternative Names for the issuer certificate
repeated string SAN = 11 [json_name = "SAN"];
// Extensions specifies additional extensions for the issuer certificate
repeated X509Extension Extensions = 12 [json_name = "Extensions"];
}
// ImportIssuerRequest specifies a request to import an existing issuer
message ImportIssuerRequest {
reserved 1;
reserved "OrgID";
// ProjectID of the owning project; empty for an org-wide issuer
string ProjectID = 2 [json_name = "ProjectID"];
// Label of the issuer, unique per (Org, Project)
string Label = 3
[json_name = "Label", (es.api.required) = true, (es.api.max) = 64];
// Type of the authority
AuthorityType.Enum Type = 4 [json_name = "Type", (es.api.required) = true];
// Certificate provides the issuer certificate in PEM format
string Certificate = 5
[json_name = "Certificate", (es.api.required) = true];
// Intermediates provides the intermediate CA certificates in PEM format
string Intermediates = 6 [json_name = "Intermediates"];
// Root provides the Root CA certificate in PEM format
string Root = 7 [json_name = "Root"];
// KeyURI references an existing key in a crypto provider,
// e.g. awskms://..., gcpkms://..., pkcs11:...
string KeyURI = 8 [json_name = "KeyURI", (es.api.required_or) = "KeyPem"];
// KeyPem provides the private key in PEM format.
// It is stored protected by the data protection provider.
string KeyPem = 9 [json_name = "KeyPem", (es.api.required_or) = "KeyURI"];
// Config provides runtime settings
IssuerConfig Config = 10 [json_name = "Config"];
}
// ActivateIssuerRequest specifies the externally signed certificate for a
// Pending issuer
message ActivateIssuerRequest {
reserved 1;
reserved "OrgID";
// ID of the Pending issuer
string ID = 2 [json_name = "ID", (es.api.required) = true];
// Certificate provides the issuer certificate in PEM format
string Certificate = 3
[json_name = "Certificate", (es.api.required) = true];
// Intermediates provides the intermediate CA certificates in PEM format
string Intermediates = 4 [json_name = "Intermediates"];
// Root provides the Root CA certificate in PEM format
string Root = 5 [json_name = "Root"];
// ProjectID of the issuer's project. A caller whose role is granted
// in the project only must name it, since the request is authorized at
// that scope; the issuer must belong to it.
string ProjectID = 6 [json_name = "ProjectID"];
}
// GetIssuerRequest specifies an issuer by ID, label or IKID
message GetIssuerRequest {
reserved 1;
reserved "OrgID";
// ProjectID of the owning project; used with Label
string ProjectID = 2 [json_name = "ProjectID"];
// ID of the issuer
string ID = 3 [json_name = "ID", (es.api.required_or) = "Label,IKID"];
// Label of the issuer, resolved as (Org, Project) then (Org)
string Label = 4 [json_name = "Label", (es.api.required_or) = "ID,IKID"];
// IKID specifies Issuer Key ID
string IKID = 5 [json_name = "IKID", (es.api.required_or) = "ID,Label"];
}
// ListIssuersRequest specifies a paginated list of issuers
message ListIssuersRequest {
reserved 1;
reserved "OrgID";
// ProjectID filters by project; empty returns org-wide and all project
// issuers
string ProjectID = 2 [json_name = "ProjectID"];
// Status filters by status; Unknown returns all
IssuerStatus.Enum Status = 3 [json_name = "Status"];
// Type filters by authority type; Unknown returns all
AuthorityType.Enum Type = 4 [json_name = "Type"];
// Limit specifies maximum number of records to return
uint32 Limit = 5 [json_name = "Limit"];
// Offset specifies offset for the offset-based pagination
uint32 Offset = 6 [json_name = "Offset"];
// Cursor specifies cursor for the cursor-based pagination.
// Use "initial" to start the pagination or pass the cursor returned from
// the previous request.
string Cursor = 7 [json_name = "Cursor"];
// IDs limits the result to the issuers with the IDs, at most 500: the
// issuers of a page of certificates in one call. An issuer outside the
// scope of the request is not returned.
repeated string IDs = 8 [json_name = "IDs"];
// IKIDs limits the result to the issuers with the key identifiers, as
// the certificates they issued carry them (the SKID of the issuer), at
// most 500: the labels of the issuers of a page of certificates in one
// call
repeated string IKIDs = 9 [json_name = "IKIDs"];
}
// IssuersResponse returns list of issuers
message IssuersResponse {
repeated Issuer Issuers = 1 [json_name = "Issuers"];
// NextPage specifies pagination information, if there are more pages to
// fetch. If there are no more pages to fetch, NextPage will be empty.
NextPage NextPage = 2 [json_name = "NextPage"];
}
// UpdateIssuerRequest updates issuer config or status
message UpdateIssuerRequest {
reserved 1;
reserved "OrgID";
// ID of the issuer
string ID = 2 [json_name = "ID", (es.api.required) = true];
// Config replaces runtime settings when provided
IssuerConfig Config = 3 [json_name = "Config"];
// Status changes the status when provided: Archived or Destroyed
IssuerStatus.Enum Status = 4 [json_name = "Status"];
// ProjectID of the issuer's project. A caller whose role is granted
// in the project only must name it, since the request is authorized at
// that scope; the issuer must belong to it.
string ProjectID = 5 [json_name = "ProjectID"];
}
//
// Roots
//
// RegisterRootRequest registers an external trust anchor
message RegisterRootRequest {
reserved 1;
reserved "OrgID";
// Pem encoded root certificate
string Pem = 2 [json_name = "Pem", (es.api.required) = true];
// Trust scope
Trust.Enum Trust = 3 [json_name = "Trust"];
}
// ListRootsRequest specifies a list of trust anchors
message ListRootsRequest {
reserved 1;
reserved "OrgID";
// Limit specifies maximum number of records to return
uint32 Limit = 2 [json_name = "Limit"];
// Offset specifies offset for the offset-based pagination
uint32 Offset = 3 [json_name = "Offset"];
// Cursor specifies cursor for the cursor-based pagination
string Cursor = 4 [json_name = "Cursor"];
}
// RootsResponse returns Root Certificates
message RootsResponse {
repeated RootCertificate Roots = 1 [json_name = "Roots"];
// NextPage specifies pagination information, if there are more pages to
// fetch. If there are no more pages to fetch, NextPage will be empty.
NextPage NextPage = 2 [json_name = "NextPage"];
}
//
// Profiles
//
// RegisterProfileRequest creates or replaces a profile
message RegisterProfileRequest {
reserved 1;
reserved "OrgID";
// ProjectID of the owning project; empty for an org-wide profile
string ProjectID = 2 [json_name = "ProjectID"];
// Profile provides the profile definition.
// Profile.Label and Profile.IssuerLabel are required.
CertProfile Profile = 3 [json_name = "Profile", (es.api.required) = true];
}
// GetProfileRequest specifies a profile by ID or label
message GetProfileRequest {
reserved 1;
reserved "OrgID";
// ProjectID of the owning project; used with Label
string ProjectID = 2 [json_name = "ProjectID"];
// ID of the profile
string ID = 3 [json_name = "ID", (es.api.required_or) = "Label"];
// Label of the profile, resolved as (Org, Project) then (Org)
string Label = 4 [json_name = "Label", (es.api.required_or) = "ID"];
}
// ListProfilesRequest specifies a paginated list of profiles
message ListProfilesRequest {
reserved 1;
reserved "OrgID";
// ProjectID filters by project; empty returns org-wide and all project
// profiles
string ProjectID = 2 [json_name = "ProjectID"];
// IssuerLabel filters by issuer label
string IssuerLabel = 3 [json_name = "IssuerLabel"];
// Limit specifies maximum number of records to return
uint32 Limit = 4 [json_name = "Limit"];
// Offset specifies offset for the offset-based pagination
uint32 Offset = 5 [json_name = "Offset"];
// Cursor specifies cursor for the cursor-based pagination
string Cursor = 6 [json_name = "Cursor"];
// IDs limits the result to the profiles with the IDs, at most 500. A
// profile outside the scope of the request is not returned.
repeated string IDs = 7 [json_name = "IDs"];
// Labels limits the result to the profiles with the labels, in every
// scope the request covers, at most 500: the profiles of a page of
// certificates in one call
repeated string Labels = 8 [json_name = "Labels"];
}
// ProfilesResponse returns list of profiles
message ProfilesResponse {
repeated CertProfile Profiles = 1 [json_name = "Profiles"];
// NextPage specifies pagination information, if there are more pages to
// fetch. If there are no more pages to fetch, NextPage will be empty.
NextPage NextPage = 2 [json_name = "NextPage"];
}
// DeleteProfileRequest deletes a profile
message DeleteProfileRequest {
reserved 1;
reserved "OrgID";
// ID of the profile
string ID = 2 [json_name = "ID", (es.api.required) = true];
// ProjectID of the profile's project. A caller whose role is granted
// in the project only must name it, since the request is authorized at
// that scope; the profile must belong to it.
string ProjectID = 3 [json_name = "ProjectID"];
}
//
// Certificates
//
// SignCertificateRequest specifies certificate sign request
message SignCertificateRequest {
reserved 1;
reserved "OrgID";
// ProjectID of the owning project; recorded on the certificate and used to
// resolve project-scoped profiles and issuers
string ProjectID = 2 [json_name = "ProjectID"];
// Profile specifies the certificate profile label
string Profile = 3 [json_name = "Profile", (es.api.required) = true];
// IssuerLabel selects the issuer when the profile binds to "*";
// otherwise it must match the profile's issuer
string IssuerLabel = 4 [json_name = "IssuerLabel"];
// RequestFormat provides the certificate request format: PEM or DER
EncodingFormat.Enum RequestFormat = 5 [json_name = "RequestFormat"];
// Request provides the PKCS#10 certificate request
bytes Request = 6 [json_name = "Request", (es.api.required) = true];
// SAN specifies Subject Alternative Names to add or override
repeated string SAN = 7 [json_name = "SAN"];
// Subject overrides the subject name from the request
X509Subject Subject = 8 [json_name = "Subject"];
// NotBefore overrides the validity start in RFC3339 format;
// no backdate is applied when provided
string NotBefore = 9 [json_name = "NotBefore"];
// NotAfter overrides the validity end in RFC3339 format;
// it must not exceed the profile expiry
string NotAfter = 10 [json_name = "NotAfter"];
// Extensions specifies additional extensions to include, subject to the
// profile's AllowedExtensions
repeated X509Extension Extensions = 11 [json_name = "Extensions"];
// Label is provided by the client for search and display
string Label = 12 [json_name = "Label", (es.api.max) = 260];
// Metadata is provided by the client
map<string, string> Metadata = 13 [json_name = "Metadata"];
}
// UpdateCertificateLabelRequest specifies certificate label update request
message UpdateCertificateLabelRequest {
reserved 1;
reserved "OrgID";
// ID specifies certificate ID
string ID = 2 [json_name = "ID", (es.api.required) = true];
// Label is provided by the client
string Label = 3 [json_name = "Label", (es.api.max) = 260];
// Metadata replaces the client metadata when provided
map<string, string> Metadata = 4 [json_name = "Metadata"];
// ProjectID of the certificate's project. A caller whose role is granted
// in the project only must name it, since the request is authorized at
// that scope; the certificate must belong to it.
string ProjectID = 5 [json_name = "ProjectID"];
}
// GetCertificateRequest specifies certificate by ID, SKID, Sha256 or issuer
// and serial number
message GetCertificateRequest {
reserved 1;
reserved "OrgID";
// ID specifies certificate ID
string ID = 2
[json_name = "ID", (es.api.required_or) = "SKID,Sha256,IssuerSerial"];
// SKID specifies Subject Key ID to search
string SKID = 3
[json_name = "SKID", (es.api.required_or) = "ID,Sha256,IssuerSerial"];
// Sha256 specifies the certificate thumbprint to search
string Sha256 = 4
[json_name = "Sha256", (es.api.required_or) = "ID,SKID,IssuerSerial"];
// IssuerSerial specifies Issuer Key ID and certificate serial number
IssuerSerial IssuerSerial = 5
[json_name = "IssuerSerial", (es.api.required_or) = "ID,SKID,Sha256"];
}
// ListCertificatesRequest specifies a paginated list of certificates,
// sorted by ID descending (newest first)
message ListCertificatesRequest {
reserved 1;
reserved "OrgID";
// ProjectID filters by project; empty returns org-wide and all project
// certificates
string ProjectID = 2 [json_name = "ProjectID"];
// IKID filters by issuer
string IKID = 3 [json_name = "IKID"];
// Profile filters by profile label
string Profile = 4 [json_name = "Profile"];
// Status filters by status; Unknown returns all
CertificateStatus.Enum Status = 5 [json_name = "Status"];
// ExpiringBefore filters certificates with NotAfter before the time,
// in RFC3339 format
string ExpiringBefore = 6 [json_name = "ExpiringBefore"];
// Limit specifies maximum number of records to return
uint32 Limit = 7 [json_name = "Limit"];
// Offset specifies offset for the offset-based pagination
uint32 Offset = 8 [json_name = "Offset"];
// Cursor specifies cursor for the cursor-based pagination.
// Use "initial" to start the pagination or pass the cursor returned from
// the previous request.
string Cursor = 9 [json_name = "Cursor"];
}
// ListRevokedCertificatesRequest specifies a paginated list of revoked
// certificates, sorted by revocation ID descending
message ListRevokedCertificatesRequest {
reserved 1;
reserved "OrgID";
// ProjectID filters by project
string ProjectID = 2 [json_name = "ProjectID"];
// IKID filters by issuer
string IKID = 3 [json_name = "IKID"];
// Limit specifies maximum number of records to return
uint32 Limit = 4 [json_name = "Limit"];
// Offset specifies offset for the offset-based pagination
uint32 Offset = 5 [json_name = "Offset"];
// Cursor specifies cursor for the cursor-based pagination
string Cursor = 6 [json_name = "Cursor"];
}
// RevokeCertificateRequest specifies revocation request
message RevokeCertificateRequest {
reserved 1;
reserved "OrgID";
// ID specifies certificate ID
string ID = 2
[json_name = "ID", (es.api.required_or) = "SKID,IssuerSerial"];
// SKID specifies Subject Key ID to search
string SKID = 3
[json_name = "SKID", (es.api.required_or) = "ID,IssuerSerial"];
// IssuerSerial specifies Issuer Key ID and certificate serial number
IssuerSerial IssuerSerial = 4
[json_name = "IssuerSerial", (es.api.required_or) = "ID,SKID"];
// Reason for revocation; RemoveFromCRL is refused, since it releases a
// certificate from hold instead of revoking it
ReasonCode.Enum Reason = 5 [json_name = "Reason"];
// ReasonText provides optional free-form revocation note
string ReasonText = 6 [json_name = "ReasonText", (es.api.max) = 260];
// ProjectID of the certificate's project. A caller whose role is granted
// in the project only must name it, since the request is authorized at
// that scope; the certificate must belong to it.
string ProjectID = 7 [json_name = "ProjectID"];
}
// CertificateResponse returns Certificate
message CertificateResponse {
Certificate Certificate = 1 [json_name = "Certificate"];
}
// CertificatesResponse returns Certificates list
message CertificatesResponse {
repeated Certificate Certificates = 1 [json_name = "Certificates"];
// NextPage specifies pagination information, if there are more pages to
// fetch. If there are no more pages to fetch, NextPage will be empty.
NextPage NextPage = 2 [json_name = "NextPage"];
}
// RevokedCertificateResponse returns Revoked Certificate
message RevokedCertificateResponse {
RevokedCertificate Revoked = 1 [json_name = "Revoked"];
}
// RevokedCertificatesResponse returns Revoked Certificates list
message RevokedCertificatesResponse {
repeated RevokedCertificate RevokedCertificates = 1
[json_name = "RevokedCertificates"];
// NextPage specifies pagination information, if there are more pages to
// fetch. If there are no more pages to fetch, NextPage will be empty.
NextPage NextPage = 2 [json_name = "NextPage"];
}
//
// Revocation status
//
// GetCrlRequest specifies CRL request by IKID
message GetCrlRequest {
reserved 1;
reserved "OrgID";
// IKID specifies Issuer Key ID
string IKID = 2 [json_name = "IKID", (es.api.required) = true];
}
// PublishCrlsRequest allows to publish CRLs on demand
message PublishCrlsRequest {
reserved 1;
reserved "OrgID";
// ProjectID limits the scope to the project: the issuer of the IKID
// must belong to it, and without an IKID the issuers of the project
// publish. Empty publishes for the org-wide issuers and the projects the
// caller may read; a project Admin names the project, and an API key
// restricted to a project publishes for its project.
string ProjectID = 2 [json_name = "ProjectID"];
// IKID specifies Issuer Key ID; empty to publish for all issuers in scope
string IKID = 3 [json_name = "IKID"];
// Force specifies to publish even if the current CRL is not due for renewal
bool Force = 4 [json_name = "Force"];
}
// CrlsResponse returns published CRLs
message CrlsResponse {
repeated Crl Crls = 1 [json_name = "Crls"];
}
// CrlResponse returns CRL
message CrlResponse {
Crl Crl = 1 [json_name = "Crl"];
}
// OCSPRequest provides DER encoded OCSP request
message OCSPRequest {
// Der provides DER encoded request
bytes Der = 1 [json_name = "Der", (es.api.required) = true];
}
// OCSPResponse returns DER encoded OCSP response
message OCSPResponse {
// Der provides DER encoded response
bytes Der = 1 [json_name = "Der"];
}
//
// Summary
//
// GetSummaryRequest specifies the scope of the summary
message GetSummaryRequest {
reserved 1;
reserved "OrgID";
// ProjectID limits the summary to the project; empty summarizes the
// org-wide rows and the projects the caller may read. An API key
// restricted to a project gets its project.
string ProjectID = 2 [json_name = "ProjectID"];
}
// SummaryResponse returns the counts of the rows of the scope at the time
// of the request. The counts are exact: a count of the certificates of a
// scope reads their index entries, so it grows with the tenant.
message SummaryResponse {
// At is the time of the counts, RFC3339
string At = 1 [json_name = "At"];
// Issuers counts the issuers by lifecycle status; every status is
// reported, with a zero count when the scope has none
repeated IssuerStatusCount Issuers = 2 [json_name = "Issuers"];
// Certificates counts the certificates by status; every status is
// reported, with a zero count when the scope has none
repeated CertificateStatusCount Certificates = 3
[json_name = "Certificates"];
// Expiring counts the Active certificates whose validity ends within
// the days after At. The buckets are cumulative: 7, 30 and 90 days. A
// certificate past its NotAfter is expired, not expiring, whatever its
// status.
repeated ExpiryBucket Expiring = 4 [json_name = "Expiring"];
// Crls counts the issuers that publish CRLs by the state of their CRL
CrlCounts Crls = 5 [json_name = "Crls"];
}
// IssuerStatusCount is the number of issuers of a lifecycle status
message IssuerStatusCount {
// Status of the issuers
IssuerStatus.Enum Status = 1 [json_name = "Status"];
// Count of the issuers of the status
uint32 Count = 2 [json_name = "Count"];
}
// CertificateStatusCount is the number of certificates of a status
message CertificateStatusCount {
// Status of the certificates
CertificateStatus.Enum Status = 1 [json_name = "Status"];
// Count of the certificates of the status
uint32 Count = 2 [json_name = "Count"];
}
// ExpiryBucket is the number of Active certificates whose validity ends
// within a number of days after the time of the summary
message ExpiryBucket {
// Days after the time of the summary
uint32 Days = 1 [json_name = "Days"];
// Count of the Active certificates that expire within the days
uint32 Count = 2 [json_name = "Count"];
}
// CrlCounts counts the issuers that publish CRLs, the Active and Archived
// issuers whose certificate is valid, by the state of their current CRL at
// the time of the summary: Issuers is Current, Due, Overdue and Missing
// together.
message CrlCounts {
// Issuers is the number of issuers that publish CRLs
uint32 Issuers = 1 [json_name = "Issuers"];
// Current is the number of CRLs whose next update is later than the
// renewal period of their issuer
uint32 Current = 2 [json_name = "Current"];
// Due is the number of CRLs whose next update is within the renewal
// period of their issuer; the renewal task publishes them on its next
// run
uint32 Due = 3 [json_name = "Due"];
// Overdue is the number of CRLs whose next update has passed: relying
// parties see a stale CRL until it is published
uint32 Overdue = 4 [json_name = "Overdue"];
// Missing is the number of issuers that have published no CRL yet
uint32 Missing = 5 [json_name = "Missing"];
}