Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Overview

Some remote repositories (e.g. Red Hat Networks) block access from clients that are not authenticated with an SSL/TLS certificate. Therefore, to use a remote repository to proxy such resources, Artifactory must be equipped with the corresponding SSL/TLS certificate.

To support this requirement when needed, from version 5.4, Artifactory lets you manage certificates and configure them for use by remote repositories.

Page Contents


Adding Certificates

Certificates are managed in the Admin module under Security | Certificates.

A certificate entered into this module should be a PEM file that includes both a private key and its corresponding certificate.

Certificates

To add a new certificate, click New.

New Certificate

Provide the  Certificate Alias and copy the certificate contents into the designated area. Alternatively, you can drag and drop the corresponding PEM file into the designated area.

To avoid text errors, we recommend dragging and dropping the PEM file into the designated area

Password-protected PEM files are not supported

 Make sure the PEM file you upload is not password-protected.

 


Using a Certificate with a Remote Repository

When a remote repository proxy's a resource that requires authentication with a certificate, you need to obtain the certificate from the resource's owner and add it to the list of certificates as described above.

Under the remote repository's Other Settings, select the certificate you want to use from the list provided in the SSL/TLS Certificate field.

Proxying a Resource that Uses a Self-Signed Certificates

If the remote resource that your Artifactory remote repository is proxying (e.g. Red Hat Network's server) uses an untrusted server certificate (i.e. it is self-signed and not signed by any known Certificate Authority), you need to import the server's certificate into Artifactory's JVM truststore. To learn more about configuring a Self-Signed Certificate in Artifactory, please refer to Using a Self-Signed Certificate.  

You cannot configure a self-signed certificate in Artifactory SaaS

If you are using Artifactory SaaS (as opposed to an on-prem installation), you will not be able to proxy resources that use untrusted (i.e. self-signed) certificates since you do not have access to the Artifactory SaaS JVM truststore.


REST API

Artifactory supports automated management of certificates using the REST API endpoints described below

Get Certificates

Gets a list of installed SSL certificates.

For details, refer to the REST API documentation for Get Certificates.

Add Certificate

Installs a new SSL certificate.

For details, refer to the REST API documentation for Add Certificate.

Delete Certificate

Deletes the specified certificate.

For details, refer to the REST API documentation for Delete Certificate