ironic/doc/source/install/enabling-https.rst

Enabling HTTPS

Enabling HTTPS in Swift

The drivers using virtual media use swift for storing boot images and node configuration information (contains sensitive information for Ironic conductor to provision bare metal hardware). By default, HTTPS is not enabled in swift. HTTPS is required to encrypt all communication between swift and Ironic conductor and swift and bare metal (via virtual media). It can be enabled in one of the following ways:

• Using an SSL termination proxy
• Using native SSL support in swift <deployment_guide.html> (recommended only for testing purpose by swift).

Enabling HTTPS in Image service

Ironic drivers usually use Image service during node provisioning. By default, image service does not use HTTPS, but it is required for secure communication. It can be enabled by making the following changes to /etc/glance/glance-api.conf:

1. Configuring SSL support <configuration/configuring.html#configuring-ssl-support>

2. Restart the glance-api service:

   Fedora/RHEL8/CentOS8/SUSE:
       sudo systemctl restart openstack-glance-api
   
   Debian/Ubuntu:
       sudo service glance-api restart

See the Glance <> documentation, for more details on the Image service.

Enabling HTTPS communication between Image service and Object storage

This section describes the steps needed to enable secure HTTPS communication between Image service and Object storage when Object storage is used as the Backend.

To enable secure HTTPS communication between Image service and Object storage follow these steps:

1. EnableHTTPSinSwift
2. Configure Swift Storage Backend <configuration/configuring.html#configuring-the-swift-storage-backend>
3. EnableHTTPSinGlance

Enabling HTTPS communication between Image service and Bare Metal service

This section describes the steps needed to enable secure HTTPS communication between Image service and Bare Metal service.

To enable secure HTTPS communication between Bare Metal service and Image service follow these steps:

1. Edit /etc/ironic/ironic.conf:

   [glance]
   ...
   glance_cafile=/path/to/certfile

   Note

   'glance_cafile' is an optional path to a CA certificate bundle to be used to validate the SSL certificate served by Image service.

2. If not using the keystone service catalog for the Image service API endpoint discovery, also edit the endpoint_override option to point to HTTPS URL of image service (replace <GLANCE_API_ADDRESS> with hostname[:port][path] of the Image service endpoint):

   [glance]
   ...
   endpoint_override = https://<GLANCE_API_ADDRESS>

3. Restart ironic-conductor service:

   Fedora/RHEL8/CentOS8/SUSE:
       sudo systemctl restart openstack-ironic-conductor
   
   Debian/Ubuntu:
       sudo service ironic-conductor restart