Este conteúdo não está disponível no idioma selecionado.

Chapter 6. Refreshing the self-signed CA certificate on hosts


When you change the CA certificate on your Satellite Server, you must refresh the CA certificate on your hosts.

Ensure that you use a temporary dual CA certificate file for uninterrupted operation. For more information, see Planning for self-signed CA certificate renewal in Administering Red Hat Satellite.

If you have already changed the CA certificate on Satellite Server without using the temporary dual CA certificate file, you must refresh the certificate on hosts manually because the scripted variant will not recognize Satellite Server.

Important

You only must redeploy the CA certificate if you use a self-signed CA certificate.

6.1. Deploying the CA certificate on a host by using Script REX

You can use remote execution (REX) with the Script provider to deploy the CA certificate.

Prerequisites

  • The host is registered to Satellite.
  • Remote execution is enabled on the host.
  • The CA certificate has been changed on Satellite Server. For more information, see Planning for self-signed CA certificate renewal in Administering Red Hat Satellite.

Procedure

  1. In the Satellite web UI, navigate to Monitor > Jobs.
  2. Click Run Job.
  3. From the Job category list, select Commands.
  4. From the Job template list, select Download and run a script.
  5. Click Next.
  6. Select hosts on which you want to execute the job.
  7. In the url field, enter the following URL:

    https://satellite.example.com/unattended/public/foreman_ca_refresh
    Copy to Clipboard Toggle word wrap

    Replace satellite.example.com with the FQDN of your Satellite Server.

    You can use HTTP when the CA certificate is expired.

  8. Optional: Click Next and configure advanced fields and scheduling as you require.
  9. Click Run on selected hosts.

Verification

  • If the host can access Satellite Server, the following command succeeds on your host:

    $ curl --head https://satellite.example.com
    Copy to Clipboard Toggle word wrap

    Replace satellite.example.com with the FQDN of your Satellite Server.

  • If the host can access Capsule Server, the following command succeeds on your host:

    $ curl --head https://capsule.example.com:9090/features
    Copy to Clipboard Toggle word wrap

    Replace capsule.example.com with the FQDN of your Capsule Server.

6.2. Deploying the CA certificate on a host by using Ansible REX

You can use remote execution (REX) with the Ansible provider to deploy the CA certificate.

Prerequisites

  • The host is registered to Satellite.
  • Remote execution is enabled on the host.
  • The CA certificate has been changed on Satellite Server. For more information, see Planning for self-signed CA certificate renewal in Administering Red Hat Satellite.

Procedure

  1. In the Satellite web UI, navigate to Monitor > Jobs.
  2. Click Run Job.
  3. From the Job category list, select Ansible Commands.
  4. From the Job template list, select Download and execute a script.
  5. Click Next.
  6. Select hosts on which you want to execute the job.
  7. In the url field, enter the following URL:

    https://satellite.example.com/unattended/public/foreman_ca_refresh
    Copy to Clipboard Toggle word wrap

    Replace satellite.example.com with the FQDN of your Satellite Server.

    You can use HTTP when the CA certificate is expired.

  8. Optional: Click Next and configure advanced fields and scheduling as you require.
  9. Click Run on selected hosts.

Verification

  • If the host can access Satellite Server, the following command succeeds on your host:

    $ curl --head https://satellite.example.com
    Copy to Clipboard Toggle word wrap

    Replace satellite.example.com with the FQDN of your Satellite Server.

  • If the host can access Capsule Server, the following command succeeds on your host:

    $ curl --head https://capsule.example.com:9090/features
    Copy to Clipboard Toggle word wrap

    Replace capsule.example.com with the FQDN of your Capsule Server.

6.3. Deploying the CA certificate on a host manually

You can deploy the CA certificate on the host manually by rendering a public provisioning template, which provides the CA certificate.

Prerequisites

  • You have root access on both your Satellite Server and your host.

Procedure

  1. Download the certificate on your Satellite Server:

    # curl -o "satellite_ca_cert.crt" https://satellite.example.com/unattended/public/foreman_raw_ca
    Copy to Clipboard Toggle word wrap

    Replace satellite.example.com with the FQDN of your Satellite Server.

  2. Transfer the CA certificate to your host securely, for example by using scp.
  3. Login to your host by using SSH.
  4. Copy the certificate to the Subscription Manager configuration directory:

    # cp -u satellite_ca_cert.crt /etc/rhsm/ca/katello-server-ca.pem
    Copy to Clipboard Toggle word wrap
  5. Copy the certificate to the truststore:

    # cp satellite_ca_cert.crt /etc/pki/ca-trust/source/anchors
    Copy to Clipboard Toggle word wrap
  6. Update the truststore:

    # update-ca-trust
    Copy to Clipboard Toggle word wrap

Verification

  • If the host can access Satellite Server, the following command succeeds on your host:

    $ curl --head https://satellite.example.com
    Copy to Clipboard Toggle word wrap

    Replace satellite.example.com with the FQDN of your Satellite Server.

  • If the host can access Capsule Server, the following command succeeds on your host:

    $ curl --head https://capsule.example.com:9090/features
    Copy to Clipboard Toggle word wrap

    Replace capsule.example.com with the FQDN of your Capsule Server.

Voltar ao topo
Red Hat logoGithubredditYoutubeTwitter

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Ajudamos os usuários da Red Hat a inovar e atingir seus objetivos com nossos produtos e serviços com conteúdo em que podem confiar. Explore nossas atualizações recentes.

Tornando o open source mais inclusivo

A Red Hat está comprometida em substituir a linguagem problemática em nosso código, documentação e propriedades da web. Para mais detalhes veja o Blog da Red Hat.

Sobre a Red Hat

Fornecemos soluções robustas que facilitam o trabalho das empresas em plataformas e ambientes, desde o data center principal até a borda da rede.

Theme

© 2025 Red Hat