Websites

The Websites page

Save a website, choose local or production, confirm ownership, share it with your organization, and copy the command that scans a local website from the CLI.

The Websites page keeps a list of the websites your organization scans. Save a website once and you, or your teammates, can scan it again later without typing its address. Guardian's cloud scans only production websites. A local website is saved here too, and you scan it from your own machine with the CLI.

Find the page

Select Websites under Assets in the sidebar. The page has two tables:

  • Shared websites lists the websites everyone in your organization can see and scan.
  • My websites lists the websites only you can see.

Who can do what

  • Admins, Managers, Engineers and Security members can add, edit, share, stop sharing and delete websites, and confirm ownership of production ones. They can also scan.
  • Compliance members and Viewers can view the shared websites. They can't add, edit, share or verify, and the page tells them so. They can delete a website of their own in My websites.
  • The CLI command button is shown only for local websites, and only to roles that can scan: Admins, Managers, Engineers and Security members.

Add a website

  1. Select Add website.
  2. Enter a Name, which is how the website appears in your lists.
  3. Enter the URL. Use only the scheme, host and optional port, such as https://www.example.com or http://localhost:3000. A path, query or credentials are not part of a saved website.
  4. Check Production website only if it is a live website on the public internet.
  5. Select Save website. The website appears in My websites, so only you can see it until you share it.

Each address can be saved once. If it is already saved, Guardian says so. You can keep up to 50 websites of your own in My websites and 100 in Shared websites.

Local and production websites

A production website is a live website on the public internet, on port 80 or 443. Guardian can fetch it, so you can run a Website Scan on it from the web app.

A website you don't mark as production is a local website, such as http://localhost:3000 or a staging site. Guardian never contacts it. It is saved so you can find it again, and you scan it from your own machine with the CLI (see Scan a local website from the CLI).

To change a website later, select Edit and change Production website. Changing it resets the website's ownership, and unmarking production also deletes its saved digest.

Confirm ownership of a production website

A new production website shows the Read-only chip until its ownership is confirmed. While it is Read-only, Guardian runs only the passive scan: it reads the website's standard public files (such as robots.txt, sitemap.xml and llms.txt), the homepage and up to two linked pages. A full scan also follows the sitemaps and links within the website's scope. It runs only when the website's ownership is confirmed and your plan includes website scanning, and Guardian picks the right scan for you when you start one. If ownership is lost while a full scan is running, that scan fails instead of becoming a passive one.

Once ownership is confirmed the Read-only chip disappears, so a production website without it is confirmed (there is no separate confirmed chip in the list).

Confirmation is reset when you turn off Production website, when the website opts out of scanning, and, for an email-domain confirmation, when no member has that domain any more. A file-based confirmation holds only while your plan includes website scanning.

  1. Select Confirm ownership on the website's row.
  2. Choose how to prove it:
    • A file on the website. Serve a plain-text file at the address shown, whose whole body is the line shown. Use https, answer with status 200, and don't redirect. This covers the exact host only.
    • Email domain of a member. This works when an active member of your organization has an email address on the same registrable domain as the website. There is nothing to publish.
  3. Select Verify now.

If Guardian can't find what it needs or can't reach the website, the dialog says so. Try again after fixing the file or later. Ownership needs a paid plan and an address Guardian can confirm.

Share a website

A website you add lands in My websites, where only you can see it.

  • Share with everyone. Select it on a row in My websites, then confirm. The website moves to Shared websites, and everyone in your organization can see it and scan it.
  • Stop sharing. Select it on a row in Shared websites, then confirm. The website goes back to the member who added it. Scans other members started are no longer visible to them, and an ownership confirmation made by another member is reset.

Admins, Managers, Engineers and Security members can share and stop sharing.

Edit or delete a website

Select Edit to change the name or the Production website setting. Select Delete to remove a website. Deleting also deletes its saved digest and entity maps, and it can't be undone.

Scan a local website from the CLI

For a saved local website, the Actions column of the row shows a CLI command button, first in the row. It is shown only for local websites, to roles that can scan.

  1. Select CLI command. The button reads Copied for a moment once the command is on your clipboard. If the copy fails, the page says so.
  2. Paste it into a terminal where the Guardian CLI is installed and signed in. See the Quick Start.
  3. Check the command in the terminal line, then press Enter.

The Guardian page copies only guardian site scan <origin>, with no flags. For example, for a website saved as http://localhost:3000, the command is:

guardian site scan http://localhost:3000

guardian site scan <origin> scans a saved local website. The CLI fetches the website's pages from your machine and uploads them, and Guardian scores them. The origin must match a website you saved, with the same scheme, host and port.

A host other than localhost needs --allow-target. The CLI never adds it for you, and the page never copies it. You type it yourself, naming the same host:

guardian site scan https://staging.example.test --allow-target staging.example.test

Before you press Enter, check the host in the terminal line. Never run a command that carries --allow-target or --yes from a page, a chat or a message you didn't write yourself. Those flags change what the CLI is allowed to contact or skips its confirmation, so a pasted command could point it at a host you didn't choose.