- Certifi: как использовать SSL-сертификат в Python
- Установка certifi в Python
- Как установить сертификат Python в Windows
- Как установить сертификат Python в Linux
- Python certifi.where()
- HTTPS Certificates#
- Using a specific certificate store#
- Using system certificate stores#
- When to use#
- HTTPS Certificates#
- Using a specific certificate store#
- Using system certificate stores#
- When to use#
Certifi: как использовать SSL-сертификат в Python
Python certifi предоставляет «тщательно отобранную коллекцию сертификатов Mozilla для проверки достоверности сертификатов SSL при проверке подлинности хостов TLS». Она была взята из проекта Requests.
Установка certifi в Python
Чтобы установить пакет сертификации Python, введите следующую команду.
Если вы уже установили библиотеку requests, есть 100% вероятность того, что библиотека certifi также установлена, но вы должны это проверить. Библиотека запросов Python использует свой собственный файл CA по умолчанию или будет использовать пакет сертификатов пакета certifi, если он установлен.
Несмотря на то, что вы можете передать свой собственный пакет CA в запросы, чтобы переопределить по умолчанию, несколько сторонних пакетов используют запросы под капотом, и вы не можете быть уверены, что использовали пользовательское расположение для проверки.
Как установить сертификат Python в Windows
Чтобы установить сертификат Python в Microsoft Windows:
- Введите cmd в строке поиска и нажмите Enter, чтобы открыть командную строку.
- Введите python3 -m pip install certifi в командной строке и снова нажмите Enter. Это устанавливает certifi для установки Python по умолчанию.
- Предыдущая команда может не работать, если на вашем компьютере установлены версии Python 2 и 3. В этом случае попробуйте выполнить команду pip3 install certifi. Теперь он установлен в вашей системе.
Как установить сертификат Python в Linux
Чтобы установить сертификат Python в Linux:
- Сначала откройте терминал или оболочку в вашей ОС Linux.
- Введите python3 -m pip install certifi и нажмите Enter.
- Если это не сработает, попробуйте использовать эту команду: pip3 install certifi или python -m pip install certifi.
Python certifi.where()
Функция certifi.where() помогает нам найти ссылку на установленный пакет центра сертификации(CA) в Python.
HTTPS Certificates#
By default, pip will perform SSL certificate verification for network connections it makes over HTTPS. These serve to prevent man-in-the-middle attacks against package downloads. This does not use the system certificate store but, instead, uses a bundled CA certificate store from certifi.
Using a specific certificate store#
The —cert option (and the corresponding PIP_CERT environment variable) allow users to specify a different certificate store/bundle for pip to use. It is also possible to use REQUESTS_CA_BUNDLE or CURL_CA_BUNDLE environment variables.
Using system certificate stores#
- Use Python 3.10 or newer.
- Install the truststore package, in the Python environment you’re running pip in. This is typically done by installing this package using a system package manager or by using pip in Hash-checking Mode for this package and trusting the network using the —trusted-host flag.
$ python -m pip install truststore [. ] $ python -m pip install SomePackage --use-feature=truststore [. ] Successfully installed SomePackage
$ python -m pip install truststore [. ] $ python -m pip install SomePackage --use-feature=truststore [. ] Successfully installed SomePackage
C:> py -m pip install truststore [. ] C:> py -m pip install SomePackage --use-feature=truststore [. ] Successfully installed SomePackage
When to use#
You should try using system trust stores when there is a custom certificate chain configured for your system that pip isn’t aware of. Typically, this situation will manifest with an SSLCertVerificationError with the message “certificate verify failed: unable to get local issuer certificate”:
$ python -m pip install -U SomePackage [. ] SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (\_ssl.c:997)'))) - skipping
$ python -m pip install -U SomePackage [. ] SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (\_ssl.c:997)'))) - skipping
C:> py -m pip install -U SomePackage [. ] SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (\_ssl.c:997)'))) - skipping
This error means that OpenSSL wasn’t able to find a trust anchor to verify the chain against. Using system trust stores instead of certifi will likely solve this issue.
If you encounter a TLS/SSL error when using the truststore feature you should open an issue on the truststore GitHub issue tracker instead of pip’s issue tracker. The maintainers of truststore will help diagnose and fix the issue.
HTTPS Certificates#
By default, pip will perform SSL certificate verification for network connections it makes over HTTPS. These serve to prevent man-in-the-middle attacks against package downloads. This does not use the system certificate store but, instead, uses a bundled CA certificate store from certifi.
Using a specific certificate store#
The —cert option (and the corresponding PIP_CERT environment variable) allow users to specify a different certificate store/bundle for pip to use. It is also possible to use REQUESTS_CA_BUNDLE or CURL_CA_BUNDLE environment variables.
Using system certificate stores#
- Use Python 3.10 or newer.
- Install the truststore package, in the Python environment you’re running pip in. This is typically done by installing this package using a system package manager or by using pip in Hash-checking Mode for this package and trusting the network using the —trusted-host flag.
$ python -m pip install truststore [. ] $ python -m pip install SomePackage --use-feature=truststore [. ] Successfully installed SomePackage
$ python -m pip install truststore [. ] $ python -m pip install SomePackage --use-feature=truststore [. ] Successfully installed SomePackage
C:> py -m pip install truststore [. ] C:> py -m pip install SomePackage --use-feature=truststore [. ] Successfully installed SomePackage
When to use#
You should try using system trust stores when there is a custom certificate chain configured for your system that pip isn’t aware of. Typically, this situation will manifest with an SSLCertVerificationError with the message “certificate verify failed: unable to get local issuer certificate”:
$ python -m pip install -U SomePackage [. ] SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (\_ssl.c:997)'))) - skipping
$ python -m pip install -U SomePackage [. ] SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (\_ssl.c:997)'))) - skipping
C:> py -m pip install -U SomePackage [. ] SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (\_ssl.c:997)'))) - skipping
This error means that OpenSSL wasn’t able to find a trust anchor to verify the chain against. Using system trust stores instead of certifi will likely solve this issue.
If you encounter a TLS/SSL error when using the truststore feature you should open an issue on the truststore GitHub issue tracker instead of pip’s issue tracker. The maintainers of truststore will help diagnose and fix the issue.