ACIL FM

Nama	Ukuran	Aksi
development	-	Open
hazmat	-	Open
x509	-	Open
_ext	-	Open
_static	-	Open
api-stability.rst	2.93 MB	View DL Edit
changelog.rst	30 B	View DL Edit
community.rst	589 B	View DL Edit
conf.py	6.17 MB	View DL Edit
doing-a-release.rst	3.71 MB	View DL Edit
exceptions.rst	853 B	View DL Edit
faq.rst	9.79 MB	View DL Edit
fernet.rst	11.33 MB	View DL Edit
glossary.rst	4.62 MB	View DL Edit
index.rst	2.64 MB	View DL Edit
installation.rst	11.71 MB	View DL Edit
limitations.rst	2.12 MB	View DL Edit
make.bat	4.99 MB	View DL Edit
Makefile	5.46 MB	View DL Edit
openssl.rst	4.6 MB	View DL Edit
random-numbers.rst	1.55 MB	View DL Edit
security.rst	3.51 MB	View DL Edit
spelling_wordlist.txt	1.22 MB	View DL Edit

Edit file: /usr/share/doc/python3-cryptography/docs/index.rst

Welcome to ``pyca/cryptography``
================================

``cryptography`` includes both high level recipes and low level interfaces to
common cryptographic algorithms such as symmetric ciphers, message digests, and
key derivation functions. For example, to encrypt something with
``cryptography``'s high level symmetric encryption recipe:

.. code-block:: pycon

>>> from cryptography.fernet import Fernet
    >>> # Put this somewhere safe!
    >>> key = Fernet.generate_key()
    >>> f = Fernet(key)
    >>> token = f.encrypt(b"A really secret message. Not for prying eyes.")
    >>> token
    b'...'
    >>> f.decrypt(token)
    b'A really secret message. Not for prying eyes.'

If you are interested in learning more about the field of cryptography, we
recommend `Crypto 101, by Laurens Van Houtven`_ and `The Cryptopals Crypto
Challenges`_.

Installation
------------
You can install ``cryptography`` with ``pip``:

.. code-block:: console

$ pip install cryptography

See :doc:`Installation <installation>` for more information.

.. _cryptography-layout:

Layout
------

``cryptography`` is broadly divided into two levels. One with safe
cryptographic recipes that require little to no configuration choices. These
are safe and easy to use and don't require developers to make many decisions.

The other level is low-level cryptographic primitives. These are often
dangerous and can be used incorrectly. They require making decisions and having
an in-depth knowledge of the cryptographic concepts at work. Because of the
potential danger in working at this level, this is referred to as the
"hazardous materials" or "hazmat" layer. These live in the
``cryptography.hazmat`` package, and their documentation will always contain an
admonition at the top.

We recommend using the recipes layer whenever possible, and falling back to the
hazmat layer only when necessary.

.. toctree::
    :maxdepth: 2
    :caption: The recipes layer

fernet
    x509/index

.. toctree::
    :maxdepth: 2
    :caption: The hazardous materials layer

hazmat/primitives/index
    exceptions
    random-numbers

.. toctree::
    :maxdepth: 2
    :caption: The cryptography open source project

installation
    changelog
    faq
    development/index
    openssl
    security
    limitations
    api-stability
    doing-a-release
    community
    glossary

.. note::

``cryptography`` has not been subjected to an external audit of its code or
    documentation. If you're interested in discussing an audit please
    :doc:`get in touch </community>`.

.. _`Crypto 101, by Laurens Van Houtven`: https://www.crypto101.io/
.. _`The Cryptopals Crypto Challenges`: https://cryptopals.com/

Batal