aboutsummaryrefslogtreecommitdiffstats
path: root/docs/hazmat/backends/index.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/hazmat/backends/index.rst')
-rw-r--r--docs/hazmat/backends/index.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/hazmat/backends/index.rst b/docs/hazmat/backends/index.rst
new file mode 100644
index 00000000..a89cf0d5
--- /dev/null
+++ b/docs/hazmat/backends/index.rst
@@ -0,0 +1,34 @@
+.. hazmat::
+
+Bindings
+========
+
+.. toctree::
+ :maxdepth: 1
+
+ openssl
+ interfaces
+
+
+Getting a Backend Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. currentmodule:: cryptography.hazmat.backends
+
+``cryptography`` aims to support multiple backends to ensure it can provide
+the widest number of supported cryptographic algorithms as well as supporting
+platform specific implementations.
+
+You can get the default backend by calling
+:func:`~default_backend`.
+
+The default backend will change over time as we implement new backends and
+the libraries we use in those backends changes.
+
+
+.. function:: default_backend()
+
+ :returns: An object that provides at least
+ :class:`~interfaces.CipherBackend`, :class:`~interfaces.HashBackend`, and
+ :class:`~interfaces.HMACBackend`.
+