| 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. | ||||