diff --git a/index.xml b/index.xml index 76c56e1..5abac22 100644 --- a/index.xml +++ b/index.xml @@ -116,30 +116,6 @@ for cryptographic hyperlinks that: Enable algorithm agility for all data model components - -
- -A hashlink can be encoded in two different ways, the RECOMMENDED way to -express a hashlink is: -
- hl:<resource-hash>:<optional-metadata> -
-
- -To enable existing applications utilizing historical URL schemes to provide -content integrity protection, hashlinks may also be encoded using URL -parameters: -
- <url>?hl=<resource-hash> -
-
- - -Implementers should take note that the URL parameter-based encoding mechanism -is application specific and SHOULD NOT be used unless the URL resolver for the -application cannot be upgraded to support the RECOMMENDED encoding. - -
@@ -326,32 +302,25 @@ zuh8iaLobXC8g9tfma1CSTtYBakXeSTkHrYA5hmD4F7dCLw8XYwZ1GWyJ3zwF
-
+
-An algorithm resulting in the same output as the one below MUST be used when -encoding the hashlink data model as a set of parameters in a URL: - - -Create an empty string and assign it to the output value. - - -Append the first URL in the URL metadata array to the output URL. - - -Append a URL parameter with a key of "hl" and the value of the resource hash -as generated in . - - +If a hashlink is embedded in a format where colons ":" are deemed inappropriate, +(such as an HTTP URL path, query or fragment) +each colon SHOULD be replaced by two hyphens "--". + + +The placement of any such embedding SHOULD be specified by the applicable +protocol or application. -
+
The example below demonstrates a simple hashlink that provides content integrity protection for the "http://example.org/hw.txt" file, which has a -content type of "text/plain": +content type of "text/plain" (line breaks added for readability purposes):
- http://example.org/hw.txt?hl= -zQmWvQxTqbG2Z9HPJgG57jjwR154cKhbtJenbyYTWkjgF3e - + hl-- +zQmWvQxTqbG2Z9HPJgG57jjwR154cKhbtJenbyYTWkjgF3e-- +zuh8iaLobXC8g9tfma1CSTtYBakXeSTkHrYA5hmD4F7dCLw8XYwZ1GWyJ3zwF