You can add and manage certificates in Apidog to enable authentication when sending requests to APIs that require certificate-based security. This is essential for connecting to APIs that use Mutual TLS (mTLS) or custom certificate authorities.
Mutual TLS (mTLS) is an authentication method that requires both the client and the server to confirm their identity with a certificate. Once the identity of both parties is confirmed, an encrypted connection is established. This provides stronger security than traditional one-way TLS.Custom CA certificates enable you to connect to endpoints that use certificates registered with an internal certificate registry. Without adding the CA certificate, requests sent from Apidog will fail with "SSL Error: Self signed certificate."
To send requests to an API that uses mutual TLS authentication, add your client certificate to Apidog.
1
Select Add Certificate.
2
Enter the Host domain for the certificate (don't include the protocol).
Pattern Matching
The Host field supports pattern matching. If you enter *.example.com, the same client certificate will be used for all example.com subdomains.
3
(Optional) Enter a custom port number to associate with the domain. If you don't specify a port, Apidog uses the default HTTPS port (443).
4
Select the certificate files:
Option 1: Select the CRT file and the Key file for your certificate
Option 2: Select the PFX file for your certificate
5
If you used a Passphrase when generating the client certificate, enter it in the box. Otherwise, leave the box blank.
6
Select Add.
One Certificate Per Domain
Each client certificate is specific to a domain. Don't add more than one certificate for the same domain. If you add multiple certificates for a domain, Apidog will use the last certificate added, which may cause unexpected behavior.
