Puede agregar y gestionar certificados en Apidog para habilitar la autenticación al enviar peticiones a APIs que requieren seguridad basada en certificados. Esto es esencial para conectarse a APIs que utilizan TLS mutuo (mTLS) o autoridades de certificación personalizadas.
TLS mutuo (mTLS) es un método de autenticación que requiere que tanto el cliente como el servidor confirmen su identidad con un certificado. Una vez confirmada la identidad de ambas partes, se establece una conexión cifrada. Esto proporciona mayor seguridad que el TLS tradicional unidireccional.Los certificados de CA personalizados le permiten conectarse a endpoints que utilizan certificados registrados en un registro interno de certificados. Sin agregar el certificado de CA, las peticiones enviadas desde Apidog fallarán con "SSL Error: Self signed certificate".
Para evitar errores de "self signed certificate" al enviar peticiones a APIs con autoridades de certificación personalizadas, agregue su certificado de CA a Apidog.
1
Active el interruptor junto a CA Certificates.
2
Seleccione el archivo PEM para su certificado de CA.
Multiple CA Certificates
El archivo PEM puede contener varios certificados de CA. Apidog cargará todos los certificados desde el archivo.
Para enviar peticiones a una API que utiliza autenticación TLS mutua, agregue su certificado de cliente a Apidog.
1
Seleccione Add Certificate.
2
Introduzca el dominio del Host para el certificado (no incluya el protocolo).
Pattern Matching
El campo Host admite coincidencia de patrones. Si introduce *.example.com, se utilizará el mismo certificado de cliente para todos los subdominios de example.com.
3
(Opcional) Introduzca un número de puerto personalizado para asociarlo con el dominio. Si no especifica un puerto, Apidog utiliza el puerto HTTPS predeterminado (443).
4
Seleccione los archivos de certificado:
Opción 1: Seleccione el archivo CRT y el archivo Key para su certificado
Opción 2: Seleccione el archivo PFX para su certificado
5
Si utilizó una frase de contraseña al generar el certificado de cliente, introdúzcala en el cuadro. De lo contrario, deje el cuadro en blanco.
6
Seleccione Add.
One Certificate Per Domain
Cada certificado de cliente es específico de un dominio. No agregue más de un certificado para el mismo dominio. Si agrega varios certificados para un dominio, Apidog utilizará el último certificado agregado, lo que puede causar un comportamiento inesperado.
Después de agregar un certificado de cliente, no tiene que realizar ningún paso adicional para usar el certificado en Apidog.Comportamiento automático:
Cuando realiza una petición HTTPS a un dominio configurado, Apidog envía automáticamente el certificado de cliente con la petición
El certificado se envía mediante el manejo de OpenSSL
Apidog no modifica el certificado de ninguna manera
HTTP Requests
Apidog no enviará el certificado si realiza una petición HTTP. Los certificados solo se envían a través de conexiones HTTPS.
