Haruno Knowledge base

Google Drive, OneDrive, SharePoint and Dropbox

Connect a cloud drive so Haruno can list, search, read and add files in the folders you share. What each account asks for and what a scheduled task holds.

  • Mac appAvailable
  • Windows appAvailable

Four cloud drives are connectors on the Mac: Google Drive, OneDrive, SharePoint and Dropbox. Haruno keeps a copy of the folders you choose on your Mac, in step with the cloud. This page is the connector side. The folder rules, syncing and linking a file to a project are on Cloud files.

Where they are

In the Connectors window, Google Drive is under Google, beside Gmail and Google Calendar. OneDrive, SharePoint and Dropbox are under Cloud storage.

Connect one

  1. Click Connect

    Find the drive in Connectors and click Connect. A window called Add cloud connection opens. Under Before you connect it says what the account will ask for.

  2. Sign in

    Click the button that starts with Continue to. Your browser opens the drive's own sign in. The window says Finish signing in in your browser….

  3. Save

    When the window says Connected, check the name and click Save.

  4. Choose folders

    A window called Folders Haruno can use opens. Tick the folders Haruno may use, then click Save.

Until you choose folders, the row says No folders shared yet and shows Choose folders…. Haruno reads nothing from the account in the meantime.

What each account asks for

  • Google Drive. With Haruno's own Google connection, Haruno uses a folder it creates in your Drive. It cannot see your other files. If your organization has its own Google connection, Google may ask which access to give.
  • OneDrive, SharePoint and Dropbox. They ask for access to your whole account. That is the only level they offer to an app that keeps a folder in step. Haruno still uses only the folders you choose.

The window also says that Haruno never deletes anything in the drive. It can move a file to the trash, and only after you approve it.

What Haruno can do

Once a drive is connected and you have shared folders, Haruno can do these in a chat.

Haruno canNotes
List your connected accounts and the folders in themOnly the folders you shared
Search for a file by name or by the text inside itGoogle Drive only
Open a folder as a working copy on your MacThe copy is kept in step with the cloud
Read and edit the files in that copyEdits go back to the cloud
Add a file to the driveA file at the same path is replaced
Sync nowPushes your edits and pulls the cloud's changes

Opening a folder, syncing and adding a file are the steps Haruno asks about first.

In a scheduled task

Listing, searching, reading and copying a folder down reach nobody, so they work in a scheduled task. Changes that would go up to a shared cloud folder are held in The Waiting queue until you approve them. Held changes include deletions, so read the card before you approve.

The row once connected

The row shows the account, a line about what is shared, and a status such as Syncing… or Synced. The ⋯ menu has Shared folders…, Re-check, Edit…, Add another account… and Sign out…. Sign out… asks whether to delete the copy on your Mac. Your files in the cloud are not changed either way.

Git and Local folder are gone

The Mac no longer offers Git or a local folder as a cloud source. A connection made earlier is signed out when the app starts.

Who has it

Everyone, in the normal view and the advanced view. A chat that belongs to a project does not use the cloud tools above. A project reaches Drive files by linking them as sources. See Project sources.

What to tell a customer

Connect the drive, then choose the folders Haruno may use. Haruno only touches those folders. On Haruno's own Google connection, Google Drive means a folder Haruno creates, not your existing Drive files.

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,81 @@
    +---
    +title: Google Drive, OneDrive, SharePoint and Dropbox
    +summary: Connect a cloud drive so Haruno can list, search, read and add files in the folders you share. What each account asks for and what a scheduled task holds.
    +feature: cloud-storage
    +covers:
    +  - Integrations/cloud/**
    +  - Integrations/googledrive/**
    +  - Integrations/onedrive/**
    +  - Integrations/sharepoint/**
    +  - Integrations/dropbox/**
    +  - vc-tools/VcTools.McpServer/Servers/Cloud/**
    +  - apple/Sources/CloudFeature/CloudProviderConnectorRows.swift
    +  - apple/Sources/CloudFeature/AddCloudConnectionSheet.swift
    +---
    +
    +Four cloud drives are connectors on the Mac: Google Drive, OneDrive, SharePoint and Dropbox. Haruno keeps a copy of the folders you choose on your Mac, in step with the cloud. This page is the connector side. The folder rules, syncing and linking a file to a project are on [Cloud files](/macos/chat/cloud-files/).
    +
    +## Where they are
    +
    +In the [Connectors window](/macos/connectors/connectors-window/), Google Drive is under <Ui>Google</Ui>, beside Gmail and Google Calendar. OneDrive, SharePoint and Dropbox are under <Ui>Cloud storage</Ui>.
    +
    +## Connect one
    +
    +<Steps>
    +<Step title="Click Connect">
    +Find the drive in Connectors and click <Ui>Connect</Ui>. A window called <Ui>Add cloud connection</Ui> opens. Under <Ui>Before you connect</Ui> it says what the account will ask for.
    +</Step>
    +<Step title="Sign in">
    +Click the button that starts with <Ui>Continue to</Ui>. Your browser opens the drive's own sign in. The window says <Ui>Finish signing in in your browser…</Ui>.
    +</Step>
    +<Step title="Save">
    +When the window says <Ui>Connected</Ui>, check the name and click <Ui>Save</Ui>.
    +</Step>
    +<Step title="Choose folders">
    +A window called <Ui>Folders Haruno can use</Ui> opens. Tick the folders Haruno may use, then click <Ui>Save</Ui>.
    +</Step>
    +</Steps>
    +
    +Until you choose folders, the row says <Ui>No folders shared yet</Ui> and shows <Ui>Choose folders…</Ui>. Haruno reads nothing from the account in the meantime.
    +
    +## What each account asks for
    +
    +- **Google Drive.** With Haruno's own Google connection, Haruno uses a folder it creates in your Drive. It cannot see your other files. If your organization has its own Google connection, Google may ask which access to give.
    +- **OneDrive, SharePoint and Dropbox.** They ask for access to your whole account. That is the only level they offer to an app that keeps a folder in step. Haruno still uses only the folders you choose.
    +
    +The window also says that Haruno never deletes anything in the drive. It can move a file to the trash, and only after you approve it.
    +
    +## What Haruno can do
    +
    +Once a drive is connected and you have shared folders, Haruno can do these in a chat.
    +
    +| Haruno can | Notes |
    +|---|---|
    +| List your connected accounts and the folders in them | Only the folders you shared |
    +| Search for a file by name or by the text inside it | Google Drive only |
    +| Open a folder as a working copy on your Mac | The copy is kept in step with the cloud |
    +| Read and edit the files in that copy | Edits go back to the cloud |
    +| Add a file to the drive | A file at the same path is replaced |
    +| Sync now | Pushes your edits and pulls the cloud's changes |
    +
    +Opening a folder, syncing and adding a file are the steps Haruno asks about first.
    +
    +## In a scheduled task
    +
    +Listing, searching, reading and copying a folder down reach nobody, so they work in a scheduled task. Changes that would go up to a shared cloud folder are held in [The Waiting queue](/macos/automation/waiting-queue/) until you approve them. Held changes include deletions, so read the card before you approve.
    +
    +## The row once connected
    +
    +The row shows the account, a line about what is shared, and a status such as <Ui>Syncing…</Ui> or <Ui>Synced</Ui>. The ⋯ menu has <Ui>Shared folders…</Ui>, <Ui>Re-check</Ui>, <Ui>Edit…</Ui>, <Ui>Add another account…</Ui> and <Ui>Sign out…</Ui>. <Ui>Sign out…</Ui> asks whether to delete the copy on your Mac. Your files in the cloud are not changed either way.
    +
    +<Callout variant="info" title="Git and Local folder are gone">
    +The Mac no longer offers Git or a local folder as a cloud source. A connection made earlier is signed out when the app starts.
    +</Callout>
    +
    +## Who has it
    +
    +Everyone, in the normal view and the advanced view. A chat that belongs to a project does not use the cloud tools above. A project reaches Drive files by linking them as sources. See [Project sources](/macos/chat/project-sources/).
    +
    +## What to tell a customer
    +
    +Connect the drive, then choose the folders Haruno may use. Haruno only touches those folders. On Haruno's own Google connection, Google Drive means a folder Haruno creates, not your existing Drive files.