blob: af2c8045912fab22763fe284fad4cf365db191f5 [file] [log] [blame]
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -08001google-auth
2===========
Jon Wayne Parrott377f2932016-10-04 10:20:36 -07003
4.. toctree::
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -08005 :hidden:
Jon Wayne Parrott377f2932016-10-04 10:20:36 -07006 :maxdepth: 2
7
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -08008 user-guide
9 Reference <reference/modules>
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070010
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080011google-auth is the Google authentication library for Python. This library
12provides the ability to authenticate to Google APIs using various methods. It
13also provides integration with several HTTP libraries.
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070014
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080015- Support for Google :func:`Application Default Credentials <google.auth.default>`.
16- Support for signing and verifying :mod:`JWTs <google.auth.jwt>`.
Arlan Jaska4255b102018-02-08 15:51:26 -080017- Support for verifying and decoding :mod:`ID Tokens <google.oauth2.id_token>`.
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080018- Support for Google :mod:`Service Account credentials <google.oauth2.service_account>`.
19- Support for :mod:`Google Compute Engine credentials <google.auth.compute_engine>`.
20- Support for :mod:`Google App Engine standard credentials <google.auth.app_engine>`.
21- Support for various transports, including
22 :mod:`Requests <google.auth.transport.requests>`,
23 :mod:`urllib3 <google.auth.transport.urllib3>`, and
24 :mod:`gRPC <google.auth.transport.grpc>`.
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070025
Jon Wayne Parrottcf934812017-06-07 09:47:18 -070026.. note:: ``oauth2client`` was recently deprecated in favor of this library. For more details on the deprecation, see :doc:`oauth2client-deprecation`.
27
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080028Installing
29----------
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070030
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080031google-auth can be installed with `pip`_::
Jon Wayne Parrott377f2932016-10-04 10:20:36 -070032
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080033 $ pip install --upgrade google-auth
34
35google-auth is open-source, so you can alternatively grab the source code from
36`GitHub`_ and install from source.
37
michaelawyuddf3cec2017-10-13 10:20:44 -070038
39For more information on setting up your Python development environment, please refer to `Python Development Environment Setup Guide`_ for Google Cloud Platform.
40
41.. _`Python Development Environment Setup Guide`: https://cloud.google.com/python/setup
Jon Wayne Parrott53c7b172016-11-10 10:44:30 -080042.. _pip: https://pip.pypa.io
43.. _GitHub: https://github.com/GoogleCloudPlatform/google-auth-library-python
44
45Usage
46-----
47
48The :doc:`user-guide` is the place to go to learn how to use the library and
49accomplish common tasks.
50
51The :doc:`Module Reference <reference/modules>` documentation provides API-level documentation.
52
53License
54-------
55
56google-auth is made available under the Apache License, Version 2.0. For more
57details, see `LICENSE`_
58
59.. _LICENSE:
60 https://github.com/GoogleCloudPlatform/google-auth-library-python/LICENSE
61
62Contributing
63------------
64
65We happily welcome contributions, please see our `contributing`_ documentation
66for details.
67
68.. _contributing:
69 https://github.com/GoogleCloudPlatform/google-auth-library-python/CONTRIBUTING.rst