Ajouter la fonctionnalité de connexion à votre application Apache

Ce tutoriel explique comment configurer Apache afin d’ajouter l’authentification et l’autorisation à votre application web.

Utilisez l’IA pour intégrer Auth0

Si vous utilisez un assistant de codage IA comme Claude Code, Cursor ou GitHub Copilot, vous pouvez ajouter automatiquement l’authentification Auth0 en quelques minutes à l’aide d’Agent Skills.

Installer :

npx skills add auth0/agent-skills --skill auth0

Demandez ensuite à votre assistant IA :

Add Auth0 authentication to my Apache server

Votre assistant IA créera automatiquement votre application Auth0, récupérera les identifiants et configurera mod_auth_openidc. Documentation complète sur Agent Skills →

Configuration système requise

Ce tutoriel et cet exemple de projet ont été testés avec les éléments suivants :

• Apache 2.4

​

Pour commencer

Ce tutoriel explique comment configurer Apache pour ajouter l’authentification et l’autorisation à votre application web. Nous vous recommandons de vous connecter pour suivre ce Quickstart avec des exemples configurés pour votre compte.

1. Installer et activer le module mod_auth_openidc

   Commencez par installer le module mod_auth_openidc pour Apache.

   Vous pouvez télécharger les binaires depuis GitHub et les installer sur votre système d’exploitation. Si votre système d’exploitation n’est compatible avec aucun de ces binaires, vous pouvez quand même le compiler à partir du code source.

   Une fois le module installé, activez-le dans Apache avec la commande a2enmod. Pour en savoir plus, consultez a2enmod on Ubuntu Manpage :

   a2enmod auth_openidc
   

   Sous Windows, vous pouvez utiliser ce script PowerShell pour faire fonctionner a2enmod sur votre système.

2. Configurer le module avec les informations de votre compte Auth0

   Mettez à jour votre nouveau fichier de configuration (auth_openidc.conf), situé dans le dossier /etc/apache2/mods-available.

   Sous Windows, vous devez utiliser le fichier /apache/conf/httpd.conf.

3. Configurer Auth0

   Dans le Auth0 Dashboard :

   1. Accédez à Applications > Applications, puis sélectionnez votre application dans la liste.
   2. Passez à la vue Settings, puis repérez la section Application URIs.
   3. Ajoutez la valeur de OIDCRedirectURI à Allowed Callback URLs.
   4. Repérez Advanced Settings au bas de la page.
   5. Passez à la vue OAuth.
   6. Définissez JSON Web Token (JWT) Signature Algorithm sur RS256.
4. Autorisation

   Vous pouvez configurer Apache pour protéger un emplacement précis selon la valeur d’un claim dans l’ID token de l’utilisateur en ajoutant un bloc Location à votre fichier auth_openidc.conf.

   Par exemple, vous pourriez créer une Action qui lit les rôles de l’utilisateur, puis ajoute un claim qui donne accès à un emplacement protégé :

   exports.onExecutePostLogin = async (event, api) => {
     const roles = event.authorization.roles; // ['user', 'admin']
     if (roles.includes('admin')) {
       api.idToken.setCustomClaim('folder', 'admin');
     }
   };
   

Point de contrôle

Excellent travail ! Si vous vous êtes rendu jusque-là, la connexion, la déconnexion et les renseignements du profil utilisateur devraient maintenant fonctionner dans votre application.

---

​

Prochaines étapes

Ceci conclut notre guide Quickstart, mais il reste encore beaucoup à découvrir. Pour en savoir plus sur ce que vous pouvez faire avec Auth0, consultez :

• Auth0 Dashboard - Découvrez comment configurer et gérer votre tenant Auth0 et vos applications
• Auth0 Marketplace - Découvrez les intégrations que vous pouvez activer pour étendre les fonctionnalités d’Auth0