Type at least two letters.

    ↑ ↓ to moveEnter to open

    Which addresses can be audited

    Metricevo audits public websites only. The rules an address must pass, and the message for each.

    Updated

    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

    1. When you add a site or check an address: the address itself is checked. A refused address is not stored.
    2. 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.