HTTPAPI | Réservation d'URL

La réservation d'URL HTTP.SYS est une fonctionnalité du système d'exploitation Windows qui permet à un utilisateur de réserver une URL spécifique pour son application ou service. Lorsqu'une URL est réservée via HTTP.SYS, le système d'exploitation intercepte toutes les requêtes HTTP entrantes pour cette URL et les route vers l'application ou le service spécifié.

 

Pour réserver une URL à l'aide de HTTP.SYS, une application ou un service doit d'abord enregistrer l'URL auprès du pilote HTTP.SYS en effectuant un appel à l'API HTTP. L'application ou le service spécifie l'URL, la méthode HTTP (par ex. GET, POST) et tout paramètre supplémentaire comme les exigences d'authentification.

 

Une fois l'URL enregistrée, HTTP.SYS interceptera toutes les requêtes HTTP entrantes pour cette URL et recherchera l'application ou le service enregistré en fonction de l'URL et de la méthode. Si une application ou un service correspondant est trouvé, le pilote HTTP.SYS transmettra la requête à cette application ou ce service pour traitement.

 

Commandes NETSH

Enregistrer une URL

Dans cet exemple, l'URL http://example.com:80/ est enregistrée pour l'utilisateur DOMAIN\user. Vous pouvez remplacer ceci par l'URL et l'utilisateur de votre choix.

 

netsh http add urlacl url=http://example.com:80/ user=DOMAIN\user

 

Supprimer une URL

Dans cet exemple, l'URL http://example.com:80/ est supprimée. Vous pouvez la remplacer par l'URL que vous souhaitez supprimer.

 

netsh http delete urlacl url=http://example.com:80/

 

Afficher toutes les URL

Cette commande affiche la liste de toutes les réservations d'URL enregistrées sur le système.

 

netsh http show urlacl

 

TsgcWebSocketServer_HTTPAPI

Le serveur HTTP.SYS enregistre les URLs automatiquement à son démarrage. Cela se fait en utilisant les paramètres et méthodes suivants.

 

• Hôte et Port : si l'Hôte n'est pas vide et que le Port est différent de zéro, le serveur essaiera d'enregistrer l'URL. Exemple : l'URL https://127.0.0.1:5000 sera enregistrée en utilisant les propriétés suivantes
  • Host = '127.0.0.1' ;
  • Port = 5000
  • SSL = True
• NewBinding : utilisez cette méthode pour enregistrer une ou plusieurs URL.
  • Enregistrer l'URL https://127.0.0.1:5000 --> NewBinding('127.0.0.1', 5000, '/', True)
  • Enregistrer l'URL http://+:5000/ws/ --> NewBinding('+', 5000, '/ws/')

 

L'enregistrement d'URL nécessite des privilèges administrateur dans les cas suivants :

• Le numéro de port est inférieur à 1024
• L'hôte est un joker "+", au lieu d'une adresse IP.

 

 

Si vous souhaitez enregistrer le port 443 pour toutes les adresses IP du serveur et n'écouter que sur le point de terminaison « /ws/ » sans vouloir exécuter le serveur avec des droits d'administrateur, procédez comme suit :

 

• Enregistrer l'URL avec netsh
  • netsh http add urlacl url=https://+:443/ws/ user=DOMAIN\user
• Configurez le serveur avec la liaison suivante
  • NewBinding('+', 443, '/ws/', True);
• Désactiver la propriété ConfigureSSLCertificate
  • TsgcWebSocketServer_HTTPAPI.BindingOptions.ConfigureSSLCertificate = false;
• Configurer le certificat SSL
  • SSL du serveur HTTPAPI