rfc9537v2.txt   rfc9537.txt 
skipping to change at line 110 skipping to change at line 110
[RFC8259]. [RFC8259].
2. Conventions Used in This Document 2. Conventions Used in This Document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in "OPTIONAL" in this document are to be interpreted as described in
BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all
capitals, as shown here. capitals, as shown here.
The JSON examples include extra line breaks and whitespace. For The JSON examples include extra line breaks and empty space. For
instance, the JSONPath expressions are broken out into multiple lines instance, the JSONPath expressions are broken out into multiple lines
when required for illustration. when required for illustration.
The JSONPath expressions in the examples are for illustration The JSONPath expressions in the examples are for illustration
purposes with single-role entities, and the exact expressions to be purposes with single-role entities, and the exact expressions to be
used by the server are out of scope. used by the server are out of scope.
3. Redaction Methods 3. Redaction Methods
Redaction in RDAP can be handled in multiple ways. The resulting Redaction in RDAP can be handled in multiple ways. The resulting
skipping to change at line 1382 skipping to change at line 1382
5. JSONPath Considerations 5. JSONPath Considerations
JSONPath [RFC9535] is the default JSON path expression language. JSONPath [RFC9535] is the default JSON path expression language.
This section includes JSONPath considerations for clients and This section includes JSONPath considerations for clients and
servers. servers.
5.1. JSONPath Client Considerations 5.1. JSONPath Client Considerations
This section covers considerations for clients that receive responses This section covers considerations for clients that receive responses
from servers using JSONPath [RFC9535] to identify redacted RDAP from servers using JSONPath [RFC9535] to identify redacted RDAP
fields with the "prePath", "postPath", or “replacementPath” member of fields with the "prePath", "postPath", or "replacementPath" member of
redacted objects in the "redacted" member. The list of JSONPath redacted objects in the "redacted" member. The list of JSONPath
client considerations include: client considerations include:
1. When the server is using the Redaction by Removal Method 1. When the server is using the Redaction by Removal Method
(Section 3.1) or the Redaction by Replacement Value Method (Section 3.1) or the Redaction by Replacement Value Method
(Section 3.4) with an alternative field value, the JSONPath (Section 3.4) with an alternative field value, the JSONPath
expression of the "prePath" member will not resolve successfully expression of the "prePath" member will not resolve successfully
with the redacted response. The client can key off the "name" with the redacted response. The client can key off the "name"
member for display logic related to the redaction. member for display logic related to the redaction.
5.2. JSONPath Server Considerations 5.2. JSONPath Server Considerations
This section covers considerations for servers using JSONPath This section covers considerations for servers using JSONPath
[RFC9535] to identify redacted RDAP fields with the "prePath", [RFC9535] to identify redacted RDAP fields with the "prePath",
"postPath", or “repacementPath” member of redacted objects in the "postPath", or "replacementPath" member of redacted objects in the
"redacted" member. The list of JSONPath considerations include: "redacted" member. The list of JSONPath considerations include:
1. Use absolute paths with the '$' JSONPath element. An example is 1. Use absolute paths with the '$' JSONPath element. An example is
"$.handle" for the "Registry Domain ID" in a lookup response or "$.handle" for the "Registry Domain ID" in a lookup response or
"$.domainSearchResults[0].handle" in a search response. "$.domainSearchResults[0].handle" in a search response.
2. Validate a JSONPath expression with the non-redacted RDAP 2. Validate a JSONPath expression with the non-redacted RDAP
response when using the "prePath" member, where evaluating the response when using the "prePath" member, where evaluating the
expression results in returning the redacted field. expression results in returning the redacted field.
 End of changes. 3 change blocks. 
3 lines changed or deleted 3 lines changed or added

This html diff was produced by rfcdiff 1.48.