harbor/docs/install-config/configure-internal-tls.md
DQ 01f6061e31 Add doc for internal tls
1. Add md file
2. Update index

Signed-off-by: DQ <dengq@vmware.com>
2020-05-13 19:28:33 +08:00

2.9 KiB

title weight
Configure Internal TLS communication between Harbor Component 30

By default, The internal communication between Harbor's component (harbor-core,harbor-jobservice,proxy,harbor-portal,registry,registryctl,trivy_adapter,clair_adapter,chartmuseum) use HTTP protocol which might not be secure enough for some production environment. Since Harbor v2.0, TLS can be used for this internal network. In production environments, always use HTTPS is a recommended best practice.

This functionality is introduced via the internal_tls in harbor.yml file. To enabled internal TLS, set enabled to true and set the dir value to the path of directory that contains the internal cert files.

All certs can be automatically generated by prepare tool.

docker run -v /:/hostfs goharbor/prepare:v2.0 gencert -p /path/to/internal/tls/cert

User also can provide their own CA to generate the other certs. Just put certificate and key of the CA on internal tls cert directory and name them as harbor_internal_ca.key and harbor_internal_ca.crt. Besides, a user can also provide the certs for all components. However, there are some constraints for the certs:

  • First, all certs must be signed by a single unique CA
  • Second, the filename of the internal cert and CN field on cert file must follow the convention listed below'
    name usage CN
    harbor_internal_ca.key ca's key file for internal TLS N/A
    harbor_internal_ca.crt ca's certificate file for internal TLS N/A
    core.key core's key file N/A
    core.crt core's certificate file core
    job_service.key job_service's key file N/A
    job_service.crt job_service's certificate file jobservice
    proxy.key proxy's key file N/A
    proxy.crt proxy's certificate file proxy
    portal.key portal's key file N/A
    portal.crt portal's certificate file portal
    registry.key registry's key file N/A
    registry.crt registry's certificate file registry
    registryctl.key registryctl's key file N/A
    registryctl.crt registryctl's certificate file registryctl
    notary_server.key notary_server's key file N/A
    notary_server.crt notary_server's certificate file notary-server
    notary_signer.key notary_signer's key file N/A
    notary_signer.crt notary_signer's certificate file notary-signer
    trivy_adapter.key trivy_adapter.'s key file N/A
    trivy_adapter.crt trivy_adapter.'s certificate file trivy-adapter
    clair.key clair's key file N/A
    clair.crt clair's certificate file clair
    clair_adapter.key clair_adapter's key file N/A
    clair_adapter.crt clair_adapter's certificate file clair-adapter
    chartmuseum.key chartmuseum's key file N/A
    chartmuseum.crt chartmuseum's certificate file chartmuseum