aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorAndre Caron <andre.l.caron@gmail.com>2015-05-18 13:53:43 -0400
committerIan Cordasco <graffatcolmingov@gmail.com>2015-06-24 13:35:48 -0500
commit0ef595f1d9b5336872dc24d7d67c8cd127b31cea (patch)
tree70f497d2583b45840811f16f2c2a7f1667489e73 /docs
parent77c98e3c4ef69d0cfee665cd0835670f4ac44242 (diff)
downloadcryptography-0ef595f1d9b5336872dc24d7d67c8cd127b31cea.tar.gz
cryptography-0ef595f1d9b5336872dc24d7d67c8cd127b31cea.tar.bz2
cryptography-0ef595f1d9b5336872dc24d7d67c8cd127b31cea.zip
Adds CSR builder.
Diffstat (limited to 'docs')
-rw-r--r--docs/x509.rst41
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/x509.rst b/docs/x509.rst
index b8e3c8ee..8507edc1 100644
--- a/docs/x509.rst
+++ b/docs/x509.rst
@@ -468,6 +468,47 @@ X.509 Revoked Certificate Object
The extensions encoded in the revoked certificate.
+X.509 CSR (Certificate Signing Request) Builder Object
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. class:: CertificateSigningRequestBuilder
+
+ .. method:: __init__()
+
+ Creates an empty certificate signing request.
+
+ .. method:: set_version(version)
+
+ :param version: The :class:`Version` of the X.509 protocol.
+
+ .. method:: set_subject_name(name)
+
+ :param name: The :class:`Name` of the certificate subject.
+
+ .. method:: add_extension(extension)
+
+ :param extension: The :class:`Extension` to add to the request.
+
+ .. method:: sign(backend, private_key, algorithm)
+
+ :param backend: Backend that will be used to sign the request.
+ Must support the
+ :class:`~cryptography.hazmat.backends.interfaces.X509Backend`
+ interface.
+
+ :param private_key: The
+ :class:`~cryptography.hazmat.primitives.asymmetric.rsa.RSAPrivateKey`
+ that will be used to sign the request. When the request is
+ signed by a certificate authority, the private key's associated
+ public key will be stored in the resulting certificate.
+
+ :param algorithm: The
+ :class:`~cryptography.hazmat.primitives.hashes.HashAlgorithm`
+ that will be used to generate the request signature.
+
+ :type: :class:`CertificateSigningRequest`
+
+
.. class:: Name
.. versionadded:: 0.8