Interface SubmissionRequirement.Builder

  • Method Details

    • code

      A stable, dot-namespaced identifier for the submission requirement that the report did not meet (for example, rule.timestamp.too_old). The set of codes is append-only, so treat an unrecognized value as opaque. This value is absent when the requirement that the report did not meet does not publish an identifier.

      The service checks the following submission requirements:

      • rule.source_identifier.too_long (source_identifier) – The value exceeds the maximum accepted length of 253 characters (the DNS hostname limit).

      • rule.source_identifier.forbidden_characters (source_identifier) – The value contains characters that are never valid in an address ({, }, *, or `). These are common template-injection and command-injection markers.

      • rule.source_identifier.malformed (source_identifier) – The value is not a valid IPv4 address, IPv6 address, URL, or domain name.

      • rule.timestamp.unparseable (timestamp) – The value could not be parsed as an RFC 3339 date-time.

      • rule.timestamp.in_future (timestamp) – The value is dated further into the future than the accepted clock-skew tolerance (a default of 1 hour).

      • rule.timestamp.too_old (timestamp) – The value predates the submission lookback window (a default of 90 days). For content that is still accessible, set timestamp to the time you most recently observed it.

      • rule.evidence.content_type_mismatch (evidence) – The decoded payload of an evidence item does not match its declared content_type. The path identifies the item, for example /evidence/0.

      Submission requirement thresholds are configuration-driven and can change over time. The set of codes is append-only, so treat an unrecognized code as opaque.

      Parameters:
      code - A stable, dot-namespaced identifier for the submission requirement that the report did not meet (for example, rule.timestamp.too_old). The set of codes is append-only, so treat an unrecognized value as opaque. This value is absent when the requirement that the report did not meet does not publish an identifier.

      The service checks the following submission requirements:

      • rule.source_identifier.too_long (source_identifier) – The value exceeds the maximum accepted length of 253 characters (the DNS hostname limit).

      • rule.source_identifier.forbidden_characters (source_identifier) – The value contains characters that are never valid in an address ({, }, * , or `). These are common template-injection and command-injection markers.

      • rule.source_identifier.malformed (source_identifier) – The value is not a valid IPv4 address, IPv6 address, URL, or domain name.

      • rule.timestamp.unparseable (timestamp) – The value could not be parsed as an RFC 3339 date-time.

      • rule.timestamp.in_future (timestamp) – The value is dated further into the future than the accepted clock-skew tolerance (a default of 1 hour).

      • rule.timestamp.too_old (timestamp) – The value predates the submission lookback window (a default of 90 days). For content that is still accessible, set timestamp to the time you most recently observed it.

      • rule.evidence.content_type_mismatch (evidence) – The decoded payload of an evidence item does not match its declared content_type. The path identifies the item, for example /evidence/0.

      Submission requirement thresholds are configuration-driven and can change over time. The set of codes is append-only, so treat an unrecognized code as opaque.

      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • path

      A JSON Pointer expression to the report member that did not meet the requirement. An empty string refers to the report as a whole.

      Parameters:
      path - A JSON Pointer expression to the report member that did not meet the requirement. An empty string refers to the report as a whole.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • message

      A detailed, human-readable description of the unmet submission requirement.

      Parameters:
      message - A detailed, human-readable description of the unmet submission requirement.
      Returns:
      Returns a reference to this object so that method calls can be chained together.