Decrypt HTTPS
Most traffic is HTTPS, which is encrypted. To show what’s inside, Reqly creates its own certificate on your computer, and macOS or Windows trusts it for your user account. Reqly then decrypts only the hosts you choose. Everything else passes through untouched.
Install the certificate
Section titled “Install the certificate”- Choose Capture › Decrypt HTTPS…. Settings opens on HTTPS.
- Click Install Certificate….
- Enter your password when macOS asks.
If you cancel the password prompt, the certificate is made but not trusted, and Reqly decrypts nothing. Click Trust Certificate… to try again.
- Choose Capture › Decrypt HTTPS…. Settings opens on HTTPS.
- Click Install certificate….
- Windows shows a security warning of its own about the certificate, and asks you to confirm. Confirm it.
There’s no password to enter. If you say no, the certificate is made but not trusted, and Reqly decrypts nothing: Settings says Windows doesn’t trust the Reqly certificate. Click Trust certificate… to try again.
Once it’s trusted, Settings says The Reqly certificate is installed and trusted. Its name is Reqly CA, followed by the date and time it was made, and it never leaves your computer. To find it on the Mac, click Show in Keychain Access. On Windows, click Open certificate manager, and look under Trusted Root Certification Authorities, then Certificates.
Choose the hosts to decrypt
Section titled “Choose the hosts to decrypt”In Settings › HTTPS, under Decrypt HTTPS for these hosts:
- Click +.
- Type a host, such as
api.example.com, or*.example.comfor its subdomains. - Press Return.
- Type a host in the box, such as
api.example.com, or*.example.comfor its subdomains. - Click Add host, or press Enter.
Each host has a switch of its own, so you can stop decrypting it without removing it. To remove a host on the Mac, select it and press Delete, or click −. On Windows, click the trash button beside it.
You can also decide from the request list. Right-click an encrypted request, and choose Decrypt followed by its host. Its next requests show up decrypted. To undo it, choose Stop Decrypting on the Mac, or Stop decrypting on Windows.
How hosts match
Section titled “How hosts match”*.example.commatches the subdomains of example.com, such asapi.example.com, but notexample.comitself. Add both if you need both.- The most specific entry wins. An exact host beats a wildcard, and a longer wildcard beats a shorter one. So you can decrypt
*.example.combut switch offads.example.com.
Decrypt all hosts
Section titled “Decrypt all hosts”Decrypt all hosts decrypts every host except the ones you switch off in the list. It isn’t recommended: some apps stop working when their traffic is decrypted.
Apps that accept only their own certificate
Section titled “Apps that accept only their own certificate”Some apps accept only their own certificate, and their requests fail when Reqly decrypts them. Such a request shows as Failed, and its details say the app didn’t accept Reqly’s certificate. Stop decrypting the host, and its traffic passes through encrypted again.
Remove the certificate
Section titled “Remove the certificate”In Settings › HTTPS, click Remove Certificate…, then Remove Certificate, and enter your password. Reqly stops decrypting, and removes its certificates from your keychain, older ones included.
In Settings › HTTPS, under Remove certificate, click Remove…, then Remove certificate, and confirm when Windows asks. Reqly stops decrypting, and removes its certificate and key from your PC.
You can set up HTTPS again at any time. Reqly then makes a new certificate, which phones, tablets, simulators and emulators need to install again.