--- schema_version: "1" id: 92bd68262a285c4c526a046241e8abd59cc90319568a0174935e9b82aab599b2 title: Configurer le module d’authentification avec une passerelle indépendante collection: tableau version: next locale: fr-ca portal_url: https://docs.salesforce.com/tableau/next/fr-ca/server-linux/server_tsig_configure_auth_mod.md canonical_url: https://help.tableau.com/v0.0/server-linux/fr-ca/server_tsig_configure_auth_mod.htm source_site: help.tableau.com content_type: documentation content_hash: ad5916d12481e49b0d6d830d514c0976dde1cafcce69774d53a9bf9ee84f2f38 description: Configure a custom authentication module with Independent Gateway. --- [Passer au contenu principal](#main-content) # Configurer le module d’authentification avec une passerelle indépendante Une pratique de sécurité courante consiste à n’autoriser que les demandes authentifiées à traverser le pare-feu interne des serveurs DMZ. La passerelle indépendante prend en charge les méthodes d’authentification traditionnelles de Tableau Server, mais elle inclut également des propriétés de configuration qui permettent d’intégrer un module chargeable Apache httpd pour une authentification personnalisée. Par exemple, en configurant SAML sur Tableau Server et en configurant un module d’authentification personnalisé, vous pouvez demander à tous les utilisateurs de s’authentifier auprès de votre IdP au niveau de la passerelle indépendante. Seuls les utilisateurs authentifiés pourront alors accéder à Tableau Server, qui pourra alors s’authentifier et autoriser l’accès des utilisateurs. Pour de plus amples renseignements sur ce modèle d’authentification, consultez [Pré-authentification avec un module AuthN](https://help.tableau.com/current/guides/enterprise-deployment/fr-ca/edg_part5.htm#preauthentication-with-an-authn-module) dans le Guide de déploiement en entreprise. Pour configurer le module d’authentification, vous devez effectuer les étapes suivantes : 1. Générez les fichiers de configuration du module d’authentification. Une fois l’installation terminée, chaque module et ses instructions de configuration seront traités comme des options Inclusion, ce qui fait que les fichiers inclus font logiquement partie de la configuration globale de httpd. 2. Copiez les fichiers de configuration sur chaque ordinateur exécutant la passerelle indépendante. Tous les fichiers doivent être copiés aux mêmes emplacements sur chaque ordinateur sur lequel s’exécute la passerelle indépendante. Chaque fichier correspond à une propriété de configuration gérée par Tableau Server. 3. Utilisez la commande `tsm configuration set` sur Tableau Server pour définir les propriétés de configuration. Ne modifiez pas le fichier de configuration httpd (httpd.conf) sur la passerelle indépendante, car celle-ci comprend une logique de mise à jour de la configuration httpd en fonction des modifications apportées par les commandes TSM sur Tableau Server. ## Exemple de configuration du module d’authentification Pour un exemple de configuration du module d’authentification de bout en bout, consultez [Exemple de configuration d’authentification : SAML avec fournisseur d’identités externe](https://help.tableau.com/current/guides/enterprise-deployment/fr-ca/edg_part5.htm#example-authentication-configuration-saml-with-external-idp) dans le Guide de déploiement en entreprise. L’exemple décrit comment installer et configurer SAML avec un fournisseur d’identités Okta et un module d’authentification Mellon pour un déploiement Tableau Server sous Linux exécuté dans AWS. Même si l’exemple décrit le processus pour Linux, l’exemple de configuration est également utile pour Tableau Server sous Windows. ## Propriétés de configuration Le tableau suivant décrit les différents fichiers de configuration auxquels vous pouvez vous référer. Chaque fichier correspond à une propriété de configuration définie sur Tableau Server. Il vous suffit de définir les propriétés nécessaires pour formuler votre configuration d’authentification personnalisée. Ignorez toutes les propriétés de configuration qui ne sont pas nécessaires.
Propriété de configurationDescription
gateway.tsig.authn_module_blockApparaît à la fin de l’ensemble des modules Apache httpd normalement chargés. L’objectif est que le fichier comprenne un ou plusieurs directives LoadModule. Les modules eux-mêmes doivent être identifiés par des chemins d’accès complets.
gateway.tsig.authn_global_blockApparaît après toutes les références LoadModule et avant la plupart des autres directives Apache httpd. L’objectif est de fournir un emplacement pour toutes les directives de configuration nécessaires au module personnalisé.
gateway.tsig.authn_globalbottom_blockApparaît tout en bas du fichier de configuration, toujours au niveau global. L’objectif est de fournir un emplacement pour toutes les directives de configuration nécessaires au module personnalisé. Elles doivent spécifiquement apparaître après diverses autres directives. (Il est peu probable que vous en ayez besoin.)
gateway.tsig.authn_location_blockApparaît dans un bloc <Location "/">, et recouvre tous les chemins d’accès des URL.
gateway.tsig.authn_directory_blockApparaît dans un bloc <Directory "/">, et recouvre tous les chemins d’accès aux fichiers traités par la passerelle indépendante. (Il est peu probable que vous en ayez besoin. La plupart des fichiers traités par la passerelle indépendante sont des ressources statiques non sensibles, comme des images et des fichiers JavaScript.)
gateway.tsig.authn_virtualhost_block

Apparaît à l’intérieur d’un ou deux blocs <VirtualHost>  : un pour TLS (si activé) et un pour non-TLS. S’il est configuré, le même fichier est inclus aux deux endroits. Si vous avez besoin de distinguer les deux cas, vous pouvez utiliser la variable d’environnement Apache httpd HTTPS standard.

## Bloc `` En plus du bloc `` attendu pour le trafic de requêtes normal, un bloc `` est également utilisé pour traiter les requêtes de gestion interne (HK) de la passerelle indépendante. Ces requêtes HK ont leurs propres protections d’authentification et ne fonctionneront pas avec les solutions classiques d’authentification unique personnalisée. Vous devrez peut-être empêcher explicitement que votre module personnalisé ne tente d’authentifier le chemin d’accès URL de la requête HK. Pour déterminer si vous devez exclure votre module, configurez-le d’abord. Recherchez ensuite les requêtes HK dans le fichier journal d’accès de la passerelle indépendante. Vous devriez voir au moins un contrôle d’état une ou deux fois par minute. Si un code de réponse 200 est généré pour ces requêtes, l’authentification a sans doute réussi. En revanche, si un code de réponse 3xx est généré (redirection vers votre fournisseur d’authentification personnalisé), vous devez faire quelque chose pour y remédier. Solutions possibles : - Le bloc `` contient la directive `AuthType None`, et cela pourrait suffire. - La configuration httpd.conf de la passerelle indépendante contient la directive standard Apache httpd `[ProxyPreserveHost](https://httpd.apache.org/docs/2.4/mod/mod_proxy.html#proxypreservehost) On`. Si une circonstance inhabituelle exige que ce soit Off ou une autre valeur, cette valeur peut être définie avec l’élément de configuration TSM `gateway.tsig.proxypreservehost`. - Vous aurez peut-être besoin de directives spécifiques au module pour désactiver votre module d’authentification pour ``. Vous ne pouvez pas modifier directement ce bloc dans le fichier httpd.conf. Vous pouvez plutôt créer un autre bloc `` dans votre fichier `gateway.tsig.authn_global_block` et laisser Apache httpd les fusionner logiquement. Par exemple, certaines versions de mod\_auth\_mellon, un module d’authentification open source populaire, nécessitent `MellonEnable Off` pour les sections où il ne s’applique pas, même si`AuthType None` est défini dans ces sections. - Lors de la création d’une section `` supplémentaire, comme décrit dans le point précédent, vous trouverez que l’ordre d’apparition des différentes sections dans le fichier httpd.conf modifie la façon dont elles s’influencent mutuellement. La section standard `` apparaît avant la section standard ``. Si vos essais montrent qu’un ordre différent est nécessaire, vous devrez peut-être définir un autre section `` dans votre bloc `gateway.tsig.authn_global_block` en plus d’une autre section ``. Dans ce cas, vous devrez peut-être laisser le bloc `gateway.tsig.authn_location_block` vide. ## Dépanner la configuration du module d’authentification personnalisé Pour savoir comment la passerelle indépendante va créer le fichier httpd.conf, il suffit de définir les éléments de configuration TSM avec des valeurs qui pointent vers des fichiers vides qui figurent sur les ordinateurs de votre passerelle indépendante. (Les fichiers doivent exister, mais ils peuvent être vides.) Vous pouvez ensuite consulter le fichier httpd.conf de la passerelle indépendante pour vous faire une idée concrète de l’emplacement des directives `Include` des différents fichiers de configuration. Des problèmes de configuration dans le fichier httpd.conf de la passerelle indépendante peuvent empêcher le service `tsig-httpd` de démarrer. D’autres problèmes de configuration sont susceptibles d’empêcher la réception des mises à jour de configuration du service complémentaire de la passerelle indépendante sur le groupement Tableau Server. L’un des moyens de récupération, après avoir corrigé la cause du problème, est de copier `TSIG_DATA/config/httpd.conf.stub` dans `TSIG_DATA/config/httpd.conf` et de redémarrer ensuite le service `tsig-httpd`. Pour plus de conseils de dépannage, consultez [Dépannage de la passerelle indépendante Tableau Server](https://help.tableau.com/current/guides/enterprise-deployment/fr-ca/edg_part7.htm#troubleshooting-tableau-server-independent-gateway) dans le Guide de déploiement en entreprise (EDG). L’EDG fournit un exemple de déploiement de Tableau Server sous Linux. Les étapes de dépannage sont utiles pour les versions Windows ou Linux de Tableau Server.