onefC demo application: installation

This page describes how to install the software needed to test the onefC demo application.

Prerequisites

You need the following software installed:

• Firefox 1.0. Our identity management client is an extension for this beautiful software. Future versions of it may support the grandfather Mozilla itself.
• Java 1.4. We don't know if any other version works, any reports on 1.3 or 1.5 are welcome.
• You also need Internet access. Apparently you have it, otherwise you would not see this page. But seriously, even if you try the examples locally on your machine, you need to assign an IP address for your machine, otherwise you'll get into problems.

Installing the onefC software

You need to install two software components for the example to work:

• the session manager proxy
• the identity and session management client

You also need to configure your web browser (which can be Firefox or anything else) to use a proxy.

Step one: Installing the local session manager proxy

The local session manager of this example is a web proxy, Scone (see the Scone Homepage for more information). If you already have Scone, please use our distribution anyway: it includes the onefC plugin, all libraries, preference settings and startup parameters you need. Download this scone distribution, unzip the archive and call "runScone.bat" (on MS Windows) or "runScone.sh" (if you have a real shell), and you're done for this step. You should see some output on the command line, hopefully no error messages or exceptions. The proxy starts to listen on port 8088, so if you already have something running there, you need to change the configuration of either.

Step two: Installing the identity and session management client (mozidm)

The onefC identity and session management client is an extension for the browser Firefox, which is available for several platforms. Download the extension and open it in Firefox. After installation, you can find a new entry in your "Tools" menu, which fires up the client. You can also call the Firefox binary with the parameters "-chrome chrome://mozidm/content/mozidm.xul" to get it directly.

Step three: Configuring your web browser

You need to configure your web browser to use the proxy you installed in step one. The address is "localhost" port 8088. If you use the Firefox profile which also holds the mozidm client, and you have not configured a web proxy before, you're already done. This also means that you must change this setting or delete the mozidm extension if you want to use Firefox without the Scone web proxy in the future. In any other case, please consult the documentation of your browser (or system) how to use a web proxy (in most cases it is very easy to find).