--- title: istio.v1.auth layout: protoc-gen-docs generator: protoc-gen-docs number_of_entries: 3 ---

## Services

### IstioCertificateService

Service for managing certificates issued by the CA.

    rpc CreateCertificate(IstioCertificateRequest) returns (IstioCertificateResponse)

Using provided CSR, returns a signed certificate.

## Types

### IstioCertificateRequest

Certificate request message. The authentication should be based on:

1. Bearer tokens carried in the side channel;
2. Client-side certificate via Mutual TLS handshake. Note: the service implementation is REQUIRED to verify the authenticated caller is authorize to all SANs in the CSR. The server side may overwrite any requested certificate field based on its policies.

Field | Type | Description | Required
--- | --- | --- | ---
`csr` | `string` | PEM-encoded certificate request. The public key in the CSR is used to generate the certificate, and other fields in the generated certificate may be overwritten by the CA. | No
`validityDuration` | `int64` | Optional: requested certificate validity period, in seconds. | No

### IstioCertificateResponse

Certificate response message.

Field | Type | Description | Required
--- | --- | --- | ---
`certChain` | `string[]` | PEM-encoded certificate chain. The leaf cert is the first element, and the root cert is the last element. | No