RoutingEndpointConventionBuilderExtensions.RequireHost<TBuilder> Méthode

Définition

Espace de noms:

Microsoft.AspNetCore.Builder

Assembly:

Microsoft.AspNetCore.Routing.dll

Paquet:

Microsoft.AspNetCore.App.Ref v10.0.0

Nécessite que les points de terminaison correspondent à l’un des hôtes spécifiés pendant le routage.

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 TBuilder

Paramètres de type

TBuilder

Paramètres

builder

TBuilder

À IEndpointConventionBuilder laquelle ajouter les métadonnées.

hosts

String[]

Hôtes utilisés pendant le routage. Les hôtes doivent être Unicode plutôt que punycode et peuvent avoir un port. Une collection vide signifie que n’importe quel hôte sera accepté.

Retours

TBuilder

Référence à cette instance une fois l’opération terminée.

Remarques

Les API qui dépendent de l’en-tête hôte, y compris Host et RequireHost<TBuilder>(TBuilder, String[]), sont vulnérables à l’usurpation du client.

Pour vous protéger contre l’usurpation d’identité d’hôte et de port :

• Vérifiez le nom du serveur utilisé pendant l’établissement d’une liaison TLS à l’aide d’ITlsHandshakeFeature.HostName.
• Vérifiez le port local où la connexion a été acceptée à l’aide Connection (en particulier LocalPort).