# Workbench installation

This guide will help you to connect with your lab Workbench over a web browser.

Requirements

Time estimate

Allow for 30 minutes to complete this installation and some playtime in your new environment.

# 1. Edit hosts file

We are sending hosts record in onboarding email. You will need to make sure that your hosts file contains this line.

Example of hosts record:

10.42.130.X <lab_name>.lab.hdc.ntnu.no
Windows
  1. Press the Windows key.

  2. Type Notepad in the search field.

  3. In the search results, right-click Notepad and select Run as administrator.

    notepad-administrator.png

    notepad-admin-confirm.png

  4. From Notepad, open the following file: C:\Windows\System32\Drivers\etc\hosts.

    Start by selecting File > Open.

    notepad-open-file.png

    Find the directory, and then change Text documents to view All files. When hosts file appears in the list select it and click Open:

    notepad-open-hosts-steps.png

  5. Add the line that you received from us on email.

  6. Select File > Save to save your changes.

OS X and macOS

On your local machine, edit /etc/hosts file in your preferred text editor, and add the line that you received from us on email.

Example with text editor:

EDITOR='open -Wne' sudo -e /etc/hosts

Example with vim:

sudo vim /etc/hosts
Ubuntu Linux

On your local machine, edit /etc/hosts file in your preferred text editor, and add the line that you received from us on email.

Example with gedit

sudo gedit /etc/hosts

Example with vim

sudo vim /etc/hosts

# 2. Install certificates

Windows
  1. Open the p12 certificate. Make sure the store location is set to Current User and click next:

    1_cert_p12.png

  2. Continue clicking on next

    2_cert_p12.png

  3. Fill in the TLS passphrase that you received on signal, and make sure only the same option is checked exactly as in the image. Then click next:

    3_cert_p12.png

  4. Keep the first option to Automatically select the certificate store based on the type of certificate. Click next:

    4_cert_p12.png

  5. Your client certificate is imported and you can hit finish:

    5_cert_p12.png

  6. Wizard will require additional confirmation for installation certification authority HCTS CA 1 (HUNT Cloud Trust Services). HUNT Cloud certificate is required to safely access Workbench in your lab. If you see LAB instead of HCTS CA 1 skip to step 7. Usually you are asked to confirm only when setting up Workbench for the first time. Before clicking yes you should confirm that you see this thumbprint (fingerprint): ADD9DFEC C998BE44 AC2F254E 75E5EB98 D91879A6

    6_confirmCAcertificate.png

  7. Same step is required for your Lab CA, where your Lab name should appear:

    7_confirmLabCAcertificate.png

  8. Quit your browser and restart it again for the certificate to get recognized.

    8_import_success.png

OS X and macOS
  1. Open the system profile config (.mobileconfig) attached in archive.

  2. In System Preferences open section Profiles.

    NTNU managed Macbook

    If your Macbook is managed by NTNU and you do not see section Profiles in your System Preferences you will need to request access to Profile through NTNU Hjelp. If you are not NTNU affiliated you can contact IT department of your organisation / university.

  3. Confirm the installation of profile.

    macos-profiles-continue.png

  4. Enter the passphrase that you received on signal and then confirm.

    macos-profiles-credentials.png

  5. Quit your browser and restart it again for the certificate to get recognized.

  6. When opening Workbench for the first time you will be asked for macOS password, allowing the browser to access your client certificate stored in Keychain. After filling in the password you can confirm by clicking on Always allow / Tillat alltid.

    macos_chrome.png

Ubuntu Linux

We recommend that you use the Google Chrome browser (opens new window) for predictability.

  1. Open Google Chrome on your local machine.

  2. Open url chrome://settings/certificates and click the Import button on the right side of the screen.

  3. Browse and select your .p12 file on your local machine and enter the TLS passphrase that you got on Signal.

  4. Restart Chrome.

After the restart of Google Chrome the certificate is ready for network or secure web site client authentication.

# 3. Open your new Workbench

TIP

Make sure you are connected to the VPN before accessing Workbench.

  1. Open your web browser (we recommend Google Chrome browser (opens new window)).

  2. Type in the URL address to your lab in your browser.

# -- Principal example
https://<labname>.lab.hdc.ntnu.no

# -- Demo example
https://demolab.lab.hdc.ntnu.no

Click OK if you get a User Identification Request for your new certificate and ensure that the Remember this decision is checked. The certificates are to be issued by:

Organization: "HUNT Cloud"
Issued Under: "HUNT Cloud Trust Services"

chrome_select_certificate_confirm.png

  1. Sign in with your HUNT Cloud lab username and lab passphrase. This is the passphrase that you made on your first login.

  2. With a little bit of luck you should now see your new Workbench. Click around and explore your new world!

TIP

Read Principles and FAQ sections to learn more about Workbench.

hunt-lab-workbench.png

# Immediate troubleshooting

This section includes only main questions regarding first time setup.

You should also look into FAQ and Troubleshooting if you do not find your answers here.

# I don't remember my passphrase

Read more

Don't worry. Contact us on email for an SSH passphrase reset.

# Firefox - Did Not Connect

Read more

Firefox may require manually importing HUNT Cloud Certificate Authority to consider it trusted. If you see Error code: SEC_ERROR_UNKNOWN_ISSUER when accessing Workbench follow these steps:

  1. Download our public CA certificate: https://pki.hdc.ntnu.no/hctsca1.crt (opens new window)
  2. Open Firefox url: about:preferences#privacy
  3. Scroll down to section Certificates and click on View Certificates: mac-firefox-certificates.png
  4. Switch to tab Authorities and click on Import: mac-firefox-import-cert.png
  5. Select hctsca1.crt and check option Trust this CA to identify websites: mac-firefox-trust-ca.png

# 502 Bad gateway

Read more

Something is wrong with configuration of the server, reach out in your lab channel on Slack or Contact us us for further investigation.