dcc-utils 0.2.1

解析DCC

此库将带有二维码或疫苗接种证明原始表示的图像作为参数，并将显示证书的内容。

from dcc_utils import dcc

dcc_from_img = dcc.from_image("/my/certificate/path")
dcc_from_raw = dcc.from_raw("HC1:6BF...FTPQ3C3F")

然后，您可以访问 payload 和 kid

assert dcc_from_img.kid == "53FOjX/4aJs="
assert dcc_from_img.payload["v"][0]["ci"] == "URN:UVCI:01:FR:W7V2BE46QSBJ#L"

👉🏻 payload 符合 欧盟数字COVID证书JSON模式规范

from_image 和 from_raw 方法可能会引发 DCCParsingError

from dcc_utils.exceptions import DCCParsingError

验证DCC数字签名

signature = b"""
-----BEGIN CERTIFICATE-----
MIIIAjCCBeqgAwIBAgIQAnq8g/T
-----END CERTIFICATE-----
"""
assert my_dcc.check_signature(signature)

check_signature 方法可能会引发 DCCSignatureError

from dcc_utils.exceptions import DCCSignatureError

评估CertLogic业务规则

使用 dcc-utils，您可以对DCC评估 业务规则

from dcc_utils import rule, dcc

my_dcc = dcc.from_image("/my/certificate/path")
my_rule = rule.from_file("/my/rule.json")
print(my_rule.description["en"])
my_rule.evaluate_dcc(my_dcc) # True or False

evaluate_dcc 接受作为第二个参数的额外变量，例如 validationClock

import datetime
clock = datetime.datetime(2022, 10, 10, 0, 0, tzinfo=datetime.timezone.utc)
my_rule.evaluate_dcc(
    my_dcc,
    {
        "validationClock": clock,
    },
)

您还可以从JSON（from_json）加载规则，这对于评估服务器上公开的规则很有用

my_rule = rule.from_json({...})

from_file 和 from_json 方法可能会引发 DCCRuleError

from dcc_utils.exceptions import DCCRuleError

示例数据

所有参与国家的数字绿色证书网关（DGCG）样本: https://github.com/eu-digital-green-certificates/dgc-testdata