| Index: client/third_party/google/auth/app_engine.py
|
| diff --git a/client/third_party/google/auth/app_engine.py b/client/third_party/google/auth/app_engine.py
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..6dc871256ba1e7462190db8d7b3d22c8aa913239
|
| --- /dev/null
|
| +++ b/client/third_party/google/auth/app_engine.py
|
| @@ -0,0 +1,154 @@
|
| +# Copyright 2016 Google Inc.
|
| +#
|
| +# Licensed under the Apache License, Version 2.0 (the "License");
|
| +# you may not use this file except in compliance with the License.
|
| +# You may obtain a copy of the License at
|
| +#
|
| +# http://www.apache.org/licenses/LICENSE-2.0
|
| +#
|
| +# Unless required by applicable law or agreed to in writing, software
|
| +# distributed under the License is distributed on an "AS IS" BASIS,
|
| +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| +# See the License for the specific language governing permissions and
|
| +# limitations under the License.
|
| +
|
| +"""Google App Engine standard environment support.
|
| +
|
| +This module provides authentication and signing for applications running on App
|
| +Engine in the standard environment using the `App Identity API`_.
|
| +
|
| +
|
| +.. _App Identity API:
|
| + https://cloud.google.com/appengine/docs/python/appidentity/
|
| +"""
|
| +
|
| +import datetime
|
| +
|
| +from google.auth import _helpers
|
| +from google.auth import credentials
|
| +from google.auth import crypt
|
| +
|
| +try:
|
| + from google.appengine.api import app_identity
|
| +except ImportError:
|
| + app_identity = None
|
| +
|
| +
|
| +class Signer(crypt.Signer):
|
| + """Signs messages using the App Engine App Identity service.
|
| +
|
| + This can be used in place of :class:`google.auth.crypt.Signer` when
|
| + running in the App Engine standard environment.
|
| + """
|
| +
|
| + @property
|
| + def key_id(self):
|
| + """Optional[str]: The key ID used to identify this private key.
|
| +
|
| + .. warning::
|
| + This is always ``None``. The key ID used by App Engine can not
|
| + be reliably determined ahead of time.
|
| + """
|
| + return None
|
| +
|
| + @_helpers.copy_docstring(crypt.Signer)
|
| + def sign(self, message):
|
| + message = _helpers.to_bytes(message)
|
| + _, signature = app_identity.sign_blob(message)
|
| + return signature
|
| +
|
| +
|
| +def get_project_id():
|
| + """Gets the project ID for the current App Engine application.
|
| +
|
| + Returns:
|
| + str: The project ID
|
| +
|
| + Raises:
|
| + EnvironmentError: If the App Engine APIs are unavailable.
|
| + """
|
| + # pylint: disable=missing-raises-doc
|
| + # Pylint rightfully thinks EnvironmentError is OSError, but doesn't
|
| + # realize it's a valid alias.
|
| + if app_identity is None:
|
| + raise EnvironmentError(
|
| + 'The App Engine APIs are not available.')
|
| + return app_identity.get_application_id()
|
| +
|
| +
|
| +class Credentials(credentials.Scoped, credentials.Signing,
|
| + credentials.Credentials):
|
| + """App Engine standard environment credentials.
|
| +
|
| + These credentials use the App Engine App Identity API to obtain access
|
| + tokens.
|
| + """
|
| +
|
| + def __init__(self, scopes=None, service_account_id=None):
|
| + """
|
| + Args:
|
| + scopes (Sequence[str]): Scopes to request from the App Identity
|
| + API.
|
| + service_account_id (str): The service account ID passed into
|
| + :func:`google.appengine.api.app_identity.get_access_token`.
|
| + If not specified, the default application service account
|
| + ID will be used.
|
| +
|
| + Raises:
|
| + EnvironmentError: If the App Engine APIs are unavailable.
|
| + """
|
| + # pylint: disable=missing-raises-doc
|
| + # Pylint rightfully thinks EnvironmentError is OSError, but doesn't
|
| + # realize it's a valid alias.
|
| + if app_identity is None:
|
| + raise EnvironmentError(
|
| + 'The App Engine APIs are not available.')
|
| +
|
| + super(Credentials, self).__init__()
|
| + self._scopes = scopes
|
| + self._service_account_id = service_account_id
|
| + self._signer = Signer()
|
| +
|
| + @_helpers.copy_docstring(credentials.Credentials)
|
| + def refresh(self, request):
|
| + # pylint: disable=unused-argument
|
| + token, ttl = app_identity.get_access_token(
|
| + self._scopes, self._service_account_id)
|
| + expiry = _helpers.utcnow() + datetime.timedelta(seconds=ttl)
|
| +
|
| + self.token, self.expiry = token, expiry
|
| +
|
| + @property
|
| + def service_account_email(self):
|
| + """The service account email."""
|
| + if self._service_account_id is None:
|
| + self._service_account_id = app_identity.get_service_account_name()
|
| + return self._service_account_id
|
| +
|
| + @property
|
| + def requires_scopes(self):
|
| + """Checks if the credentials requires scopes.
|
| +
|
| + Returns:
|
| + bool: True if there are no scopes set otherwise False.
|
| + """
|
| + return not self._scopes
|
| +
|
| + @_helpers.copy_docstring(credentials.Scoped)
|
| + def with_scopes(self, scopes):
|
| + return Credentials(
|
| + scopes=scopes, service_account_id=self._service_account_id)
|
| +
|
| + @_helpers.copy_docstring(credentials.Signing)
|
| + def sign_bytes(self, message):
|
| + return self._signer.sign(message)
|
| +
|
| + @property
|
| + @_helpers.copy_docstring(credentials.Signing)
|
| + def signer_email(self):
|
| + return self.service_account_email
|
| +
|
| + @property
|
| + @_helpers.copy_docstring(credentials.Signing)
|
| + def signer(self):
|
| + return self._signer
|
|
|