1.1 Logging In

This section describes how to log in to SGD and display the SGD workspace.

1.1.1 User Credentials

When you use SGD, you need to know your user credentials for the following servers:

  • The SGD server

  • The application servers that run your applications

User credentials are typically a user name and password, but can include other things such as digital certificates or secure keys.

The following table describes the user credentials you may require when using SGD.

User Credentials

Description

SGD server

When you log in to SGD, you need to enter your user credentials, so that the SGD server knows who you are and can display your workspace. You do not need to enter your credentials again until the next time you log in to SGD.

You can log in to SGD with a user name and password.

Depending on how SGD is configured, you can log in using a digital certificate, called a client certificate.

If you are using the single sign-on feature of Oracle applications, you may not need to enter your user credentials.

You may also be able to log in to SGD anonymously, that is, without entering credentials.

If your password has expired or is about to expire, you may be prompted to change your password.

Application servers

When you start an application, you may need to supply a password for the application server that runs it. The SGD server can remember these passwords, so you do not need to enter them every time. Use the Save This Password option, if available, when you enter your user name and password.

If you use a secure digital key, called an SSH key, you do not need to enter a user name and password.

If you are using the single sign-on feature of Oracle applications, you may not need to enter a user name and password.

If you want to use a different user name and password to run an application, you can force SGD to prompt you.

1.1.2 Ways to Log In to SGD

There are several possible ways to log in to SGD, depending on the configuration of your browser and computer. The most common ways are as follows:

You can use the Client Options feature to select the login method that you want to use. See Section 1.1.5, “Client Options”.

1.1.3 Logging In to SGD

Before you log in to SGD, ensure that the following requirements are met:

  • JavaScript software is enabled in your browser

  • Cookies are enabled for your browser

  • You have a user name and password for the SGD server. Contact your SGD Administrator if you do not know your user name and password.

  • You know the login URL for the SGD server. Contact your SGD Administrator if you do not know the URL for the SGD login page.

The following procedure describes how to obtain and install the SGD Client and then use it to log in to SGD with a browser. You do not require Java software to be installed on your computer.

  1. Download the SGD Client program and install it on your computer.

    You only need to do this the first time that you log in to SGD.

    Using a browser, go to the SGD web server Welcome page. For example, https://server.example.com, where server.example.com is the name of the SGD server.

    Click Install the Oracle Secure Global Desktop Client and follow the on-screen instructions to download and install the SGD Client.

    Detailed instructions for installing the SGD Client are given in Section A.1, “Installing the SGD Client”.

  2. Using your browser, go to the SGD login URL.

    The SGD login URL is usually https://server.example.com/sgd, where server.example.com is the name of the SGD server.

    The SGD login dialog box is displayed. See Figure 1.1, “SGD Login Dialog Box”.

    Figure 1.1 SGD Login Dialog Box


    Note

    If JavaScript is not enabled in your browser, a warning message is displayed beneath the login dialog box.

  3. (Optional) Select your preferred language.

    Click a language from the language list and click the Check icon.

    The login dialog box is displayed in the selected language.

  4. Enter your SGD user name and password.

  5. Click Login to log in to SGD.

    While SGD is starting up, the splash screen is shown. See Figure 1.2, “SGD Splash Screen”.

    Figure 1.2 SGD Splash Screen


  6. A dialog box prompts you to start the Oracle Secure Global Desktop Client. See Figure 1.3, “Prompt to Start the SGD Client, Shown Using Firefox”.

    Figure 1.3 Prompt to Start the SGD Client, Shown Using Firefox

    Dialog box with prompt to start the SGD Client, shown for Firefox on a Windows client

  7. Click the on-screen prompt to start the SGD Client.

    The prompt varies, depending on the browser and client platform.

  8. (Optional) The Untrusted Initial Connection message may be displayed.

    This is a security message that is shown the first time that you connect to an SGD server. It enables you to check the hostname and server certificate details before agreeing to the connection. See Figure 1.4, “Untrusted Initial Connection Dialog Box”.

    Figure 1.4 Untrusted Initial Connection Dialog Box

    Untrusted Initial Connection dialog box

    Click Yes to connect to the SGD server.

  9. The SGD Client icon is displayed in the task bar, as shown in Figure 1.5, “SGD Client Task Bar Icon”.

    Figure 1.5 SGD Client Task Bar Icon

    SGD Client task bar icon

    The SGD workspace is displayed. See Figure 1.12, “SGD Workspace”.

1.1.4 Using Java Software

Using Java software to log in to SGD means that the SGD Client is downloaded and installed automatically on your computer. You can use Java software to log in to SGD in the following ways:

1.1.4.1 Using Java Web Start

If Java technology is not enabled in your browser, or if your browser does not support Java technology, you can use Java Web Start software to log in to SGD.

Java Web Start is an Oracle technology for installing Java applications without using applets or browser plug-in software. See https://www.java.com/en/download/faq/java_webstart.xml for more information.

Note

To use Java Web Start, Java software must be installed on your computer.

Contact your Administrator if you need help with using Java Web Start.

Logging In to SGD With Java Web Start

The steps for logging in to SGD with Java Web Start are similar to those described in Section 1.1.3, “Logging In to SGD”. Depending on how your computer is configured, you may see some extra Java Web Start prompts when you log in to SGD.

  1. Using your browser, go to the SGD login URL.

    The SGD login URL is usually https://server.example.com/sgd, where server.example.com is the name of the SGD server.

    The SGD login dialog box is displayed. See Figure 1.1, “SGD Login Dialog Box”.

  2. Use the Client Options feature to choose the log in method.

    This step is typically required because using Java software is not the default login method for SGD. However, your Administrator can configure SGD so that you do not need to use this step.

    • Click Client Options on the SGD login dialog box.

    • Select the option to use Java software to log in to SGD.

      The SGD login dialog box is redisplayed.

    See Section 1.1.5, “Client Options” for more details of how you can use the Client Options feature to choose the login method.

  3. Enter your SGD user name and password.

  4. Click the Login button.

  5. The SGD splash screen is displayed. See Figure 1.2, “SGD Splash Screen”.

  6. (Optional) You may be prompted to save and open a file called sgd-webstart.jnlp.

    This step depends on how your computer is configured to handle Java Network Launch Protocol (JNLP) files.

    Some example prompts are shown below.

    Figure 1.6 Prompt to Save a JNLP File, Shown Using a Chrome Browser


    Figure 1.7 Prompt to Open a JNLP File, Shown Using a Chrome Browser


    Click the option to open the JNLP file.

    The option varies depending on your computer, but is typically Open.

  7. A Java technology security warning is shown. This is a security message that is shown when you connect to an SGD server. See Figure 1.8, “Java Technology Security Warning Dialog Box for Java Web Start”.

    Figure 1.8 Java Technology Security Warning Dialog Box for Java Web Start

    Java software security warning dialog box for Java Web Start

    Click the Run button.

  8. (Optional) The Untrusted Initial Connection message may be displayed.

    This is a security message that is shown the first time you connect to an SGD server. It enables you to check the hostname and server certificate details before agreeing to the connection. See Figure 1.4, “Untrusted Initial Connection Dialog Box”.

    Click Yes to connect to the SGD server.

  9. The SGD Client icon is displayed in the task bar. See Figure 1.5, “SGD Client Task Bar Icon”.

    The SGD workspace is displayed. See Figure 1.12, “SGD Workspace”.

1.1.4.2 Using Java Plug-in Software

The following procedure describes how to log in and install the SGD Client automatically using a browser that has Java Plug-in software installed and enabled.

Logging In to SGD With Java Plug-in Software

The steps for logging in to SGD using a browser with Java Plug-in software are similar to those described in Section 1.1.3, “Logging In to SGD”. Depending on how your computer is configured, you may see some extra Java prompts when you log in to SGD.

Note

Some browsers do not support Java Plug-in software. Contact your Administrator if you are need advice on this.

  1. Using your browser, go to the SGD login URL.

    The SGD login URL is usually https://server.example.com/sgd, where server.example.com is the name of the SGD server.

    The SGD login dialog box is displayed. See Figure 1.1, “SGD Login Dialog Box”.

  2. Use the Client Options feature to choose the log in method.

    This step is typically required because using Java software is not the default login method for SGD. However, your Administrator can configure SGD so that you do not need to use this step.

    • Click Client Options on the SGD login dialog box.

    • Select the option to use Java software to log in to SGD.

      The SGD login dialog box is redisplayed.

    See Section 1.1.5, “Client Options” for more details of how you can use the Client Options feature to choose the login method.

  3. Enter your SGD user name and password.

  4. Click the Login button.

  5. The SGD splash screen is displayed. See Figure 1.2, “SGD Splash Screen”.

  6. If a Java technology security message is displayed, click Run to install the SGD Client.

    The SGD Client is a component installed on client devices.

  7. (Optional) The Untrusted Initial Connection message may be displayed.

    This is a security message that is shown the first time you connect to an SGD server. It enables you to check the hostname and server certificate details before agreeing to the connection. See Figure 1.4, “Untrusted Initial Connection Dialog Box”.

    Click Yes to connect to the SGD server.

  8. The SGD Client icon is displayed in the task bar. See Figure 1.5, “SGD Client Task Bar Icon”.

    The SGD workspace is displayed. See Figure 1.12, “SGD Workspace”.

1.1.5 Client Options

The Client Options feature enables you to select which method you want to use to log in to SGD. You do this by clicking a link on the SGD login dialog box.

The available login methods are as follows:

  • Install the SGD Client program on your computer. This is the default method.

  • Use Java technology in your browser, or Java Web Start software on your computer.

  • Log in to the HTML5 workspace.

1.1.5.1 Using Client Options to Change the Login Method

  1. Using your browser, go to the SGD login URL.

    For example, https://server.example.com/sgd, where server.example.com is the name of the SGD server.

    The SGD login dialog box is displayed.

  2. Click Client Options on the SGD login dialog box. See Figure 1.9, “Client Options Link on the SGD Login Dialog Box”.

    Figure 1.9 Client Options Link on the SGD Login Dialog Box

    Client Options link on the SGD login dialog box. Located in the lower right corner of the dialog.

    A list of available Client Options is displayed. See Figure 1.10, “List of Available Client Options”.

    Figure 1.10 List of Available Client Options

    List of available client options. Shown when clicking Client Options link on the SGD login dialog box.

  3. Click a link to log in using the selected login method.

    Shortcut links are available, if you need to install the SGD Client program or Java software on your computer.

  4. (Optional) If the login method you select does not work well with your computer, you can select an alternative login method during the login process.

    Click Client Options on the SGD splash screen.

    The list of available Client Options is redisplayed.

    Select the login method that works best with your computer.

1.1.6 Security Warning Messages

When you connect to an SGD server using an https:// URL, you may see some or all of the following security warnings.

The warning messages you see depend on whether your browser and computer are configured to work with the Secure Sockets Layer (SSL) certificate installed on the SGD server and whether you are using Java software to log in to SGD.

  • SGD server SSL certificate security warnings. You see security warnings about the SSL certificate if the certificate date is invalid, has an incorrect hostname, or is issued by an unknown Certificate Authority (CA).

  • Untrusted initial connection warnings. This warning may be shown the first time that you connect to an SGD server. You should check the certificate details and agree to the connection. If there is a problem with the connection, for example because the SSL certificate has changed, a Potentially Unsafe Connection message is displayed. See Section 1.1.6.1, “Potentially Unsafe Connection Message”.

  • Browser and Java Plug-in software security warnings. These warnings are shown if the CA or root certificate used to sign the SSL certificate is not available in the browser's certificate store. You may also need to import the CA or root certificate using the Java Plug-in software.

Contact your SGD Administrator for more information about why security warnings occur and what you can do about them.

1.1.6.1 Potentially Unsafe Connection Message

If there is a security problem with the connection to the SGD server, a Potentially Unsafe Connection message may be displayed, as shown in Figure 1.11, “Potentially Unsafe Connection Message” .

Figure 1.11 Potentially Unsafe Connection Message

Potentially Unsafe Connection message

If you see a Potentially Unsafe Connection message, do the following.

How To Deal With a Potentially Unsafe Connection Message

  1. Click the View Certificate button and make a note of the certificate details.

  2. Do one of the following:

    • Click the Accept button to accept the certificate and connect to the SGD server.

      Do this only if you are certain that the reason for the certificate change is not malicious. Contact your SGD Administrator if you need advice on whether to accept the certificate.

    • Click the Reject button to cancel the connection.

      Contact your SGD Administrator for more advice.