Tratamiento del esquema nacional

Utilice esta sección solo si:

• Tokenization Service actúa como intermediario TSP para un esquema nacional o una marca privada.
• Habilita una de estas carteras xPay: Apple Pay, Google Pay o Samsung Pay.

En el aprovisionamiento push, la aplicación del emisor prepara una carga útil. La aplicación del emisor la pasa a Tokenization Service a través del solicitante de token (proveedor de la cartera).

Esta carga útil se llama datos de inscripción App2App (CryptoOTP). Tiene dos partes:

• Datos de la tarjeta de financiación que contiene los detalles para tokenizar (PAN, fecha de vencimiento, etc.).
• Valor de autenticación que contiene una prueba de seguridad adicional.

Hay dos opciones de implementación para el valor de autenticación:

Opciones de validación del valor de autenticación.

• Opción 1 (recomendada): Tokenization Service valida el valor de autenticación.

  • El valor de autenticación debe seguir el formato de Thales.
• Opción 2: El backend del emisor valida el valor de autenticación.

  • El formato del valor de autenticación depende del emisor.

datos de inscripción App2App (JWE)

Esta sección se aplica solo a Samsung Pay, Google Pay y Apple Pay (configuración 3).

Los datos de inscripción App2App son un JWE (JSON Web Encryption), según se define en RFC 7516, con estas propiedades:

• Use la serialización compacta.
• Tipo de clave: RSA de 2048 bits o 4096 bits.
• Algoritmos:

  • Cifrado de clave: RSA1_5 (obsoleto) o RSA-OAEP-256
  • Cifrado de contenido: A256GCM

CABECERA JWE	DESCRIPCIÓN	VALOR	MOC
alg	Algoritmo criptográfico utilizado para cifrar la clave de cifrado de contenido (CEK).	'RSA1_5' (obsoleto) o 'RSA-OAEP-256'	M
enc	Algoritmo de cifrado de contenido utilizado para realizar cifrado autenticado sobre el texto plano para producir el texto cifrado y la etiqueta de autenticación.	'A256GCM'	M
kid	Identificador de la clave RSA utilizada para el cifrado de clave. Definido durante la incorporación. Proporcionado por Thales al emisor.	cadena	C (obligatorio para nuevos emisores)
x-gto-issuerid	Encabezado JWE personalizado que contiene el issuerId definido durante la incorporación.	cadena	M
x-gto-productid	Encabezado JWE personalizado que contiene el productId definido durante la incorporación. Su presencia depende de la configuración de incorporación.	cadena	O (no debe proporcionarse para nuevos emisores)

Ejemplo de encabezado JWE:

{
    "alg":"RSA-OAEP-256",
    "enc":"A256GCM",
    "kid":"key_123",
    "x-gto-issuerid":"IssuerABC"
}

TEXTO SIN FORMATO JWE	DESCRIPCIÓN	TIPO	MOC
fpan	FPAN de la tarjeta de financiación a tokenizar.	cadena	M
exp	Fecha de vencimiento en MMYY formato.	cadena	O
issuerCardLastDigits	Últimos dígitos de la tarjeta de financiación para mostrar en la cartera.	cadena	O
authvalue	Dos opciones: Formato de Thales validado por Tokenization Service Identificador opaco pasado al backend del emisor en la requestCardDigitization operación	cadena	C (No debe proporcionarse para el flujo auxiliar o el formato 3 con Apple Pay)

Ejemplo de texto sin formato JWE:

{
    "fpan":"3450163332324735",
    "authvalue":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJCYW5jb21hdEkxIiwic3ViIjoiYzQxZTdiZmQ3MWQ3ZiIsImV4cCI6MTUzMTgyOTUyNiwiaWF0IjoxNTMxODI1OTI2LCJwcm9kdWN0SWQiOiJCYW5jb21hdF9QVVJFIn0.Pjv-rS6s2O8I5IXSKi8eBxwhIDquUUYEegDQzqWqQjxAfYyQlJ7fNAt33p7cFhbWSuEVHowyy0xkYOorqZHC3TaAGMqB-pcU5KrwtGkXKUPPzdTOfUnZ8qmg1opiN1PfgCOHF0jja61QmAjcMPEHRSrTeK7EUogA-WM7ozSn6BAX0nTDb4dICr9bpksVKvB53DG5GTqTV00cX4EjSP_QuuiUpAvuiZFRcWaDzGzTECB8DptcOUmaHhuuuHIgPng5DNJeMtPvPqEmCNdSpMJ7eq-kg0RWsHmkbNpgVpk2pLm8AB_MPoq0wZ7hs660qnnU9d-9AG28VQrASsvkBolHZg",
    "exp":"0221"
}

Ejemplo completo de JWE:

eyJhbGciOiJSU0ExXzUiLCJlbmMiOiJBMjU2R0NNIiwieC1ndG8tcHJvZHVjdGlkIjoiQmFuY29tYXRfUFVSRSIsIngtZ3RvLWlzc3VlcmlkIjoiQmFuY29tYXRJMSJ9.m0WJhih-DYQOFJBHHvJGyuMcFYMsUTeEFkfRB1YOgODMNzZoYDhyhnx2kNQWr382Zw8qc-QmhGGnrhVw5EVoffpS5CSF5JP4Y1aSffssTFTeYtGGrVWF4GWSvQGCBZs9fEJMT9SpKpCLbVl7LJXJ5oHbsFu_MG9jkYZFvyyVVJ6xq97iQE6Co8zEYD5uPrQXX7jJlqqGX1VhA_Bs1aklTgaPYvt-mpYauPl8qIKSFL2w2yJZ3LwQxffuQxCMc6aaAu5k0VWPGtez7zimRd044n5WqErUfguSTxVOLhODpB0HanOwq7YVqeE40TqOtzzgWENzNm2KSraXjXUHuL5smg.z3nyT9uJ30YRNarp.Tt3avmBS0_Svg0yxG-yq0WLJ6BZn7xEtOcYHg0465T_TAP-3tKbCsDe5RG-kGADHB6oHy-oJa1YYn3nybkBl9SVsBWBPTJ9f1gPJvtY4jLkbq7nolTr3XjvK9ljtdE2G0IbcCZ4s7pLoQHf459AxilP8U-M3R3SEayMRsJocJQOlhVBLz6rTMgKEwAV52mtPccOTPpwL351fX4ssCG4oeTcM_gB7kDMuYgHLBmCW3XCKkRg7QLBybPP7TNhBy78JHcZe8DZ3mNHfL8tFEntnEYEGAWWHUQKm3H8qYoIlEVGqAz9j-UpDfyok8wohm5RxblH0NWMitarPjH01MNouMvomfM5FCaze7PErNNoaAw5Mp5I2h0QeEI3sJJkAkbzDq0R0UEbheNbhFdm3h10qSZ-mnJCp8ju1dcneOFxxlGwCQFO13EnDKFLuj4Qvnm9ARdIoQJiqWl4M8deiRPq2jrksrlEnavyADTnr4Dj1J56KS-eI8QIlSZEMqzGKZ6LsxLkEQE7Jy9-RW1-VctBczTJvdUpk-41IxrJdeGUV8UQPQGGwZ9CCa_2gmxjxByEL0UtO0mzno8UBUaI-Rmho7xvOjHLm73fkk2OeXJzNVgbNo4f5IrEW-e6GKAMhsBudcw2upSh0u2Cew8ruvPKzfu3JNSdSUaQv8lO_Yc6yH8x4UxqsylO1hsGaEpIogkTqnMWfTJHDTkK0VVwuoDye48aOhDWv8XWIsiyMIyFp0bEDCkfKQpDCXaANUhXgqQ.fewcSD5vzA5ICFBT_XBISg

Valor de autenticación (formato de Thales) (JWT)

Esta sección se aplica solo a Apple Pay, Samsung Pay y Google Pay.

El valor de autenticación es un JWT (JSON Web Token), según se define en RFC 7519, con estas propiedades:

• Tipo de clave: RSA de 2048 bits o 4096 bits.

CABECERA JWT	DESCRIPCIÓN	VALOR	MOC
typ	Tipo de medio del JWT completo.	'JWT'	M
alg	Algoritmo utilizado en el JWT.	Algoritmos compatibles: 'RS256' 'PS256' 'PS512'	M
kid	Identificador de la clave utilizada para firmar el JWT. Definido durante la incorporación. Proporcionado por el emisor a Thales	cadena	O

Ejemplo:

{
    "typ":"JWT",
    "alg":"RS256",
    "kid":"key_456"
}

RECLAMACIONES JWT	DESCRIPCIÓN	VALOR	MOC
iss	Identificador único del emisor asignado durante la incorporación.	cadena	M
sub	El issuerCardRefId definido por el emisor.	cadena	M
iat	Fecha de creación del token definida en RFC 7519.	int	M
exp	Expiración del token definida en RFC 7519.	int	M
productId	El identificador del producto de la tarjeta definido durante la incorporación.	cadena	O
nonce	Reclamo privado utilizado para Apple Pay. Es el nonce valor que la aplicación del emisor captura a través del SDK PassKit de iOS.	cadena	C (aplicable solo a Apple Pay)
nonceSignature	Reclamo privado utilizado para Apple Pay. Es el nonceSignature valor que la aplicación del emisor captura a través del SDK PassKit de iOS.	cadena	C (aplicable solo a Apple Pay)

Ejemplos:

Reclamaciones base

{
    "iat":1456815010,
    "exp":1456851010,
    "iss":"IssuerABC",
    "sub":"11111",
    "productId":"Product123"
}

Reclamaciones de Apple Pay

{
    "iat":1456815010,
    "exp":1456851010,
    "iss":"acmeBank",
    "sub":"111111",
    "nonce":"iYWNtZUJhbmsiLCJzdWIiOiIxMTExMTEifQ.WIo8cL1d71CZuxQ",
    "nonceSignature":"aXNzIjoiYWNtZUJhbmsiLCJzdWIiOiIxMTExMTEifQ.WIo8cL1d71CZuxQZ2re2TnBuRfQy-6p_OowGuaN9Hp1SMSY01BN-hl1q7TI67WdP5Vz2Em6BXzOdE1I1anPzoLeJXQW-y8UVWOMQN3hLn6hYoNDYye0Y3m-_jsOIJ7a7yr33ODKmgq4ieQoceeaZNpMEGeZr1X3G2a3iS-1tP9515qgcp-UoM9TjrP5kvP1cTjVG7djsb1UNlPwbnXdMRh8cxHa4bYqZ8fJYqcMcUVLLc08C9ejNwn2lL3eX2tU9Ofkrs2sf44stDxhwSLRP3I3x15_rEMeW6FtvN83_ecmROcI"
}

Ejemplo completo de JWT:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJCYW5jb21hdEkxIiwic3ViIjoiYzQxZTdiZmQ3MWQ3ZiIsImV4cCI6MTUzMTgyOTUyNiwiaWF0IjoxNTMxODI1OTI2LCJwcm9kdWN0SWQiOiJCYW5jb21hdF9QVVJFIn0.Pjv-rS6s2O8I5IXSKi8eBxwhIDquUUYEegDQzqWqQjxAfYyQlJ7fNAt33p7cFhbWSuEVHowyy0xkYOorqZHC3TaAGMqB-pcU5KrwtGkXKUPPzdTOfUnZ8qmg1opiN1PfgCOHF0jja61QmAjcMPEHRSrTeK7EUogA-WM7ozSn6BAX0nTDb4dICr9bpksVKvB53DG5GTqTV00cX4EjSP_QuuiUpAvuiZFRcWaDzGzTECB8DptcOUmaHhuuuHIgPng5DNJeMtPvPqEmCNdSpMJ7eq-kg0RWsHmkbNpgVpk2pLm8AB_MPoq0wZ7hs660qnnU9d-9AG28VQrASsvkBolHZg