Usare HTTP/3 con il server Web ASP.NET Core Kestrel

HTTP/3 è uno standard approvato e la terza versione principale di HTTP. Questo articolo illustra i requisiti per HTTP/3. HTTP/3 è completamente supportato in ASP.NET Core 7.0 e versioni successive.

Importante

Le app configurate per sfruttare i vantaggi di HTTP/3 devono essere progettate per supportare anche HTTP/1.1 e HTTP/2.

Requisiti HTTP/3

HTTP/3 ha requisiti diversi a seconda del sistema operativo. Se la piattaforma Kestrel in esecuzione in non ha tutti i requisiti per HTTP/3, viene disabilitata e Kestrel verrà eseguito il fallback ad altri protocolli HTTP.

Finestre

• Windows 11 Build 22000 o versione successiva o Windows Server 2022.
• Connessione TLS 1.3 o successiva.

Linux

• libmsquic pacchetto installato.

libmsquic viene pubblicato tramite il repository ufficiale dei pacchetti Linux di Microsoft all'indirizzo packages.microsoft.com. Per installare questo pacchetto:

1. Aggiungere il packages.microsoft.com repository. Per istruzioni, vedere Repository software Linux per prodotti Microsoft.
2. Installare il libmsquic pacchetto usando la gestione pacchetti della distribuzione. Ad esempio, apt install libmsquic=1.9* in Ubuntu.

Nota: .NET 6 è compatibile solo con le versioni 1.9.x di libmsquic. Libmsquic 2.x non è compatibile a causa di modifiche di rilievo. Libmsquic riceve gli aggiornamenti alla versione 1.9.x quando sono necessari per incorporare correzioni di sicurezza.

macOS

HTTP/3 non è attualmente supportato in macOS e potrebbe essere disponibile in una versione futura.

Introduzione

HTTP/3 non è abilitato per impostazione predefinita. Aggiungere la configurazione a per Program.cs abilitare HTTP/3.

var builder = WebApplication.CreateBuilder(args);

builder.WebHost.ConfigureKestrel((context, options) =>
{
    options.ListenAnyIP(5001, listenOptions =>
    {
        listenOptions.Protocols = HttpProtocols.Http1AndHttp2AndHttp3;
        listenOptions.UseHttps();
    });
});

Il codice precedente configura la porta 5001 per:

• Usare HTTP/3 insieme a HTTP/1.1 e HTTP/2 specificando HttpProtocols.Http1AndHttp2AndHttp3.
• Abilitare HTTPS con UseHttps. HTTP/3 richiede HTTPS.

Poiché non tutti i router, i firewall e i proxy supportano correttamente HTTP/3, HTTP/3 deve essere configurato insieme a HTTP/1.1 e HTTP/2. A tale scopo, è possibile specificare HttpProtocols.Http1AndHttp2AndHttp3 come protocolli supportati da un endpoint.

Per altre informazioni, vedere Configurare gli endpoint per il server Web ASP.NET CoreKestrel.

Alt-svc

HTTP/3 viene individuato come aggiornamento da HTTP/1.1 o HTTP/2 tramite l'intestazione alt-svc . Ciò significa che la prima richiesta userà normalmente HTTP/1.1 o HTTP/2 prima di passare a HTTP/3. Kestrel aggiunge automaticamente l'intestazione alt-svc se HTTP/3 è abilitato.

Test localhost

• I browser non consentono certificati autofirmato su HTTP/3, ad esempio il Kestrel certificato di sviluppo.

• HttpClient può essere usato per i test localhost/loopback in .NET 6 o versione successiva. È necessaria una configurazione aggiuntiva quando si usa HttpClient per effettuare una richiesta HTTP/3:

  • Impostare su HttpRequestMessage.Version 3.0 o
  • Impostare HttpRequestMessage.VersionPolicy su HttpVersionPolicy.RequestVersionOrHigher.

Vantaggi di HTTP/3

HTTP/3 usa la stessa semantica di HTTP/1.1 e HTTP/2: a tutte le versioni si applicano i medesimi metodi di richiesta, codici di stato e campi dei messaggi. Le differenze stanno nel trasporto sottostante. Sia HTTP/1.1 che HTTP/2 usano TCP come protocollo di trasporto. HTTP/3 usa una nuova tecnologia di trasporto sviluppata insieme a HTTP/3 denominata QUIC.

HTTP/3 e QUIC presentano diversi vantaggi rispetto a HTTP/1.1 e HTTP/2:

• Tempo di risposta più rapido della prima richiesta. QUIC e HTTP/3 negoziano la connessione in meno round trip tra il client e il server. La prima richiesta raggiunge il server più velocemente.
• Esperienza migliorata quando si verifica una perdita di pacchetti di connessione. HTTP/2 esegue il multiplexing di più richieste tramite una connessione TCP. La perdita di pacchetti sulla connessione influisce su tutte le richieste. Questo problema è denominato "blocco head-of-line". Poiché QUIC fornisce il multiplexing nativo, i pacchetti persi influisce solo sulle richieste in cui i dati sono stati persi.
• Supporta la transizione tra reti. Questa funzionalità è utile per i dispositivi mobili in cui è comune passare da una rete wi-fi all'altra perché un dispositivo mobile cambia posizione. Attualmente, durante il cambio di rete le connessioni HTTP/1.1 e HTTP/2 hanno esito negativo e restituiscono un errore. Un'app o un Web browser deve ritentare eventuali richieste HTTP non riuscite. HTTP/3 consente all'app o al Web browser di continuare senza problemi quando cambia la rete. Kestrel non supporta le transizioni di rete in .NET 8. Il supporto potrebbe essere disponibile in una versione futura.