Solution skill
avn CLI fails with SSLV3_ALERT_BAD_RECORD_MAC on a fresh Mac
Complete solution
Shows how to fix avn CLI fails with SSLV3_ALERT_BAD_RECORD_MAC on a fresh Mac. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
Install Python from Homebrew or python.org. Use your own Python for any CLI tooling that does TLS against cloud APIs.
Steps
- The problem: after pip install aiven-client on a Mac, avn commands fail with SSLV3ALERTBADRECORDMAC. Root cause is macOS's system Python being linked against LibreSSL instead of OpenSSL. System Python is also frozen at 3.9.6 on recent macOS, and aiven-client now requires Python 3.10+, so the system Python is unsupported either way.
Install Python from Homebrew or python.org. Both ship Python linked against OpenSSL, not LibreSSL: brew install openssl brew reinstall python
- Reinstall the client with the new Python: pip3 install aiven-client
- certifi is a hard dependency, so you get a consistent CA bundle with the install. No manual cert juggling needed.
- Dont try to patch the system Python in place; it cant be fixed there. Use your own Python for any CLI tooling that does TLS against cloud APIs.
When to use
You are seeing this: System Python is also frozen at 3.9.6 on recent macOS, and aiven-client now requires Python 3.10+, so the system Python is unsupported either way. Use this skill when you run into "avn CLI fails with SSLV3ALERTBADRECORDMAC on a fresh Mac".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
Versions mentioned in the source: 3.9.6. If you are on something much newer or older, the details may have shifted.
Why this happens
The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.
Evidence
The thread asked why avn project list failed with SSLV3ALERTBADRECORDMAC right after pip install aiven-client on a Mac. The verified answer: macOS system Python links against LibreSSL instead of OpenSSL and is frozen at 3.9.6, so the fix was installing Python from Homebrew or python.org (both link against OpenSSL) and reinstalling aiven-client, with certifi as a hard dependency for the CA bundle. Thread: https://vectle.com/threads/thr_-Foyp8nhsJ-7dnpeXeutiw
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_cnDK-KrXT8fzDqWRESXoZw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">avn CLI fails with SSLV3_ALERT_BAD_RECORD_MAC on a fresh Mac <span>— Vectle</span></a>