Security

AG Fulfillment sử dụng chữ ký điện tử và mã hoá dữ liệu để xác thực dữ liệu đầu vào và ra trên mỗi yêu cầu HTTP Request/HTTP Response.

Chữ ký điện tử

signature là một chuỗi ký tự được tạo ra từ một thuật toán cho trước, sử dụng để kiểm tra tính đúng đắn của dữ liệu trên đường truyền giữa 2 hệ thống. Một số thuật toán đang sử dụng là MD5, SHA1, SHA256 và Hmac.

Trong tài liệu này AG Fulfillment sử dụng thuật toán HMAC_SHA1 để tạo signature. Dữ liệu đầu vào bao gồm API KEY và data, data được tạo ra theo định dạng là string.

Ví dụ:

Request mẫu:

const data = {
    "products": [
        {
            "sku": "VA0997",
            "quantity": 1,
            "price": 500,
            "weight": 50
        }
    ],
    "customer": {
        "name": "Quân",
        "phone": "0888888888",
        "address": "Cầu Giấy, Hà Nội",
        "ward": "8050301",
        "district": "80503",
        "province": "805"
    },
    "externalId": "VNG-20240329-1",
    "clientId": 1027,
    "countryId": "84",
    "discount": 0,
    "surcharge": 0,
    "shippingFee": 0,
    "paid": 0,
    "subTotal": 500,
    "seller": "Tôi ở dự án VN gạo"
};

import { createHmac } from 'crypto';

createHmac('sha1', apiKey).update(data).digest('hex');

APIKey: a3fcfd07-7cf5-44ed-a40a-281a8785038a

Data: {"products":[{"sku":"VA0997","quantity":1,"price":500,"weight":50}],"customer":{"name":"Quân","phone":"0888888888","address":"Cầu Giấy, Hà Nội","ward":"8050301","district":"80503","province":"805"},"externalId":"VNG-20240329-1","clientId":1027,"countryId":"84","discount":0,"surcharge":0,"shippingFee":0,"paid":0,"subTotal":500,"seller":"Tôi ở dự án VN gạo"}

signature : 1e8b81231a050b2b72ce83fd58453ea7c48e80cc

URL test online: https://www.freeformatter.com/hmac-generator.html#before-output