Sign up for an{" "}
Auth0 account
{" "}
or{" "}
console.log("log in")}>
log in
{" "}
to your existing account to integrate directly with your own tenant.
;
};
export const sections = [{
id: "configuration-d-auth0",
title: "Configuration d’Auth0"
}, {
id: "installer-la-trousse-sdk-express-openid-connect",
title: "Installer la trousse SDK Express OpenID Connect"
}, {
id: "afficher-le-profil-utilisateur",
title: "Afficher le profil utilisateur"
}];
Auth0 vous permet d’ajouter rapidement l’authentification à presque tous les types d’application. Ce guide explique comment intégrer Auth0, ajouter la connexion utilisateur, la déconnexion et un profil à une application Node.js Express en utilisant la trousse SDK Express OpenID Connect.
Pour utiliser les services Auth0, vous devez avoir une application installée dans Auth0 Dashboard. L’application Auth0 est l’endroit où vous allez configurer le fonctionnement de l’authentification pour le projet que vous développez.
### Configurer une application
Utilisez le sélecteur interactif pour créer une nouvelle application Auth0 ou sélectionner une application existante qui représente le projet avec lequel vous souhaitez effectuer l’intégration. Dans Auth0, chaque application se voit attribuer un identifiant client unique alphanumérique que votre code d’application utilisera pour appeler les API Auth0 via la trousse SDK.
Tous les paramètres que vous configurez à l’aide de ce guide de démarrage rapide seront automatiquement mis à jour pour votre application dans le [Tableau de bord](https://manage.auth0.com/#/), qui est l’endroit où vous pourrez gérer vos applications à l’avenir.
Si vous préférez explorer une configuration complète, consultez plutôt un exemple d’application.
### Configurer les URL de rappel
Une URL de rappel est une URL intégrée dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur authentification. Si elle n’est pas définie, les utilisateurs ne seront pas redirigés vers votre application après s’être connectés.
Si vous suivez notre exemple de projet, définissez cette URL comme suit : `http://localhost:3000``/callback`.
### Configuration des URL de déconnexion
Une URL de déconnexion est une URL intégrée dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur déconnexion. Si elle n’est pas définie, les utilisateurs ne pourront pas se déconnecter de votre application et recevront un message d’erreur.
Si vous suivez notre exemple de projet, définissez cette URL comme suit : `http://localhost:3000/logout`.
Votre application aura besoin du package [`express-openid-connect`](https://github.com/auth0/express-openid-connect), qui est une trousse SDK conforme à l’OIDC maintenue par Auth0 pour Express.
Installez la trousse SDK Express OpenID Connect en exécutant les commandes suivantes dans votre terminal :
```
cd
npm install express-openid-connect
```
### Configurer le routeur
La bibliothèque Express OpenID Connect fournit le routeur `auth` afin de joindre des routes d’authentification à votre application. Vous devez configurer le routeur avec les clés de configuration suivantes :
* `authRequired` - Vérifie si l’authentification est requise pour toutes les routes.
* `auth0Logout` - Utilise la fonctionnalité de déconnexion d’Auth0.
* `baseURL` - L’URL où l’application est hébergée.
* `secret` - Une chaîne longue et aléatoire.
* `issuerBaseURL` - Le domaine sous forme d’URL sécurisée trouvé dans vos [Paramètres d’application](https://manage.auth0.com/#/applications/%7ByourClientId%7D/settings).
* `clientID` - L’ID client trouvé dans vos [Paramètres d’application](https://manage.auth0.com/#/applications/%7ByourClientId%7D/settings).
Pour des options de configuration supplémentaires, consultez la [documentation API](https://auth0.github.io/express-openid-connect).
Vous pouvez générer une chaîne appropriée pour`LONG\_RANDOM\_STRING` en utilisant `openssl rand -hex 32` dans la ligne de commande.
##### Point de contrôle
Un utilisateur peut désormais se connecter à votre application en visitant la route `/login` fournie par la bibliothèque. Si vous exécutez votre projet sur `localhost:3000`, ce lien sera [`http://localhost:3000/login`](http://localhost:3000/login).
Pour afficher le profil utilisateur, votre application doit fournir une route protégée.
Ajoutez le logiciel médiateur `requiresAuth` pour les routes qui nécessitent une authentification. Toute route utilisant ce logiciel médiateur vérifiera s’il existe une session utilisateur valide et, si ce n’est pas le cas, redirigera l’utilisateur vers la page de connexion.
##### Point de contrôle
Un utilisateur peut se déconnecter de votre application en visitant la route `/logout` fournie par la bibliothèque. Si vous exécutez votre projet sur `localhost:3000`, ce lien sera [`http://localhost:3000/logout`](http://localhost:3000/logout).
## Étapes suivantes
Beau travail! Si vous en êtes arrivé là, vous devriez avoir la connexion, la déconnexion et les informations de profil utilisateur actives dans votre application.
Cela conclut notre tutoriel de démarrage rapide, mais il y a tellement plus à explorer. Pour en savoir plus sur ce que vous pouvez faire avec Auth0, consultez :
* [Auth0 Dashboard](https://manage.auth0.com/#) : apprenez à configurer et gérer votre locataire et vos applications Auth0
* [Trousse SDK express-openid-connect](https://github.com/auth0/express-openid-connect) : explorez en détail la trousse SDK utilisée dans ce tutoriel
* [Auth0 Marketplace](https://marketplace.auth0.com/) : découvrez des intégrations que vous pouvez activer pour étendre les fonctionnalités d’Auth0
```js server.js highlight={2-16} lines theme={null}
const express = require('express');
const { auth, requiresAuth } = require('express-openid-connect');
const app = express();
const config = {
authRequired: false,
auth0Logout: true,
baseURL: 'http://localhost:3000',
clientID: '{yourClientId}',
issuerBaseURL: 'https://{yourDomain}',
secret: 'LONG_RANDOM_STRING'
};
// The `auth` router attaches /login, /logout
// and /callback routes to the baseURL
app.use(auth(config));
// req.oidc.isAuthenticated is provided from the auth router
app.get('/', (req, res) => {
res.send(
req.oidc.isAuthenticated() ? 'Logged in' : 'Logged out'
)
});
// The /profile route will show the user profile as JSON
app.get('/profile', requiresAuth(), (req, res) => {
res.send(JSON.stringify(req.oidc.user, null, 2));
});
app.listen(3000, function() {
console.log('Listening on http://localhost:3000');
});
```
```js server.js highlight={25-28} lines theme={null}
const express = require('express');
const { auth, requiresAuth } = require('express-openid-connect');
const app = express();
const config = {
authRequired: false,
auth0Logout: true,
baseURL: 'http://localhost:3000',
clientID: '{yourClientId}',
issuerBaseURL: 'https://{yourDomain}',
secret: 'LONG_RANDOM_STRING'
};
// The `auth` router attaches /login, /logout
// and /callback routes to the baseURL
app.use(auth(config));
// req.oidc.isAuthenticated is provided from the auth router
app.get('/', (req, res) => {
res.send(
req.oidc.isAuthenticated() ? 'Logged in' : 'Logged out'
)
});
// The /profile route will show the user profile as JSON
app.get('/profile', requiresAuth(), (req, res) => {
res.send(JSON.stringify(req.oidc.user, null, 2));
});
app.listen(3000, function() {
console.log('Listening on http://localhost:3000');
});
```
Sign up for an{" "}
Auth0 account
{" "}
or{" "}
console.log("log in")}>
log in
{" "}
to your existing account to integrate directly with your own tenant.