Feature #5257

Explain how to add HTTPS to XMLRPC

Added by OpenNebula Systems Support Team almost 4 years ago. Updated over 3 years ago.

Status:NewStart date:07/20/2017
Priority:NormalDue date:
Assignee:-% Done:


Target version:Release 5.4.4
Resolution: Pull request:


To harden OpenNebula based clouds. Using an SSL proxy like nginx


#1 Updated by OpenNebula Systems Support Team almost 4 years ago

Notes for the docs:

$ cat /etc/nginx/conf.d/opennebula-ssl.conf 
server {
    listen 2634 ssl;
    ssl_certificate           /etc/nginx/nginx.crt;
    ssl_certificate_key       /etc/nginx/nginx.key;
    location / {
        proxy_pass          http://localhost:2633;

export ONE_XMLRPC=https://localhost:2634/RPC2
or one_endpoint

#2 Updated by Ruben S. Montero almost 4 years ago

  • Target version changed from Release 5.6 to Release 5.4.1

#3 Updated by Strahinja Kustudic almost 4 years ago

I'm willing to write this documentation, but I'm not sure where exactly to add it. I was thinking to add it to frontend_installation.rst similar like MySQL is added as option and than make a separate page about it, but I'm not sure if that is the best way to do it?

#4 Updated by Kristian Feldsam almost 4 years ago

Hii all, I like to share my config. I also use limit_req_zone to limit max connections to api

# main server config /etc/nginx/nginx.conf
# For more information on configuration, see:
#   * Official English Documentation: http://nginx.org/en/docs/
#   * Official Russian Documentation: http://nginx.org/ru/docs/

user nginx;
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;

events {
    worker_connections 1024;

http {
    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile            on;
    tcp_nopush          on;
    tcp_nodelay         on;
    keepalive_timeout   65;
    types_hash_max_size 2048;
    server_names_hash_bucket_size 64;

    include             /etc/nginx/mime.types;
    default_type        application/octet-stream;

    client_max_body_size 20M;

    limit_req_zone $binary_remote_addr zone=perip:10m rate=24r/s; # one tenth of MAX_CONN from oned.conf
    limit_req_zone $server_name zone=perserver:10m rate=240r/s; # MAX_CONN from oned.conf

    # Load modular configuration files from the /etc/nginx/conf.d directory.
    # See http://nginx.org/en/docs/ngx_core_module.html#include
    # for more information.
    include /etc/nginx/conf.d/*.conf;

# vhost config in /etc/nginx/conf.d/
server {
    listen 443;
    server_name  cloud-api.domain.tld;

    ssl on;
     ssl_certificate /etc/nginx/nginx.crt;
     ssl_certificate_key /etc/nginx/nginx.key;
     ssl_session_timeout 1d;
     ssl_session_cache shared:SSL:50m;

    # Diffie-Hellman parameter for DHE ciphersuites, recommended 2048 bits
     ssl_dhparam /etc/nginx/dhparams.pem;

    # intermediate configuration. tweak to your needs.
     ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
     ssl_prefer_server_ciphers on;

    # HSTS (ngx_http_headers_module is required) (15768000 seconds = 6 months)
     add_header Strict-Transport-Security max-age=15768000;

    # Load configuration files for the default server block.
    include /etc/nginx/default.d/*.conf;

    location / {
        limit_req zone=perip burst=48; # one tenth of MAX_CONN_BACKLOG from oned.conf
        limit_req zone=perserver burst=480;  #  MAX_CONN_BACKLOG from oned.conf

        proxy_set_header   Host             $host;
        proxy_set_header   X-Real-IP        $remote_addr;
        proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;

#5 Updated by kvaps kvaps almost 4 years ago

This is how to connect to opennebula remotely:

sudo gem install --no-user-install  opennebula-cli
echo "export ONE_XMLRPC=https://opennebula-backend.tld/RPC2" >> .bashrc
echo "export ONE_DISABLE_SSL_VERIFY=true" >> .bashrc

After re login to bash:

mkdir .one
touch .one/one_auth
oneuser login myuser

#6 Updated by Ruben S. Montero over 3 years ago

  • Target version changed from Release 5.4.1 to Release 5.4.3

#7 Updated by OpenNebula Systems Support Team over 3 years ago

  • Target version changed from Release 5.4.3 to Release 5.4.4

Also available in: Atom PDF