Zum Hauptinhalt springen

11. IANA Considerations (IANA-Überlegungen)

Diese Spezifikation etabliert mehrere Register für das HTTP/2-Protokoll. Dieser Abschnitt beschreibt diese Register und ihre zugehörigen Registrierungsrichtlinien.

11.1. Registration of HTTP/2 Identification Strings (Registrierung von HTTP/2-Identifikationszeichenfolgen)​

Dieses Dokument erstellt zwei Registrierungen für die Identifikation von HTTP/2: die Zeichenfolgen "h2" und "h2c".

Die Zeichenfolge "h2" identifiziert HTTP/2, wenn es über TLS verwendet wird, wie in Abschnitt 3.3 beschrieben.

Die Zeichenfolge "h2c" identifiziert HTTP/2, wenn es über Klartext-TCP verwendet wird, wie in Abschnitt 3.2 beschrieben.

Diese Identifikationszeichenfolgen sind im "Application-Layer Protocol Negotiation (ALPN) Protocol IDs"-Register (etabliert durch [TLS-ALPN]) registriert.

11.2. Frame Type Registry (Frame-Typ-Register)​

Dieses Dokument etabliert ein Register für HTTP/2-Frame-Typ-Codes. Das "HTTP/2 Frame Type"-Register verwaltet einen 8-Bit-Raum. Das "HTTP/2 Frame Type"-Register operiert unter der "Expert Review"-Richtlinie [RFC8126], mit reservierten Werten.

Registrierungen für neue Einträge erfordern die folgenden Informationen:

  • Frame Type (Frame-Typ): Ein Name oder eine Bezeichnung für den Frame-Typ.
  • Code: Der dem Frame-Typ zugewiesene 8-Bit-Code.
  • Specification (Spezifikation): Eine Referenz zu einer Spezifikation, die eine Beschreibung des Frame-Typs enthält.

Von diesem Dokument registrierte Einträge finden sich in Tabelle 1.

Table 1: Frame Types (Frame-Typen)​

Frame TypeCodeSectionReference
DATA0x00Abschnitt 6.1RFC 9113
HEADERS0x01Abschnitt 6.2RFC 9113
PRIORITY0x02Abschnitt 6.3RFC 9113
RST_STREAM0x03Abschnitt 6.4RFC 9113
SETTINGS0x04Abschnitt 6.5RFC 9113
PUSH_PROMISE0x05Abschnitt 6.6RFC 9113
PING0x06Abschnitt 6.7RFC 9113
GOAWAY0x07Abschnitt 6.8RFC 9113
WINDOW_UPDATE0x08Abschnitt 6.9RFC 9113
CONTINUATION0x09Abschnitt 6.10RFC 9113

11.3. Settings Registry (Einstellungsregister)​

Dieses Dokument etabliert ein Register für HTTP/2-Einstellungen. Das "HTTP/2 Settings"-Register verwaltet einen 16-Bit-Raum. Das "HTTP/2 Settings"-Register operiert unter der "Expert Review"-Richtlinie [RFC8126], mit reservierten Werten.

Registrierungen für neue Einträge erfordern die folgenden Informationen:

  • Name: Ein symbolischer Name für die Einstellung. Die Angabe eines Einstellungsnamens ist optional.
  • Code: Der der Einstellung zugewiesene 16-Bit-Code.
  • Initial Value (Anfangswert): Der Anfangswert der Einstellung.
  • Specification (Spezifikation): Eine optionale Referenz zu einer Spezifikation, die eine Beschreibung der Einstellung enthält.

Von diesem Dokument registrierte Einträge finden sich in Tabelle 2.

Table 2: Settings (Einstellungen)​

NameCodeInitial ValueSectionReference
SETTINGS_HEADER_TABLE_SIZE0x014096Abschnitt 6.5.2RFC 9113
SETTINGS_ENABLE_PUSH0x021Abschnitt 6.5.2RFC 9113
SETTINGS_MAX_CONCURRENT_STREAMS0x03(infinite)Abschnitt 6.5.2RFC 9113
SETTINGS_INITIAL_WINDOW_SIZE0x0465535Abschnitt 6.5.2RFC 9113
SETTINGS_MAX_FRAME_SIZE0x0516384Abschnitt 6.5.2RFC 9113
SETTINGS_MAX_HEADER_LIST_SIZE0x06(infinite)Abschnitt 6.5.2RFC 9113

11.4. Error Code Registry (Fehlercode-Register)​

Dieses Dokument etabliert ein Register für HTTP/2-Fehlercodes. Das "HTTP/2 Error Code"-Register verwaltet einen 32-Bit-Raum. Das "HTTP/2 Error Code"-Register operiert unter der "Expert Review"-Richtlinie [RFC8126], mit reservierten Werten.

Registrierungen für neue Einträge erfordern die folgenden Informationen:

  • Name: Der Name des Fehlercodes. Die Angabe eines Fehlercode-Namens ist optional.
  • Code: Der zugewiesene 32-Bit-Fehlercode.
  • Description (Beschreibung): Eine kurze Beschreibung der Fehlerbedingung.
  • Specification (Spezifikation): Eine optionale Referenz zu einer Spezifikation, die den Fehlercode definiert.

Von diesem Dokument registrierte Einträge finden sich in Tabelle 3.

Table 3: Error Codes (Fehlercodes)​

NameCodeDescriptionSectionReference
NO_ERROR0x00Graceful shutdownAbschnitt 7RFC 9113
PROTOCOL_ERROR0x01Protocol error detectedAbschnitt 7RFC 9113
INTERNAL_ERROR0x02Implementation faultAbschnitt 7RFC 9113
FLOW_CONTROL_ERROR0x03Flow control limits exceededAbschnitt 7RFC 9113
SETTINGS_TIMEOUT0x04Settings not acknowledgedAbschnitt 7RFC 9113
STREAM_CLOSED0x05Frame received for closed streamAbschnitt 7RFC 9113
FRAME_SIZE_ERROR0x06Frame size incorrectAbschnitt 7RFC 9113
REFUSED_STREAM0x07Stream not processedAbschnitt 7RFC 9113
CANCEL0x08Stream cancelledAbschnitt 7RFC 9113
COMPRESSION_ERROR0x09Compression state not updatedAbschnitt 7RFC 9113
CONNECT_ERROR0x0aTCP connection error for CONNECT methodAbschnitt 7RFC 9113
ENHANCE_YOUR_CALM0x0bProcessing capacity exceededAbschnitt 7RFC 9113
INADEQUATE_SECURITY0x0cNegotiated TLS parameters not acceptableAbschnitt 7RFC 9113
HTTP_1_1_REQUIRED0x0dUse HTTP/1.1 for the requestAbschnitt 7RFC 9113

11.5. HTTP2-Settings Header Field Registration (HTTP2-Settings-Header-Feld-Registrierung)​

Dieser Abschnitt registriert das HTTP2-Settings-Header-Feld im "Hypertext Transfer Protocol (HTTP) Field Name Registry" [HTTP].

  • Header field name (Header-Feldname): HTTP2-Settings
  • Applicable protocol (Anwendbares Protokoll): http
  • Status: standard
  • Author/Change controller (Autor/Änderungskontrolleur): IETF
  • Specification document(s) (Spezifikationsdokument(e)): Abschnitt 3.2.1 von RFC 9113

11.6. PRI Method Registration (PRI-Methoden-Registrierung)​

Dieser Abschnitt registriert die PRI-Methode im "HTTP Method Registry" [HTTP].

  • Method Name (Methodenname): PRI
  • Safe (Sicher): No
  • Idempotent: No
  • Specification document(s) (Spezifikationsdokument(e)): Abschnitt 3.4 von RFC 9113

11.7. The 421 (Misdirected Request) HTTP Status Code (Der 421-HTTP-Statuscode)​

Dieser Abschnitt registriert den 421 (Misdirected Request) HTTP-Statuscode im "HTTP Status Codes"-Register [HTTP].

  • Status Code (Statuscode): 421
  • Short Description (Kurze Beschreibung): Misdirected Request
  • Specification document(s) (Spezifikationsdokument(e)): Abschnitt 9.1.2 von RFC 9113

11.8. The h2c Upgrade Token (Das h2c-Upgrade-Token)​

Dieser Abschnitt registriert das "h2c"-Upgrade-Token im "HTTP Upgrade Token Registry" [HTTP].

  • Name: h2c
  • Description (Beschreibung): Hypertext Transfer Protocol version 2 (HTTP/2)
  • Expected Version Tokens (Erwartete Versions-Token): None
  • References (Referenzen): Abschnitt 3.2 von RFC 9113

Kapitel 11 abgeschlossen!

References​

  • [RFC8126] Cotton, M., Leiba, B., and T. Narten, "Guidelines for Writing an IANA Considerations Section in RFCs", BCP 26, RFC 8126, June 2017.
  • [HTTP] Fielding, R., Ed., Nottingham, M., Ed., and J. Reschke, Ed., "HTTP Semantics", STD 97, RFC 9110, June 2022.
  • [TLS-ALPN] Friedl, S., Popov, A., Langley, A., and E. Stephan, "Transport Layer Security (TLS) Application-Layer Protocol Negotiation Extension", RFC 7301, July 2014.
Letztes Update am