使用 Python 和 Azure 函数的 Xero API Webhook 服务器答案

【问题标题】：Xero API Webhook Server using Python and Azure functions使用 Python 和 Azure 函数的 Xero API Webhook 服务器
【发布时间】：2021-01-15 11:33:01
【问题描述】：

我正在使用 Azure Function Apps 从 Xero 接收 webhook 进行处理。但是，我的 HASH 计算不正确。

我认为这与 Python 处理正文请求的方式有关。

代码如下：

#import Logging module to log errors to console
import logging

#import Azure Functions
import azure.functions as func

#import Cryptopackages
import hmac
import hashlib
import base64

#import JSON
import json

XERO_KEY = 'key here'

#function to generate key
def create_sha256_signature(key, message):
    messagecoded = bytes(message, 'UTF-8')
    return base64.b64encode(hmac.new(key.encode(), messagecoded, digestmod=hashlib.sha256).digest()).decode()

#Define Main function - Recieve a HTTP reponse
def main(req: func.HttpRequest) -> func.HttpResponse:
    logging.info('Recieved a Request from Xero')
    
    #Parse HASH Key from Header
    xerosign = req.headers.get('x-xero-signature')
    logging.info(xerosign)
    
    #Get JSON body
    Data = req.get_body()
    Body = Data
    #Body = json.dumps(payload, separators=(",", ":")).strip()
    logging.info(Body)
    
    #Get Signature from defined function
    signature = create_sha256_signature(XERO_KEY, str(Body))
    
    logging.info(signature)
    logging.info(xerosign)

    if hmac.compare_digest(xerosign, signature):
        return func.HttpResponse(
            status_code=200)
    else:
        return func.HttpResponse(
            status_code=401
            )

正文请求是

{
    "events": [],
    "lastEventSequence": 0,
    "firstEventSequence": 0,
    "entropy": "TXHKKDMKUHWFBYTVJSQU"
}

标头 x-xero-signature = C7G5M2SVxs/fAJM8fFLahzex32Rr7jwMHixX/OgvkFQ=

【问题讨论】：

欢迎来到 SO。请更清楚地描述您的问题。
问题是，我在运行上述脚本时收到了不同的计算哈希值。在代码中的某个地方，主体正在被修改或转换。这导致哈希发生变化。

标签： python azure-function-app xero-api

【解决方案1】：

我已经发布了implementing webhooks using node 的示例。虽然语言不同，但概念保持不变。请务必不要修改传入的原始请求正文，否则签名验证将失败。在使用 node 和 express 时，这意味着将 body-parser 中间件配置为专门为 webhooks 端点使用原始请求正文。链接文章中包含一个示例。

此外，另一位 Xero 开发人员宣传员在 implementing webhooks in aws lambda using python 上写了这篇文章。虽然本文中的内容超出了您的需要，但它确实包含一个代码 sn-p，它应该可以帮助您通过“意图接收”签名验证。

【讨论】：

【解决方案2】：

在查看了 Rett Behrens 所做的工作并深入研究了 Azure Function App 处理数据的方式之后。我有一个利用 Node.js 的工作解决方案，它规定了 Microsoft 处理 API 响应的方式，如果你不输入“body”：“”它会自动响应来自初始发布请求的正文。因此导致了 Xero 排除空主体的问题。

https://github.com/mast3rbow/Xero-Functionapp

github 存储库包含我的工作示例，它将使企业能够将 Xero 事件直接发送到 Microsoft Power Automate 以在那里进行一些逻辑处理。

【讨论】：