(phzSrSSKrSSKJr SSKrSSKrSSKJr SSK r SSK r SSK r SSK r SSK Jr SSKrSSKJr SSKJr SSKJr SSKJr SS KJr S rS rS rS rSrSr"SS\5rSrSr Sr!S04Sjr"\"SS55r#"SS\RHS9r%"SS\%5r&"SS\RN5r'g) a AWS Credentials and AWS Signature V4 Request Signer. This module provides credentials to access Google Cloud resources from Amazon Web Services (AWS) workloads. These credentials are recommended over the use of service account credentials in AWS as they do not involve the management of long-live service account private keys. AWS Credentials are initialized using external_account arguments which are typically loaded from the external credentials JSON file. This module also provides a definition for an abstract AWS security credentials supplier. This supplier can be implemented to return valid AWS security credentials and an AWS region and used to create AWS credentials. The credentials will then call the supplier instead of using pre-defined methods such as calling the EC2 metadata endpoints. This module also provides a basic implementation of the `AWS Signature Version 4`_ request signing algorithm. AWS Credentials use serialized signed requests to the `AWS STS GetCallerIdentity`_ API that can be exchanged for Google access tokens via the GCP STS endpoint. .. _AWS Signature Version 4: https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html .. _AWS STS GetCallerIdentity: https://docs.aws.amazon.com/STS/latest/APIReference/API_GetCallerIdentity.html N) dataclass)Optional)urljoin)_helpers)environment_vars) exceptions)external_accountzAWS4-HMAC-SHA256 aws4_requestzx-amz-security-tokenz x-amz-datezNhttps://sts.{region}.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15300c,\rSrSrSrSrS04SjrSrg) RequestSignerLzImplements an AWS request signer based on the AWS Signature Version 4 signing process. https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html cXlg)zInstantiates an AWS request signer used to compute authenticated signed requests to AWS APIs based on the AWS Signature Version 4 signing process. Args: region_name (str): The AWS region to use. N _region_name)self region_names B/var/www/html/venv/lib/python3.13/site-packages/google/auth/aws.py__init__RequestSigner.__init__Rs (c U=(d 0n[RRU5n[RR[U[R "UR 555nUR(aURS:wa[R"S5e[URUR =(d S[UR5UURUUUS9nURS5URS.n SU;aURS5U [ 'UH n XZX'M UR"bUR"U [$'X#U S.n U(aXKS 'U $) aGenerates the signed request for the provided HTTP request for calling an AWS API. This follows the steps described at: https://docs.aws.amazon.com/general/latest/gr/sigv4_signing.html Args: aws_security_credentials (AWSSecurityCredentials): The AWS security credentials. url (str): The AWS service URL containing the canonical URI and query string. method (str): The HTTP method used to call this API. request_payload (Optional[str]): The optional request payload if available. additional_headers (Optional[Mapping[str, str]]): The optional additional headers needed for the requested AWS API. Returns: Mapping[str, str]: The AWS signed request dictionary object. httpszInvalid AWS service URL/)host canonical_uricanonical_querystringmethodregionaws_security_credentialsrequest_payloadadditional_headersauthorization_header) Authorizationramz_dateurlrheadersdata)urllibparseurlparser posixpathnormpathpathhostnameschemerInvalidResource#_generate_authentication_header_map_get_canonical_querystringqueryrget_AWS_DATE_HEADER session_token_AWS_SECURITY_TOKEN_HEADER) rr!r(rr"r#urinormalized_uri header_mapr)keysigned_requests rget_request_options!RequestSigner.get_request_options\sA4052ll##C( .. C++CHH5 6 ||szzW4,,-FG G8(--4" quote_keyitem sorted_keysquerystring_encoded_pairss rr5r5s,,''.K LL&&s&8 -/*$D # . 5 5 ""4f"5 % *//1.3356K "+0D % , ,W^^C-F G1 88- ..rc[R"XRS5[R5R 5$)zCreates the HMAC-SHA256 hash of the provided message using the provided key. Args: key (str): The HMAC-SHA256 key to use. msg (str): The message to hash. Returns: str: The computed hash bytes. utf-8)hmacnewencodehashlibsha256digest)r>msgs r_signrcs+ 88CG,gnn = D D FFrc[SU-RS5U5n[XB5n[XS5n[US5nU$)aCalculates the signing key used to calculate the signature for AWS Signature Version 4 based on: https://docs.aws.amazon.com/general/latest/gr/sigv4-calculate-signature.html Args: key (str): The AWS secret access key. date_stamp (str): The '%Y%m%d' date format. region_name (str): The AWS region. service_name (str): The AWS service name, eg. sts. Returns: str: The signing key bytes. AWS4r[r )rcr^)r> date_stampr service_namek_datek_region k_service k_signings r_get_signing_keyrlsEFSL((1: >FV)Hh-Ii0I rrc lURS5Sn[R"5n U RS5n U RS5n 0n UHn X}XR 5'M UR bUR U [ 'X S'SU ;aX['Sn[U R55nUR5 UHn SRXX5nM S RU5n[R"U=(d SRS 55R!5nS RUUUUUU5nS RXU["5nS R[$U U[R"URS 55R!55n['UR(XU5n[*R,"UURS 5[R5R!5nSR[$UR.UUU5nSU0nSU ;aU US'U$)a?Generates the authentication header map needed for generating the AWS Signature Version 4 signed request. Args: host (str): The AWS service URL hostname. canonical_uri (str): The AWS service URL path name. canonical_querystring (str): The AWS service URL query string. method (str): The HTTP method used to call this API. region (str): The AWS region. aws_security_credentials (AWSSecurityCredentials): The AWS security credentials. request_payload (Optional[str]): The optional request payload if available. additional_headers (Optional[Mapping[str, str]]): The optional additional headers needed for the requested AWS API. Returns: Mapping[str, str]: The AWS authentication header dictionary object. This contains the x-amz-date and authorization header information. .rz%Y%m%dT%H%M%SZz%Y%m%drdaterz{}{}:{} ;r[z{} {} {} {} {} {}z {}/{}/{}/{}z {} {} {} {}z3{} Credential={}/{}, SignedHeaders={}, Signature={}r$r&)splitrutcnowstrftimelowerr9r:r8rPrQrOrRrSr_r`r^ hexdigest_AWS_REQUEST_TYPE_AWS_ALGORITHMrlsecret_access_keyr\r] access_key_id)rrrrr r!r"r#rg current_timer&rf full_headersr>canonical_headers header_keyssigned_headers payload_hashcanonical_requestcredential_scopestring_to_sign signing_key signaturer$authentication_headers rr4r4s>>::c?1%L??$L$$%56H&&x0JL!$6$; YY[!" --9 % 2 2  &   \!)1%&|((*+K'.. L$5 XXk*N>>?#8b"@"@"IJTTVL177 %++L*; &,,(//89CCE N# 22J K^**73W^^ik QWW .. 45IJ \!,4j)  rcB\rSrSr%Sr\\S'\\S'Sr\\\S'Sr g)AwsSecurityCredentialsi[ayA class that models AWS security credentials with an optional session token. Attributes: access_key_id (str): The AWS security credentials access key id. secret_access_key (str): The AWS security credentials secret access key. session_token (Optional[str]): The optional AWS security credentials session token. This should be set when using temporary credentials. ryrxNr9rH) rBrCrDrErFstr__annotations__r9rrGrHrrrr[s##'M8C='rrc`\rSrSrSr\R S5r\R S5rSr g)AwsSecurityCredentialsSupplierija7Base class for AWS security credential suppliers. This can be implemented with custom logic to retrieve AWS security credentials to exchange for a Google Cloud access token. The AWS external account credential does not cache the AWS security credentials, so caching logic should be added in the implementation. c[S5e)aReturns the AWS security credentials for the requested context. .. warning: This is not cached by the calling Google credential, so caching logic should be implemented in the supplier. Args: context (google.auth.externalaccount.SupplierContext): The context object containing information about the requested audience and subject token type. request (google.auth.transport.Request): The object used to make HTTP requests. Raises: google.auth.exceptions.RefreshError: If an error is encountered during security credential retrieval logic. Returns: AwsSecurityCredentials: The requested AWS security credentials. rNotImplementedErrorrcontextrequests rget_aws_security_credentials;AwsSecurityCredentialsSupplier.get_aws_security_credentialsps&""%%rc[S5e)aReturns the AWS region for the requested context. Args: context (google.auth.externalaccount.SupplierContext): The context object containing information about the requested audience and subject token type. request (google.auth.transport.Request): The object used to make HTTP requests. Raises: google.auth.exceptions.RefreshError: If an error is encountered during region retrieval logic. Returns: str: The AWS region. rrrs rget_aws_region-AwsSecurityCredentialsSupplier.get_aws_regions"""%%rrHN) rBrCrDrErFabcabstractmethodrrrGrHrrrrjs;  &&( &&rr) metaclassc\rSrSrSrSr\R"\5S5r \R"\5S5r Sr Sr Sr S rg ) &_DefaultAwsSecurityCredentialsSupplierizDefault implementation of AWS security credentials supplier. Supports retrieving credentials and region via EC2 metadata endpoints and environment variables. cURS5UlURS5UlURS5Ulg)N region_urlr(imdsv2_session_token_url)r7 _region_url_security_credentials_url_imdsv2_session_token_url)rcredential_sources rr/_DefaultAwsSecurityCredentialsSupplier.__init__s>,00>):)>)>u)E&):)>)> &* &rc [RR[R5n[RR[R 5n[RR[R 5nU(aU(a [X4U5$URU5nURX&5nURX'U5n[URS5URS5URS55$)N AccessKeyIdSecretAccessKeyToken) osenvironr7rAWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYAWS_SESSION_TOKENr_get_imdsv2_session_token_get_metadata_role_name"_get_metadata_security_credentials) rrrenv_aws_access_key_idenv_aws_secret_access_keyenv_aws_session_tokenimdsv2_session_token role_name credentialss rrC_DefaultAwsSecurityCredentialsSupplier.get_aws_security_credentialss !# /?/Q/Q R$&JJNN  2 2% !!# /?/Q/Q R %>)%BW  $==gF00O ==  4 & OOM * OO- . OOG $  rc[RR[R5nUbU$[RR[R 5nUbU$UR (d[R"S5eSnURU5nUbSU0nU"UR SUS9n[URS5(aURRS5O URnUR[R:wa%[R"SR!U55eUSS$) NzUnable to determine AWS regionX-aws-ec2-metadata-tokenGETr'decoder[z!Unable to retrieve AWS region: {})rrr7r AWS_REGIONAWS_DEFAULT_REGIONrr RefreshErrorrhasattrr*rstatus http_clientOKrR)rrrenv_aws_regionr)rresponse response_bodys rr5_DefaultAwsSecurityCredentialsSupplier.get_aws_regions (8(C(CD  %! !(8(K(KL  %! !))*JK K#==gF  +13GHGt//wO x}}h// MM  )  ??knn ,))3::=I  Sb!!rc UbURbsS[0nU"URSUS9nUR[R:wa/[ R "SRUR55eUR$g)Nz$X-aws-ec2-metadata-token-ttl-secondsPUTr'z(Unable to retrieve AWS Session Token: {}) r!_IMDSV2_SESSION_TOKEN_TTL_SECONDSrrrrrrRr*)rrr)imdsv2_session_token_responses rr@_DefaultAwsSecurityCredentialsSupplier._get_imdsv2_session_tokens  4#A#A#M68YG-4225'- )-33{~~E -->EE5:: 155 5rcSS0nUbX4S'U"SRURU5SUS9n[URS5(aURR S5O URnUR [ R:wa%[R"S RU55e[R"U5nU$) aRetrieves the AWS security credentials required for signing AWS requests from the AWS metadata server. Args: request (google.auth.transport.Request): A callable used to make HTTP requests. role_name (str): The AWS role name required by the AWS metadata server security_credentials endpoint in order to return the credentials. imdsv2_session_token (str): The AWS IMDSv2 session token to be added as a header in the requests to AWS metadata endpoint. Returns: Mapping[str, str]: The AWS metadata server security credentials response. Raises: google.auth.exceptions.RefreshError: If an error occurs while retrieving the AWS security credentials. z Content-Typezapplication/jsonrz{}/{}rr'rr[z/Unable to retrieve AWS security credentials: {}) rRrrr*rrrrrrjsonloads)rrrrr)rrcredentials_responses rrI_DefaultAwsSecurityCredentialsSupplier._get_metadata_security_credentialss."#56  +2F. /t==yI x}}h// MM  )  ??knn ,))AHHW  $zz-8##rcURc[R"S5eSnUbSU0nU"URSUS9n[URS5(aURR S5O URnUR [R:wa%[R"SRU55eU$) aRetrieves the AWS role currently attached to the current AWS workload by querying the AWS metadata server. This is needed for the AWS metadata server security credentials endpoint in order to retrieve the AWS security credentials needed to sign requests to AWS APIs. Args: request (google.auth.transport.Request): A callable used to make HTTP requests. imdsv2_session_token (str): The AWS IMDSv2 session token to be added as a header in the requests to AWS metadata endpoint. Returns: str: The AWS role name. Raises: google.auth.exceptions.RefreshError: If an error occurs while retrieving the AWS role name. NzIUnable to determine the AWS metadata server security credentials endpointrrr'rr[z#Unable to retrieve AWS role name {}) rrrrr*rrrrrR)rrrr)rrs rr>_DefaultAwsSecurityCredentialsSupplier._get_metadata_role_name0s&  ) ) 1))[   +13GHG..ug x}}h// MM  )  ??knn ,))5<<]K r)rrrN)rBrCrDrErFrrcopy_docstringrrrrrrrGrHrrrrs] ;< = :;<$"=$"L*/$b,rrc^\rSrSrSr\R SS4U4SjjrSrU4Sjr Sr U4Sjr \ U4S j5r \ U4S j5rS rU=r$) Credentialsi_zAWS external account credentials. This is used to exchange serialized AWS signature v4 signed requests to AWS STS GetCallerIdentity service for Google access tokens. Nc>[[U] "UUUUUS.UD6 UcUc[R"S5eUbUb[R"S5eU(aXPl[ UlOURS5=(d Sn[U5UlURS5Ul[R"SU5n U (aU R5upOS upU S :wd URc[R"S 5eU b[U 5S :wa%[R"S RU 55eXlSUlg)uInstantiates an AWS workload external account credentials object. Args: audience (str): The STS audience field. subject_token_type (str): The subject token type based on the Oauth2.0 token exchange spec. Expected values include:: “urn:ietf:params:aws:token-type:aws4_request” token_url (Optional [str]): The STS endpoint URL. If not provided, will default to "https://sts.googleapis.com/v1/token". credential_source (Optional [Mapping]): The credential source dictionary used to provide instructions on how to retrieve external credential to be exchanged for Google access tokens. Either a credential source or an AWS security credentials supplier must be provided. Example credential_source for AWS credential:: { "environment_id": "aws1", "regional_cred_verification_url": "https://sts.{region}.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15", "region_url": "http://169.254.169.254/latest/meta-data/placement/availability-zone", "url": "http://169.254.169.254/latest/meta-data/iam/security-credentials", imdsv2_session_token_url": "http://169.254.169.254/latest/api/token" } aws_security_credentials_supplier (Optional [AwsSecurityCredentialsSupplier]): Optional AWS security credentials supplier. This will be called to supply valid AWS security credentails which will then be exchanged for Google access tokens. Either an AWS security credentials supplier or a credential source must be provided. args (List): Optional positional arguments passed into the underlying :meth:`~external_account.Credentials.__init__` method. kwargs (Mapping): Optional keyword arguments passed into the underlying :meth:`~external_account.Credentials.__init__` method. Raises: google.auth.exceptions.RefreshError: If an error is encountered during access token retrieval logic. ValueError: For invalid parameters. .. note:: Typically one of the helper constructors :meth:`from_file` or :meth:`from_info` are used instead of calling the constructor directly. )audiencesubject_token_type token_urlrNzPA valid credential source or AWS security credentials supplier must be provided.z]AWS credential cannot have both a credential source and an AWS security credentials supplier.environment_idrregional_cred_verification_urlz^(aws)([\d]+)$)NNawsz)No valid AWS 'credential_source' providedz7aws version '{}' is not supported in the current build.)superrrr InvalidValue"_aws_security_credentials_supplier1_DEFAULT_AWS_REGIONAL_CREDENTIAL_VERIFICATION_URL_cred_verification_urlr7rrematchgroupsr3intrR_target_resource_request_signer) rrrrr!aws_security_credentials_supplierargskwargsrmatchesenv_id env_version __class__s rrCredentials.__init__esrd k4)  1/      $)J)R))b   )1=))o  -6W 3B  '/223CDJN6\!7D 3+<*?*?0+D ' hh0.AG&-nn&6# &2#$"="="E 00?$K(8A(= --MTT# !)#rcURcEURRURU5Ul[ UR5UlURR URU5nURRUURRSUR5S5nURS5nURUS'0nURS5US'URS5US'/US'UR5HnUSRXdUS.5 M [RR!["R$"USS S 95$) aRetrieves the subject token using the credential_source object. The subject token is a serialized `AWS GetCallerIdentity signed request`_. The logic is summarized as: Retrieve the AWS region from the AWS_REGION or AWS_DEFAULT_REGION environment variable or from the AWS metadata server availability-zone if not found in the environment variable. Check AWS credentials in environment variables. If not found, retrieve from the AWS metadata server security-credentials endpoint. When retrieving AWS credentials from the metadata server security-credentials endpoint, the AWS role needs to be determined by calling the security-credentials endpoint without any argument. Then the credentials can be retrieved via: security-credentials/role_name Generate the signed request to AWS STS GetCallerIdentity action. Inject x-goog-cloud-target-resource into header and serialize the signed request. This will be the subject-token to pass to GCP STS. .. _AWS GetCallerIdentity signed request: https://cloud.google.com/iam/docs/access-resources-aws#exchange-token Args: request (google.auth.transport.Request): A callable used to make HTTP requests. Returns: str: The retrieved subject token. z{region}POSTr)zx-goog-cloud-target-resourcer(r)r>value),:T) separators sort_keys)rrr_supplier_context_regionr rr@rreplacer7rrQrNr+r,rMrdumps)rrr!request_optionsrequest_headersaws_signed_reqr>s rretrieve_subject_token"Credentials.retrieve_subject_tokens]F    'BBQQ&&DL$1#>D $(#J#J#g#g  " "G$  ..BB $  ' ' / / DLL I  "*--i8 ;?:O:O67 / 3 3E :u#2#6#6x#@x $&y!"'')C 9 % , ,c&:; * ||!! JJ~* M  rcj>[[U] 5nSUS'UR5(aSUS'U$)Nrsource programmatic)rr_create_default_metrics_options_has_custom_supplier)rmetrics_optionsrs rr+Credentials._create_default_metrics_options&s; TRT$)!  $ $ & &(6OH %rcURSL$)N)_credential_source)rs rr Credentials._has_custom_supplier-s&&$..rc>[[U] 5nUR5(aUR SUR 05 U$)Nr)rr_constructor_argsrupdater)rrrs rr Credentials._constructor_args0sD[$9;  $ $ & & KK79`9`   rc v>URS5nURSU05 [[U]"U40UD6$)aZCreates an AWS Credentials instance from parsed external account info. Args: info (Mapping[str, str]): The AWS external account info in Google format. kwargs: Additional arguments to pass to the constructor. Returns: google.auth.aws.Credentials: The constructed credentials. Raises: ValueError: For invalid parameters. r)r7r rr from_info)clsinforrrs rrCredentials.from_info;sG-1HH /- )  02S T [#0@@@rc .>[[U] "U40UD6$)aCreates an AWS Credentials instance from an external account json file. Args: filename (str): The path to the AWS external account json file. kwargs: Additional arguments to pass to the constructor. Returns: google.auth.aws.Credentials: The constructed credentials. )rr from_file)rfilenamerrs rrCredentials.from_fileRs[#0DVDDr)rrrrr)rBrCrDrErFr _DEFAULT_TOKEN_URLrrrrr  classmethodrrrG __classcell__)rs@rrr_sb#55*. h$TU n/ AA, E Err)(rFr dataclassesrr_r\ http.clientclientrrrr.rtypingrr+ urllib.parser google.authrrrr rwrvr:r8rrobjectr r5rcrlr4rABCMetarrrrHrrr#s4 ! !   ("($#3U2%*!SFSl!/H G8o!d  ( (  (,&s{{,&^C-KCL~E"..~Er