Nuvelics documentation
Web app

Activate a device sign-in

Enter the code a command-line tool or embedded panel shows you, check what it asks for, and choose the organization to authorize.

Some tools cannot open a sign-in page of their own: the command line, or a panel embedded in another program. They show you a short code instead, and you confirm it here, in any browser on any device. The tool notices on its own and carries on. This page covers the browser half. The command line's side is in Sign in to the command line.

Who reaches it

Anyone with an account. If you are signed out you are sent to Sign in first and returned to this page with the code intact. You must belong to an organization: otherwise the page reads Authorize device with "You must belong to an organization to authorize a device."

Activate a sign-in

  1. Open the address the tool printed, or the link it opened for you. A link that carries the code skips to step 3.
  2. On Authorize device, enter the code in Sign-in code and choose Continue. The code looks like XXXX-XXXX: eight letters in two groups of four. It never contains digits, and it leaves out letters that look alike, so characters it cannot contain are dropped as you type.
  3. Read what is asking. The page is titled Authorize followed by the application's name when the tool gave one, and otherwise Authorize device. The text beneath names the host asking, "is requesting access to your Nuvelics account", and below it lists what the application may do, in plain words such as View stories.
  4. Choose the organization in Organization. If you belong to only one, it is shown instead of a picker.
  5. Choose Authorize.

The page then reads Signed in: "You can close this tab. Go back to where you started — it will continue on its own." You can close it.

The code lasts five minutes. Start again in the tool if it runs out.

Check before you authorize

Authorize only a code you started yourself, a moment ago. Someone else can start a sign-in of their own and send you its code, hoping you confirm it. The screen shows who is asking and what for so you can notice, but treat a code you did not request as a reason to stop.

A panel embedded in a newsroom system names its host as "an embedded panel (its host is not verified)". Nuvelics cannot tell which system the panel sits in, so the same wording appears for every panel. The Saga panel, described in Saga plugin panel, is one.

What each outcome means

  • Signed in: you authorized it. The tool finishes by itself.
  • Invalid, expired, or already-used code. Check the code and try again.: the page cannot tell which of those applies. Check how you typed it, then start again in the tool for a new code if it is more than five minutes old or you already used it.
  • Cancel, on the confirmation page: nothing is authorized, and you are taken back to the code entry. The tool is not told; it keeps waiting until its code expires.

The authorization is for the one organization you picked. Connecting an AI assistant uses a different screen, described in Authorize an application, with the background in Agents.

Report a problem with this page

On this page