# Copyright 2017 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.

"""ECDSA verifier and signer that use the ``cryptography`` library.

"""

from dataclasses import dataclass

from typing import Any, Dict, Optional, Union

import cryptography.exceptions

from cryptography.hazmat import backends

from cryptography.hazmat.primitives import hashes

from cryptography.hazmat.primitives import serialization

from cryptography.hazmat.primitives.asymmetric import ec

from cryptography.hazmat.primitives.asymmetric import padding

from cryptography.hazmat.primitives.asymmetric.utils import decode_dss_signature

from cryptography.hazmat.primitives.asymmetric.utils import encode_dss_signature

import cryptography.x509

from google.auth import _helpers

from google.auth.crypt import base

_CERTIFICATE_MARKER = b"-----BEGIN CERTIFICATE-----"

_BACKEND = backends.default_backend()

_PADDING = padding.PKCS1v15()

@dataclass

class _ESAttributes:

"""A class that models ECDSA attributes.

Attributes:

rs_size (int): Size for ASN.1 r and s size.

sha_algo (hashes.HashAlgorithm): Hash algorithm.

algorithm (str): Algorithm name.

"""

rs_size: int

sha_algo: hashes.HashAlgorithm

algorithm: str

@classmethod

def from_key(

cls, key: Union[ec.EllipticCurvePublicKey, ec.EllipticCurvePrivateKey]

):

return cls.from_curve(key.curve)

@classmethod

def from_curve(cls, curve: ec.EllipticCurve):

# ECDSA raw signature has (r||s) format where r,s are two

# integers of size 32 bytes for P-256 curve and 48 bytes

# for P-384 curve. For P-256 curve, we use SHA256 hash algo,

# and for P-384 curve we use SHA384 algo.

if isinstance(curve, ec.SECP384R1):

return cls(48, hashes.SHA384(), "ES384")

else:

# default to ES256

return cls(32, hashes.SHA256(), "ES256")

class EsVerifier(base.Verifier):

"""Verifies ECDSA cryptographic signatures using public keys.

Args:

public_key (

cryptography.hazmat.primitives.asymmetric.ec.EllipticCurvePublicKey):

The public key used to verify signatures.

"""

def __init__(self, public_key: ec.EllipticCurvePublicKey) -> None:

self._pubkey = public_key

self._attributes = _ESAttributes.from_key(public_key)

@_helpers.copy_docstring(base.Verifier)

def verify(self, message: bytes, signature: bytes) -> bool:

# First convert (r||s) raw signature to ASN1 encoded signature.

sig_bytes = _helpers.to_bytes(signature)

if len(sig_bytes) != self._attributes.rs_size * 2:

return False

r = int.from_bytes(sig_bytes[: self._attributes.rs_size], byteorder="big")

s = int.from_bytes(sig_bytes[self._attributes.rs_size :], byteorder="big")

asn1_sig = encode_dss_signature(r, s)

message = _helpers.to_bytes(message)

try:

self._pubkey.verify(asn1_sig, message, ec.ECDSA(self._attributes.sha_algo))

return True

except (ValueError, cryptography.exceptions.InvalidSignature):

return False

@classmethod

def from_string(cls, public_key: Union[str, bytes]) -> "EsVerifier":

"""Construct an Verifier instance from a public key or public

certificate string.

Args:

public_key (Union[str, bytes]): The public key in PEM format or the

x509 public key certificate.

Returns:

Verifier: The constructed verifier.

Raises:

ValueError: If the public key can't be parsed.

"""

public_key_data = _helpers.to_bytes(public_key)

if _CERTIFICATE_MARKER in public_key_data:

cert = cryptography.x509.load_pem_x509_certificate(

public_key_data, _BACKEND

)

pubkey = cert.public_key() # type: Any

else:

pubkey = serialization.load_pem_public_key(public_key_data, _BACKEND)

if not isinstance(pubkey, ec.EllipticCurvePublicKey):

raise TypeError("Expected public key of type EllipticCurvePublicKey")

return cls(pubkey)

class EsSigner(base.Signer, base.FromServiceAccountMixin):

"""Signs messages with an ECDSA private key.

Args:

private_key (

cryptography.hazmat.primitives.asymmetric.ec.EllipticCurvePrivateKey):

The private key to sign with.

key_id (str): Optional key ID used to identify this private key. This

can be useful to associate the private key with its associated

public key or certificate.

"""

def __init__(

self, private_key: ec.EllipticCurvePrivateKey, key_id: Optional[str] = None

) -> None:

self._key = private_key

self._key_id = key_id

self._attributes = _ESAttributes.from_key(private_key)

@property

def algorithm(self) -> str:

"""Name of the algorithm used to sign messages.

Returns:

str: The algorithm name.

"""

return self._attributes.algorithm

@property # type: ignore

@_helpers.copy_docstring(base.Signer)

def key_id(self) -> Optional[str]:

return self._key_id

@_helpers.copy_docstring(base.Signer)

def sign(self, message: bytes) -> bytes:

message = _helpers.to_bytes(message)

asn1_signature = self._key.sign(message, ec.ECDSA(self._attributes.sha_algo))

# Convert ASN1 encoded signature to (r||s) raw signature.

(r, s) = decode_dss_signature(asn1_signature)

return r.to_bytes(self._attributes.rs_size, byteorder="big") + s.to_bytes(

self._attributes.rs_size, byteorder="big"

)

@classmethod

def from_string(

cls, key: Union[bytes, str], key_id: Optional[str] = None

) -> "EsSigner":

"""Construct a RSASigner from a private key in PEM format.

Args:

key (Union[bytes, str]): Private key in PEM format.

key_id (str): An optional key id used to identify the private key.

Returns:

google.auth.crypt._cryptography_rsa.RSASigner: The

constructed signer.

Raises:

ValueError: If ``key`` is not ``bytes`` or ``str`` (unicode).

UnicodeDecodeError: If ``key`` is ``bytes`` but cannot be decoded

into a UTF-8 ``str``.

ValueError: If ``cryptography`` "Could not deserialize key data."

"""

key_bytes = _helpers.to_bytes(key)

private_key = serialization.load_pem_private_key(

key_bytes, password=None, backend=_BACKEND

)

if not isinstance(private_key, ec.EllipticCurvePrivateKey):

raise TypeError("Expected private key of type EllipticCurvePrivateKey")

return cls(private_key, key_id=key_id)

def __getstate__(self) -> Dict[str, Any]:

"""Pickle helper that serializes the _key attribute."""

state = self.__dict__.copy()

state["_key"] = self._key.private_bytes(

encoding=serialization.Encoding.PEM,

format=serialization.PrivateFormat.PKCS8,

encryption_algorithm=serialization.NoEncryption(),

)

return state

def __setstate__(self, state: Dict[str, Any]) -> None:

"""Pickle helper that deserializes the _key attribute."""

state["_key"] = serialization.load_pem_private_key(state["_key"], None)

self.__dict__.update(state)