Download the Root CA Certificate
To access the Device Console, the computer (host) that you use to access the Device Console must have the root CA certificate from the Roving Edge Device. The root CA certificate is the top most certificate in the certificate chain of trust and is used by your computer to verify the authenticity of the Device Console.
Perform the tasks in this section to download the root CA certificate and sign in to the device UI for the first time.
Prerequisites
To perform the tasks in this section, you need the following Roving Edge device items:
- IP address
- hostname
- User name
- Password
Oracle provides these items to your organization when Oracle provisions your device request.
Ensure Your Host Has OpenSSL Installed
Most Linux and MacOS computers have OpenSSL installed. For Microsoft Windows, you might need to install OpenSSL.
To determine if OpenSSL is installed on Microsoft Windows, search for openssl. If OpenSSL isn't installed, follow your organization's best practices for installing OpenSSL.
The following links take you to popular OpenSSL sites from which OpenSSL can be obtained:
Task 1 - Configure the hosts File
Adding the device IP address and hostname to the hosts file enables your computer to find the Device Console IP address regardless of the DNS configuration.
Use one of the following procedures based on your OS.
- Linux
-
-
In a text editor, open the
/etc/hosts
file. The following example uses the vim editor:sudo vim /etc/hosts
-
Enter your administrator password.
-
Open a new line and enter the device IP address and hostname. Example:
198.168.0.1 my-1234567 my-device-hostname
-
Save the
/etc/hosts
file.
-
- MacOS
-
-
Open a terminal:
Navigate to Finder > Utilities, then click Terminal.
-
Open the
/etc/hosts
file in a text editor. The following example uses the nano editor:sudo nano /etc/hosts
-
Enter your administrator password.
-
Create a new line and enter the device IP address and hostname. Example:
198.168.0.1 my-1234567 my-device-hostname
-
Save the
/etc/hosts
file.
-
- Microsoft Windows
-
-
Open Notepad as the administrator.
-
In Notepad, open the following file:
C:\Windows\System32\drivers\etc\hosts
-
Open a new line and enter the device IP address and hostname. Example:
198.168.0.1 my-1234567 my-device-hostname
-
Save the
hosts
file.
-
Task 2 - Download the Root Certificate File from the Device
Use one of the following procedures based on your computer OS.
If your computer runs Microsoft Windows, also select the procedure based on your browser type.
Note - Browsers evolve over time. If some browser steps don't match what you see in your browser, consult your browser documentation.
- Linux and MacOS
-
-
In a terminal window, use the following command to download the certificate from the Roving Edge device:
echo -n | openssl s_client -showcerts -connect <device_ip_address>:8015 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > $HOME/redroot.pem
The root certificate
redroot.pem
is downloaded to your home directory.
-
- Microsoft Windows with Firefox
- The following steps are for Firefox version 115.
- Microsoft Windows with Edge
- The following steps are for Microsoft Edge version 128.0.2739.67.
- Microsoft Windows with Chrome
- The following steps are for Google Chrome version 128.0.6613.120.
Task 3 - Import the Root Certificate into Your Browser
Import the downloaded root certificate into your browser using one of the following tasks based on your browser type.
Note - Browsers evolve over time. If some browser steps don't match what you see in your browser, consult your browser documentation.
- Firefox
-
-
In Firefox, use the navigation menu to open Settings.
-
In the Find in Settings field, enter certificates.
-
Click View Certificates.
The Certificate manager is displayed.
-
With the Authorities tab selected, click Import.
Browse to the location of the downloaded certificate file, select it, then click Open.
-
In the Certificate Manager, click Trust this CA to identify websites, then click OK.
-
In the Certificate Manager, click OK.
-
Refresh the browser tab that's connected to the device.
You're prompted to enter your user name and password.
-
- Edge
-
-
In Edge, use the navigation menu to open Settings.
-
In the Find in Settings field, enter certificates.
-
Click Manage certificates.
The Certificate manager is displayed.
-
In the Certificates dialog box, click Import.
- In the Import Wizard, click Next.
- Click Browse, and navigate to the location of the downloaded certificate file.
-
In the file type drop-down menu, select All Files.
-
Select your downloaded certificate file, and click Open.
-
Click Next.
-
Select Automatically select the certificate store based on the type of certificate.
-
Click Next.
-
Click Finish.
-
Click OK.
-
In the Certificate manager, click Close.
Now you can sign in to the Device Console.
-
-
Refresh the browser tab that's connected to the device.
You're prompted to enter your user name and password.
-
- Chrome
-
-
In Chrome, use the navigation menu to open Settings.
-
In the Search settings field, enter certificates.
-
Click Security.
-
Click Manage certificates.
The Certificate manager is displayed.
-
Select the Trusted Root Certificates tab.
-
Click Import.
The Certificate Wizard is displayed.
-
Click Next.
-
Click Browse, and browse to the location of the downloaded certificate file, select it, then click Open.
-
Select Automatically select the certificate store based on the type of certificate, then click Next.
-
Click Finish.
-
Click OK to acknowledge the import was successful.
-
Close the Certificate Wizard by clicking Cancel.
-
In the Certificates dialog box, click Close.
-
Refresh the browser tab that's connected to the device.
You're prompted to enter your user name and password.
-
What's next?
Go to the online Roving Edge Infrastructure documentation.
Learn about ways to access the device. See Accessing a Roving Edge Infrastructure Device.