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
- Open the surface and choose Settings in the sidebar.
- In the Scan login card, choose a Sign-in method.
- Fill in the fields for that method (see below).
- Choose Save login.
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 withSign-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 withGET, PUT, and DELETE on /v1/domains/{slug}/scan-auth. The API never returns the password. has_password says whether one is stored.
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.