Which addresses can be audited
Metricevo audits public websites only. The rules an address must pass, and the message for each.
Metricevo only reads websites that anyone on the internet can reach. Every address is checked when you add a site, and again when the audit runs: the host must resolve to a public IP address, and every redirect target is checked the same way.
The rules
| The address | Message you get |
|---|---|
| Is not a web address | This is not a web address. |
Uses something other than http or https |
Only http and https addresses can be audited. |
| Contains a username or password | The address cannot contain a username or password. |
Is localhost or ends in .localhost, .local, .internal or .lan |
Local and internal network names cannot be audited. |
Has no dot, for example intranet |
Use a full domain, for example example.com. |
| Is a private, loopback or reserved IP address | Private, loopback and reserved IP addresses cannot be audited. |
| Is a cloud metadata or link-local address | Cloud metadata and link-local addresses cannot be audited. |
| Is an IPv6 literal | IPv6 literals are not accepted in the PoC. Use a domain. |
| Uses a port other than 80 or 443 | Only the default ports (80 and 443) are allowed. |
When the check happens
- When you add a site or check an address: the address itself is checked. A refused address is not stored.
- When the audit runs: the host is resolved and must point to a public IP address. Each redirect is checked again before it is followed. If any step fails, the run ends as failed with
errorCode: url_policy_denied.
The second step protects against a public name that points, or later starts pointing, to an internal address.
Check an address without auditing it
Over the API, POST /url-checks runs the same rules and answers at once:
curl -X POST "$METRICEVO_API/url-checks" \
-H "Authorization: Bearer $METRICEVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"http://localhost:8080"}'
{
"allowed": false,
"reasons": ["localhost"],
"message": "Local and internal network names cannot be audited."
}
An allowed address comes back with "allowed": true and its normalised form in normalisedUrl. The call needs the audits:read scope.