Skip to main content
By default, Ility crawls and scans a surface as an anonymous visitor. If parts of your site are only visible after signing in, such as an account area or a staging site behind a password, set up a scan login. Ility then signs in before it crawls or scans and tests the pages that account can see. Members and owners can set up a scan login. Viewers can see it but not change it.
Use a dedicated test account, never a real person’s. Give it access only to what you want scanned. Accounts that need a one-time code aren’t supported yet.

Choose a sign-in method

On plans without login forms, choosing Login form shows a notice with a link to see plans. Basic auth stays available.

Set up a scan login

  1. Open the surface and choose Settings in the sidebar.
  2. In the Scan login card, choose a Sign-in method.
  3. Fill in the fields for that method (see below).
  4. Choose Save login.
Ility uses the login from the next crawl or scan.

HTTP basic auth

Enter the Username and Password the site’s prompt expects.

Login form

Under Field selectors (optional) you can also set the Username field, Password field, and Submit button, such as input[name=email], input[type=password], and button[type=submit]. Leave them blank and Ility finds the username and password fields itself and submits with Enter. Two-step forms, where the password field only appears after you submit the username, work without extra settings. Set the selectors when Ility can’t find your form’s fields on its own.

The password is write-only

Ility stores the password encrypted and never shows it again. When a password is saved, the field stays empty and reads A password is saved. Leave this blank to keep it. Leave it blank when you save other changes to keep the stored password. Type a new one to replace it.

How Ility signs in

  • Ility signs in once at the start of each crawl or scan, then reuses that session for every page.
  • A signed-in crawl also starts from the page your site shows right after login. Signed-in pages are often only linked from there.
  • If a page sends Ility back to the login page, Ility signs in again and retries that page once. A page that still lands on the login page fails as Signed out.
  • Ility never opens URLs that look like sign-out links, such as /logout, because that would end the session for every page after it. A crawl skips them. A scan marks them as failed with Sign-out link skipped.

When sign-in fails

If Ility can’t sign in at all, it fails the whole crawl or scan instead of testing your site anonymously. The error starts with Sign-in failed: and says what went wrong, such as a rejected password, a selector that matched nothing, or a login page URL that isn’t allowed. Fix the scan login in Settings and run the scan again. See When a page fails for page-level failure reasons.

Remove a scan login

Set Sign-in method to None (scan as a visitor) and choose Remove login. Later crawls and scans run anonymously.

Manage a scan login with the API

Read, set, and remove a scan login with GET, PUT, and DELETE on /v1/domains/{slug}/scan-auth. The API never returns the password. has_password says whether one is stored.
Omit password on a later PUT to keep the stored one. PUT returns 403 for form on a plan without login forms, 400 for an off-site login URL or a missing logged-in check, and 503 when scan logins aren’t available. In that case GET returns available: false. See Set a domain’s scan login for the full request and response.