> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter certificado do banco de dados

> Retorna o certificado de um banco de dados específico pelo seu ID.

**id** `string` *required*

O ID do banco de dados do qual obter o certificado.

### Resposta

A resposta é um objeto JSON com os componentes do certificado em PEM para a conexão TLS com o banco de dados, além da CA e de um bundle PKCS#12 quando o banco de dados os tiver.

**response** `object`

Os detalhes do certificado para conexões seguras com o banco de dados.

**Mostrar objeto**

**crt** `string`

O certificado do cliente. Use-o com `key` para a autenticação TLS do cliente.

**key** `string`

A chave privada do certificado do cliente. Use-a com `crt` para a autenticação TLS do cliente.

**pem** `string`

Um único arquivo PEM com a chave privada do cliente, o certificado do cliente e o certificado da CA, nessa ordem. Use-o quando um driver quiser um único arquivo de cliente combinado; para verificar a cadeia de certificados do servidor, use a parte da CA.

**ca** `string`

O certificado da CA (PEM) que assina o certificado do servidor do banco de dados, sozinho. Use-o para verificar a cadeia de certificados do servidor. Ausente em bancos de dados mais antigos; a CA continua sendo a última parte de `pem`.

**p12** `string`

A identidade do cliente em PKCS#12, codificada em base64, com senha vazia. Decodifique-a para um arquivo `.p12` para drivers que aceitam apenas uma identidade PKCS#12, como o Prisma 6. Ausente em bancos de dados mais antigos.

```json Response theme={null}
{
  "response": {
    "crt": "-----BEGIN CERTIFICATE-----\nMIID1TCCAr2gAwIBAgIUe7z...\n-----END CERTIFICATE-----",
    "key": "-----BEGIN PRIVATE KEY-----\nMIIEvQIBADANBgkqhkiG9w0BAQE...\n-----END PRIVATE KEY-----",
    "pem": "-----BEGIN CERTIFICATE-----\nMIIDazCCAlOgAwIBAgIUT...\n-----END CERTIFICATE-----",
    "ca": "-----BEGIN CERTIFICATE-----\nMIIDazCCAlOgAwIBAgIUT...\n-----END CERTIFICATE-----",
    "p12": "MIIJqQIBAzCCCW8GCSqGSIb3DQEHAaCCCWAEgglc..."
  }
}
```

### Uso

Todos os motores exigem TLS **e** o certificado do cliente. Salve cada campo em um arquivo:

| Campo | Salvar como | Conteúdo |
| - | - | - |
| `crt` | `certificate.crt` | Certificado do cliente |
| `key` | `certificate.key` | Chave privada do cliente |
| `pem` | `certificate.pem` | Chave do cliente + certificado do cliente + a CA que assina o servidor |
| `ca` | `ca.pem` | A CA que assina o servidor (quando presente) |
| `p12` | `certificate.p12` (decodifique o base64 antes) | Identidade do cliente em PKCS#12, senha vazia (quando presente) |

Use `ca.pem` (ou `certificate.pem`, que termina com a mesma CA) como arquivo de CA e, no MongoDB, `certificate.pem` como arquivo de certificado com chave. Use
`certificate.crt` + `certificate.key` como certificado do cliente, ou `certificate.p12` quando o driver aceitar apenas uma identidade PKCS#12 (Prisma 6, com senha vazia). A porta é única por banco de dados — leia-a em [Obter banco de dados](https://docs.vertracloud.app/pt-br/api-reference/endpoint/databases/get.md). Comandos e exemplos de driver para cada motor estão em [Como me conecto a cada motor?](https://docs.vertracloud.app/pt-br/databases.md#como-me-conecto-a-cada-motor).

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: O header `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: A chave de API é usada a partir de um IP fora da sua lista de IPs permitidos, ou não tem o escopo que a rota exige (`403`).
* `ACCESS_DENIED`: O recurso pertence a outra conta, ou você não tem a permissão de workspace para ele (`403`).
* `DATABASE_NOT_FOUND_OR_FORBIDDEN`: O banco de dados informado não existe ou o usuário não tem acesso.
* `FAILED_TO_GET_CERTIFICATE`: Falha ao obter o certificado.

**message** `string`

Uma mensagem descritiva com detalhes adicionais sobre o erro.

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "DATABASE_NOT_FOUND_OR_FORBIDDEN"
}
```

```json Error Response (500) theme={null}
{
  "code": "FAILED_TO_GET_CERTIFICATE"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.