Haruno Knowledge base

Link an app with a code

An older way to sign in a desktop app, where the app shows a confirmation code and the customer authorizes it on the dashboard. The current apps use the approval page instead, so a customer rarely meets this one.

  • DashboardAvailable
An older path

The current Mac and Windows apps sign in through Approve a desktop app. This page belongs to an earlier way of signing in, in which the app showed a short code. It still works, and the dashboard still has the screen. A customer on a current app should not land here.

The page is called Connect the Haruno app.

How it works

The app opens the dashboard's sign-in with a code in the link. The dashboard remembers the code for that browser tab while the customer signs in with Google. Then it sends them to this page instead of to Usage.

The page when a code is waiting.
The Connect the Haruno app page. The subtitle Authorize the Haruno desktop app to sign in as you. A card titled Authorize this device that says You're about to sign the Haruno desktop app in to your account, with the email. A box labelled Confirmation code holding K7QD-4MXP. A warning to check the code matches the one in the app. An Authorize the app button.
  1. Read the code in the app

    The app shows a confirmation code.

  2. Compare it on the dashboard

    The page says "Check this code matches the one shown in the Haruno app. If it doesn't — or you didn't start a sign-in — do not authorize."

  3. Press Authorize the app

    The page says "The app is connected." and "You can return to the Haruno app — it's now signed in. You can close this tab."

After Authorize the app.
The Connect the Haruno app page with a green line: The app is connected. Under it: You can return to the Haruno app, it's now signed in. You can close this tab.

The customer always has to press the button. Nothing is linked on its own.

When it does not work

If the code has run out or was used, the card shows a red box with "Invalid or expired desktop sign-in". Start the sign-in again in the app.

An expired code.
The Authorize this device card with a red box under the warning: Invalid or expired desktop sign-in.

If the customer opens the page with no code waiting, it says "There's no desktop sign-in waiting. Start the sign-in from the Haruno app, then follow the link it opens." and offers Download for macOS.

The page with no code waiting.
The Connect the Haruno app page with the line: There's no desktop sign-in waiting. Start the sign-in from the Haruno app, then follow the link it opens. And a Download for macOS link.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,47 @@
    +---
    +title: Link an app with a code
    +summary: An older way to sign in a desktop app, where the app shows a confirmation code and the customer authorizes it on the dashboard. The current apps use the approval page instead, so a customer rarely meets this one.
    +feature: dashboard-devices
    +covers:
    +  - web/dashboard/app/[lang]/link-desktop/page.tsx
    +  - web/dashboard/lib/desktop-link.ts
    +  - server-dotnet/src/Haruno.Server/Controllers/PortalDesktopAuthController.cs
    +---
    +
    +<Callout variant="info" title="An older path">
    +The current Mac and Windows apps sign in through [Approve a desktop app](/dashboard/desktop-app-sign-in/approve-a-device/). This page belongs to an earlier way of signing in, in which the app showed a short code. It still works, and the dashboard still has the screen. A customer on a current app should not land here.
    +</Callout>
    +
    +The page is called **Connect the Haruno app**.
    +
    +## How it works
    +
    +The app opens the dashboard's sign-in with a code in the link. The dashboard remembers the code for that browser tab while the customer signs in with Google. Then it sends them to this page instead of to **Usage**.
    +
    +<Shot src="/m/2a89daa3746d-dashboard-link-desktop-light.webp" alt="The Connect the Haruno app page. The subtitle Authorize the Haruno desktop app to sign in as you. A card titled Authorize this device that says You're about to sign the Haruno desktop app in to your account, with the email. A box labelled Confirmation code holding K7QD-4MXP. A warning to check the code matches the one in the app. An Authorize the app button." caption="The page when a code is waiting." />
    +
    +<Steps>
    +<Step title="Read the code in the app">
    +The app shows a confirmation code.
    +</Step>
    +<Step title="Compare it on the dashboard">
    +The page says "Check this code matches the one shown in the Haruno app. If it doesn't — or you didn't start a sign-in — do not authorize."
    +</Step>
    +<Step title="Press Authorize the app">
    +The page says "The app is connected." and "You can return to the Haruno app — it's now signed in. You can close this tab."
    +</Step>
    +</Steps>
    +
    +<Shot src="/m/864e357e0c38-dashboard-link-desktop-done-light.webp" alt="The Connect the Haruno app page with a green line: The app is connected. Under it: You can return to the Haruno app, it's now signed in. You can close this tab." caption="After Authorize the app." />
    +
    +The customer always has to press the button. Nothing is linked on its own.
    +
    +## When it does not work
    +
    +If the code has run out or was used, the card shows a red box with "Invalid or expired desktop sign-in". Start the sign-in again in the app.
    +
    +<Shot src="/m/ad4c424e0632-dashboard-link-desktop-error-light.webp" alt="The Authorize this device card with a red box under the warning: Invalid or expired desktop sign-in." caption="An expired code." />
    +
    +If the customer opens the page with no code waiting, it says "There's no desktop sign-in waiting. Start the sign-in from the Haruno app, then follow the link it opens." and offers **Download for macOS**.
    +
    +<Shot src="/m/6aa9fe28406a-dashboard-link-desktop-none-light.webp" alt="The Connect the Haruno app page with the line: There's no desktop sign-in waiting. Start the sign-in from the Haruno app, then follow the link it opens. And a Download for macOS link." caption="The page with no code waiting." />