Chapter 6. Accessing the Discovery user interface
You access the Discovery graphical user interface through a browser. You access the Discovery command line interface by running a terminal session command to connect to the server.
Learn more
To learn more about the requirements and steps to log in to and out of the Discovery graphical user interface, see the following information:
To learn more about the requirements and steps to log in to and out of the Discovery command line interface, see the following information:
6.1. Logging in to the Discovery user interface
To log in to the Discovery user interface, you need the IP address of the system where the Discovery server is installed, the port number for the connection if the default port was changed during server installation, and the server administrator username and password to use when logging in. If you do not have this information, contact the administrator who installed the Discovery server.
Prerequisites
- To use the Discovery graphical user interface, the system on which you want to run the user interface must be able to communicate with the system on which the Discovery server is installed.
Procedure
In a browser, enter the URL for the Discovery server in the following format:
https://IPaddress:server_port
, whereIPaddress
is the IP address of the Discovery server andserver_port
is the exposed server port.The following examples show two different ways to enter the URL, based on the system that you are logging in from and whether the default port is used:
If you log in from the system where the server is installed and the default port
9443
is used, you can use the loopback address (also known as localhost) as the IP address, as shown in the following example:https://127.0.0.1:9443
If you log in from a system that is remote from the server, the server is running on the IP address
192.0.2.0
, and the default port was changed during installation to8443
, you would log in as shown in the following example:https://192.0.2.0:8443
After you enter the URL for the server, the Discovery login page displays.
- On the login page, enter the username and password for the Discovery server administrator account and then click Log in to log in to the server.
Verification steps
If this is the first time that you have logged in to Discovery, the Welcome page displays. You can begin by adding sources and credentials that can be used in scans. If you have previously logged in to Discovery, the Welcome page is skipped and you can interact with your previously created sources, credentials, and scans.
6.2. Logging out of the Discovery user interface
Procedure
- In the application toolbar, click the person icon or your username.
- Click Logout.
6.3. Logging in to the Discovery command line interface
To log in to the Discovery command line interface, you need the username and password for the Discovery server administrator. If you do not have this information, contact the administrator who installed the Discovery server.
The login command retrieves a token that is used for authentication with subsequent command line interface commands. That token is removed when you log out of the server, and expires daily.
Prerequisites
- The Discovery command line interface must be installed on the same system where the server container is installed.
- You must access the command line interface on the same system where the server container is installed.
Procedure
To log in to the command line interface, enter the following command, where
server_username
is the username for the Discovery server administrator andserver_password
is the password for the server administrator:$ dsc server login --username server_administrator_username --password server_administrator_password
After you log in to the command line interface, you can begin entering commands to create sources, credentials, and scans.
6.4. Logging out of the Discovery command line interface
The command to log out of the server removes the token that was created when you logged in to the server. This token also expires daily.
Procedure
To log out of the command line interface, enter the following command:
$ dsc server logout