libvirtd.conf 6.7 KB
Newer Older
1 2 3 4 5
# Master libvirt daemon configuration file
#
# For further information consult http://libvirt.org/format.html


6 7
#################################################################
#
8
# Network connectivity controls
9 10
#

11 12 13 14
# Flag listening for secure TLS connections on the public TCP/IP port.
# NB, must pass the --listen flag to the libvirtd process for this to
# have any effect.
#
15
# It is necessary to setup a CA and issue server certificates before
16 17 18
# using this capability.
#
# This is enabled by default, uncomment this to disable it
19
#listen_tls = 0
20 21 22 23 24

# Listen for unencrypted TCP connections on the public TCP/IP port.
# NB, must pass the --listen flag to the libvirtd process for this to
# have any effect.
#
25 26 27
# Using the TCP socket requires SASL authentication by default. Only
# SASL mechanisms which support data encryption are allowed. This is
# DIGEST_MD5 and GSSAPI (Kerberos5)
28 29
#
# This is disabled by default, uncomment this to enable it.
30
#listen_tcp = 1
31 32 33 34 35 36



# Override the port for accepting secure TLS connections
# This can be a port number, or service name
#
37
#tls_port = "16514"
38 39 40

# Override the port for accepting insecure TCP connections
# This can be a port number, or service name
41 42
#
#tcp_port = "16509"
43 44


45 46 47 48 49
# Override the default configuration which binds to all network
# interfaces. This can be a numeric IPv4/6 address, or hostname
#
# ip_addr = "192.168.0.1"

50 51 52 53 54 55 56

# Flag toggling mDNS advertizement of the libvirt service.
#
# Alternatively can disable for all services on a host by
# stopping the Avahi daemon
#
# This is enabled by default, uncomment this to disable it
57
#mdns_adv = 0
58 59 60

# Override the default mDNS advertizement name. This must be
# unique on the immediate broadcast network.
61
#
62 63 64
# The default is "Virtualization Host HOSTNAME", where HOSTNAME
# is subsituted for the short hostname of the machine (without domain)
#
65
#mdns_name = "Virtualization Host Joe Demo"
66 67


68 69 70 71
#################################################################
#
# UNIX socket access controls
#
72 73 74 75

# Set the UNIX domain socket group ownership. This can be used to
# allow a 'trusted' set of users access to management capabilities
# without becoming root.
76 77 78
#
# This is restricted to 'root' by default.
#unix_sock_group = "libvirt"
79 80 81 82 83 84

# Set the UNIX socket permissions for the R/O socket. This is used
# for monitoring VM status only
#
# Default allows any user. If setting group ownership may want to
# restrict this to:
85
#unix_sock_ro_perms = "0777"
86 87 88 89

# Set the UNIX socket permissions for the R/W socket. This is used
# for full management of VMs
#
90 91 92 93 94
# Default allows only root. If PolicyKit is enabled on the socket,
# the default will change to allow everyone (eg, 0777)
#
# If not using PolicyKit and setting group ownership for access
# control then you may want to relax this to:
95
#unix_sock_rw_perms = "0770"
96 97 98



99
#################################################################
100
#
101
# Authentication.
102
#
103 104 105 106 107 108 109 110 111 112 113
#  - none: do not perform auth checks. If you can connect to the
#          socket you are allowed. This is suitable if there are
#          restrictions on connecting to the socket (eg, UNIX
#          socket permissions), or if there is a lower layer in
#          the network providing auth (eg, TLS/x509 certificates)
#
#  - sasl: use SASL infrastructure. The actual auth scheme is then
#          controlled from /etc/sasl2/libvirt.conf. For the TCP
#          socket only GSSAPI & DIGEST-MD5 mechanisms will be used.
#          For non-TCP or TLS sockets,  any scheme is allowed.
#
114 115 116 117 118 119
#  - polkit: use PolicyKit to authenticate. This is only suitable
#            for use on the UNIX sockets. The default policy will
#            require a user to supply their own password to gain
#            full read/write access (aka sudo like), while anyone
#            is allowed read/only access.
#
120 121 122 123 124 125 126 127
# Set an authentication scheme for UNIX read-only sockets
# By default socket permissions allow anyone to connect
#
# To restrict monitoring of domains you may wish to enable
# an authentication mechanism here
#auth_unix_ro = "none"

# Set an authentication scheme for UNIX read-write sockets
128 129 130
# By default socket permissions only allow root. If PolicyKit
# support was compiled into libvirt, the default will be to
# use 'polkit' auth.
131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153
#
# If the unix_sock_rw_perms are changed you may wish to enable
# an authentication mechanism here
#auth_unix_rw = "none"

# Change the authentication scheme for TCP sockets.
#
# If you don't enable SASL, then all TCP traffic is cleartext.
# Don't do this outside of a dev/test scenario. For real world
# use, always enable SASL and use the GSSAPI or DIGEST-MD5
# mechanism in /etc/sasl2/libvirt.conf
#auth_tcp = "sasl"

# Change the authentication scheme for TLS sockets.
#
# TLS sockets already have encryption provided by the TLS
# layer, and limited authentication is done by certificates
#
# It is possible to make use of any SASL authentication
# mechanism as well, by using 'sasl' for this option
#auth_tls = "none"


154

155
#################################################################
156
#
157
# TLS x509 certificate configuration
158
#
159

160 161 162

# Override the default server key file path
#
163
#key_file = "/etc/pki/libvirt/private/serverkey.pem"
164 165 166

# Override the default server certificate file path
#
167
#cert_file = "/etc/pki/libvirt/servercert.pem"
168 169 170

# Override the default CA certificate path
#
171
#ca_file = "/etc/pki/CA/cacert.pem"
172 173

# Specify a certificate revocation list.
174
#
175
# Defaults to not using a CRL, uncomment to enable it
176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195
#crl_file = "/etc/pki/CA/crl.pem"



#################################################################
#
# Authorization controls
#


# Flag to disable verification of client certificates
#
# Client certificate verification is the primary authentication mechanism.
# Any client which does not present a certificate signed by the CA
# will be rejected.
#
# Default is to always verify. Uncommenting this will disable
# verification - make sure an IP whitelist is set
#tls_no_verify_certificate = 1

196 197

# A whitelist of allowed x509  Distinguished Names
198
# This list may contain wildcards such as
199 200 201 202 203 204 205 206 207
#
#    "C=GB,ST=London,L=London,O=Red Hat,CN=*"
#
# See the POSIX fnmatch function for the format of the wildcards.
#
# NB If this is an empty list, no client can connect, so comment out
# entirely rather than using empty list to disable these checks
#
# By default, no DN's are checked
208
#tls_allowed_dn_list = ["DN1", "DN2"]
209 210


211 212 213
# A whitelist of allowed SASL usernames. The format for usernames
# depends on the SASL authentication mechanism. Kerberos usernames
# look like username@REALM
214
#
215 216 217 218 219
# This list may contain wildcards such as
#
#    "*@EXAMPLE.COM"
#
# See the POSIX fnmatch function for the format of the wildcards.
220 221 222 223
#
# NB If this is an empty list, no client can connect, so comment out
# entirely rather than using empty list to disable these checks
#
224 225
# By default, no Username's are checked
#sasl_allowed_username_list = ["joe@EXAMPLE.COM", "fred@EXAMPLE.COM" ]
226 227