Authenticating libvirt (with VNC) against IPA
Introduction
The 'default' behaviour of KVM with libvirt is to use a UNIX socket rather than network and to only allow root read/write access to the system session with others only having user-session access read/write and the system session being read only - with this controlled via PolicyKit.
Leveraging the SASL mechanisms in libvirt allows GSSAPI for an authentication mechanism (X509 certificates are also possible but since 'user certificates' are not yet in IPA and I've not tested that in this workplace I'll leave that out of scope of this document).
The prerequisites to work through this guide are a working IPA topology and a working libvirt/kvm server (which only needs to allow root to manage the guests) that has been joined to the IPA domain.
For the purposes of this document the IPA server will be ipa01.example.com in the realm EXAMPLE.COM, the virtualization server will be kvmhost01.example.com and the guest will be kvmguest01.example.com.
Creating the services and obtaining the keytabs
In order to allow for all this to work keytabs need to be arranged for libvirt and VNC. On ipa01.example.com (or any system with ipa-admintools installed or the GUI):
ipa service-add libvirt/kvmhost01.example.com ipa service-add vnc/kvmhost01.example.com
On the KVM host server:
ipa-getkeytab -s ipa01.example.com -p libvirt/kvmhost01.example.com -k /etc/libvirt/krb5.tab ipa-getkeytab -s ipa01.example.com -p vnc/kvmhost01.example.com -k /etc/qemu/krb5.tab
With the keytabs in place libvirt and qemu now need to be configured to make use of them and enable TCP connections.
Configuring libvirt to use kerberos via SASL
In order to tell kerberos that GSSAPI is an available mechanism and to allow connections over tcp the following configuration needs to be carried out:
The appropriate changes in /etc/libvirt/libvirtd.conf are:
listen_tls = 0 listen_tcp = 1 auth_tcp = "sasl" sasl_allowed_username_list = ["*@EXAMPLE.COM" ]
To configure the SASL auth for libvirtd following this make sure you have the following in /etc/sasl2/libvirt.conf:
mech_list: gssapi keytab: /etc/libvirt/krb5.tab
Finally listening on TCP needs to be enabled in /etc/sysconfig/libvirtd:
LIBVIRTD_ARGS="--listen"
Configuring qemu to allow SASL authentication for VNC
With libvirt listening qemu needs to be configured to allow connections to console. This part of things it's the qemu process running the guest rather than the overall libvirt daemon that's responsible.
To enable the VNC side of things edit /etc/libvirt/qemu.conf:
vnc_listen = "0.0.0.0" vnc_tls = 0 vnc_sasl = 1
Then configure SASL2 appropriately in /etc/sasl2/qemu.conf:
mech_list: gssapi keytab: /etc/qemu/krb5.tab
The keytabs are 600 root:root for libvirt and 600 qemu:root for qemu.... the standard etc_t selinux type appeared to work fine.
The final note to make is an outstanding bug that affects this setup currently where the kerberos key cache that gets made by libvirt has the range set to the guest VM being connected to and then consequently connecting to another guest on the same host fails due to the selinux range on the file preventing it from being read.
As a workaround until the bug is fixed, as an example, I have the following in cron:
*/5 * * * * chcon -l s0 /var/tmp/vnc_*
This will set the range to s0 and thus all VMs can then use this replay cache for the credentials.
Firewall configuration
Although libvirtd should now be listening remotely at this point iptables should still be blocking connections. Assuming default ports for libvirt and VNC the following lines should be put in /etc/sysconfig/iptables:
-A INPUT -m state --state NEW -m tcp -p tcp --dport 5900:5999 -j ACCEPT -A INPUT -m state --state NEW -m tcp -p tcp --dport 16509 -j ACCEPT
This should be the only requirement left for connectivity.
Client usage
At this point everything should be functional. Either a remote connection should be possible or ssh -X to kvmhost01.example.com and then opening virt-manager.
To connect to libvirt over TCP use a connection string such as :
virsh -c qemu+tcp://kvmhost01.example.com/system
In the alternative add the environment variable to the client (useful on the server itself where it won't need to vary) of:
LIBVIRT_DEFAULT_URI="qemu+tcp://kvmhost01.example.com/system"
To connect to the VNC instance a client that is capable of GSSAPI for VNC should be used such as virt-viewer or the console view of virt-manager.