Serveur HTTP Apache Version 2.5

Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

# Module Apache mod_proxy_connect

Description: | Extension de `mod_proxy` pour le traitement des requêtes `CONNECT`
Statut: | Extension
Identificateur de Module: | proxy_connect_module
Fichier Source: | mod_proxy_connect.c

### Sommaire

Pour fonctionner, ce module nécessite le chargement de `mod_proxy`. Il fournit le support de la méthode HTTP `CONNECT`. Cette méthode est principalement utilisée pour le franchissement des serveurs mandataires par les requêtes SSL à l'aide d'un tunnel.

Ainsi, pour pouvoir traiter les requêtes `CONNECT`, `mod_proxy` et `mod_proxy_connect` doivent être chargés dans le serveur.

CONNECT est aussi utilisée lorsque le serveur doit envoyer une requête HTTPS via un mandataire. Dans ce cas, le serveur se comporte comme un client CONNECT. Cette fonctionnalité étant fournie par le module `mod_proxy`, le module `mod_proxy_connect` n'est dans ce cas pas nécessaire.

### Avertissement

N'activez pas la fonctionnalité de mandataire avant d'avoir sécurisé votre serveur. Les serveurs mandataires ouverts sont dangereux non seulement pour votre réseau, mais aussi pour l'Internet au sens large.

### Sujets

- Informations sur les requêtes

### Directives

### Traitement des bugs

- Journal des modifications de httpd
- Problèmes connus
- Signaler un bug

### Voir aussi

- `mod_proxy`

## Informations sur les requêtes ¶

`mod_proxy_connect` enregistre les informations suivantes pour journalisation via le format `%{NOMVAR}n` dans les directives `LogFormat` ou `ErrorLogFormat` :

proxy-source-port
  Le port local utilisé pour la connexion vers le serveur d'arrière-plan.

Les requêtes avec méthode CONNECT sont traitées dans les sections `Proxy` au même titre que toute autre requête HTTP qui passe par cette même section. Il est possible de filtrer explicitement les connexions SSL à travers un mandataire en spécifiant les nom d'hôte et port cible comme suit :

    <Proxy www.example.com:443>
      Require ip 192.168.0.0/16
    </Proxy>

## Directive AllowCONNECT ¶

Description: | Ports autorisés à se `CONNECT`er à travers le mandataire
Syntaxe: | `AllowCONNECT port[-port] [port[-port]] ... | None`
Défaut: | `AllowCONNECT 443 563`
Contexte: | configuration globale, serveur virtuel
Statut: | Extension
Module: | mod_proxy_connect
Compatibilité: | Déplacé depuis `mod_proxy` à partir d'Apache 2.3.5. Tranches de ports disponibles depuis Apache 2.3.7.

La directive `AllowCONNECT` permet de spécifier une liste de numéros ou de tranches de ports auxquels la méthode de mandataire `CONNECT` pourra se connecter. Les navigateurs d'aujourd'hui utilisent cette méthode dans le cas où une connexion `https` est requise et où le tunneling mandataire sur HTTP est en service.

Par défaut, seuls les ports par défaut https (`443`) et snews (`563`) sont pris en compte. Vous pouvez utiliser la directive `AllowCONNECT` pour outrepasser ces valeurs par défaut et n'autoriser les connexions que vers les ports spécifiés.

Définir la valeur à `None` pour interdire les requêtes `CONNECT` vers tous les ports, y compris ceux par défaut.