有何不可0365 发表于 2023-7-18 15:39

使用Python来操作Microchip安全芯片

使用Python来操作Microchip安全芯片
Microchip提供业界优秀的安全方案，包括支持SHA256，ECC P256和AES128的完整算法支持，同时提供了基于C语言的器件支持库cryptoauthlib.

由于Python语言的通用性和便利性，Microchip同时提供了基于Python语言的CryptoAuthLib和相关的例程cryptoauthtools。

CryptoAuthLib Python库可以做什么 ?
CryptoAuthLib库提供了访问cryptoauthlib大部分功能的模块，这些模块只是对C语言库cryptoauth中的API做了一层封装，以实现在Python中的调用。

Microchip的cryptoauthlib的访问页面如下:
CryptoAuthLib Link（https://www.microchip.com/en-us/software-library?swsearch=CryptoAuthLib）官网

有何不可0365 发表于 2023-7-18 15:40

准备工作
软件部分
首先从github上下载最新的例程代码，地址如下：
https://github.com/MicrochipTech/cryptoauthtools

安装Python需要的组件。
进入cryptoauthtools\python\examples目录中，运行以下命令:

    pip install -r requirements.txt

Python将自动安装cryptoauthlib和cryptography库(需要v2.3以上的版本)

另外，也可以手动安装cryptoauthlib和cryptography

    pip install cryptoauthlib
    pip install cryptography

有何不可0365 发表于 2023-7-18 15:40

硬件部分
支持的硬件如下：

AT88CK101
CryptoAuthentication Starter Kit (DM320109)
ATECC508A, ATECC608A, ATSHA204A device directly connected via I2C (Linux Only)
国产兼容开发板购买链接：Crypto Writer Nano

有何不可0365 发表于 2023-7-18 15:40

支持的器件型号如下:

ATSHA204A
ATECC508A
ATECC608A
下面的演示是在Windows 10 64bit，Python 3.6下运行的，使用的硬件是CryptoAuthentication Starter Kit。使用SAMD21实现USB HID通信，再转换为I2C接口控制安全芯片。

有何不可0365 发表于 2023-7-18 15:41

Tips: 需注意USB线应该插到Target USB上。
可以使用SAMD21的开发板烧录一个固件来实现的。这个固件可以在官网下载ATCRYPTOAUTHSSH-XSTK_v1.0.1.zip

有何不可0365 发表于 2023-7-18 15:41

运行例程
这些例子旨在简单明了地说明基本概念。
要获得任何示例的帮助，您可以参考相关文档(例如: 有一个说明文档)或者通过命令行:

    info.py -h
usage: info.py [-h] [-i {i2c,hid}] [-d {ecc,sha}] [-p ]]

有何不可0365 发表于 2023-7-18 15:41

示例列表：

: 读器件信息. 详见
: 配置器件. 详见
: 演示 ECDH 运算. 详见
: 演示 ECDSA 签名和验证. 详见
: 演示从Slot中连续加密写和读. 详见

有何不可0365 发表于 2023-7-18 15:41

Info例程
这个示例从设备中提取标识信息和配置。

设备类型识别和掩码OTP修改
序列号
配置区数据
锁状态
可选的参数：

-h, --help            显示帮助信息
-i {i2c,hid}, --iface {i2c,hid}
                        接口类型 (默认: hid)
-d {ecc,sha}, --device {ecc,sha}
                        器件类型(默认: ecc)
-p ], --params ]
                        接口参数如key=value

有何不可0365 发表于 2023-7-18 15:41

使用DM320109和ATECC508A运行如下：
$ python info.py

Device Part:
    ATECC508A

Serial number:
    01 23 6B 3F AC 10 2F 1B A5


Configuration Zone:
    01 23 6B 3F 00 00 50 00 AC 10 2F 1B A5 00 45 00
    B0 00 55 00 8F 20 C4 44 87 20 87 20 8F 0F C4 36
    9F 0F 82 20 0F 0F C4 44 0F 0F 0F 0F 0F 0F 0F 0F
    0F 0F 0F 0F FF FF FF FF 00 00 00 00 FF FF FF FF
    00 00 00 00 FF FF FF FF FF FF FF FF FF FF FF FF
    FF FF FF FF 00 00 00 00 FF FF 00 00 00 00 00 00
    33 00 1C 00 13 00 13 00 7C 00 1C 00 3C 00 33 00
    3C 00 3C 00 3C 00 30 00 3C 00 3C 00 3C 00 30 00


Check Device Locks
    Config Zone is locked
    Data Zone is locked

Loading Public key

-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE5O6vcWT7anlt+HFc6AAkF+rOBtly
uOXuM78qcnXtIA+nxvPzSWWiF0yruZK/4ANK8q2C21dICxDwxo7YyYpc4w==
-----END PUBLIC KEY-----

Done

有何不可0365 发表于 2023-7-18 15:42

Config例程
在使用加密身份验证设备之前，必须为器件设置好适当的配置。
配置可能非常复杂，需要仔细创建和分析配置交互可能带来的安全漏洞。
开发新配置时，请同时查阅数据表和联系FAE。

这个脚本将编写一个通用配置程序，允许对各种示例进行评估。
在生产设备使用之前，应该修改这个配置。
为了让实验人员更容易使用配置，下面列出了一些设置项。

有何不可0365 发表于 2023-7-18 15:42

ATECC508A配置
Slot 4 & 6允许非加密写入，这意味着保护密钥可以在不需要很强安全性的前提下可以被改写。

# Example configuration for ATECC508A minus the first 16 bytes which are fixed by the factory
_atecc508_config = bytearray.fromhex(
    'B0 00 55 00 8F 20 C4 44 87 20 87 20 8F 0F C4 36'
    '9F 0F 82 20 0F 0F C4 44 0F 0F 0F 0F 0F 0F 0F 0F'
    '0F 0F 0F 0F FF FF FF FF 00 00 00 00 FF FF FF FF'
    '00 00 00 00 FF FF FF FF FF FF FF FF FF FF FF FF'
    'FF FF FF FF 00 00 55 55 FF FF 00 00 00 00 00 00'
    '33 00 1C 00 13 00 13 00 7C 00 1C 00 3C 00 33 00'
    '3C 00 3C 00 3C 00 30 00 3C 00 3C 00 3C 00 30 00')

有何不可0365 发表于 2023-7-18 15:42

ATECC608A配置:
同ATECC508A
Slot 4是额外增加的，用作从tempkey中读取ECDH前导密钥和KDF因子的保护密钥
# Example configuration for ATECC608A minus the first 16 bytes which are fixed by the factory
_atecc608_config = bytearray.fromhex(
    'B0 00 55 01 8F 20 C4 4487 20 87 20 8F 0F C4 36'
    '9F 0F 82 20 0F 0F C4 440F 0F 0F 0F 0F 0F 0F 0F'
    '0F 0F 0F 0F FF FF FF FF00 00 00 00 FF FF FF FF'
    '00 00 00 00 00 00 00 0000 00 00 00 00 00 00 00'
    '00 00 00 00 00 00 55 55FF FF 06 40 00 00 00 00'
    '33 00 1C 00 13 00 13 007C 00 1C 00 3C 00 33 00'
    '3C 00 3C 00 3C 00 30 003C 00 3C 00 3C 00 30 00')

有何不可0365 发表于 2023-7-18 15:42

ATSHA204A配置:
Solt可自由写入，无需事先知道Slot中的内容
_atsha204_config = bytearray.fromhex(
    'C8 00 55 00 8F 80 80 A1 82 E0 C4 F4 84 00 A0 85'
    '86 40 87 07 0F 00 C4 64 8A 7A 0B 8B 0C 4C DD 4D'
    'C2 42 AF 8F FF 00 FF 00 FF 00 FF 00 FF 00 FF 00'
    'FF 00 FF 00 FF FF FF FF FF FF FF FF FF FF FF FF'
    'FF FF FF FF 00 00 55 55')

有何不可0365 发表于 2023-7-18 15:43

上述示例主要是为了演示。实际使用中有一些安全性常识特别需注意的:

设备的用户/实验者必须仔细设置和管理密钥。
否则，如果这些密钥丢失或不小心设置，就会使设备变得异常。

有何不可0365 发表于 2023-7-18 15:43

如果设备之前没有被配置为可以使用，那么可以编写一个支持许多用例的基本配置(这是不可逆的)。

运行配置脚本可以如下运行：

查看脚本的可选项和帮助信息:

$ python config.py -h

有何不可0365 发表于 2023-7-18 15:43

运行配置脚本:

$ python config.py

有何不可0365 发表于 2023-7-18 15:43

ECDH例子
ECDH命令实现了椭圆曲线Diffie-Hellman算法，将内部私钥与外部公钥组合在一起，以计算共享密钥。
示例中genkey命令生成两个独立的ECC密钥对，然后通过ECDH命令计算共享密钥。

有何不可0365 发表于 2023-7-18 15:44

如果设备之前没有被配置为可以使用，那么可以编写一个支持许多用例的基本配置(这是不可逆的)。

$ python config.py

有何不可0365 发表于 2023-7-18 15:44

运行此示例的步骤:
查看脚本的可选项和帮助信息:

$ python ecdh.py -h

有何不可0365 发表于 2023-7-18 15:44

运行ECDH脚本:
$ python .\ecdh.py

Performing ECDH operations in the clear - see datasheet for encryption details

Host Public Key:
    9C 9C 1F 4D 71 0F 39 6E C0 49 80 E3 C7 A5 FA F7
    89 E6 39 F4 55 13 49 51 16 1D AA 93 58 52 07 7F
    87 36 AD DA 8E 4F 88 BF 51 29 F3 08 94 28 FC 7C
    C8 82 B5 33 AD E8 93 8B FC 52 33 35 22 F6 E2 3C


Device public key:
    49 E5 CE F0 48 F9 3C 81 D0 99 6D F0 E9 BD 6F 70
    A3 C9 7C 61 46 89 26 49 1E 0B E1 24 C1 42 95 58
    A3 8F 97 8B E6 CF 78 64 EC C8 81 7A A0 4D E8 BB
    E1 4E 99 F7 35 31 ED E1 05 88 97 37 BE B9 E1 2D


Host Calculated Shared Secret:
    E5 0B 40 8F F7 8F C7 92 4B AA 5F 04 9F 5E 16 64
    E7 80 11 A3 FC 7D B4 8E 17 4B 05 44 3E 85 12 2E


Device Calculated Shared Secret:
    E5 0B 40 8F F7 8F C7 92 4B AA 5F 04 9F 5E 16 64
    E7 80 11 A3 FC 7D B4 8E 17 4B 05 44 3E 85 12 2E


Comparing host and device generated secrets:
    Success - Generated secrets match!

Done
页: [1] 2
查看完整版本: 使用Python来操作Microchip安全芯片