HOW TO RUN REMOTE X APPLICATIONS 1. Introduction This is (supposed to be) a guide how to do remote X applications. The focus is on security issues. I have written this document for several reasons. 1. Many questions have appeared on usenet on how to run a remote X application. 2. I see many, many hints of use xhost +hostname or even xhost + to allow X connections. _This is ridiculously insecure_, and there are better methods. 3. I do not know of a simple document that describes the options you _do_ have. Please inform me if you know more. This document has been written with unix-like systems in mind. If either your local or remote operating system are of another flavour, you may find here how things work. However, you will have to translate examples yourself to apply to your own system(s). A related document on WWW is What to do when Tk says that your display is insecure . It was written by Kevin Kenny. It suggests a similar solution to X authentication to that in this document (xauth). However, Kevin aims more at using xdm to steer xauth for you. The X System Window System Vol. 8 X Window System Administrator's Guide by O'Reilly and Associates has also been brought to my attention as a good source of information. Unfortunately, I've not been able to check it out. Yet another document much like the one you're reading now, titled Securing X Windows, is available at . This is version 0.4.0. No guarantees, only good intentions. I'm open to suggestions, ideas, additions, useful pointers, (typo) corrections, etc... I want this to remain a simple readable document, though, in the best-meant HOWTO style. Flames to /dev/null. The most recent version of this document is always available on WWW at . This document is posted irregularly to comp.windows.x. It is also available as the Linux Remote X Apps mini-HOWTO at . Linux (mini-)HOWTOs are available by http or ftp from sunsite.unc.edu. A Japanese translation is available via . Contents last updated on 12 February 1998 by Vincent Zweije. 2. Index 1. Introduction - why, when, where, what else 2. Index - voici! 3. The Scene - what you're trying to do 4. A Little Theory - you have to know to understand 5. Telling the Client - where the display is 6. Telling the Server - whom to display for 1. Xhost - host based access 2. Xauth - secret based access 3. Ssh - encrypted forwarding 7. Troubleshooting - common mistakes _________________________________________________________________ 3. The Scene You're using two computers. You're using the X window system of the first to type to and look at. You're using the second to do some important graphical work. You want the second to show its output on the display of the first. The X window system makes this possible. Of course, you need a network connection for this. Preferably a fast one; the X protocol is a network hog. But with a little patience and suitable protocol compression, you can even run applications over a modem. For X protocol compression, you might want to check out dxpc or LBX (also known as the LBX mini-HOWTO). You must do two things to achieve all this: 1. Tell the local display (the server) to accept connections from the remote computer. 2. Tell the remote application (the client) to direct its output to your local display. 4. A Little Theory The magic word is DISPLAY. In the X window system, a display consists (simplified) of a keyboard, a mouse and a screen. A display is managed by a server program, known as an X server. The server serves displaying capabilities to other programs that connect to it. A display is indicated with a name, for instance: * DISPLAY=light.uni.verse:0 * DISPLAY=localhost:4 * DISPLAY=:0 The display consists of a hostname (such as light.uni.verse and localhost), a colon (:), and a sequence number (such as 0 and 4). The hostname of the display is the name of the computer where the X server runs. An omitted hostname means the local host. The sequence number is usually 0 -- it can be varied if there are multiple displays connected to one computer. If you ever come across a display indication with an extra .n attached to it, that's the screen number. A display can actually have multiple screens. Usually there's only one screen though, with number n=0. Other forms of DISPLAY exist, but this will do for our purposes. 5. Telling the Client The client program (for instance, your graphics application) knows which display to connect to by inspecting the DISPLAY environment variable. This setting can be overridden, though, by giving the client the command line argument -display hostname:0 when it's started. Some examples may clarify things. Our computer is known to the outside as light, and we're in domain uni.verse. If we're running a normal X server, the display is known as light.uni.verse:0. We want to run the drawing program xfig on a remote computer, called dark.matt.er, and display its output here on light. If you have csh running on the remote computer: dark% setenv DISPLAY light.uni.verse:0 dark% xfig & Or alternatively: dark% xfig -display light.uni.verse:0 & If you have sh running on the remote computer: dark$ DISPLAY=light.uni.verse:0 dark$ export DISPLAY dark$ xfig & Or alternatively: dark$ DISPLAY=light.uni.verse:0 xfig & Or, of course, also: dark$ xfig -display light.uni.verse:0 & It seems that some versions of telnet automatically transport the DISPLAY variable to the remote host. If you have one of those, you're lucky, and it's automatic. If not, most versions of telnet _do_ transport the TERM environment variable; with some judicious hacking it is possible to piggyback the DISPLAY variable on to the TERM variable. However, you're on own here from my point of view. 6. Telling the Server The server will not accept connections from just anywhere. You don't want everyone to be able to display windows on your screen. Or read what you type -- remember that your keyboard is part of your display! Too few people seem to realise that allowing access to your display poses a security risk. Someone with access to your display can read and write your screens, read your keystrokes, and read your mouse actions. Most servers know two ways of authenticating connections to it: the host list mechanism (xhost) and the magic cookie mechanism (xauth). Then there is ssh, the secure shell, that can forward X connections. 6.1 Xhost Xhost allows access based on hostnames. The server maintains a list of hosts which are allowed to connect to it. It can also disable host checking entirely. Beware: this means no checks are done, so _every_ host may connect! You can control the server's host list with the xhost program. To use this mechanism in the previous example, do: light$ xhost +dark.matt.er This allows all connections from host dark.matt.er. As soon as your X client has made its connection and displays a window, for safety, revoke permissions for more connections with: light$ xhost -dark.matt.er You can disable host checking with: light$ xhost + This disables host access checking and thus allows _everyone_ to connect. You should _never_ do this on a network on which you don't trust _all_ users (such as Internet). You can re-enable host checking with: light$ xhost - xhost - by itself does _not_ remove all hosts from the access list (that would be quite useless - you wouldn't be able to connect from anywhere, not even your local host). _Xhost is a very insecure mechanism._ It does not distinguish between different users on the remote host. Also, hostnames (addresses actually) can be spoofed. This is bad if you're on an untrusted network (for instance already with dialup PPP access to Internet). 6.2 Xauth Xauth allows access to anyone who knows the right secret. Such a secret is called an authorization record, or a magic cookie. This authorization scheme is formally called MIT-MAGIC-COOKIE-1. The cookies for different displays are stored together in ~/.Xauthority. The xauth program manages these cookies, hence the nickname xauth for the scheme. Your ~/.Xauthority must be inaccessible for group/other users. On starting a session, the server will read a cookie from the file that is indicated by the -auth argument. After that, the server only allows connections from clients that know the same cookie. When the cookie in ~/.Xauthority changes, _the server will not pick up the change_. Newer servers can generate cookies on the fly for clients that ask for it. Cookies are still kept inside the server though; the don't end up in ~/.Xauthority unless a client puts them there. According to David Wiggins: A further wrinkle was added in X11R6.3 that you may be interested in. Via the new SECURITY extension, the X server itself can generate and return new cookies on the fly. Furthermore, the cookies can be designated "untrusted" so that applications making connections with such cookies will be restricted in their operation. For example, they won't be able to steal keyboard/mouse input, or window contents, from other trusted clients. There is a new "generate" subcommand to xauth to make this facility at least possible to use, if not easy. Xauth has a clear security advantage over xhost. You can limit access to specific users on specific computers. It does not suffer from spoofed addresses as xhost does. And if you want to, you can still use xhost next to it to allow connections. 6.2.1 Making the Cookie If you want to use xauth, you must start the X server with the -auth authfile argument. If you use the _startx_ script to start the X server, that's the right place to do it. Create the authorization record as below in your startx script. Excerpt from /usr/X11R6/bin/startx: mcookie|sed -e 's/^/add :0 . /'|xauth -q xinit -- -auth "$HOME/.Xauthority" Mcookie is a tiny program in the util-linux package, primary site . Alternatively, you can use md5sum to massage some random data (from, for instance, /dev/urandom or ps -axl) into cookie format: dd if=/dev/urandom count=1|md5sum|\ sed -e 's/^\([0-9a-f]*\).*$/add :0 . \1/'|xauth -q xinit -- -auth "$HOME/.Xauthority" If you can't edit the startx script (because you aren't root), get your system administrator to set up startx properly, or let him set up xdm instead. If he can't or won't, you can make a ~/.xserverrc script. If you have this script, it is run by xinit instead of the real X server. Then you can start the real X server from this script with the proper arguments. To do so, have your ~/.xserverrc use the mcookie line above to create a cookie and then exec the real X server: #!/bin/sh mcookie|sed -e 's/^/add :0 . /'|xauth -q exec /usr/X11R6/bin/X "$@" -auth "$HOME/.Xauthority" If you use _xdm_ to manage your X sessions, you can use xauth easily. Define the DisplayManager.authDir resource in /etc/X11/xdm/xdm-config. Xdm will pass the -auth argument to the X server when it starts. When you then log in under xdm, xdm puts the cookie in your ~/.Xauthority for you. See xdm(1) for more information. For instance, my /etc/X11/xdm/xdm-config has the following line in it: DisplayManager.authDir: /var/lib/xdm 6.2.2 Transporting the Cookie Now that you have started your X session on the server host light.uni.verse and have your cookie in ~/.Xauthority, you will have to transfer the cookie to the client host, dark.matt.er. The easiest is when your home directories on light and dark are shared. The ~/.Xauthority files are the same, so the cookie is transported instantaneously. If not, you can transport the cookie by means of rsh, the remote shell: light$ xauth nlist :0 | rsh dark.matt.er xauth nmerge - This says: 1. Extract the cookie from your local ~/.Xauthority (xauth nlist :0). 2. Transfer it to dark.matt.er (| rsh dark.matt.er). 3. Put it in the ~/.Xauthority there (xauth nmerge -). It's possible that rsh doesn't work for you. Besides that, rsh also has a security drawback (spoofed host names again, if I remember correctly). If you can't or don't want to use rsh, you can also transfer the cookie manually, like: light$ echo $DISPLAY :0 light$ xauth list $DISPLAY light/unix:0 MIT-MAGIC-COOKIE-1 076aaecfd370fd2af6bb9f5550b26926 light$ rlogin dark.matt.er Password: dark% setenv DISPLAY light.uni.verse:0 dark% xauth add $DISPLAY . 076aaecfd370fd2af6bb9f5550b26926 dark% xfig & [15332] dark% logout light$ See also rsh(1) and xauth(1x) for more information. Just as an idea: it might be possible to piggyback the cookie on the TERM variable when you telnet to the remote host, and so still have it automated. Look in section 6.1 on DISPLAY transfer. I'm interested if anyone can confirm or deny this. 6.2.3 Using the Cookie An X application on dark.matt.er, such as xfig above, will automatically look in ~/.Xauthority there for the cookie to authenticate itself with. 6.3 Ssh Authority records are transmitted with no encryption. If you're even worried someone might snoop on your connections, use ssh, the secure shell. It will do X forwarding over encrypted connections. And besides, it's great in other ways too. It's a good structural improvement to your system. Just visit , the ssh home page. Who knows anything else on authentication schemes or encrypting X connections? Maybe Kerberos? 7. Troubleshooting The first time you try to run a remote X application, it usually does not work. Here are a few common error messages, their probable causes, and solutions to help you on your way. xterm Xt error: Can't open display: There is no DISPLAY variable in the environment, and you didn't tell the application with the -display flag either. The application assumes the empty string, but that is syntactically invalid. To solve this, be sure that you set the DISPLAY variable correctly in the environment (with setenv or export depending on your shell). _X11TransSocketINETConnect: Can't connect: errno = 101 xterm Xt error: Can't open display: love.dial.xs4all.nl:0 The application could not make a network connection to the server. Check that you have the correct DISPLAY set, and that the server machine is reachable from your client (it should be, after all you're probably logged in to the server and telnetting to the client). _X11TransSocketINETConnect: Can't connect: errno = 111 xterm Xt error: Can't open display: love.dial.xs4all.nl:0 The server machine you're trying to connect to is reachable, but the indicated server does not exist there. Check that you are using the right host name and the right display number. Xlib: connection to ":0.0" refused by server Xlib: Client is not authorized to connect to Server xterm Xt error: Can't open display: love.dial.xs4all.nl:0.0 The client could make a connection to the server, but the server does not allow the client to use it (not authorized). Make sure that you have transported the correct magic cookie to the client, and that it has not expired (the server uses a new cookie when a new session starts).