How to install Certificate and debug HTTPS contents in macOS device.

Install Certificates on macOS

In order to intercept encrypted HTTPS messages (Request or Response), you have to install Proxyman CA Certificate on your current machine. This step is mandatory for iOS, Android devices, iOS simulator, Java VMs, and Firefox too.

You can install the Proxyman CA Certificate by navigating to

  • Certificate menu -> Install Certificate on this Mac...

The Proxyman Certificate is locally generated in your machine and never store in the Proxyman's web server.

You can locally generate a Certificate on your machine then adding to Proxyman. Please check out the Custom Certificate Doc

Proxyman's certificate is store locally at ~/.proxyman or ~/Library/Application Support/com.proxyman.NSProxy/certificates/

Automatic mode

Proxyman could automatically install & trust the Certificate in Keychain by following the instruction in the following screenshot.

It's convenient for the majority of users and we can start debugging now.

Install & Trust Proxyman CA by automatic mode

Automation mode requires Root Privileges to perform the installation script. If you're not sure, please consider using Manual mode.

Manual Mode

Proxyman also offers more freedom for super-users who need to install the certificate on their behalf.

You can select one of the following approaches:

  • Generate and Add: Proxyman will locally generate the certificate and add it to Keychain, but not Trust automatically.

  • Add your Custom Certificate: Proxyman will open Custom Certificate and help you manually generate a certificate by using the OpenSSL command line. This feature intends for advanced users.

If you would like to manually generate a Root Certificate that works with Proxyman, please check out the Custom Certificate Doc

Trust Proxyman Certificate

Make sure that your machine trusts Proxyman Certificate properly.

  • Open Keychain -> Search Proxyman CA -> Open it then expanding the Trust Section -> Select Always Trust

  • This step is required for Manual Mode

macOS Setup Guide for SSL Proxying

Make sure that you Delete the Proxyman Certificate in Keychain app if you're not using Proxyman anymore. If not, anyone who has the Proxyman Certificate can intercept your HTTP/HTTPS requests from your macOS machine.

SSL Proxying

After the installation, we can start capture and view HTTPS message by following SSL Proxying Doc