Auth Helpers for Asyncio Google Cloud Library
Project description
This library is not meant to be a standalone project, rather it is used by various gcloud-aio-* packages.
This library implements a Token class, which is used for authorizing against Google Cloud. The other gcloud-aio-* package components accept a Token instance as an argument; you can define a single token for all of these components or define one for each. Each component corresponds to a given Google Cloud service and each service requires “scopes”.
Installation
$ pip install --upgrade gcloud-aio-auth
Usage
from gcloud.aio.auth import Token
token = Token()
Additionally, the Token constructor accepts the following optional arguments:
service_file: path to a service account, authorized user file, or any other application credentials. If omitted, will attempt to find one on your path or fallback to generating a token from GCE metadata.
session: an aiohttp.ClientSession instance to be used for all requests. If omitted, a default session will be created.
scopes: an optional list of GCP scopes for which to generate our token. Only valid (and required!) for service account authentication.
CLI
This project can also be used to help you manually authenticate to test GCP routes, eg. we can list our project’s uptime checks with a tool such as curl:
# using default application credentials
curl \
-H "Authorization: Bearer $(python3 -c 'import asyncio; from gcloud.aio.auth import Token; print(asyncio.run(Token().get()))')" \
"https://monitoring.googleapis.com/v3/projects/PROJECT_ID/uptimeCheckConfigs"
# using a service account (make sure to provide a scope!)
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service.json
curl \
-H "Authorization: Bearer $(python3 -c 'import asyncio; from gcloud.aio.auth import Token; print(asyncio.run(Token(scopes=["'"https://www.googleapis.com/auth/cloud-platform"'"]).get()))')" \
"https://monitoring.googleapis.com/v3/projects/PROJECT_ID/uptimeCheckConfigs"
# using legacy account credentials
export GOOGLE_APPLICATION_CREDENTIALS=~/.config/gcloud/legacy_credentials/EMAIL@DOMAIN.TLD/adc.json
curl \
-H "Authorization: Bearer $(python3 -c 'import asyncio; from gcloud.aio.auth import Token; print(asyncio.run(Token().get()))')" \
"https://monitoring.googleapis.com/v3/projects/PROJECT_ID/uptimeCheckConfigs"
Contributing
Please see our contributing guide.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file gcloud-aio-auth-2.1.1.tar.gz
.
File metadata
- Download URL: gcloud-aio-auth-2.1.1.tar.gz
- Upload date:
- Size: 8.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.4.3 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 54bac8b135dcb3c9572fc58ea7a034e5504f5211db7d9de20791b3c0ae2bb7d3 |
|
MD5 | be09d88de119748add7e57b25dbe9bf8 |
|
BLAKE2b-256 | 5290f69b7b19e11ae664b771ebe4ef9a9501d4360f4e4d145c3600ffd777d0f0 |
File details
Details for the file gcloud_aio_auth-2.1.1-py2.py3-none-any.whl
.
File metadata
- Download URL: gcloud_aio_auth-2.1.1-py2.py3-none-any.whl
- Upload date:
- Size: 11.5 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.4.3 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2877be8ce30f32001b44d87919930c4c0d2250519301cc7889da9a9da011cafd |
|
MD5 | 9746969d83172708f29d4164d6efb470 |
|
BLAKE2b-256 | b175755f3843e2aef9e52479f90b659a6788f2187b6645133bb54b962364378f |