Haruno Knowledge base

Signing in to a connector

How a connector signs in through your browser, what the card shows while you wait, what to do when it fails, and how to add, switch or remove an account.

  • Mac appAvailable
  • Windows appAvailableEach connector is installed and updated on its own.

Most connectors sign in through your browser. You leave Haruno, sign in on the provider's own page, press Allow, and come back. Haruno never sees your password.

Haruno keeps the sign-in it gets back on this PC, inside the connector. The sign-in is never shown to the assistant.

A few connectors work differently. Telegram and Discord ask you to paste a bot token into the card instead.

Sign in with your browser

  1. Open the connector

    Go to Settings ▸ Connectors and click the card. If Enable is off, turn it on first.

  2. Fill in what the card asks

    Some cards ask for a name or for folders before you connect. Required boxes have a star.

  3. Press Connect

    Haruno opens the provider's sign-in page in your default browser.

  4. Sign in and allow

    Sign in on that page and press Allow. Then come back to Haruno. The card says Connected.

Google shows its access screen each time you connect. Outlook Mail and Outlook Calendar always show Microsoft's account picker, so you can choose which account to use.

While you wait

The Connect button turns grey and the card says that a sign-in page is open in your browser.

The card while a sign-in is open. The demo shows it on a Telegram card.
Part of a connector's panel during sign-in. Connect is grey. Open the sign-in page again and Cancel sign-in are available. A line below says a sign-in page is open in your browser.Part of a connector's panel during sign-in. Connect is grey. Open the sign-in page again and Cancel sign-in are available. A line below says a sign-in page is open in your browser.
  • Open the sign-in page again opens the page once more if it ended up behind a window or you closed the tab.
  • Cancel sign-in stops the attempt.

Haruno waits about eight minutes for you. You can look at another page of the app meanwhile. The sign-in carries on.

When it does not work

What the card saysWhat to do
The sign-in was not completed in the browser. Press Connect to try again.Nobody finished it. Press Connect.
Sign-in cancelled. Press Connect to start again.You or someone cancelled. Press Connect.
Haruno could not open your browser. Check that Windows has a default browser set.Set a default browser in Windows, then press Connect.
Another program on this PC is using the port Haruno needs to finish the sign-in.Close that program, then press Connect.

You can press Connect as often as you like. A sign-in nobody finished does no harm.

More than one account

A connector that supports several accounts shows Add account. Once one account is connected, the button reads Add another. Adding takes two steps.

  1. Sign in first

    The card says: Step 1 of 2, sign in with the account you want to add. Use the setup on the card, then Connect.

    Step 1. Nothing can be saved until you have signed in.
    The Add another form at step 1. Two saved accounts are listed, one connected and the default, one expired. Below them a line says step 1 of 2: sign in with the account you want to add. A Cancel adding account button follows.The Add another form at step 1. Two saved accounts are listed, one connected and the default, one expired. Below them a line says step 1 of 2: sign in with the account you want to add. A Cancel adding account button follows.
  2. Name it and save

    Type a name for the connection and press Save connection. The account is not added until you save.

    Step 2. Names use lowercase letters and underscores and must be different from each other.
    The Add another form at step 2. It says signed in as a demo address. A box asks for the new connection name. Save connection and Cancel adding account buttons follow.The Add another form at step 2. It says signed in as a demo address. A box asks for the new connection name. Save connection and Cancel adding account buttons follow.

If you close the panel after signing in but before saving, Haruno says the new account isn't saved yet. Choose Keep setting up or Close. The card then shows Signed in, not saved. Cancel adding account throws the account away.

A panel with a saved account. Pick another account from the list to switch to it.
A connector's panel with a saved account chosen. A list shows the account with its state, Connected and Default. Add another, Rename connection and Remove connection buttons are below.A connector's panel with a saved account chosen. A list shows the account with its state, Connected and Default. Add another, Rename connection and Remove connection buttons are below.

With several accounts, pick one from the list. Choose Set as default to make it the one Haruno uses when you do not name one. Rename connection changes its name.

Signing in again

An account can show Expired or Needs sign-in. Select it and press Connect. This signs the selected account in again. It does not add a new one. To connect a different account, use Add another.

Removing an account

Remove connection deletes the account's saved sign-in and settings from this PC. It cannot be undone. Haruno also asks the provider to end its access, where the connector can. If that fails the account is still removed here, so check the provider's list of connected apps if it matters.

Wiping every sign-in

Settings ▸ General ▸ Delete local data signs you out and removes every connector sign-in, along with other data Haruno keeps on this PC. Files inside your own project folders are left alone.

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,89 @@
    +---
    +title: Signing in to a connector
    +summary: How a connector signs in through your browser, what the card shows while you wait, what to do when it fails, and how to add, switch or remove an account.
    +feature: connectors
    +covers:
    +  - windows-client/docs/integration-sign-in.md
    +---
    +
    +Most connectors sign in through your browser. You leave Haruno, sign in on the provider's own page, press Allow, and come back. Haruno never sees your password.
    +
    +Haruno keeps the sign-in it gets back on this PC, inside the connector. The sign-in is never shown to the assistant.
    +
    +A few connectors work differently. Telegram and Discord ask you to paste a bot token into the card instead.
    +
    +## Sign in with your browser
    +
    +<Steps>
    +<Step title="Open the connector">
    +Go to <Ui>Settings ▸ Connectors</Ui> and click the card. If <Ui>Enable</Ui> is off, turn it on first.
    +</Step>
    +<Step title="Fill in what the card asks">
    +Some cards ask for a name or for folders before you connect. Required boxes have a star.
    +</Step>
    +<Step title="Press Connect">
    +Haruno opens the provider's sign-in page in your default browser.
    +</Step>
    +<Step title="Sign in and allow">
    +Sign in on that page and press Allow. Then come back to Haruno. The card says Connected.
    +</Step>
    +</Steps>
    +
    +Google shows its access screen each time you connect. Outlook Mail and Outlook Calendar always show Microsoft's account picker, so you can choose which account to use.
    +
    +## While you wait
    +
    +The Connect button turns grey and the card says that a sign-in page is open in your browser.
    +
    +<Shot src="/m/554296fe175e-windows-connectors-signin-waiting-light.png" dark="/m/5f4ce97f8837-windows-connectors-signin-waiting-dark.png" alt="Part of a connector's panel during sign-in. Connect is grey. Open the sign-in page again and Cancel sign-in are available. A line below says a sign-in page is open in your browser." caption="The card while a sign-in is open. The demo shows it on a Telegram card." />
    +
    +- <Ui>Open the sign-in page again</Ui> opens the page once more if it ended up behind a window or you closed the tab.
    +- <Ui>Cancel sign-in</Ui> stops the attempt.
    +
    +Haruno waits about eight minutes for you. You can look at another page of the app meanwhile. The sign-in carries on.
    +
    +## When it does not work
    +
    +| What the card says | What to do |
    +|---|---|
    +| The sign-in was not completed in the browser. Press Connect to try again. | Nobody finished it. Press Connect. |
    +| Sign-in cancelled. Press Connect to start again. | You or someone cancelled. Press Connect. |
    +| Haruno could not open your browser. Check that Windows has a default browser set. | Set a default browser in Windows, then press Connect. |
    +| Another program on this PC is using the port Haruno needs to finish the sign-in. | Close that program, then press Connect. |
    +
    +You can press Connect as often as you like. A sign-in nobody finished does no harm.
    +
    +## More than one account
    +
    +A connector that supports several accounts shows <Ui>Add account</Ui>. Once one account is connected, the button reads <Ui>Add another</Ui>. Adding takes two steps.
    +
    +<Steps>
    +<Step title="Sign in first">
    +The card says: Step 1 of 2, sign in with the account you want to add. Use the setup on the card, then Connect.
    +
    +<Shot src="/m/c3263ced9837-windows-connectors-add-step1-light.png" dark="/m/ddabacb5707b-windows-connectors-add-step1-dark.png" alt="The Add another form at step 1. Two saved accounts are listed, one connected and the default, one expired. Below them a line says step 1 of 2: sign in with the account you want to add. A Cancel adding account button follows." caption="Step 1. Nothing can be saved until you have signed in." />
    +</Step>
    +<Step title="Name it and save">
    +Type a name for the connection and press <Ui>Save connection</Ui>. The account is not added until you save.
    +
    +<Shot src="/m/2f7f57b12500-windows-connectors-add-step2-light.png" dark="/m/fb091f9544c1-windows-connectors-add-step2-dark.png" alt="The Add another form at step 2. It says signed in as a demo address. A box asks for the new connection name. Save connection and Cancel adding account buttons follow." caption="Step 2. Names use lowercase letters and underscores and must be different from each other." />
    +</Step>
    +</Steps>
    +
    +If you close the panel after signing in but before saving, Haruno says the new account isn't saved yet. Choose <Ui>Keep setting up</Ui> or <Ui>Close</Ui>. The card then shows Signed in, not saved. <Ui>Cancel adding account</Ui> throws the account away.
    +
    +<Shot src="/m/53498bb03cfa-windows-connectors-accounts-light.png" dark="/m/aa27ef72e2a7-windows-connectors-accounts-dark.png" alt="A connector's panel with a saved account chosen. A list shows the account with its state, Connected and Default. Add another, Rename connection and Remove connection buttons are below." caption="A panel with a saved account. Pick another account from the list to switch to it." />
    +
    +With several accounts, pick one from the list. Choose <Ui>Set as default</Ui> to make it the one Haruno uses when you do not name one. <Ui>Rename connection</Ui> changes its name.
    +
    +## Signing in again
    +
    +An account can show Expired or Needs sign-in. Select it and press <Ui>Connect</Ui>. This signs the selected account in again. It does not add a new one. To connect a different account, use <Ui>Add another</Ui>.
    +
    +## Removing an account
    +
    +<Ui>Remove connection</Ui> deletes the account's saved sign-in and settings from this PC. It cannot be undone. Haruno also asks the provider to end its access, where the connector can. If that fails the account is still removed here, so check the provider's list of connected apps if it matters.
    +
    +<Callout variant="info" title="Wiping every sign-in">
    +<Ui>Settings ▸ General ▸ Delete local data</Ui> signs you out and removes every connector sign-in, along with other data Haruno keeps on this PC. Files inside your own project folders are left alone.
    +</Callout>