Pode adicionar e gerir certificados no Apidog para permitir a autenticação ao enviar pedidos para APIs que exigem segurança baseada em certificados. Isto é essencial para estabelecer ligação a APIs que utilizam Mutual TLS (mTLS) ou autoridades de certificação personalizadas.
Mutual TLS (mTLS) é um método de autenticação que exige que tanto o cliente como o servidor confirmem a sua identidade com um certificado. Assim que a identidade de ambas as partes é confirmada, é estabelecida uma ligação encriptada. Isto proporciona uma segurança mais forte do que o TLS unidirecional tradicional.Certificados CA personalizados permitem-lhe estabelecer ligação a endpoints que utilizam certificados registados num registo interno de certificados. Sem adicionar o certificado CA, os pedidos enviados a partir do Apidog irão falhar com "SSL Error: Self signed certificate".
Para evitar erros de "self signed certificate" ao enviar pedidos para APIs com autoridades de certificação personalizadas, adicione o seu certificado CA ao Apidog.
1
Ative o botão de alternância junto a CA Certificates.
2
Selecione o ficheiro PEM do seu certificado CA.
Múltiplos Certificados CA
O ficheiro PEM pode conter múltiplos certificados CA. O Apidog irá carregar todos os certificados do ficheiro.
Para enviar pedidos para uma API que utiliza autenticação por Mutual TLS, adicione o seu certificado de cliente ao Apidog.
1
Selecione Add Certificate.
2
Introduza o domínio do Host para o certificado (não inclua o protocolo).
Correspondência de Padrões
O campo Host suporta correspondência de padrões. Se introduzir *.example.com, o mesmo certificado de cliente será utilizado para todos os subdomínios de example.com.
3
(Opcional) Introduza um número de porta personalizado para associar ao domínio. Se não especificar uma porta, o Apidog utiliza a porta HTTPS predefinida (443).
4
Selecione os ficheiros do certificado:
Opção 1: selecione o ficheiro CRT e o ficheiro Key do seu certificado
Opção 2: selecione o ficheiro PFX do seu certificado
5
Se utilizou uma frase-passe ao gerar o certificado de cliente, introduza-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 do que um certificado para o mesmo domínio. Se adicionar múltiplos certificados para um domínio, o Apidog irá utilizar o último certificado adicionado, o que pode causar comportamento inesperado.
Depois de adicionar um certificado de cliente, não tem de executar quaisquer passos adicionais para utilizar o certificado no Apidog.Comportamento automático:
Quando faz um pedido HTTPS para um domínio configurado, o Apidog envia automaticamente o certificado de cliente com o pedido
O certificado é enviado utilizando o processamento do OpenSSL
O Apidog não modifica o certificado de forma alguma
Pedidos HTTP
O Apidog não irá enviar o certificado se fizer um pedido HTTP. Os certificados só são enviados através de ligações HTTPS.
