xref: /openbmc/qemu/qemu.sasl (revision dfb3804d)
12f9606b3Saliguori# If you want to use the non-TLS socket, then you *must* include
22f9606b3Saliguori# the GSSAPI or DIGEST-MD5 mechanisms, because they are the only
32f9606b3Saliguori# ones that can offer session encryption as well as authentication.
42f9606b3Saliguori#
52f9606b3Saliguori# If you're only using TLS, then you can turn on any mechanisms
62f9606b3Saliguori# you like for authentication, because TLS provides the encryption
72f9606b3Saliguori#
82f9606b3Saliguori# Default to a simple username+password mechanism
92f9606b3Saliguori# NB digest-md5 is no longer considered secure by current standards
102f9606b3Saliguorimech_list: digest-md5
112f9606b3Saliguori
122f9606b3Saliguori# Before you can use GSSAPI, you need a service principle on the
132f9606b3Saliguori# KDC server for libvirt, and that to be exported to the keytab
142f9606b3Saliguori# file listed below
152f9606b3Saliguori#mech_list: gssapi
162f9606b3Saliguori#
172f9606b3Saliguori# You can also list many mechanisms at once, then the user can choose
182f9606b3Saliguori# by adding  '?auth=sasl.gssapi' to their libvirt URI, eg
192f9606b3Saliguori#   qemu+tcp://hostname/system?auth=sasl.gssapi
202f9606b3Saliguori#mech_list: digest-md5 gssapi
212f9606b3Saliguori
222f9606b3Saliguori# Some older builds of MIT kerberos on Linux ignore this option &
232f9606b3Saliguori# instead need KRB5_KTNAME env var.
242f9606b3Saliguori# For modern Linux, and other OS, this should be sufficient
25*dfb3804dSLaszlo Ersek#
26*dfb3804dSLaszlo Ersek# There is no default value here, uncomment if you need this
27*dfb3804dSLaszlo Ersek#keytab: /etc/qemu/krb5.tab
282f9606b3Saliguori
292f9606b3Saliguori# If using digest-md5 for username/passwds, then this is the file
302f9606b3Saliguori# containing the passwds. Use 'saslpasswd2 -a qemu [username]'
31805695daSCole Robinson# to add entries, and 'sasldblistusers2 -f [sasldb_path]' to browse it
322f9606b3Saliguorisasldb_path: /etc/qemu/passwd.db
332f9606b3Saliguori
342f9606b3Saliguori
352f9606b3Saliguoriauxprop_plugin: sasldb
362f9606b3Saliguori
37