summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorChristian Heimes <christian@cheimes.de>2013-06-09 17:03:31 (GMT)
committerChristian Heimes <christian@cheimes.de>2013-06-09 17:03:31 (GMT)
commit46bebee25f8cdbec6bbee04fdf9681edf0155c5b (patch)
tree1efc519de6a189022c18f84d46c234fa48bf55ff /Doc
parent142ec2c0149995c8d2299eaf6eccec9c69d6110b (diff)
downloadcpython-46bebee25f8cdbec6bbee04fdf9681edf0155c5b.zip
cpython-46bebee25f8cdbec6bbee04fdf9681edf0155c5b.tar.gz
cpython-46bebee25f8cdbec6bbee04fdf9681edf0155c5b.tar.bz2
Issue #17134: Add ssl.enum_cert_store() as interface to Windows' cert store.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/ssl.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst
index 398169b..3816aca 100644
--- a/Doc/library/ssl.rst
+++ b/Doc/library/ssl.rst
@@ -359,6 +359,20 @@ Certificate handling
.. versionadded:: 3.4
+.. function:: enum_cert_store(store_name, cert_type='certificate')
+
+ Retrieve certificates from Windows' system cert store. *store_name* may be
+ one of ``CA``, ``ROOT`` or ``MY``. Windows may provide additional cert
+ stores, too. *cert_type* is either ``certificate`` for X.509 certificates
+ or ``crl`` for X.509 certificate revocation lists.
+
+ The function returns a list of (bytes, encoding_type) tuples. The
+ encoding_type flag can be interpreted with :const:`X509_ASN_ENCODING` or
+ :const:`PKCS_7_ASN_ENCODING`.
+
+ Availability: Windows.
+
+ .. versionadded:: 3.4
Constants
^^^^^^^^^
@@ -598,6 +612,15 @@ Constants
.. versionadded:: 3.4
+.. data:: X509_ASN_ENCODING
+ PKCS_7_ASN_ENCODING
+
+ Encoding flags for :func:`enum_cert_store`.
+
+ Availability: Windows.
+
+ .. versionadded:: 3.4
+
SSL Sockets
-----------