Você pode adicionar e gerenciar certificados no Apidog para habilitar a autenticação ao enviar requisições para APIs que exigem segurança baseada em certificados. Isso é essencial para se conectar a APIs que usam Mutual TLS (mTLS) ou autoridades certificadoras personalizadas.
Mutual TLS (mTLS) é um método de autenticação que exige que tanto o cliente quanto o servidor confirmem suas identidades com um certificado. Depois que a identidade de ambas as partes é confirmada, uma conexão criptografada é estabelecida. Isso oferece uma segurança mais robusta do que o TLS unidirecional tradicional.Certificados de CA personalizados permitem que você se conecte a endpoints que usam certificados registrados em um registro interno de certificados. Sem adicionar o certificado de CA, as requisições enviadas pelo Apidog falharão com "SSL Error: Self signed certificate".
Para evitar erros de "self signed certificate" ao enviar requisições para APIs com autoridades certificadoras personalizadas, adicione seu certificado de CA ao Apidog.
1
Ative o alternador ao lado de CA Certificates.
2
Selecione o arquivo PEM do seu certificado de CA.
Vários Certificados de CA
O arquivo PEM pode conter vários certificados de CA. O Apidog carregará todos os certificados do arquivo.
Para enviar requisições para uma API que usa autenticação Mutual TLS, adicione seu certificado de cliente ao Apidog.
1
Selecione Add Certificate.
2
Insira o domínio do Host para o certificado (não inclua o protocolo).
Correspondência de Padrões
O campo Host oferece suporte à correspondência de padrões. Se você inserir *.example.com, o mesmo certificado de cliente será usado para todos os subdomínios de example.com.
3
(Opcional) Insira um número de porta personalizado para associar ao domínio. Se você não especificar uma porta, o Apidog usará a porta HTTPS padrão (443).
4
Selecione os arquivos do certificado:
Opção 1: selecione o arquivo CRT e o arquivo Key do seu certificado
Opção 2: selecione o arquivo PFX do seu certificado
5
Se você usou uma Passphrase ao gerar o certificado de cliente, insira-a na caixa. Caso contrário, deixe a caixa em branco.
6
Selecione Add.
Um Certificado por Domínio
Cada certificado de cliente é específico de um domínio. Não adicione mais de um certificado para o mesmo domínio. Se você adicionar vários certificados para um domínio, o Apidog usará o último certificado adicionado, o que pode causar comportamento inesperado.
Depois de adicionar um certificado de cliente, você não precisa realizar nenhuma etapa extra para usar o certificado no Apidog.Comportamento automático:
Quando você faz uma requisição HTTPS para um domínio configurado, o Apidog envia automaticamente o certificado de cliente com a requisição
O certificado é enviado usando o tratamento do OpenSSL
O Apidog não modifica o certificado de forma alguma
Requisições HTTP
O Apidog não enviará o certificado se você fizer uma requisição HTTP. Certificados são enviados somente por conexões HTTPS.
