Zum Hauptinhalt springen

2. Erstellen und Überarbeiten von Registries

Die Definition einer Registry umfasst die Beschreibung der zu erstellenden Namensräume, die Auflistung eines anfänglichen Satzes von Zuweisungen (falls zutreffend) und die Dokumentation von Richtlinien, wie zukünftige Zuweisungen vorgenommen werden sollen.

Bei der Definition einer Registry sollte erwogen werden, den Namensraum so zu strukturieren, dass nur Zuweisungen der obersten Ebene mit zentraler Koordination vorgenommen werden müssen, und diese Zuweisungen können Zuweisungen niedrigerer Ebenen delegieren, sodass die Koordination für diese verteilt werden kann. Dies verringert die Belastung von IANA beim Umgang mit Zuweisungen und ist besonders nützlich in Situationen, in denen verteilte Koordinatoren bessere Kenntnisse über ihren Teil des Namensraums haben und besser geeignet sind, diese Zuweisungen zu handhaben.

2.1. Organisation von Registries​

Alle Registries sind von der IANA-Seite "Protocol Registries" verankert:

https://www.iana.org/protocols

Diese Seite listet Registries in Protokollkategoriegruppen auf, wobei verwandte Registries zusammengestellt werden, um es Benutzern der Registries zu erleichtern, die erforderlichen Informationen zu finden. Ein Klick auf den Titel einer der Registries auf der IANA Protocol Registries-Seite führt den Leser zur Detailseite dieser Registry.

Leider waren wir inkonsistent in der Art und Weise, wie wir uns auf diese Entitäten beziehen. Die Gruppennamen, auf die hier Bezug genommen wird, wurden unterschiedlich als "Protokollkategoriegruppen", "Gruppen", "Registries der obersten Ebene" oder einfach "Registries" bezeichnet. Die Registries darunter wurden als "Registries" oder "Unter-Registries" bezeichnet.

Unabhängig von der verwendeten Terminologie sollten Dokumentautoren auf die Registry-Gruppierungen achten, beantragen, dass verwandte Registries zusammengefasst werden, um verwandte Registries leichter zu finden, und beim Erstellen einer neuen Registry prüfen, ob diese Registry am besten in eine vorhandene Gruppe aufgenommen werden sollte. Diese Gruppierungsinformationen sollten IANA in der Registry-Erstellungsanforderung klar mitgeteilt werden.

2.2. Dokumentationsanforderungen für Registries​

Dokumente, die einen neuen Namensraum erstellen (oder die Definition eines vorhandenen Raums ändern) und von denen erwartet wird, dass IANA eine Rolle bei der Pflege dieses Raums spielt (als Repository für registrierte Werte dient), müssen klare Anweisungen zu Details des Namensraums bereitstellen, entweder im Abschnitt IANA Considerations oder von dort referenziert.

Insbesondere müssen solche Anweisungen Folgendes enthalten:

Der Name der Registry​

Dieser Name wird auf der IANA-Webseite erscheinen und in zukünftigen Dokumenten referenziert werden, die einen Wert aus dem neuen Raum zuweisen müssen. Der vollständige Name (und die Abkürzung, falls zutreffend) sollte angegeben werden. Es ist sehr wünschenswert, dass der gewählte Name nicht leicht mit dem Namen einer anderen Registry verwechselt werden kann.

Beim Erstellen einer Registry muss die Gruppe, zu der sie gehört, unter Verwendung ihres vollständigen Namens identifiziert werden, genau so, wie er in der Protocol Registries-Liste erscheint.

Die Angabe einer URL zur genauen Identifizierung der Registry hilft IANA, die Anforderung zu verstehen. Solche URLs können vor der endgültigen Veröffentlichung aus dem RFC entfernt oder im Dokument zur Referenz belassen werden. Wenn Sie iana.org-URLs einschließen, wird IANA bei Bedarf während ihrer Überprüfung Korrekturen vornehmen.

Erforderliche Informationen für Registrierungen​

Dies teilt Registranten mit, welche Informationen sie in ihre Registrierungsanforderungen aufnehmen müssen. Einige Registries erfordern nur den angeforderten Wert und einen Verweis auf ein Dokument, in dem die Verwendung des Werts definiert ist. Andere Registries erfordern eine detailliertere Registrierungsvorlage, die relevante Sicherheitsüberlegungen, Internationalisierungsüberlegungen und andere solche Informationen beschreibt.

Anwendbare Registrierungsrichtlinie​

Die Richtlinie, die für alle zukünftigen Registrierungsanforderungen gelten wird. Siehe Abschnitt 4.

Größe, Format und Syntax von Registry-Einträgen​

Welche Felder in der Registry aufzuzeichnen sind, alle technischen Anforderungen an Registry-Einträge (gültige Bereiche für Ganzzahlen, Längenbeschränkungen für Zeichenketten usw.) und das genaue Format, in dem Registry-Werte angezeigt werden sollen. Bei numerischen Zuweisungen sollte angegeben werden, ob Werte in Dezimal-, Hexadezimal- oder einem anderen Format aufgezeichnet werden sollen.

Es wird erwartet, dass Zeichenketten ASCII sind, und es sollte klar angegeben werden, ob Groß-/Kleinschreibung wichtig ist und ob beispielsweise Zeichenketten in der Registry in Groß- oder Kleinbuchstaben angezeigt werden sollen.

Zeichenketten, die Protokollparameter darstellen, müssen selten, wenn überhaupt, Nicht-ASCII-Zeichen enthalten. Wenn Nicht-ASCII-Zeichen wirklich notwendig sind, sollten die Anweisungen sehr klar machen, dass sie erlaubt sind und dass die Nicht-ASCII-Zeichen als Unicode-Zeichen unter Verwendung der "(U+XXXX)"-Konvention dargestellt werden sollten. Jeder, der eine solche Registry erstellt, sollte dies sorgfältig überdenken und Internationalisierungsratschläge wie die in [RFC7564], Abschnitt 10, in Betracht ziehen.

Anfängliche Zuweisungen und Reservierungen​

Alle anfänglichen Zuweisungen oder Registrierungen, die einbezogen werden sollen. Darüber hinaus sollten alle Bereiche angegeben werden, die für "Private Use", "Reserved", "Unassigned" usw. reserviert werden sollen (siehe Abschnitt 6).

Beispielsweise könnte ein Dokument eine neue Registry angeben, indem es Folgendes enthält:

---------------------------------------------------------------

X. IANA-Überlegungen

Dieses Dokument definiert eine neue DHCP-Option mit dem Titel "FooBar" (siehe
Abschnitt y) und weist einen Wert von TBD1 aus dem DHCP-Optionsraum zu
<https://www.iana.org/assignments/bootp-dhcp-parameters>
[RFC2132] [RFC2939]:
Data
Tag Name Length Meaning
---- ---- ------ -------
TBD1 FooBar N FooBar-Server

Die FooBar-Option definiert auch ein 8-Bit-FooType-Feld, für das
IANA eine neue Registry mit dem Titel "FooType values" erstellen und pflegen soll,
die von der FooBar-Option verwendet wird. Anfangswerte für die
DHCP FooBar FooType-Registry sind unten angegeben; zukünftige Zuweisungen
sollen durch Expert Review [BCP26] erfolgen. Zuweisungen bestehen
aus einem DHCP FooBar FooType-Namen und seinem zugehörigen Wert.

Value DHCP FooBar FooType Name Definition
---- ------------------------ ----------
0 Reserved
1 Frobnitz RFCXXXX, Abschnitt y.1
2 NitzFrob RFCXXXX, Abschnitt y.2
3-254 Unassigned
255 Reserved
---------------------------------------------------------------

Beispiele für Dokumente, die Registries einrichten, finden Sie in [RFC3575], [RFC3968] und [RFC4520].

Jedes Mal, wenn IANA Namen und Kontaktinformationen in die öffentliche Registry aufnimmt, könnten einige Personen es vorziehen, dass ihre Kontaktinformationen nicht öffentlich gemacht werden. In solchen Fällen können Vereinbarungen mit IANA getroffen werden, um die Kontaktinformationen privat zu halten.

2.3. Festlegung der Änderungskontrolle für eine Registry​

Registry-Definitionen und Registrierungen innerhalb von Registries müssen oft nach ihrer Erstellung geändert werden. Der Prozess solcher Änderungen wird kompliziert, wenn unklar ist, wer berechtigt ist, die Änderungen vorzunehmen. Für Registries, die durch RFCs im IETF-Stream erstellt wurden, liegt die Änderungskontrolle für die Registry standardmäßig bei der IETF über die IESG. Dasselbe gilt für Wertregistrierungen, die in IETF-Stream-RFCs vorgenommen werden.

Da Registries außerhalb des IETF-Streams erstellt und Registrierungen vorgenommen werden können, kann es manchmal wünschenswert sein, die Änderungskontrolle außerhalb der IETF und IESG zu haben, und die klare Spezifikation von Änderungskontrollrichtlinien ist immer hilfreich.

Es wird daher empfohlen, dass alle erstellten Registries eine Änderungskontrollrichtlinie und einen Änderungskontrolleur klar angeben. Es wird auch empfohlen, dass Registries, die Registrierungen von außerhalb des IETF-Streams zulassen, für jeden Wert die Bezeichnung eines Änderungskontrolleurs für diesen Wert enthalten. Wenn die Definition oder Referenz für einen registrierten Wert jemals geändert werden muss oder wenn ein registrierter Wert veraltet werden muss, ist es entscheidend, dass IANA weiß, wer berechtigt ist, die Änderung vorzunehmen. Beispielsweise enthält die Media Types-Registry [RFC6838] einen "Change Controller" in ihrer Registrierungsvorlage. Siehe auch Abschnitt 9.5.

2.4. Überarbeitung bestehender Registries​

Die Aktualisierung des Registrierungsprozesses oder das Vornehmen von Änderungen am Format einer bereits bestehenden (zuvor erstellten) Registry (ob explizit oder implizit erstellt) folgt einem Prozess, der dem bei der Erstellung einer neuen Registry verwendeten ähnlich ist. Das heißt, es wird ein Dokument erstellt, das auf den vorhandenen Namensraum Bezug nimmt und dann detaillierte Anleitungen für den Umgang mit Zuweisungen in der Registry oder detaillierte Anweisungen zu den erforderlichen Änderungen bereitstellt.

Wenn eine Änderung eine neue Spalte in der Registry erfordert, müssen die Anweisungen klar sein, wie diese Spalte für die vorhandenen Einträge zu füllen ist. Andere Änderungen können ähnliche Klarheit erfordern.

Solche Dokumente werden normalerweise mit demselben Dokumentstatus verarbeitet wie das Dokument, das die Registry erstellt hat. Unter einigen Umständen, wie bei einer einfachen Änderung, die eindeutig erforderlich ist (wie das Hinzufügen einer "Status"-Spalte), oder wenn ein früherer Fehler korrigiert werden muss, kann die IESG eine Aktualisierung einer Registry genehmigen, ohne ein neues Dokument zu verlangen.

Beispieldokumente, die die Richtlinien für Zuweisungen in bereits bestehenden Registries aktualisiert haben, umfassen: [RFC6895], [RFC3228] und [RFC3575].