directory search
Compose About versions and upgrading (Compose) ASP.NET Core + SQL Server on Linux (Compose) CLI environment variables (Compose) Command-line completion (Compose) Compose(组成) Compose command-line reference(组合命令行参考) Control startup order (Compose) Django and PostgreSQL (Compose) Docker stacks and distributed application bundles (Compose) docker-compose build(docker-compose构建) docker-compose bundle docker-compose config docker-compose create docker-compose down docker-compose events docker-compose exec docker-compose help docker-compose images docker-compose kill docker-compose logs docker-compose pause docker-compose port docker-compose ps docker-compose pull docker-compose push docker-compose restart docker-compose rm docker-compose run docker-compose scale docker-compose start docker-compose stop docker-compose top docker-compose unpause docker-compose up Environment file (Compose) Environment variables in Compose Extend services in Compose Frequently asked questions (Compose) Getting started (Compose) Install Compose Link environment variables (deprecated) (Compose) Networking in Compose Overview of Docker Compose Overview of docker-compose CLI Quickstart: Compose and WordPress Rails and PostgreSQL (Compose) Sample apps with Compose Using Compose in production Using Compose with Swarm Engine .NET Core application (Engine) About images, containers, and storage drivers (Engine) Add nodes to the swarm (Engine) Apply custom metadata (Engine) Apply rolling updates (Engine) apt-cacher-ng Best practices for writing Dockerfiles (Engine) Binaries (Engine) Bind container ports to the host (Engine) Breaking changes (Engine) Build your own bridge (Engine) Configure container DNS (Engine) Configure container DNS in user-defined networks (Engine) CouchDB (Engine) Create a base image (Engine) Create a swarm (Engine) Customize the docker0 bridge (Engine) Debian (Engine) Default bridge network Delete the service (Engine) Deploy a service (Engine) Deploy services to a swarm (Engine) Deprecated Engine features Docker container networking (Engine) Docker overview (Engine) Docker run reference (Engine) Dockerfile reference (Engine) Dockerize an application Drain a node (Engine) Engine FAQ (Engine) Fedora (Engine) Get started (Engine) Get started with macvlan network driver (Engine) Get started with multi-host networking (Engine) How nodes work (Engine) How services work (Engine) Image management (Engine) Inspect the service (Engine) Install Docker (Engine) IPv6 with Docker (Engine) Join nodes to a swarm (Engine) Legacy container links (Engine) Lock your swarm (Engine) Manage nodes in a swarm (Engine) Manage sensitive data with Docker secrets (Engine) Manage swarm security with PKI (Engine) Manage swarm service networks (Engine) Migrate to Engine 1.10 Optional Linux post-installation steps (Engine) Overview (Engine) PostgreSQL (Engine) Raft consensus in swarm mode (Engine) Riak (Engine) Run Docker Engine in swarm mode Scale the service (Engine) SDKs (Engine) Select a storage driver (Engine) Set up for the tutorial (Engine) SSHd (Engine) Storage driver overview (Engine) Store service configuration data (Engine) Swarm administration guide (Engine) Swarm mode key concepts (Engine) Swarm mode overlay network security model (Engine) Swarm mode overview (Engine) Understand container communication (Engine) Use multi-stage builds (Engine) Use swarm mode routing mesh (Engine) Use the AUFS storage driver (Engine) Use the Btrfs storage driver (Engine) Use the Device mapper storage driver (Engine) Use the OverlayFS storage driver (Engine) Use the VFS storage driver (Engine) Use the ZFS storage driver (Engine) Engine: Admin Guide Amazon CloudWatch logs logging driver (Engine) Bind mounts (Engine) Collect Docker metrics with Prometheus (Engine) Configuring and running Docker (Engine) Configuring logging drivers (Engine) Control and configure Docker with systemd (Engine) ETW logging driver (Engine) Fluentd logging driver (Engine) Format command and log output (Engine) Google Cloud logging driver (Engine) Graylog Extended Format (GELF) logging driver (Engine) Journald logging driver (Engine) JSON File logging driver (Engine) Keep containers alive during daemon downtime (Engine) Limit a container's resources (Engine) Link via an ambassador container (Engine) Log tags for logging driver (Engine) Logentries logging driver (Engine) PowerShell DSC usage (Engine) Prune unused Docker objects (Engine) Run multiple services in a container (Engine) Runtime metrics (Engine) Splunk logging driver (Engine) Start containers automatically (Engine) Storage overview (Engine) Syslog logging driver (Engine) tmpfs mounts Troubleshoot volume problems (Engine) Use a logging driver plugin (Engine) Using Ansible (Engine) Using Chef (Engine) Using Puppet (Engine) View a container's logs (Engine) Volumes (Engine) Engine: CLI Daemon CLI reference (dockerd) (Engine) docker docker attach docker build docker checkpoint docker checkpoint create docker checkpoint ls docker checkpoint rm docker commit docker config docker config create docker config inspect docker config ls docker config rm docker container docker container attach docker container commit docker container cp docker container create docker container diff docker container exec docker container export docker container inspect docker container kill docker container logs docker container ls docker container pause docker container port docker container prune docker container rename docker container restart docker container rm docker container run docker container start docker container stats docker container stop docker container top docker container unpause docker container update docker container wait docker cp docker create docker deploy docker diff docker events docker exec docker export docker history docker image docker image build docker image history docker image import docker image inspect docker image load docker image ls docker image prune docker image pull docker image push docker image rm docker image save docker image tag docker images docker import docker info docker inspect docker kill docker load docker login docker logout docker logs docker network docker network connect docker network create docker network disconnect docker network inspect docker network ls docker network prune docker network rm docker node docker node demote docker node inspect docker node ls docker node promote docker node ps docker node rm docker node update docker pause docker plugin docker plugin create docker plugin disable docker plugin enable docker plugin inspect docker plugin install docker plugin ls docker plugin push docker plugin rm docker plugin set docker plugin upgrade docker port docker ps docker pull docker push docker rename docker restart docker rm docker rmi docker run docker save docker search docker secret docker secret create docker secret inspect docker secret ls docker secret rm docker service docker service create docker service inspect docker service logs docker service ls docker service ps docker service rm docker service scale docker service update docker stack docker stack deploy docker stack ls docker stack ps docker stack rm docker stack services docker start docker stats docker stop docker swarm docker swarm ca docker swarm init docker swarm join docker swarm join-token docker swarm leave docker swarm unlock docker swarm unlock-key docker swarm update docker system docker system df docker system events docker system info docker system prune docker tag docker top docker unpause docker update docker version docker volume docker volume create docker volume inspect docker volume ls docker volume prune docker volume rm docker wait Use the Docker command line (Engine) Engine: Extend Access authorization plugin (Engine) Docker log driver plugins Docker network driver plugins (Engine) Extending Engine with plugins Managed plugin system (Engine) Plugin configuration (Engine) Plugins API (Engine) Volume plugins (Engine) Engine: Security AppArmor security profiles for Docker (Engine) Automation with content trust (Engine) Content trust in Docker (Engine) Delegations for content trust (Engine) Deploying Notary (Engine) Docker security (Engine) Docker security non-events (Engine) Isolate containers with a user namespace (Engine) Manage keys for content trust (Engine) Play in a content trust sandbox (Engine) Protect the Docker daemon socket (Engine) Seccomp security profiles for Docker (Engine) Secure Engine Use trusted images Using certificates for repository client verification (Engine) Engine: Tutorials Engine tutorials Network containers (Engine) Get Started Part 1: Orientation Part 2: Containers Part 3: Services Part 4: Swarms Part 5: Stacks Part 6: Deploy your app Machine Amazon Web Services (Machine) Digital Ocean (Machine) docker-machine active docker-machine config docker-machine create docker-machine env docker-machine help docker-machine inspect docker-machine ip docker-machine kill docker-machine ls docker-machine provision docker-machine regenerate-certs docker-machine restart docker-machine rm docker-machine scp docker-machine ssh docker-machine start docker-machine status docker-machine stop docker-machine upgrade docker-machine url Driver options and operating system defaults (Machine) Drivers overview (Machine) Exoscale (Machine) Generic (Machine) Get started with a local VM (Machine) Google Compute Engine (Machine) IBM Softlayer (Machine) Install Machine Machine Machine CLI overview Machine command-line completion Machine concepts and help Machine overview Microsoft Azure (Machine) Microsoft Hyper-V (Machine) Migrate from Boot2Docker to Machine OpenStack (Machine) Oracle VirtualBox (Machine) Provision AWS EC2 instances (Machine) Provision Digital Ocean Droplets (Machine) Provision hosts in the cloud (Machine) Rackspace (Machine) VMware Fusion (Machine) VMware vCloud Air (Machine) VMware vSphere (Machine) Notary Client configuration (Notary) Common Server and signer configurations (Notary) Getting started with Notary Notary changelog Notary configuration files Running a Notary service Server configuration (Notary) Signer configuration (Notary) Understand the service architecture (Notary) Use the Notary client
characters

本文档适用于那些希望指定自定义选项的运行自己的公证服务的人员。

概述

公证签名人需要环境变量来加密私人密钥。它还需要一个配置文件,该文件是使用-config标志在命令行上指定的路径。

这是一个完整的签名者配置文件示例; 请点击顶级JSON键以了解更多关于与该键相对应的配置部分:

{  "server": {    
    "http_addr": ":4444",    
    "grpc_addr": ":7899",    
    "tls_cert_file": "./fixtures/notary-signer.crt",    
    "tls_key_file": "./fixtures/notary-signer.key",    
    "client_ca_file": "./fixtures/notary-server.crt"  
    },  
    "logging": {    "level": 2  },  
    "storage": {    
        "backend": "mysql",    
        "db_url": "user:pass@tcp(notarymysql:3306)/databasename?parseTime=true",    
        "default_alias": "passwordalias1"  
        },  
    "reporting": {    "bugsnag": {      "api_key": "c9d60ae4c7e70c4b6c4ebd3e8056d2b8",      "release_stage": "production"    }  }}

服务器部分(必填)

在本例中,“server”指的是公证签字人的HTTP/GRPC服务器,而不是“公证服务器”。

例子:

"server": {  
    "http_addr": ":4444",  
    "grpc_addr": ":7899",  
    "tls_cert_file": "./fixtures/notary-signer.crt",  
    "tls_key_file": "./fixtures/notary-signer.key",  
    "client_ca_file": "./fixtures/notary-server.crt"
    }

参数

是否需要

描述

http_addr

侦听HTTP通信的TCP地址(IP和端口)。例如:“:4444”表示监听所有IP上的端口4444(因此所有接口,例如运行ifconfig时列出的那些接口)“127.0.0.1:4444”表示只侦听本地主机上的端口4444。这意味着除了本地服务器之外,服务器将不可访问(通过SSH隧道或仅在本地终端上)

grpc_addr

侦听GRPC流量的TCP地址(IP和端口)。例如:“:7899”表示监听所有IP上的端口7899(因此所有接口,如运行ifconfig时列出的那些接口)“127.0.0.1:7899”表示只监听本地主机上的7899端口。这意味着除了本地服务器之外,服务器将不可访问(通过SSH隧道或仅在本地终端上)

tls_key_file

私钥用于HTTPS的路径。该路径相对于配置文件的目录。

tls_cert_file

用于HTTPS的证书路径。该路径相对于配置文件的目录。

client_ca_file

要相互认证的可信根证书。如果提供,连接到公证签名者的任何客户端都必须拥有由此根签名的客户端证书。如果不提供,则不需要相互认证。该路径相对于配置文件的目录。

  • ":4444"意味着在所有IP上的端口4444上监听(因此所有接口,例如运行时列出的接口ifconfig

  • "127.0.0.1:4444"表示仅在本地主机上侦听端口4444。这意味着除了本地服务器之外,服务器将不可访问(通过SSH隧道或仅在本地终端上)

`grpc_addr` yes The TCP address (IP and port) to listen for GRPC traffic. Examples:
  • ":7899"表示在所有IP上的端口7899上监听(因此所有接口,例如运行时列出的接口ifconfig

  • "127.0.0.1:7899"表示仅在本地主机上侦听端口7899。这意味着除了本地服务器之外,服务器将不可访问(通过SSH隧道或仅在本地终端上)

`tls_key_file` yes The path to the private key to use for HTTPS. The path is relative to the directory of the configuration file.   `tls_cert_file` yes The path to the certificate to use for HTTPS. The path is relative to the directory of the configuration file.   `client_ca_file` no The root certificate to trust for mutual authentication. If provided, any clients connecting to Notary signer will have to have a client certificate signed by this root. If not provided, mutual authentication will not be required. The path is relative to the directory of the configuration file.

存储部分(必填)

这用于存储加密的私钥。目前,我们只支持MySQL或内存存储.

例子:

"storage": {  
    "backend": "mysql",  
    "db_url": "user:pass@tcp(notarymysql:3306)/databasename?parseTime=true",  
    "default_alias": "passwordalias1"
    }

参数

需要

描述

后端

必须是“mysql”或“内存”。如果选择“内存”,则会忽略db_url。

db_url

是(如果不是内存)

用于访问数据库的数据源名称。(注意:请包含parseTime = true作为DSN的一部分)

default_alias

是(如果不是内存)

此参数指定用于加密数据库中私钥的当前密码的别名。所有新私钥都将使用此密码进行加密,该密码也必须作为环境变量NOTARY_SIGNER_ <DEFAULT_ALIAS_VALUE>提供。请参阅环境变量部分了解更多信息。

环境变量(使用MySQL时需要)

公证签名人以加密形式存储私钥。还会存储用于加密密钥的密码短语的别名。为了加密存储密钥和解密密钥以进行签名,密码必须作为环境变量传入。

例如,上面的配置指定默认密码别名为passwordalias1...

如果使用此配置,则必须:

export NOTARY_SIGNER_PASSWORDALIAS1=mypassword

使该公证员签名者知道加密与密码的所有密钥mypassword,并解密存储与密码别名任何私钥passwordalias1与密码mypassword

旧密码也可以作为环境变量提供。

假设您想更改用于创建新密钥的密码(旋转密码并重新加密所有私钥尚不受支持)。

您可以将配置更改为:

"storage": {  
    "backend": "mysql",  
    "db_url": "user:pass@tcp(notarymysql:3306)/databasename?parseTime=true",  
    "default_alias": "passwordalias2"
    }

然后你可以设置:

export NOTARY_SIGNER_PASSWORDALIAS1=mypasswordexport NOTARY_SIGNER_PASSWORDALIAS2=mynewfancypassword

这样,所有新密钥都将使用密码进行加密和解密mynewfancypassword,但使用密码短语加密的旧密钥mypassword仍然可以解密。

旧密码的环境变量是可选的,但如果不提供旧密钥,公证签名者将无法解密旧密钥,使用这些密钥对数据签名的尝试将失败。

相关信息

  • 公证服务器配置文件

  • 公证服务器和签名者共有的配置部分

Previous article: Next article: