公证人客户端配置文件

预计阅读时间：5分钟

本文档适用于 希望促进CLI交互或指定自定义选项的Notary客户端的高级用户。

Notary客户端的配置文件通常位于~/.notary/config.json，但是可以使用-c或--configFile命令行标志来指定其他配置文件的路径 。

文件概述

除了配置文件格式之外，请参阅Notary客户端为便于使用而可以使用的可选密码 环境变量。

这是完整的客户端配置文件示例；单击顶级JSON密钥以了解有关该密钥对应的配置部分的更多信息：

{
  "trust_dir" : "~/.docker/trust",
  "remote_server": {
    "url": "https://my-notary-server.my-private-registry.com",
    "root_ca": "./fixtures/root-ca.crt",
    "tls_client_cert": "./fixtures/secure.example.com.crt",
    "tls_client_key": "./fixtures/secure.example.com.crt"
  },
  "trust_pinning": {
    "certs": {
      "docker.com/notary": ["49cf5c6404a35fa41d5a5aa2ce539dfee0d7a2176d0da488914a38603b1f4292"]
    }
  }
}

trust_dir部分（可选）

在trust_dir指定的位置（为绝对路径或相对于配置文件的目录的路径），其中TUF元数据和私钥存储。

通常，默认值为~/.notary，但是通过指定可以~/.docker/trust 促进与内容信任的互操作性。

可以使用命令行标志覆盖此选项--trustDir。

remote_server部分（可选）

在remote_server指定如何连接到公证服务器下载元数据更新和发布元数据的变化。

远程服务器示例：

"remote_server": {
  "url": "https://my-notary-server.my-private-registry.com",
  "root_ca": "./fixtures/root-ca.crt",
  "tls_client_cert": "./fixtures/secure.example.com.crt",
  "tls_client_key": "./fixtures/secure.example.com.crt"
}

trust_pinning部分（可选）

该trust_pinning指定如何引导信任的公证客户的信任集的根目录。

此部分是可选的，默认情况下，Notary使用HTTPS上的TOFU，并在下载的根文件中使用信任证书。

在本节中，可以提供要固定到的特定证书，或提供要固定到的CA作为GUN的信任根。可以指定多个部分，但是固定证书的验证优先级最高，其次是固定CA，其次是TOFUS（HTTPS上的TOFU）。下图描述了此验证流程：

即使指定了多个部分，也仅使用一个信任锁定选项来验证GUN，并且任何验证失败都会导致回购自举失败。

环境变量（可选）

以下包含签名密钥密码短语的环境变量可用于促进Notary客户端CLI的交互。如果提供的话，这些密码最初用于签署TUF元数据。如果密码不正确，将提示您输入正确的密码。

如果提供了密码，NOTARY_DELEGATION_PASSPHRASE 则尝试使用公证尝试签名的所有委派角色的密码。