Provided by: apt_3.1.3_amd64 
NOM
apt-transport-http - Transport d'APT pour téléchargement par HTTP (protocole de transfert hypertexte)
DESCRIPTION
Ce transport d'APT permet d'utiliser les dépôts auxquels on accède au moyen de HTTP (Hypertext Transfer
Protocol). Il est disponible par défaut et il est probablement le transport le plus utilisé de tous.
Veuillez noter qu'un transport n'est jamais appelé directement par l'utilisateur, mais utilisé par les
outils d'APT s'appuyant sur la configuration de l'utilisateur.
HTTP est un protocole de transport non chiffré ce qui veut dire que toutes les communications avec le
serveur distant (ou le mandataire) peuvent être observées par un attaquant suffisamment compétent appelé
couramment « homme du milieu » (MITM). Cependant, un tel attaquant ne peut pas modifier la communication
pour compromettre la sécurité du système dans la mesure où le modèle de sécurité des données d'APT est
indépendant de la méthode de transport choisie. Cela est expliqué en détail dans apt-secure(8). Un aperçu
des méthodes de transport disponibles est donné dans sources.list(5).
OPTIONS
Diverses options peuvent être réglées dans un fichier apt.conf(5) pour modifier son comportement depuis
la configuration d'un mandataire à des contournements pour les limites d'un serveur particulier.
Configuration du mandataire
La variable d'environnement http_proxy est prise en charge pour une configuration au niveau du système.
Les mandataires particuliers à APT peuvent être configurés grâce à l'option Acquire::http::Proxy. Les
mandataires qui devraient être utilisés seulement pour certains hôtes peuvent être spécifiés avec
Acquire::http::Proxy::hôte. Un contrôle encore plus fin peut être obtenu avec l'autodétection du
mandataire, détaillée ci-dessous. Toutes ces options utilisent le format d'URI
schéma://[[utilisateur][:mot_de_passe]@]hôte[:port]/. Les schémas d'URI pris en charge sont socks5h
(SOCKS5 avec résolution distante de DNS), http et https. Les détails d'authentification peuvent être
fournis avec apt_auth.conf(5) plutôt que de les inclure directement dans l'URI.
Les diverses options de configuration d'APT prennent en charge la valeur particulière DIRECT signifiant
qu'aucun mandataire ne doit être utilisé. La variable d'environnement no_proxy est aussi prise en charge
dans le même but.
De plus, il y a trois options de configuration fournies pour le contrôle des caches mandataire
compatibles avec HTTP/1.1 : Acquire::http::No-Cache dit au mandataire de ne jamais utiliser les réponses
qu'il a stockées. Acquire::http::Max-Age établit l'ancienneté maximale (en secondes) d'un fichier d'index
dans le cache du mandataire. Acquire::http::No-Store indique que le mandataire ne doit pas mettre en
cache les fichiers d'archive, ce qui peut éviter de polluer un cache mandataire avec des fichiers .deb
très grands.
Configuration automatique du mandataire
L'option Acquire::http::Proxy-Auto-Detect peut être utilisée pour indiquer une commande externe pour
découvrir le mandataire HTTP à utiliser. Le premier et seul paramètre est un URI indiquant l'hôte à
contacter pour permettre une configuration propre à l'hôte. Apt s'attend à ce que la commande indique le
mandataire sur la sortie standard sur une seule ligne dans le format d'URI précédemment défini ou le mot
DIRECT si aucun mandataire ne doit être utilisé. Aucune sortie indique que le mandataire générique doit
être utilisé.
Notez que l'auto-détection ne sera pas exécutée si une configuration spécifique de mandataire hôte a déjà
été établie par Acquire::http::Proxy::hôte.
Voir les paquets squid-deb-proxy-client(1) et auto-apt-proxy(1) pour des exemples d'implémentation.
Cette option prend le pas sur l'ancien nom d'option Acquire::http::ProxyAutoDetect.
Configuration de connexion
L'option Acquire::http::Timeout positionne le compteur d'expiration du délai (timeout) utilisé par la
méthode. Cela s'applique aussi bien à la connexion qu'aux données.
La bande passante utilisée peut être limitée avec Acquire::http::Dl-Limit qui peut prendre une valeur
entière, l'unité utilisée étant le kilo-octet par seconde. La valeur par défaut est 0, ce qui correspond
à aucune limitation de bande passante. Veuillez noter que cette option désactive implicitement le
téléchargement simultané depuis plusieurs serveurs.
Le réglage Acquire::http::Pipeline-Depth permet d'utiliser l'enchaînement HTTP (« HTTP pipelining »,
RFC 2616 section 8.1.2.2) ce qui peut être utile par exemple avec des connexions à latence élevée. Il
indique le nombre de requêtes envoyées dans le tuyau. APT tente de détecter et de contourner les serveurs
web et les mandataires qui se comportent mal à l'exécution, mais si vous savez que vos serveurs ne
respectent pas la norme HTTP/1.1, l'enchaînement peut être désactivé en définissant cette valeur à 0. Il
est activé par défaut avec une valeur de 10.
Acquire::http::AllowRedirect contrôle le fait qu'APT suive les redirections. Ce réglage est activé par
défaut.
L'option Acquire::http::User-Agent peut être utilisée pour envoyer une valeur User-Agent modifiée pour
les téléchargements HTTP, ce qui peut par exemple être utile avec certains mandataires HTTP qui
n'autorisent l'accès qu'aux clients s'identifiant de manière spécifique.
Acquire::http::SendAccept est activé par défaut et envoie un champ d'en-tête Accept: text/* au serveur
pour les requêtes sans extension de fichier pour éviter que le serveur ne tente une négociation de
contenu.
EXEMPLES
Acquire::http {
Proxy::example.org "DIRECT";
Proxy "socks5h://apt:pass@127.0.0.1:9050";
Proxy-Auto-Detect "/usr/local/bin/apt-http-proxy-auto-detect";
No-Cache "true";
Max-Age "3600";
No-Store "true";
Timeout "10";
Dl-Limit "42";
Pipeline-Depth "0";
AllowRedirect "false";
User-Agent "My APT-HTTP";
SendAccept "false";
};
VOIR AUSSI
apt.conf(5) apt_auth.conf(5) sources.list(5)
BOGUES
Page des bogues d'APT[1]. Si vous souhaitez signaler un bogue à propos d'APT, veuillez lire
/usr/share/doc/debian/bug-reporting.txt ou utiliser la commande reportbug(1).
TRADUCTEURS
Jérôme Marant, Philippe Batailler, Christian Perrier <bubulle@debian.org> (2000, 2005, 2009, 2010), bubu
et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr> (2004, 2017-2024) et l'équipe de traduction francophone
de Debian <debian-l10n-french@lists.debian.org>
Veuillez noter que cette traduction peut contenir des parties non traduites. Cela est volontaire, pour
éviter de perdre du contenu quand la traduction est légèrement en retard sur le contenu d'origine.
AUTEUR
Équipe de développement d'APT
NOTES
1. Page des bogues d'APT
https://bugs.debian.org/src:apt
APT 3.1.3 04 avril 2019 APT-TRANSPORT-HTTP(1)