Enable Authentication in DL Workbench

By default, the DL Workbench is started without authentication settings. This can cause problems with sensitive data, like your model or performance information. It is recommended to enable authentication when starting the DL Workbench.

Enable Authentication

To enable authentication, use -e ENABLE_AUTH=1 when you start the DL Workbench with the docker run command or --enable-auth with the openvino-workbench script:

  • Example docker run command:

    docker run -p 127.0.0.1:5665:5665 --name workbench -e ENABLE_AUTH=1 -it openvino/workbench:2021.4.1.2
  • Example openvino-workbench command:

    openvino-workbench --image openvino/workbench:2021.4.1.2 --enable-authentication

When you enable authentication, the terminal displays the following when the Docker container with the DL Workbench is up and running:

  1. One-time link with token

  2. Login token

  3. JupyterLab* token

_images/auth2.png

How to Use Tokens

Login Token

The login token is valid as long as you do not remove the current Docker container, so treat the token as a password for the current DL Workbench session. Use it whenever you see the Enter OpenVINO DL Workbench window.

Open the http://127.0.0.1:5665 link without the URL token, and the Enter OpenVINO DL Workbench page appears. Copy the login token from the console and paste it into the field:

_images/auth1.png

Note

The token is also saved to a folder inside a Docker container, and you can obtain it with the command below:

docker exec workbench cat /home/workbench/.workbench/token.txt

Press Start. The Active Projects page appears, and you can move on to work with models and sample datasets by clicking Create Project.

_images/start_page_crop.png

Accept or block cookies in the pop-up window. You can change your decision later on the Settings panel.

_images/pop_up_cookies.png

JupyterLab Token

Use this token when you access the JupyterLab* Environment delivered by the DL Workbench. This token is valid as long as you do not remove the current Docker container.

_images/auth4.png