Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

VH 1314 - Allow V2X-Hub Web UI browser access without self signed certificate warning acceptance #622

9 changes: 9 additions & 0 deletions configuration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,3 +59,12 @@ To support execution in a simulated environment, V2X-Hub is in the process of in
* **V2XHUB_IP** – Environment variable for storing IP address of V2X Hub.
* **INFRASTRUCTURE_ID** – Environment variable for storing infrastructure id of V2X Hub.
* **SENSOR_JSON_FILE_PATH** – Environment variable for storing path to sensor configuration file. This is an optional simulation environment variable that allows for setting up simulated sensor for a V2X-Hub instance. Example file can be found in the **CDASimAdapterPlugin** tests [here](../src/v2i-hub/CDASimAdapter/test/sensors.json).

### Open V2X-Hub in Google Chrome
If the chromium browser is not available, run this command to open V2X-Hub in google chrome:
Copy link
Contributor

@paulbourelly999 paulbourelly999 Jul 10, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To access V2X-Hub Admin Web UI from a different machine on the same network please use either chromium or google-chrome browser and run the following command

chromium --ignore-certificate-errors <v2xhub_ip>

or

google-chrome --ignore-certificate-errors <v2xhub_ip>

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated the README file.

```
google-chrome --ignore-certificate-errors localhost > /dev/null 2>&1 &
```

> [!NOTE]
> V2X-Hub Server uses a secure WebSocket connection to communicate with the browser. For this, V2X-Hub Server uses a self-signed certificate instead of one signed by a trusted certificate authority (CA). Most of the browsers do not trust this until explicitly told to do so by navigating to the WebSocket URL (https://<v2xhub_ip>:19760) and accepting the risk. The `--ignore-certificate-errors` option instructs the browser to ignore certificate errors and warnings which removes manually effort of accepting this risk on V2X-Hub deployments. **Using the browser with this option enabled to access the internet or any other application is not advised as it is a security risk**.
3 changes: 1 addition & 2 deletions configuration/initialization.sh
Original file line number Diff line number Diff line change
Expand Up @@ -148,5 +148,4 @@ fi
cd "$mysqlDir" || return # return in case cd fails
./add_v2xhub_user.bash

chromium-browser "http://127.0.0.1" > /dev/null 2>&1 &
chromium-browser "https://127.0.0.1:19760" > /dev/null 2>&1 &
chromium-browser --ignore-certificate-errors localhost > /dev/null 2>&1 &
Loading