Při vytváření parametru CheckHash a verifikování parametru OrderHash být použito kódování HMAC_SHA256. Proces funguje spojením tajného klíče secret key a zprávy message a vytvořením hash použitím SHA256 kódování, následné spojení tajného klíče secretkey a hash pomocí SHA256 kódování vytvoří hodnotu HMAC.
Některý z online HMAC validátorů může být použit k verifikování výstupu vaší implementace. Např. https://www.freeformatter.com/hmac-generator.html.
HMAC_SHA256(secretkey, message) = SHA256(secretkey || SHA256(secretkey || message)) CheckHashMessage = MerchantId|ReturnUrlSuccess|ReturnUrlSuccessServer|OrderId|Amount|Currency
OrderHashMessage = OrderId|Amount|Currency SecretKey = "1234567890abcdef"
CheckHashMessage = "9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK"
CheckHash value = "275dcb516773c96a1856550c1b2126f35d501c5dc1b0ba2f73fdf617cecb7461"
OrderHashMessage = "TEST00000001|100|ISK"
OrderHash value = "d605531aa71c833edb59651652161e7845933d2f7d44d3697bc336e493befd25" | POZNÁMKA: Pokud není použit parametr returnurlsuccessserver, pak je parametr returnurlsuccess použit namísto returnurlsuccessserver. |
Některý z online HMAC validátorů může být použit k verifikování výstupu vaší implementace. Např. https://www.freeformatter.com/hmac-generator.html.
| POZNÁMKA: Nikdy nepoužívejte reálná ostrá data při použití online HMAC testovacích skriptů. |
Následují příklady HMAC implementace v různých programovacích jazycích:
C# použitie HMAC_SHA256
Příklad pro použití třídy HMACSHA256 class.
string secretKey = "1234567890abcdef"; string message = "9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK"; byte[] secretBytes = Encoding.UTF8.GetBytes(secretKey); HMACSHA256 hasher = new HMACSHA256(secretBytes); byte[] result = hasher.ComputeHash(Encoding.UTF8.GetBytes(message)); string checkhash = BitConverter.ToString(result).Replace("-", "");
PHP
Příklad k použití hash_hmac.
$secretKey = '1234567890abcdef'; $message = utf8_encode('9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK'); $checkhash = hash_hmac('sha256', $message, $secretKey); Python 2.7
Příklad k použití hmac.
#!/usr/bin/env python # -*- coding: utf-8 -*- import hmac import hashlib secret_key = '1234567890abcdef' message = u'9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK'.encode('utf-8') checkhash = hmac.new(secret_key, msg=message, digestmod=hashlib.sha256).hexdigest() Python 3.4
Příklad k použití hmac.
#!/usr/bin/env python # -*- coding: utf-8 -*- import hmac import hashlib secret_key = b'1234567890abcdef' message = '9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK'.encode(encoding='utf-8') checkhash = hmac.new(secret_key, msg=message, digestmod=hashlib.sha256).hexdigest() Ruby
Příklad k použití OpenSSL::HMAC.
# encoding: utf-8 require 'openssl' secret_key = '1234567890abcdef' message = '9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK' digest = OpenSSL::Digest.new('sha256') checkhash = OpenSSL::HMAC.hexdigest(digest, secret_key, message) Javascript
Příklad k použití crypto-js a Node.
var crypto = require('crypto-js'); var secret_key = '1234567890abcdef'; var message = '9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK'; var checkhash_data = crypto.HmacSHA256(message, secret_key); var checkhash = crypto.enc.Hex.stringify(checkhash_data);
Java
Příklad k použití Mac.
import java.util.*; import javax.crypto.*; import javax.crypto.spec.*; import javax.xml.bind.DatatypeConverter; public class hmac { public static void main (String[] args) throws Exception { String secretKey = "1234567890abcdef"; String message = "9123456|https://borgun.is|https://borgun.is/success|TEST00000001|100|ISK"; byte[] secretKeyBytes = secretKey.getBytes("utf-8"); byte[] messageBytes = message.getBytes("utf-8"); SecretKeySpec signingKey = new SecretKeySpec(secretKeyBytes, "HmacSHA256"); Mac mac = Mac.getInstance("HmacSHA256"); mac.init(signingKey); byte[] checkhashBytes = mac.doFinal(messageBytes); String checkhash = DatatypeConverter.printHexBinary(checkhashBytes).toLowerCase(); }