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 runcommand:docker run -p 127.0.0.1:5665:5665 --name workbench -e ENABLE_AUTH=1 -it openvino/workbench:2022.1
Example
openvino-workbenchcommand: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:
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 runcommand: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-workbenchcommand:openvino-workbench --image openvino/workbench:2022.1 --enable-authentication --custom-token MY_CUSTOM_TOKEN
How to Use Tokens¶
One-Time Link with Token¶
The link is provided to make it easy for you to go to the DL Workbench for the first time. For each new container, a unique one-time link is generated and expires once you click it. Use this link to access the DL Workbench for the first time. When you click the link, the DL Workbench Active Projects page appears, and you can move on to work with models and sample datasets by clicking Create Project :
Accept or block cookies in the pop-up window. You can change your decision later on the Settings panel.
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:
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 ` 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.
Accept or block cookies in the pop-up window. You can change your decision later on the Settings panel.
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.
