RoutingEndpointConventionBuilderExtensions.RequireHost<TBuilder> Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wymaga, aby punkty końcowe odpowiadały jednemu z określonych hostów podczas routingu.
public:
generic <typename TBuilder>
where TBuilder : Microsoft::AspNetCore::Builder::IEndpointConventionBuilder[System::Runtime::CompilerServices::Extension]
static TBuilder RequireHost(TBuilder builder, ... cli::array <System::String ^> ^ hosts);public static TBuilder RequireHost<TBuilder>(this TBuilder builder, params string[] hosts) where TBuilder : Microsoft.AspNetCore.Builder.IEndpointConventionBuilder;static member RequireHost : 'Builder * string[] -> 'Builder (requires 'Builder :> Microsoft.AspNetCore.Builder.IEndpointConventionBuilder)<Extension()>
Public Function RequireHost(Of TBuilder As IEndpointConventionBuilder) (builder As TBuilder, ParamArray hosts As String()) As TBuilderParametry typu
- TBuilder
Parametry
- builder
- TBuilder
Element IEndpointConventionBuilder , do których należy dodać metadane.
- hosts
- String[]
Hosty używane podczas routingu. Hosty powinny być unicode, a nie punycode i może mieć port. Pusta kolekcja oznacza, że każdy host zostanie zaakceptowany.
Zwraca
Odwołanie do tego wystąpienia po zakończeniu operacji.
Uwagi
Interfejsy API, które zależą od nagłówka hosta, w tym Host i RequireHost<TBuilder>(TBuilder, String[]), są narażone na fałszowanie klientów.
Aby chronić przed fałszowaniem hostów i portów:
- Sprawdź nazwę serwera używaną podczas uzgadniania protokołu TLS przy użyciu elementu ITlsHandshakeFeature.HostName.
- Sprawdź port lokalny, w którym zostało zaakceptowane połączenie przy użyciu ( Connection w szczególności LocalPort).