diff --git a/src/murano-manual/src/docbkx/content/installation-guide.xml b/src/murano-manual/src/docbkx/content/installation-guide.xml index 58a7d73..09c02cf 100644 --- a/src/murano-manual/src/docbkx/content/installation-guide.xml +++ b/src/murano-manual/src/docbkx/content/installation-guide.xml @@ -527,4 +527,143 @@ service murano-api start +
+ SSL configuration +
+ HTTPS for Murano API + + SSL for Murano API service + can be enabled in ssl section in + /etc/murano-api.conf. The use of SSL is + automatically implemented by using a URL starting with HTTPS instead of HTTP. + SSL configuration example using the included sample certificates: + + + + keyfile = + ca_certs = + cert_required = True + ]]> + + + + + enable: True enables SSL. Defaults to False. + + + + + certfile: Path to Keystone public certificate file. + + + + + keyfile: Path to Keystone private certificate file. + If the private key is included in the certfile, the keyfile maybe omitted. + + + + + ca_certs: Path to CA trust chain. + + + + + cert_required: + Requires client certificate. Defaults to False. + + + +
+
+ SSL for RabbitMQ + + All Murano components communicate with each other + by RabbitMQ. This interaction can be encrypted with SSL. By + default all messages in Rabbit MQ are not encrypted. + Each RabbitMQ Exchange should be configured separately. + +
+ Murano API -> Rabbit MQ exchange + + Edit rabbitmq section in /etc/murano-api.conf + and set ssl option to True to enable SSL. Specify the path to the + SSL CA certificate in regular format: /path/to/file without quotes or leave it empty to allow + self-signed certificates. + + + + +
+
+ Rabbit MQ -> Murano Conductor exchange + + Open /etc/murano-conductor/conductor.conf + and configure rabbitmq section in the same way: + Enable ssl option to True and set CA certificate path or leave it empty to allow + self-signed certificates. + + + + +
+
+ Murano Agent -> Rabbit MQ exchange + + By default all Murano Conductor configuration settings apply to Murano Agent. + If you want to configure Murano Agent in a different way change the default template. It can be found + here:/murano-conductor/data/templates/agent-config/Default.template. + Take a look at appSettings section: + + + + + + + + + + + + + + + + + + ]]> + + + Desired parameter should be set directly to the value of the key + that you want to change. Quotes are need to be kept. + Thus you can change "rabbitmq.ssl" and "rabbitmq.port" values to + make Rabbit MQ work with this exchange in a different from + Murano-Conductor way. + +
+
+
\ No newline at end of file