Pular para o conteúdo principal
Os certificados mTLS (TLS Mútuo) habilitam a autenticação mútua entre sua aplicação e servidores externos. Este recurso permite que você use certificados de cliente para autenticar com APIs que exigem autenticação TLS mútua.

​
Acessar os certificados

Para gerenciar seus certificados mTLS, vá em Configurações > Certificados. Esta seção permite que você gerencie todos os certificados associados à sua empresa.
A seção de certificados não está disponível para empresas self-service.
Visualização completa da seção de certificados mTLS mostrando a lista de certificados com seus nomes, datas de expiração e opções para marcá-los como principal

​
Criar certificado

Clique em Criar, na parte superior da lista, para abrir um painel lateral com estes campos:
Painel para criar um novo certificado mTLS com opções para enviar arquivos PEM ou CRT + KEY
  • Nome (obrigatório): máximo de 100 caracteres, único dentro da sua empresa (sem diferenciar maiúsculas de minúsculas) e sem emojis.
  • Passphrase do certificado (opcional): se a sua chave privada for protegida, informe a senha dela. Deve ter entre 8 e 128 caracteres, sem emojis e sem espaços no início ou no fim.
  • Arquivo do certificado: escolha uma das duas opções a seguir.
Você pode enviar os arquivos em dois formatos, que são mutuamente exclusivos: ao carregar uma opção, a outra é limpa e bloqueada.
Cada arquivo pode ter até 5 MB. Certifique-se de que os certificados são válidos e não expiraram antes de enviá-los. A data de expiração é extraída automaticamente do certificado.
O botão Enviar do painel só é habilitado quando o nome é válido e você anexou o arquivo .pem ou o par CRT + KEY. Os certificados novos não são marcados como principal: você pode fazer isso depois, pela lista.

​
Opção A: arquivos separados (CRT + KEY)

Os dois arquivos são obrigatórios:
  • Arquivo CRT (.crt ou .cer): contém o certificado
  • Arquivo KEY (.key): contém a chave privada

​
Opção B: arquivo único (.pem)

Um arquivo .pem que contém tanto o certificado quanto a chave privada.

​
Ver certificados

Na seção Certificados você pode ver todos os certificados da sua empresa em uma tabela com as colunas:
  • Nome do certificado
  • Data de expiração (por exemplo, out 13, 2027; é exibido - se não houver data)
  • Principal: um interruptor que indica se é o certificado principal
  • Ações: ícones para editar e excluir
A tabela é paginada na parte inferior. Se você ainda não adicionou certificados, verá a mensagem “Nenhum certificado adicionado ainda”.

​
Marcar um certificado como principal

Ative o interruptor Principal do certificado. Este certificado será selecionado automaticamente quando você habilitar mTLS em um nó de API, caso não tenha selecionado manualmente outro certificado.
Apenas um certificado pode ser marcado como principal de cada vez. Se você marcar um novo certificado como principal, o anterior perderá automaticamente esse status.
Enquanto a alteração é salva, o interruptor permanece desabilitado; se a operação falhar, ele volta ao estado anterior.

​
Editar um certificado

Você pode editar o nome dos seus certificados existentes para identificá-los mais facilmente. Isso é útil quando você tem múltiplos certificados para diferentes finalidades ou ambientes. Clique no ícone de editar (lápis) da coluna Ações, ao lado do certificado que deseja modificar. O nome deve cumprir as mesmas regras de quando foi criado.
Você só pode alterar o nome. Os arquivos não podem ser substituídos: para usar outro certificado ou chave, crie um novo certificado.

​
Excluir um certificado

Você pode excluir certificados que não precisa mais. Para excluir um certificado, clique no ícone de excluir (lixeira) da coluna Ações; será aberto um modal de confirmação com o nome do certificado.
Você não pode excluir o certificado principal: a opção aparece desabilitada. Primeiro remova a marca de principal ativando outro certificado.
Antes de excluir um certificado, o sistema exibirá um aviso indicando que você deve garantir que este certificado não está sendo usado em nenhum nó de API. Se você excluir um certificado que está em uso, isso pode causar erros nas chamadas de API dos seus fluxos ativos.

​
Usar certificados em nós de API

Uma vez que você tenha certificados carregados, pode usá-los no nó de API habilitando a opção de certificados mTLS na seção Configurações do nó.