Add PKCS#12 support to the requests library in a clean way, without monkey patching or temporary files
Project description
This library adds PKCS#12 support to the Python requests library.
It is a clean implementation: it uses neither monkey patching nor temporary files. Instead, it is integrated into requests as recommended by its authors: creating a custom TransportAdapter, which provides a custom SSLContext.
This library is meant to be a transitional solution until this functionality is provided by requests directly. However, that will take some time. See the corresponding issue for more details.
Usage
For simple one-off requests you can use this library as a drop-in replacement for the requests library:
from requests_pkcs12 import get
r = get('https://example.com/test', pkcs12_filename='clientcert.p12', pkcs12_password='correcthorsebatterystaple')
If you are using requests sessions, use the Pkcs12Adapter:
from requests import Session
from requests_pkcs12 import Pkcs12Adapter
with Session() as s:
s.mount('https://example.com', Pkcs12Adapter(pkcs12_filename='clientcert.p12', pkcs12_password='correcthorsebatterystaple'))
r = s.get('https://example.com/test')
Installation
This library is available as PyPI package:
pip install requests-pkcs12
Alternatively, you can retrieve the latest development version via Git:
git clone https://github.com/m-click/requests_pkcs12
Arguments
The following keyword arguments are supported:
pkcs12_filename is a byte string or unicode string that contains the file name of the encrypted PKCS#12 certificate.
Either this argument or pkcs12_data must be provided.
pkcs12_data is a byte string that contains the encrypted PKCS#12 certificate data.
Either this argument or pkcs12_filename must be provided.
pkcs12_password is a byte string or unicode string that contains the password.
This argument must be provided whenever pkcs12_filename or pkcs12_data is provided.
If you use these parameters, don’t use the built-in cert parameter of requests at the same time. However, do use the other parameters. In particular, do use the “verify” parameter to verify the server-side certificate.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for requests_pkcs12-1.9-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9d902cd077967311ce96d6606b3cf90788608b08edc831b4821891c651ac87b9 |
|
MD5 | 25530895ea8141b29fc4fccaa6c6cecf |
|
BLAKE2b-256 | c9be605fa4e2371649680f3e6e96f392cfd52c7f49be620944caca53ebeb04b8 |