传统身份验证

• 基于令牌的识别将请求与您的帐户关联起来。
• 使用共享密钥（Sign Key）的 HMAC 签名，以确保请求正文在传输过程中未被篡改。

​

先决条件

• 有效的签名密钥（由 Nayax 共享，通常为 16 个字符）
• 关联的签名密钥 ID

​

验证请求

1. 准备包含所有必要字段（例如 TerminalId、Cipher 等）的 JSON 正文。以下是 StartAuthentication 端点的简化示例：
   {
     "TokenId": 116383,  
     "TerminalId": "0434334921100366",
     "TerminalIdType": 1,
     "Random": "123456789qwertyui",
     "Cipher": "X305dITNTAw2vHsxE+taVcn6UvgBC3fdI6QbqeABgHbo8CKsoZhqISJfslehCiA+L7XYrqvKFci7C6BNj/trzBuNJwBEjgBzKhhgpJ5ggnw="
   }
   
   
2. 序列化 JSON 请求内容，删除空格和换行符。请勿更改值或添加转义符，除非它们是实际负载的一部分。
   
   我们在示例中使用了这款JSON 代码检查工具。结果如下。
   {"TokenId":116383,"TerminalId":"0434334921100366","TerminalIdType":1,"Random":"123456789qwertyui","Cipher":"X305dITNTAw2vHsxE+taVcn6UvgBC3fdI6QbqeABgHbo8CKsoZhqISJfslehCiA+L7XYrqvKFci7C6BNj/trzBuNJwBEjgBzKhhgpJ5ggnw="}
   
3. 请按照以下步骤生成 Signature 头：
   1. 将序列化的请求和签名密钥连接起来，用“;”分隔。
      {"TokenId":116383,...,"Cipher":"..."};RbtdDsiVNjkAeRty
      
   2. 使用 SHA-256 算法（UTF-8 编码）对结果进行哈希处理：
      
      We used this tool to do so in the example. Use the output as your Signature header.
      536a5813206bcb663d98715d10a6b2612364245c865cdd5f781ff4428c4a6137
      
4. 将 IntegratorId 和 Signature 头添加到您的请求中。
   基本 URLSpark API 的基础 URL 为 https://nayax-spark-dmz.nayax.com/api。集成环境和生产环境使用同一个主机。
   curl -X POST https://nayax-spark-dmz.nayax.com/api/StartAuthentication \
   --header 'IntegratorId: 927' \
   --header 'Signature: 536a5813206bcb663d98715d10a6b2612364245c865cdd5f781ff4428c4a6137' \
   --header 'Content-Type: application/json' \
   --data '{
     "TokenId": 116383,	
     "TerminalId": "0434334921100366",
     "TerminalIdType": 1,
     "Random": "123456789qwertyui",
     "Cipher": "X305dITNTAw2vHsxE+taVcn6UvgBC3fdI6QbqeABgHbo8CKsoZhqISJfslehCiA+L7XYrqvKFci7C6BNj/trzBuNJwBEjgBzKhhgpJ5ggnw="
   }'
   

​

构建 cipher

• 一个 36 个字符的 Spark 事务 ID（一个带有连字符的 GUID）。
• 单个 ”=” 字符。
• 一个 17 个字符的字母数字随机字符串。
• 一个 10 个字符的 YYMMDDhhmm 格式 UTC 时间戳。

1. 将 Spark 事务 ID、“=”字符、随机字符串和时间戳连接起来，形成 64 个字符的密文，如下例所示：
   12c7cec2-c690-4425-9a1f-db0db60e2d8c=123456789qwertyui2306061021
   
2. 从提供的令牌中提取最右侧的 32 个字符，以创建 256 位 AES 加密密钥。例如，假设令牌如下：
   some_long_token_wRvTVTkungMIKThTVbj_fiXdfoGclhn0
   
   加密密钥如下：
   wRvTVTkungMIKThTVbj_fiXdfoGclhn0
   
3. 使用 ECB 模式的 AES 加密 64 个字符的密文。确保明文已填充（例如，使用 PKCS7）至 16 字节的倍数。对生成的加密字节进行 Base64 编码以进行传输，这将产生类似于以下示例的输出：
   X305dITNTAw2vHsxE+taVcn6UvgBC3fdI6QbqeABgHbo8CKsoZhqISJfslehCiA+L7XYrqvKFci7C6BNj/trzBuNJwBEjgBzKhhgpJ5ggnw=
   

​

参见