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:2022.1
  • Example openvino-workbench command:

    openvino-workbench --image openvino/workbench:2022.1 --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

Configure Authentication

To set up your own login token, use -e CUSTOM_TOKEN=<token> when you start the DL Workbench with the docker run command or --custom-token <token> with the openvino-workbench script:

  • Example docker run command:

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

    openvino-workbench --image openvino/workbench:2022.1 --enable-authentication --custom-token MY_CUSTOM_TOKEN

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:

`bash docker cp workbench:/home/workbench/.workbench/token.txt token.txt `` ``<blockquote>If you do not want to save the token inside a Docker container, use SAVE_TOKEN_TO_FILE=0 when you start the DL Workbench with the docker run command or disable-token-saving with the openvino-workbench` script.

Press Start. The Start 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