requests-hawk 1.0.0

太好了，我怎么用呢？

首先，您需要安装它：

.. code-block:: bash

  pip install requests-hawk

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

.. code-block:: python

  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会话令牌派生它们，请使用：

.. code-block:: python

  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)

在第二个示例中，HawkAuth的server_url参数用于 提供一个默认主机名，以避免对每个请求重复该名称。

如果要重写sha256的默认算法，请传递所需的 使用可选的algorithm参数的算法名称。

注意：已删除credentials参数。而是传递id和 {TT7} $单独（如上），或将现有的DICT作为^ {TT8}$。

与httpie集成

Httpie是一个让您 以一种友好而简单的方式请求远程服务器。在引擎盖下，httpie 使用请求库。我们已经让你很容易用它来插上Hawk。

如果您知道ID和钥匙，请按如下方式使用：

.. code-block:: bash

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

或者，如果要使用Hawk会话令牌，可以执行以下操作：

.. code-block:: bash

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

注意，不要忘记在hawk会话结束时添加额外的:。 它被认为是这样的象征。

如何共享共享凭据？

好的，具体细节。

服务器为您提供一个会话令牌，您需要派生该令牌才能获取 霍克证件。

对给定会话令牌执行hkdf派生。你需要使用 以下参数：

.. code-block:: python

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

你将从香港国防军得到的关键材料需要分为两部分 部分中，前32个十六进制字符是hawk id，后32个是 hawk key：

.. code-block:: python

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

运行测试

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

.. code-block:: bash

  tox

更改日志