aws-sdk-paymentcryptographydata 1.8.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d246f10d283f4f8857b8bfbe662357345223b14850138a60fc1c6cebd957522
-  data.tar.gz: a9a377a805c22c02fb302b3680c86d585117c2514f511a29a723c9a9c33206d7
+  metadata.gz: 6126989706af46778cf434cc347a8c7d3612827a1001706d0e213e05d5cd9612
+  data.tar.gz: a8a99a810c24b25b8ba1b9f30b7fc03d295cb426c41ff77e207dfe888a3654b9
 SHA512:
-  metadata.gz: 739f357152f8f65838bb76ad63be89705143827b640d203e7ff3f03c199e9e404e763713aa912fa5d201d00ecb54b0574202964140ecbfbdeb528134c828f812
-  data.tar.gz: 8b12c6514700ff200a93c37683d5d989f6aa041adc50015963ef4388a65da42d6c2ced1411464b2338e456f99c63427259e059c4bca47ea8d1a20c03e705bf7b
+  metadata.gz: 1c69e8560dd194bdfaf4d56ae5ffaaeb3b00fd4a79531eae91657eb4d8095c469d9bb8ec5b19820ce97c8c179abc57351f132fa829bb9ff336c6a5664eadade1
+  data.tar.gz: d274c07082e1aa888f464d77ab4aa465a6a479a276b07537752850fa537d2601994e2a383974a57d80ca1f3605f9e6beaacf910df91f8252dab7c11380ad41dd

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.10.0 (2024-03-07)
+------------------
+
+* Feature - AWS Payment Cryptography EMV Decrypt Feature  Release
+
+1.9.0 (2024-01-26)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.8.0 (2023-11-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.8.0
+1.10.0

data/lib/aws-sdk-paymentcryptographydata/client.rb

@@ -388,9 +388,10 @@ module Aws::PaymentCryptographyData
 
     # @!group API Operations
 
-    # Decrypts ciphertext data to plaintext using symmetric, asymmetric, or
-    # DUKPT data encryption key. For more information, see [Decrypt data][1]
-    # in the *Amazon Web Services Payment Cryptography User Guide*.
+    # Decrypts ciphertext data to plaintext using a symmetric (TDES, AES),
+    # asymmetric (RSA), or derived (DUKPT or EMV) encryption key scheme. For
+    # more information, see [Decrypt data][1] in the *Amazon Web Services
+    # Payment Cryptography User Guide*.
     #
     # You can use an encryption key generated within Amazon Web Services
     # Payment Cryptography, or you can import your own encryption key by
@@ -403,11 +404,15 @@ module Aws::PaymentCryptographyData
     # [GetPublicCertificate][3].
     #
     # For symmetric and DUKPT decryption, Amazon Web Services Payment
-    # Cryptography supports `TDES` and `AES` algorithms. For asymmetric
-    # decryption, Amazon Web Services Payment Cryptography supports `RSA`.
-    # When you use DUKPT, for `TDES` algorithm, the ciphertext data length
-    # must be a multiple of 16 bytes. For `AES` algorithm, the ciphertext
-    # data length must be a multiple of 32 bytes.
+    # Cryptography supports `TDES` and `AES` algorithms. For EMV decryption,
+    # Amazon Web Services Payment Cryptography supports `TDES` algorithms.
+    # For asymmetric decryption, Amazon Web Services Payment Cryptography
+    # supports `RSA`.
+    #
+    # When you use TDES or TDES DUKPT, the ciphertext data length must be a
+    # multiple of 8 bytes. For AES or AES DUKPT, the ciphertext data length
+    # must be a multiple of 16 bytes. For RSA, it sould be equal to the key
+    # size unless padding is enabled.
     #
     # For information about valid keys for this operation, see
     # [Understanding key attributes][4] and [Key types for specific data
@@ -464,6 +469,14 @@ module Aws::PaymentCryptographyData
     #         key_serial_number: "HexLengthBetween10And24", # required
     #         mode: "ECB", # accepts ECB, CBC
     #       },
+    #       emv: {
+    #         initialization_vector: "HexLength16Or32",
+    #         major_key_derivation_mode: "EMV_OPTION_A", # required, accepts EMV_OPTION_A, EMV_OPTION_B
+    #         mode: "ECB", # accepts ECB, CBC
+    #         pan_sequence_number: "HexLengthEquals2", # required
+    #         primary_account_number: "NumberLengthBetween12And19", # required
+    #         session_derivation_data: "HexLengthEquals16", # required
+    #       },
     #       symmetric: {
     #         initialization_vector: "HexLength16Or32",
     #         mode: "ECB", # required, accepts ECB, CBC, CFB, CFB1, CFB8, CFB64, CFB128, OFB
@@ -488,9 +501,10 @@ module Aws::PaymentCryptographyData
       req.send_request(options)
     end
 
-    # Encrypts plaintext data to ciphertext using symmetric, asymmetric, or
-    # DUKPT data encryption key. For more information, see [Encrypt data][1]
-    # in the *Amazon Web Services Payment Cryptography User Guide*.
+    # Encrypts plaintext data to ciphertext using a symmetric (TDES, AES),
+    # asymmetric (RSA), or derived (DUKPT or EMV) encryption key scheme. For
+    # more information, see [Encrypt data][1] in the *Amazon Web Services
+    # Payment Cryptography User Guide*.
     #
     # You can generate an encryption key within Amazon Web Services Payment
     # Cryptography by calling [CreateKey][2]. You can import your own
@@ -498,14 +512,24 @@ module Aws::PaymentCryptographyData
     # must have `KeyModesOfUse` set to `Encrypt`. In asymmetric encryption,
     # plaintext is encrypted using public component. You can import the
     # public component of an asymmetric key pair created outside Amazon Web
-    # Services Payment Cryptography by calling [ImportKey][3]).
+    # Services Payment Cryptography by calling [ImportKey][3].
     #
-    # for symmetric and DUKPT encryption, Amazon Web Services Payment
-    # Cryptography supports `TDES` and `AES` algorithms. For asymmetric
-    # encryption, Amazon Web Services Payment Cryptography supports `RSA`.
-    # To encrypt using DUKPT, you must already have a DUKPT key in your
-    # account with `KeyModesOfUse` set to `DeriveKey`, or you can generate a
-    # new DUKPT key by calling [CreateKey][2].
+    # For symmetric and DUKPT encryption, Amazon Web Services Payment
+    # Cryptography supports `TDES` and `AES` algorithms. For EMV encryption,
+    # Amazon Web Services Payment Cryptography supports `TDES`
+    # algorithms.For asymmetric encryption, Amazon Web Services Payment
+    # Cryptography supports `RSA`.
+    #
+    # When you use TDES or TDES DUKPT, the plaintext data length must be a
+    # multiple of 8 bytes. For AES or AES DUKPT, the plaintext data length
+    # must be a multiple of 16 bytes. For RSA, it sould be equal to the key
+    # size unless padding is enabled.
+    #
+    # To encrypt using DUKPT, you must already have a BDK (Base Derivation
+    # Key) key in your account with `KeyModesOfUse` set to `DeriveKey`, or
+    # you can generate a new DUKPT key by calling [CreateKey][2]. To encrypt
+    # using EMV, you must already have an IMK (Issuer Master Key) key in
+    # your account with `KeyModesOfUse` set to `DeriveKey`.
     #
     # For information about valid keys for this operation, see
     # [Understanding key attributes][4] and [Key types for specific data
@@ -544,6 +568,18 @@ module Aws::PaymentCryptographyData
     # @option params [required, String] :plain_text
     #   The plaintext to be encrypted.
     #
+    #   <note markdown="1"> For encryption using asymmetric keys, plaintext data length is
+    #   constrained by encryption key strength that you define in
+    #   `KeyAlgorithm` and padding type that you define in
+    #   `AsymmetricEncryptionAttributes`. For more information, see [Encrypt
+    #   data][1] in the *Amazon Web Services Payment Cryptography User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/payment-cryptography/latest/userguide/encrypt-data.html
+    #
     # @return [Types::EncryptDataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::EncryptDataOutput#cipher_text #cipher_text} => String
@@ -564,6 +600,14 @@ module Aws::PaymentCryptographyData
     #         key_serial_number: "HexLengthBetween10And24", # required
     #         mode: "ECB", # accepts ECB, CBC
     #       },
+    #       emv: {
+    #         initialization_vector: "HexLength16Or32",
+    #         major_key_derivation_mode: "EMV_OPTION_A", # required, accepts EMV_OPTION_A, EMV_OPTION_B
+    #         mode: "ECB", # accepts ECB, CBC
+    #         pan_sequence_number: "HexLengthEquals2", # required
+    #         primary_account_number: "NumberLengthBetween12And19", # required
+    #         session_derivation_data: "HexLengthEquals16", # required
+    #       },
     #       symmetric: {
     #         initialization_vector: "HexLength16Or32",
     #         mode: "ECB", # required, accepts ECB, CBC, CFB, CFB1, CFB8, CFB64, CFB128, OFB
@@ -708,15 +752,19 @@ module Aws::PaymentCryptographyData
     # Generates a Message Authentication Code (MAC) cryptogram within Amazon
     # Web Services Payment Cryptography.
     #
-    # You can use this operation when keys won't be shared but mutual data
-    # is present on both ends for validation. In this case, known data
-    # values are used to generate a MAC on both ends for comparision without
-    # sending or receiving data in ciphertext or plaintext. You can use this
-    # operation to generate a DUPKT, HMAC or EMV MAC by setting generation
-    # attributes and algorithm to the associated values. The MAC generation
-    # encryption key must have valid values for `KeyUsage` such as
-    # `TR31_M7_HMAC_KEY` for HMAC generation, and they key must have
-    # `KeyModesOfUse` set to `Generate` and `Verify`.
+    # You can use this operation to authenticate card-related data by using
+    # known data values to generate MAC for data validation between the
+    # sending and receiving parties. This operation uses message data, a
+    # secret encryption key and MAC algorithm to generate a unique MAC value
+    # for transmission. The receiving party of the MAC must use the same
+    # message data, secret encryption key and MAC algorithm to reproduce
+    # another MAC value for comparision.
+    #
+    # You can use this operation to generate a DUPKT, CMAC, HMAC or EMV MAC
+    # by setting generation attributes and algorithm to the associated
+    # values. The MAC generation encryption key must have valid values for
+    # `KeyUsage` such as `TR31_M7_HMAC_KEY` for HMAC generation, and they
+    # key must have `KeyModesOfUse` set to `Generate` and `Verify`.
     #
     # For information about valid keys for this operation, see
     # [Understanding key attributes][1] and [Key types for specific data
@@ -748,7 +796,8 @@ module Aws::PaymentCryptographyData
     #   The length of a MAC under generation.
     #
     # @option params [required, String] :message_data
-    #   The data for which a MAC is under generation.
+    #   The data for which a MAC is under generation. This value must be
+    #   hexBinary.
     #
     # @return [Types::GenerateMacOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1073,10 +1122,7 @@ module Aws::PaymentCryptographyData
     # can be from PEK (Pin Encryption Key) to BDK (Base Derivation Key) for
     # DUKPT or from BDK for DUKPT to PEK. Amazon Web Services Payment
     # Cryptography supports `TDES` and `AES` key derivation type for DUKPT
-    # tranlations. You can use this operation for P2PE (Point to Point
-    # Encryption) use cases where the encryption keys should change but the
-    # processing system either does not need to, or is not permitted to,
-    # decrypt the data.
+    # translations.
     #
     # The allowed combinations of PIN block format translations are guided
     # by PCI. It is important to note that not all encrypted PIN block
@@ -1090,8 +1136,9 @@ module Aws::PaymentCryptographyData
     # operations][3] in the *Amazon Web Services Payment Cryptography User
     # Guide*.
     #
-    # <note markdown="1"> At this time, Amazon Web Services Payment Cryptography does not
-    # support translations to PIN format 4.
+    # <note markdown="1"> Amazon Web Services Payment Cryptography currently supports ISO PIN
+    # block 4 translation for PIN block built using legacy PAN length. That
+    # is, PAN is the right most 12 digits excluding the check digits.
     #
     #  </note>
     #
@@ -1116,15 +1163,15 @@ module Aws::PaymentCryptographyData
     #
     # @option params [Types::DukptDerivationAttributes] :incoming_dukpt_attributes
     #   The attributes and values to use for incoming DUKPT encryption key for
-    #   PIN block tranlation.
+    #   PIN block translation.
     #
     # @option params [required, String] :incoming_key_identifier
     #   The `keyARN` of the encryption key under which incoming PIN block data
     #   is encrypted. This key type can be PEK or BDK.
     #
     # @option params [required, Types::TranslationIsoFormats] :incoming_translation_attributes
-    #   The format of the incoming PIN block data for tranlation within Amazon
-    #   Web Services Payment Cryptography.
+    #   The format of the incoming PIN block data for translation within
+    #   Amazon Web Services Payment Cryptography.
     #
     # @option params [Types::DukptDerivationAttributes] :outgoing_dukpt_attributes
     #   The attributes and values to use for outgoing DUKPT encryption key
@@ -1135,7 +1182,7 @@ module Aws::PaymentCryptographyData
     #   data. This key type can be PEK or BDK.
     #
     # @option params [required, Types::TranslationIsoFormats] :outgoing_translation_attributes
-    #   The format of the outgoing PIN block data after tranlation by Amazon
+    #   The format of the outgoing PIN block data after translation by Amazon
     #   Web Services Payment Cryptography.
     #
     # @return [Types::TranslatePinDataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1460,13 +1507,12 @@ module Aws::PaymentCryptographyData
 
     # Verifies a Message Authentication Code (MAC).
     #
-    # You can use this operation when keys won't be shared but mutual data
-    # is present on both ends for validation. In this case, known data
-    # values are used to generate a MAC on both ends for verification
-    # without sending or receiving data in ciphertext or plaintext. You can
-    # use this operation to verify a DUPKT, HMAC or EMV MAC by setting
-    # generation attributes and algorithm to the associated values. Use the
-    # same encryption key for MAC verification as you use for GenerateMac.
+    # You can use this operation to verify MAC for message data
+    # authentication such as . In this operation, you must use the same
+    # message data, secret encryption key and MAC algorithm that was used to
+    # generate MAC. You can use this operation to verify a DUPKT, CMAC, HMAC
+    # or EMV MAC by setting generation attributes and algorithm to the
+    # associated values.
     #
     # For information about valid keys for this operation, see
     # [Understanding key attributes][1] and [Key types for specific data
@@ -1498,7 +1544,8 @@ module Aws::PaymentCryptographyData
     #   The length of the MAC.
     #
     # @option params [required, String] :message_data
-    #   The data on for which MAC is under verification.
+    #   The data on for which MAC is under verification. This value must be
+    #   hexBinary.
     #
     # @option params [required, Types::MacAttributes] :verification_attributes
     #   The attributes and data values to use for MAC verification within
@@ -1691,7 +1738,7 @@ module Aws::PaymentCryptographyData
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-paymentcryptographydata'
-      context[:gem_version] = '1.8.0'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-paymentcryptographydata/client_api.rb

@@ -36,6 +36,9 @@ module Aws::PaymentCryptographyData
     DukptKeyVariant = Shapes::StringShape.new(name: 'DukptKeyVariant')
     DynamicCardVerificationCode = Shapes::StructureShape.new(name: 'DynamicCardVerificationCode')
     DynamicCardVerificationValue = Shapes::StructureShape.new(name: 'DynamicCardVerificationValue')
+    EmvEncryptionAttributes = Shapes::StructureShape.new(name: 'EmvEncryptionAttributes')
+    EmvEncryptionMode = Shapes::StringShape.new(name: 'EmvEncryptionMode')
+    EmvMajorKeyDerivationMode = Shapes::StringShape.new(name: 'EmvMajorKeyDerivationMode')
     EncryptDataInput = Shapes::StructureShape.new(name: 'EncryptDataInput')
     EncryptDataOutput = Shapes::StructureShape.new(name: 'EncryptDataOutput')
     EncryptionDecryptionAttributes = Shapes::UnionShape.new(name: 'EncryptionDecryptionAttributes')
@@ -253,6 +256,14 @@ module Aws::PaymentCryptographyData
     DynamicCardVerificationValue.add_member(:service_code, Shapes::ShapeRef.new(shape: NumberLengthEquals3, required: true, location_name: "ServiceCode"))
     DynamicCardVerificationValue.struct_class = Types::DynamicCardVerificationValue
 
+    EmvEncryptionAttributes.add_member(:initialization_vector, Shapes::ShapeRef.new(shape: HexLength16Or32, location_name: "InitializationVector"))
+    EmvEncryptionAttributes.add_member(:major_key_derivation_mode, Shapes::ShapeRef.new(shape: EmvMajorKeyDerivationMode, required: true, location_name: "MajorKeyDerivationMode"))
+    EmvEncryptionAttributes.add_member(:mode, Shapes::ShapeRef.new(shape: EmvEncryptionMode, location_name: "Mode"))
+    EmvEncryptionAttributes.add_member(:pan_sequence_number, Shapes::ShapeRef.new(shape: HexLengthEquals2, required: true, location_name: "PanSequenceNumber"))
+    EmvEncryptionAttributes.add_member(:primary_account_number, Shapes::ShapeRef.new(shape: NumberLengthBetween12And19, required: true, location_name: "PrimaryAccountNumber"))
+    EmvEncryptionAttributes.add_member(:session_derivation_data, Shapes::ShapeRef.new(shape: HexLengthEquals16, required: true, location_name: "SessionDerivationData"))
+    EmvEncryptionAttributes.struct_class = Types::EmvEncryptionAttributes
+
     EncryptDataInput.add_member(:encryption_attributes, Shapes::ShapeRef.new(shape: EncryptionDecryptionAttributes, required: true, location_name: "EncryptionAttributes"))
     EncryptDataInput.add_member(:key_identifier, Shapes::ShapeRef.new(shape: KeyArnOrKeyAliasType, required: true, location: "uri", location_name: "KeyIdentifier"))
     EncryptDataInput.add_member(:plain_text, Shapes::ShapeRef.new(shape: HexEvenLengthBetween16And4064, required: true, location_name: "PlainText"))
@@ -265,10 +276,12 @@ module Aws::PaymentCryptographyData
 
     EncryptionDecryptionAttributes.add_member(:asymmetric, Shapes::ShapeRef.new(shape: AsymmetricEncryptionAttributes, location_name: "Asymmetric"))
     EncryptionDecryptionAttributes.add_member(:dukpt, Shapes::ShapeRef.new(shape: DukptEncryptionAttributes, location_name: "Dukpt"))
+    EncryptionDecryptionAttributes.add_member(:emv, Shapes::ShapeRef.new(shape: EmvEncryptionAttributes, location_name: "Emv"))
     EncryptionDecryptionAttributes.add_member(:symmetric, Shapes::ShapeRef.new(shape: SymmetricEncryptionAttributes, location_name: "Symmetric"))
     EncryptionDecryptionAttributes.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
     EncryptionDecryptionAttributes.add_member_subclass(:asymmetric, Types::EncryptionDecryptionAttributes::Asymmetric)
     EncryptionDecryptionAttributes.add_member_subclass(:dukpt, Types::EncryptionDecryptionAttributes::Dukpt)
+    EncryptionDecryptionAttributes.add_member_subclass(:emv, Types::EncryptionDecryptionAttributes::Emv)
     EncryptionDecryptionAttributes.add_member_subclass(:symmetric, Types::EncryptionDecryptionAttributes::Symmetric)
     EncryptionDecryptionAttributes.add_member_subclass(:unknown, Types::EncryptionDecryptionAttributes::Unknown)
     EncryptionDecryptionAttributes.struct_class = Types::EncryptionDecryptionAttributes
@@ -299,7 +312,7 @@ module Aws::PaymentCryptographyData
     GeneratePinDataInput.add_member(:generation_attributes, Shapes::ShapeRef.new(shape: PinGenerationAttributes, required: true, location_name: "GenerationAttributes"))
     GeneratePinDataInput.add_member(:generation_key_identifier, Shapes::ShapeRef.new(shape: KeyArnOrKeyAliasType, required: true, location_name: "GenerationKeyIdentifier"))
     GeneratePinDataInput.add_member(:pin_block_format, Shapes::ShapeRef.new(shape: PinBlockFormatForPinData, required: true, location_name: "PinBlockFormat"))
-    GeneratePinDataInput.add_member(:pin_data_length, Shapes::ShapeRef.new(shape: IntegerRangeBetween4And12, location_name: "PinDataLength", metadata: {"box"=>true}))
+    GeneratePinDataInput.add_member(:pin_data_length, Shapes::ShapeRef.new(shape: IntegerRangeBetween4And12, location_name: "PinDataLength"))
     GeneratePinDataInput.add_member(:primary_account_number, Shapes::ShapeRef.new(shape: NumberLengthBetween12And19, required: true, location_name: "PrimaryAccountNumber"))
     GeneratePinDataInput.struct_class = Types::GeneratePinDataInput
 
@@ -560,7 +573,7 @@ module Aws::PaymentCryptographyData
     VerifyPinDataInput.add_member(:encrypted_pin_block, Shapes::ShapeRef.new(shape: HexLengthBetween16And32, required: true, location_name: "EncryptedPinBlock"))
     VerifyPinDataInput.add_member(:encryption_key_identifier, Shapes::ShapeRef.new(shape: KeyArnOrKeyAliasType, required: true, location_name: "EncryptionKeyIdentifier"))
     VerifyPinDataInput.add_member(:pin_block_format, Shapes::ShapeRef.new(shape: PinBlockFormatForPinData, required: true, location_name: "PinBlockFormat"))
-    VerifyPinDataInput.add_member(:pin_data_length, Shapes::ShapeRef.new(shape: IntegerRangeBetween4And12, location_name: "PinDataLength", metadata: {"box"=>true}))
+    VerifyPinDataInput.add_member(:pin_data_length, Shapes::ShapeRef.new(shape: IntegerRangeBetween4And12, location_name: "PinDataLength"))
     VerifyPinDataInput.add_member(:primary_account_number, Shapes::ShapeRef.new(shape: NumberLengthBetween12And19, required: true, location_name: "PrimaryAccountNumber"))
     VerifyPinDataInput.add_member(:verification_attributes, Shapes::ShapeRef.new(shape: PinVerificationAttributes, required: true, location_name: "VerificationAttributes"))
     VerifyPinDataInput.add_member(:verification_key_identifier, Shapes::ShapeRef.new(shape: KeyArnOrKeyAliasType, required: true, location_name: "VerificationKeyIdentifier"))

data/lib/aws-sdk-paymentcryptographydata/endpoint_provider.rb

@@ -32,7 +32,7 @@ module Aws::PaymentCryptographyData
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               return Aws::Endpoints::Endpoint.new(url: "https://dataplane.payment-cryptography-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"

data/lib/aws-sdk-paymentcryptographydata/plugins/endpoints.rb

@@ -14,6 +14,7 @@ module Aws::PaymentCryptographyData
       option(
         :endpoint_provider,
         doc_type: 'Aws::PaymentCryptographyData::EndpointProvider',
+        rbs_type: 'untyped',
         docstring: 'The endpoint provider used to resolve endpoints. Any '\
                    'object that responds to `#resolve_endpoint(parameters)` '\
                    'where `parameters` is a Struct similar to '\