Chapter 1. Installing a sample instance of Red Hat Single Sign-On
This section describes how to install and start a Red Hat Single Sign-On server in standalone mode, set up the initial admin user, and log in to the Red Hat Single Sign-On Admin Console.
This installation is intended for practice use of Red Hat Single Sign-On. For instructions on installation in a production environment and full details on all product features, see the other guides in the Red Hat Single Sign-On documentation.
1.1. Installing the Red Hat Single Sign-On server
For this sample instance of Red Hat Single Sign-On, this procedure involves installation in standalone mode. The server download ZIP file contains the scripts and binaries to run the Red Hat Single Sign-On server. You can install the server on Linux or Windows.
- Go to the Red Hat customer portal.
- Download the Red Hat Single Sign-On Server: rh-sso-7.4.0.zip
- Place the file in a directory you choose.
Unpack the ZIP file using the appropriate
unziputility, such as unzip, or Expand-Archive.
$ unzip rhsso-7.4.0.zip
> Expand-Archive -Path 'C:Downloads\rhsso-7.4.0.zip' -DestinationPath 'C:\Downloads'
1.2. Starting the Red Hat Single Sign-On server
You start the server on the system where you installed it.
- You saw no errors during the Red Hat Single Sign-On server installation.
Go to the
bindirectory of the server distribution.
$ cd bin $ ./standalone.sh
1.3. Creating the admin account
Before you can use Red Hat Single Sign-On, you need to create an admin account which you use to log in to the Red Hat Single Sign-On admin console.
- You saw no errors when you started the Red Hat Single Sign-On server.
Open http://localhost:8080/auth in your web browser.
The welcome page opens, confirming that the server is running.
- Enter a username and password to create an initial admin user.
1.4. Logging into the admin console
After you create the initial admin account, you can log in to the admin console. In this console, you add users and register applications to be secured by Red Hat Single Sign-On.
- You have an admin account for the admin console.
Click the Administration Console link on the Welcome page or go directly to http://localhost:8080/auth/admin/ (the console URL).Note
The Administration Console is generally referred to as the admin console for short in Red Hat Single Sign-On documentation.
Enter the username and password you created on the Welcome page to open the admin console.
Admin console login screen
The initial screen for the admin console appears.
Now that you can log into the admin console, you can begin creating realms where administrators can create users and give them access to applications. For more details, see Creating a realm and a user.