Skip to content

Commit 3d44ecc

Browse files
committed
Updated syntax/rules based on IETF review: avoiding sub-namespace overlap situations.
1 parent cea7dce commit 3d44ecc

2 files changed

Lines changed: 36 additions & 12 deletions

File tree

‎registry.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Version ID: 1.4.0
55
## 1. General
66

77
### URN rules
8-
The terminology and rules for "thread" URNs are defined in [urn-registration-v1.txt](urn-registration-v1.txt).
8+
The terminology, syntax and rules for "thread" URNs are defined in [urn-registration-v1.txt](urn-registration-v1.txt).
99

1010
### Security
1111
Registered `sub-namespace` entries MUST NOT contain privacy- or security-sensitive information. The `sn-content` elements MAY contain privacy- or security-sensitive information if the information is properly protected (cryptographically and/or physically) during URN handling.

‎urn-registration-v1.txt‎

Lines changed: 35 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Namespace Identifier: thread
44

55
Version: 1
66

7-
Date: 2024-11-18
7+
Date: 2024-11-21
88

99
Registrant:
1010

@@ -63,9 +63,23 @@ own registry for registering any sub-namespace elements. This registry
6363
will define any additional requirements for the sn-content element for
6464
each registered sub-namespace element. Any use of r-components,
6565
q-components or f-components is not defined in the current version 1
66-
definition. Note that sn-content allows for the inclusion of base64
67-
encoded data, or hexadecimal encoded data, as well as data with the
68-
":" character.
66+
definition.
67+
68+
Note that sn-content allows for the inclusion of base64 encoded data,
69+
or hexadecimal encoded data, as well as data with the ":" character. In
70+
most cases, a particular sub-namespace will impose stricter constraints
71+
on the allowed characters for sn-content than the constraints as
72+
specified by the above ABNF rules. A generic parser for "thread" URNs,
73+
which does not have knowledge of these sub-namespace constraints,
74+
therefore cannot validate URNs based only on the ABNF rules.
75+
76+
A parser for "thread" URNs is expected to apply the syntax rules listed
77+
here in combination with a list of known (registered) sub-namespaces of
78+
interest and their associated sn-content constraints. For unrecognized
79+
sub-namespace elements, a parser may not be able to identify where in
80+
the string the sub-namespace stops and the sn-content starts. This is
81+
deemed acceptable, since the parser will be unable to interpret the
82+
resulting URN in any case.
6983

7084
Assignment:
7185

@@ -74,13 +88,23 @@ Group based on the rules of engagement as defined for this committee.
7488
Assignments are recorded in the URN "thread" registry kept by Thread
7589
Group. An assignment may consist of a final URN (i.e. without the
7690
optional sn-content element) or of a sub-namespace definition for a
77-
particular purpose (where the sn-content element is present and may
78-
vary in contents). Each registry entry must define at least five
79-
elements: sub-namespace definition, whether it includes sn-content, a
80-
short description, security classification, and a link/reference to the
81-
detailed specifications for it.
82-
83-
Security and Privacy:
91+
particular purpose, where the sn-content element is present and may
92+
vary in contents.
93+
94+
Each registry entry MUST define at least five elements: sub-namespace
95+
definition, whether it includes sn-content, a short description,
96+
security classification, and a link/reference to the detailed
97+
specifications for it.
98+
99+
Each registered sub-namespace element MUST NOT be a prefix of any other
100+
registered sub-namespace element. A new registration entry MAY reuse
101+
an existing sub-namespace element and extend the sn-content definition
102+
for it. Any such extension MUST be done by adding a ":" character
103+
followed by an additional sn-content element. Such an extension MUST NOT
104+
be approved if the existing sn-content element as registered allows the
105+
inclusion of a ":" character, to avoid parsing ambiguity.
106+
107+
Security and Privacy:
84108

85109
Any registered URNs MUST NOT contain privacy-sensitive information about
86110
persons such as names, addresses, or personal data. URNs with desig-

0 commit comments

Comments
 (0)