Python security certificate prevents running the setup process on Mac

[snarve]

Prerequisites

• This issue has an informative and human-readable title.

ScubaGoggles Version

scubagoggles version 0.6

Operating System

MacOS Sequoia

Python Version

Python 3.13.5

🐛 Summary

This issue encountered when trying to run a fresh install on Mac, the issue is reproducible with development environment installation as well.

Issue: Unable to run the setup process, dependency do not get installed and throws a certificate issue

Reason: The problem is not related to VPN or Zscaler or other security tools, but instead this is python security setting. Python runs its own certificates that come with the installed python package and hence the certificate authentication fails.

Solution: In the python package installed run the Installed Certificates.command which will replace the default python certificates with the trusted certificates installed on your local system.
This resolves the cert issue and setup process works.

Reference: https://stackoverflow.com/questions/52805115/certificate-verify-failed-unable-to-get-local-issuer-certificate

Note:
On Mac:

• The python command needs to be python3 and not python
• Only while running the tool, VPN needs to be disconnected
• While installing dependencies VPN connection is needed, since the trusted certs are used, else it did not work

Steps to reproduce

1. Run a fresh install or development environment setup from scratch following the user guide in the repo on a Mac environment
2. Installation process will run into certificate issue when installing dependencies.

Expected behavior

Installation process should run without any errors

[snarve]

Potential next steps:

• Add this as a note in the readme or troubleshooting section