Haruno Knowledge base

Web access and fetching pages

Haruno can open and read a public web page for you, even though a command in the sandbox has no internet. Only public https sites work, and one setting decides whether it asks first.

  • Mac appAvailableA website Haruno wants to open asks first. Sites you always allow are listed in Settings ▸ Advanced ▸ Security.
  • Windows appAvailableSettings ▸ Advanced ▸ Allow Web Fetch without asking is on by default and only appears in the advanced view.

Haruno can open a specific web page and read it. This is called Web Fetch. It works in the sandbox, even though a command Haruno runs has no internet of its own.

What the customer sees

When Haruno wants a page, the chat shows a step such as open a web page. Unless Web Fetch is allowed without asking (see below), a card appears first. See Approvals and permission modes.

Web Fetch reads one page at a time. Searching the web is a separate action.

The sites Haruno read pages on are listed under Sources in the Activities panel, with the number of pages read on each.

Sources lists the sites Haruno read pages on, and the files it opened.
The Sources list in the Activities panel: two web sites, one with 2 pages, and one file.The Sources list in the Activities panel: two web sites, one with 2 pages, and one file.

Which pages it can open

  • Only public sites, over a secure address (https).
  • Not a page on this PC or on a company network. Addresses that are private are refused.
  • A very large page is cut off. Haruno reads about the first 10 MB.
A few sites fail here and open in a browser

A site that is set up with an incomplete security certificate can fail in the sandbox while it opens normally in a browser. Such sites are rare. If a customer reports one page that will not open, this is a likely reason.

Asking first, or not

The setting is Settings ▸ Advanced ▸ Allow Web Fetch without asking. It is on by default.

SettingWhat happens
OnHaruno opens public pages without a card.
OffHaruno asks before it fetches a site it does not already trust.

The setting appears only in the advanced view. The normal view does not show it and keeps whatever it was set to, which is on unless someone changed it.

Why a command cannot do the same

A command in the sandbox cannot make an internet connection. If Haruno runs a download command, it fails. That is by design: web pages go through Web Fetch, where Haruno can check that the site is public and secure. See The sandbox.

What to tell a customer

Haruno can read public web pages for a task. It cannot read a page that sits on this PC or on a company network. For a site where the person has to sign in, the browser tools let Haruno work in a browser window where the person signs in themselves.

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,53 @@
    +---
    +title: Web access and fetching pages
    +summary: Haruno can open and read a public web page for you, even though a command in the sandbox has no internet. Only public https sites work, and one setting decides whether it asks first.
    +feature: web-fetch
    +covers:
    +  - windows-client/docs/sandbox-web-fetch.md
    +  - windows-client/Haruno.Desktop.Services/Sandbox/WebFetchEgressBroker.cs
    +  - windows-client/Haruno.Desktop.Services/Sandbox/WebFetchEgressPolicy.cs
    +  - windows-client/Haruno.Desktop.Services/EngineBuiltInToolPolicyWriter.cs
    +  - windows-client/Haruno.Desktop.Services/WebFetchPermissionService.cs
    +  - windows-client/Haruno.Desktop.Core/Contracts/IWebFetchPermissionService.cs
    +---
    +
    +Haruno can open a specific web page and read it. This is called **Web Fetch**. It works in the sandbox, even though a command Haruno runs has no internet of its own.
    +
    +## What the customer sees
    +
    +When Haruno wants a page, the chat shows a step such as **open a web page**. Unless Web Fetch is allowed without asking (see below), a card appears first. See [Approvals and permission modes](/windows/safety/approvals-and-permission-modes/).
    +
    +Web Fetch reads one page at a time. Searching the web is a separate action.
    +
    +The sites Haruno read pages on are listed under **Sources** in the Activities panel, with the number of pages read on each.
    +
    +<Shot src="/m/28f1d444742f-windows-safety-web-sources-light.png" dark="/m/16e9024a11c8-windows-safety-web-sources-dark.png" alt="The Sources list in the Activities panel: two web sites, one with 2 pages, and one file." caption="Sources lists the sites Haruno read pages on, and the files it opened." />
    +
    +## Which pages it can open
    +
    +- Only public sites, over a secure address (https).
    +- Not a page on this PC or on a company network. Addresses that are private are refused.
    +- A very large page is cut off. Haruno reads about the first 10 MB.
    +
    +<Callout variant="info" title="A few sites fail here and open in a browser">
    +A site that is set up with an incomplete security certificate can fail in the sandbox while it opens normally in a browser. Such sites are rare. If a customer reports one page that will not open, this is a likely reason.
    +</Callout>
    +
    +## Asking first, or not
    +
    +The setting is <Ui>Settings ▸ Advanced ▸ Allow Web Fetch without asking</Ui>. It is on by default.
    +
    +| Setting | What happens |
    +|---|---|
    +| On | Haruno opens public pages without a card. |
    +| Off | Haruno asks before it fetches a site it does not already trust. |
    +
    +The setting appears only in the advanced view. The normal view does not show it and keeps whatever it was set to, which is on unless someone changed it.
    +
    +## Why a command cannot do the same
    +
    +A command in the sandbox cannot make an internet connection. If Haruno runs a download command, it fails. That is by design: web pages go through Web Fetch, where Haruno can check that the site is public and secure. See [The sandbox](/windows/safety/sandbox/).
    +
    +<Callout variant="tip" title="What to tell a customer">
    +Haruno can read public web pages for a task. It cannot read a page that sits on this PC or on a company network. For a site where the person has to sign in, the browser tools let Haruno work in a browser window where the person signs in themselves.
    +</Callout>