requests-hawk 1.2.1

很好，我该如何使用它？

首先，您需要安装它

pip install requests-hawk

然后，在您的项目中，如果您知道id和key，可以使用

import requests
from requests_hawk import HawkAuth

hawk_auth = HawkAuth(id='my-hawk-id', key='my-hawk-secret-key')
requests.post("https://example.com/url", auth=hawk_auth)

或者如果您需要从hawk会话令牌中推导它们，请使用以下方式

import requests
from requests_hawk import HawkAuth

hawk_auth = HawkAuth(
    hawk_session=resp.headers['hawk-session-token'],
    server_url=self.server_url
)
requests.post("/url", auth=hawk_auth)

在第二个示例中，server_url参数到HawkAuth被用来提供一个默认的主机名，以避免在每次请求中重复它。

如果您希望覆盖默认算法（sha256），请使用可选的algorithm参数传递所需的算法名称。

注意：已删除credentials参数。相反，单独传递id和key（如上所示），或者将现有字典作为**credentials。

与httpie集成

Httpie是一个工具，它允许您以简单易懂的方式向远程服务器发送请求。在底层，httpie使用requests库。我们已使其简单，您可以轻松地将hawk与它集成。

如果您知道id和key，使用它如下

http POST localhost:5000/registration\
--auth-type=hawk --auth='id:key'

或者，如果您想使用hawk会话令牌，您可以这样做

http POST localhost:5000/registration\
--auth-type=hawk --auth='c0d8cd2ec579a3599bef60f060412f01f5dc46f90465f42b5c47467481315f51:'

请注意，不要忘记在hawk会话令牌的末尾添加额外的:，以便将其视为如下。

共享凭据是如何共享的？

好的，接下来是实际细节。

服务器给您一个会话令牌，您需要从中推导出hawk凭据。

对给定的会话令牌进行HKDF推导。您需要使用以下参数

key_material = HKDF(hawk_session, '', 'identity.mozilla.com/picl/v1/sessionToken', 32*2)

从HKDF中获得的密钥材料需要分为两部分，前32个十六进制字符是hawk id，接下来的32个是hawk key

credentials = {
    'id': keyMaterial[0:32]
    'key': keyMaterial[32:64]
    'algorithm': 'sha256'
}

运行测试

要运行测试，您可以使用tox

tox

变更日志