From 47f3945cfe5bf12ff892152e0321697f7d7f9abf Mon Sep 17 00:00:00 2001 From: Tim Gross Date: Wed, 24 Feb 2021 14:51:20 -0500 Subject: [PATCH] docs: 'nomad ui -login' command --- website/content/docs/commands/ui.mdx | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/website/content/docs/commands/ui.mdx b/website/content/docs/commands/ui.mdx index 35780ec65..7fb07ad65 100644 --- a/website/content/docs/commands/ui.mdx +++ b/website/content/docs/commands/ui.mdx @@ -22,10 +22,21 @@ will be opened in the default browser. An identifier may be provided, in which case the UI will be opened to view the details for that object. Supported identifiers are jobs, allocations and nodes. +If ACLs are enabled, the web UI will start in an unauthenticated state and you +may see a 403 Unauthorized page if anonymous read access is denied. The `nomad +ui -login` option will exchange your command line client's Nomad ACL token for +a one-time login token to the web UI. That one-time token will be exchanged +for your Nomad ACL token and stored in the browser's local storage for +authentication. + ## General Options @include 'general_options_no_namespace.mdx' +## UI Options + +- `-login`: Exchange your Nomad ACL token for a one-time token in the web UI. + ## Examples Open the UI homepage: @@ -48,3 +59,10 @@ Open the UI directly to look at an allocation: $ nomad ui d4005969 Opening URL "http://127.0.0.1:4646/ui/allocations/d4005969-b16f-10eb-4fe1-a5374986083d" ``` + +Open the UI and login using your ACL token: + +```shell-session +$ NOMAD_ACL_TOKEN=e9674b26-763b-4637-a28f-0df95c53cdda nomad ui -login +Opening URL "http://127.0.0.1:4646" with token +```