Sửa Lỗi SSL Certificate Verify Failed Khi Cài Python Package: WSL, Docker, Azure Artifacts

Bạn đang gặp rắc rối với lỗi SSL Certificate Verify Failed khi cài đặt các gói Python trên WSL (Windows Subsystem for Linux), Docker hoặc khi sử dụng Azure Artifacts? Đừng lo lắng, đây là một vấn đề phổ biến và bài viết này sẽ cung cấp cho bạn các giải pháp chi tiết, dễ hiểu để khắc phục triệt để. Chúng ta sẽ cùng nhau tìm hiểu nguyên nhân gây ra lỗi và các bước cấu hình cần thiết để môi trường phát triển của bạn hoạt động trơn tru trở lại.

Nguyên Nhân Gây Ra Lỗi SSL Certificate Verify Failed

Lỗi SSL Certificate Verify Failed xảy ra khi Python không thể xác minh được chứng chỉ SSL của máy chủ mà bạn đang cố gắng kết nối. Điều này thường xảy ra do một số nguyên nhân chính sau:

• Chứng chỉ SSL tự ký: Bạn đang kết nối đến một máy chủ sử dụng chứng chỉ SSL tự ký (self-signed certificate), mà các trình duyệt và Python mặc định không tin cậy.
• Chứng chỉ SSL hết hạn hoặc không hợp lệ: Chứng chỉ SSL trên máy chủ đã hết hạn hoặc không được cấp phát bởi một tổ chức chứng nhận (Certificate Authority) được tin cậy.
• Thiếu chứng chỉ trung gian: Chứng chỉ trung gian (intermediate certificate) cần thiết để xác minh chuỗi tin cậy của chứng chỉ SSL bị thiếu trên hệ thống của bạn.
• Tường lửa hoặc proxy: Tường lửa hoặc proxy đang chặn hoặc can thiệp vào quá trình xác minh chứng chỉ SSL.

Các Giải Pháp Khắc Phục Lỗi SSL Certificate Verify Failed

1. Thêm Chứng Chỉ SSL Tự Ký Vào Danh Sách Tin Cậy

Nếu bạn đang làm việc với một máy chủ sử dụng chứng chỉ SSL tự ký, bạn có thể thêm chứng chỉ này vào danh sách tin cậy của hệ thống để Python có thể xác minh nó. Lưu ý rằng việc này chỉ nên được thực hiện trong môi trường phát triển hoặc khi bạn hoàn toàn tin tưởng vào nguồn gốc của chứng chỉ.

**Cách thực hiện:**

1. Tải xuống chứng chỉ SSL tự ký từ máy chủ.
2. Tìm đường dẫn đến tệp `cacert.pem` của Python bằng lệnh: `python -m certifi`.
3. Mở tệp `cacert.pem` bằng một trình soạn thảo văn bản và dán nội dung của chứng chỉ SSL tự ký vào cuối tệp.

2. Sử Dụng Tùy Chọn --trusted-host Với Pip

Khi cài đặt các gói bằng pip, bạn có thể sử dụng tùy chọn `--trusted-host` để chỉ định các máy chủ mà bạn tin cậy. Điều này sẽ bỏ qua việc xác minh chứng chỉ SSL cho các máy chủ này.

**Ví dụ:**

`pip install --trusted-host pkgs.dev.azure.com `

Lưu ý rằng bạn cần thay thế `pkgs.dev.azure.com` bằng tên miền của máy chủ mà bạn đang kết nối.

3. Cấu Hình SSL Cho Azure Artifacts

Nếu bạn đang sử dụng Azure Artifacts, bạn cần đảm bảo rằng bạn đã cấu hình SSL đúng cách. Điều này bao gồm việc thêm các host tin cậy vào tệp `pip.ini` hoặc `pip.conf`.

**Ví dụ:**

Trong tệp `pip.ini`:

    [global]
    index-url=https://{FEED_NAME}:{PAT}@pkgs.dev.azure.com/{ORGANIZATION_NAME}/{PROJECT_NAME}/_packaging/{FEED_NAME}/pypi/simple/
    trusted-host = pkgs.dev.azure.com
                   pypi.org
    

Đảm bảo rằng bạn đã thay thế các giá trị `{FEED_NAME}`, `{PAT}`, `{ORGANIZATION_NAME}`, và `{PROJECT_NAME}` bằng thông tin chính xác của bạn.

4. Kiểm Tra và Cập Nhật Pip, Setuptools và Wheel

Đôi khi, lỗi SSL Certificate Verify Failed có thể xảy ra do phiên bản cũ của pip, setuptools hoặc wheel. Hãy đảm bảo rằng bạn đang sử dụng các phiên bản mới nhất bằng lệnh:

`pip install --upgrade pip setuptools wheel`

5. Kiểm Tra Môi Trường Mạng (Proxy, Tường Lửa)

Nếu bạn đang sử dụng proxy hoặc tường lửa, hãy đảm bảo rằng chúng không chặn hoặc can thiệp vào quá trình xác minh chứng chỉ SSL. Bạn có thể cần phải cấu hình proxy để cho phép kết nối đến các máy chủ cần thiết.

Kết Luận

Lỗi SSL Certificate Verify Failed có thể gây khó chịu, nhưng với các giải pháp được trình bày trong bài viết này, bạn có thể dễ dàng khắc phục nó và tiếp tục công việc phát triển của mình một cách suôn sẻ. Hãy thử từng giải pháp một cho đến khi bạn tìm ra giải pháp phù hợp với trường hợp của mình. Chúc bạn thành công!