---
title: Contrôles d'accès public
slug: docs/fr/iBwdJ1ZPVoGAq1NLQfD2H
description: Contrôlez l'accès public avec trois options différentes qui peuvent placer votre site de documentation derrière des mots de passe ou une méthode d'authentification JWT.
createdAt: 2020-11-19T17:32:03.000Z
---
Par défaut, un espace public n’a aucune méthode d’authentification, mais vous pouvez en choisir et en configurer quelques-unes :
- **Mot de passe global de l’espace**;
- [Comptes invités](docId\:rcEK0l-DvXdZG7NbnO9Pq), où vous créez manuellement des combinaisons email + mot de passe et les distribuez à vos utilisateurs ;
- [Liens magiques](docId\:rcEK0l-DvXdZG7NbnO9Pq), où vous saisissez des emails spécifiques ou des domaines entiers, et les utilisateurs s’authentifient à l’aide d’un lien que nous envoyons à leur adresse email ;
- [Comptes privés](docId\:rcEK0l-DvXdZG7NbnO9Pq), où vous ajoutez des domaines spécifiques pour permettre aux utilisateurs de s’authentifier/créer des comptes avec leur adresse email
- [Liens privés](docId\:rcEK0l-DvXdZG7NbnO9Pq), où vous pouvez générer des liens privés et les partager avec vos utilisateurs et équipes. Gérez le contrôle d’accès par groupe d’utilisateurs via ces liens ;
- [JWT](docId\:rcEK0l-DvXdZG7NbnO9Pq), où votre équipe de développement génère un JWT avec une clé secrète que vous fournissez dans notre UI, puis nous le renvoie dans le cadre d’un lien. C’est l’option la plus simple à gérer, mais elle nécessite du temps développeur.
- [SAML](docId\:rcEK0l-DvXdZG7NbnO9Pq), lorsque vous avez une application externe pouvant agir comme routeur vers votre domaine d’espace, de sorte que le portail public ne soit accessible qu’aux membres définis dans des fournisseurs comme Google, Azure, Okta.
***
# Aucun
Le comportement par défaut est défini sur Aucun, ce qui signifie qu’il est disponible publiquement. Vous pouvez modifier les contrôles pour limiter l’accès des lecteurs.
Toute personne disposant du lien pourra lire le contenu.
Les liens sont sûrs à partager parce qu’ils sont générés de manière cryptographique et impossibles à deviner.
Lorsque vous souhaitez restreindre le contenu à des lecteurs spécifiques, essayez l’une des options ci-dessous.
***
# Comptes invités
Créez des comptes invités. Toute personne disposant du lien et d’un compte invité pourra lire le contenu. Les comptes invités ne sont pas facturés comme des sièges dans Archbee.
***
# Comptes privés
Les utilisateurs pourront s’authentifier/créer un compte dans votre espace avec leur adresse email/mot de passe si vous ajoutez leur adresse email ou leur domaine email à la liste ci-dessous.
Toute personne disposant du lien et d’un compte correspondant pourra lire le contenu. Les comptes ne sont pas facturés comme des sièges dans Archbee.
:::hint{type="info"}
La liste des utilisateurs avec des comptes actifs apparaîtra dans la fenêtre « Comptes actifs ».
:::
***
# Lien magique
Les utilisateurs pourront s’authentifier dans votre espace avec leur adresse email si vous ajoutez leur adresse email ou leur domaine email à la liste ci-dessous.
Toute personne disposant du lien et d’un compte correspondant pourra lire le contenu. Les comptes ne sont pas facturés comme des sièges dans Archbee.
***
# Liens privés
Générez des liens privés pour des groupes d’utilisateurs/équipes spécifiques. Chaque groupe/équipe disposera de son propre lien vers la même documentation et vous pourrez gérer le contrôle d’accès via ces liens. Vous devez couper l’accès pour l’équipe 1 ? Supprimez le lien privé associé à l’équipe 1.
***
# Fonctionnement du JWT
## JWT - authentification des visiteurs avec secret
Accédez aux Spaces settings et définissez une clé secrète JWT que vous générez sur votre serveur
## Authentification des visiteurs via JSON WEB Key
Accédez aux Spaces settings et définissez une URL JSON WEB Key Set. Une URL JSON Web Key Set (JWKS) est un endpoint URL où un serveur publie ses clés publiques au format JSON.
L’URL JWKS pointe généralement vers un document JSON contenant un tableau de clés cryptographiques utilisées pour vérifier les signatures.
Lorsque Archbee reçoit un JWT, il peut récupérer la clé publique correspondante depuis l’URL JWKS et l’utiliser pour vérifier la signature du JWT, garantissant ainsi que le jeton n’a pas été altéré et qu’il a bien été émis par une partie de confiance.
Une URL JWKS fournit un moyen standardisé permettant aux clients d’obtenir les clés publiques nécessaires pour vérifier les signatures JWT de manière sécurisée et évolutive.
Voici un exemple de fichier `jwks.json` :
```json
{
"keys": [{
"kid": "1234example=",
"alg": "RS256",
"kty": "RSA",
"e": "AQAB",
"n": "1234567890",
"use": "sig"
}, {
"kid": "5678example=",
"alg": "RS256",
"kty": "RSA",
"e": "AQAB",
"n": "987654321",
"use": "sig"
}]
}
```
## Générer le jeton JWT
Utilisez l’un des exemples ci-dessous pour générer le jeton JWT.
Vous devez également remplacer l’URL par le sous-domaine de votre site de documentation.
```nodejs
const sign = require('jsonwebtoken').sign;
exports.buildArchbeeLoginURL = function() {
// Optional user credentials that you want to send back to Archbee
const user = {
name: 'John',
email: 'Wick',
};
//create a signed token out of the user credentials with the
//secret you set in Archbee
const jwtToken = sign(user, '');
//yourdomain is set in the Custom Domain tab
const archbeeUrl = 'https://yourdomain.com';
//create the complete URL containing the signed token that you'll send back to Archbee
return `${archbeeUrl}?jwt=${jwtToken}&reload`;
};
```
Voici un exemple pour générer un jeton JWT avec .NET : [https://github.com/dragosbulugean/archbee-jwt-dotnet](https://github.com/dragosbulugean/archbee-jwt-dotnet)
```javascript
using JWT;
using JWT.Algorithms;
using JWT.Serializers;
var payload = new Dictionary
{
{ "name", "John Wick" },
{ "email", "john.wick@matrix.com" }
};
const string secret = "TW9zaGVFcmV6UHJpdmF0ZUtleQ";
IJwtAlgorithm algorithm = new HMACSHA256Algorithm(); // symmetric
IJsonSerializer serializer = new JsonNetSerializer();
IBase64UrlEncoder urlEncoder = new JwtBase64UrlEncoder();
IJwtEncoder encoder = new JwtEncoder(algorithm, serializer, urlEncoder);
var jwtToken = encoder.Encode(payload, secret);
var archbeeLink = $"https://docs.yourcompany.com/?jwt={jwtToken}&reload";
Console.WriteLine($"JWT Token: {jwtToken}");
Console.WriteLine($"Archbee Link: {archbeeLink}");
```
:::hint{type="info"}
Les jetons JWT sont ignorés sur Preview/Staging
:::
***
# SAML - Security Assertion Markup Language
SAML peut être configuré pour l’accès public à un espace de la même manière que pour l’intégration d’équipe, voir [Intégration SAML](docId\:nzQeTgTrUXT0n6o_lOWZi) pour obtenir des étapes plus détaillées sur la configuration de chaque fournisseur.
Notez que seule l’URL des métadonnées est nécessaire comme entrée. Nous supposons également que l’espace est déjà hébergé sur un domaine personnalisé.
De cette façon, le lien de l’espace publié sera routé via la nouvelle application SAML ; ainsi, seuls les membres configurés dans l’application du fournisseur peuvent accéder au portail public.
### Comment configurer SAML comme contrôle d’accès public
::::WorkflowBlock
:::WorkflowBlockItem
Accédez à Azure Services -> Microsoft Entra ID -> "+Add" -> App registration
Sélectionnez "Comptes dans ce répertoire organisationnel uniquement - Locataire unique" et collez l’URL CallBack depuis Archbee Space Settings -> Public Access Control -> SAML dans "Redirect URI" comme dans l’image ci-dessous, en choisissant Web auth :
::Image[]{src="https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/3UT5owvW3hIctm8WvFS5p_image.png" size="50" width="1746" height="1304" position="center" showCaption="false"}
:::
:::WorkflowBlockItem
Cliquez sur "Register"
:::
:::WorkflowBlockItem
Sur l’application nouvellement créée dans Azure, accédez à "Endpoints" et copiez le "Federation metadata document" depuis l’application Azure vers Archbee Space Settings -> Public Access Control -> SAML dans "Set SAML Metadata URL"
::Image[]{src="https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/tmIsl_WC_b8Gg53we8F7w_image.png" size="60" width="2272" height="1216" position="center" showCaption="false"}
:::
:::WorkflowBlockItem
Un Entity ID unique sera généré dans Archbee, copiez le lien "[api://PUBLISHED](#)..." dans votre application Azure - Exposer une API -> Ajouter -> Renseignez l’URL -> Enregistrez
::Image[]{src="https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/1MpmJaW_2e-NQvI7TOKxd_image.png" size="34" width="782" height="1388" position="center" showCaption="false"}
:::
:::WorkflowBlockItem
Accédez à votre espace Archbee et republiez-le
:::
:::WorkflowBlockItem
Essayez d’accéder au lien et testez l’authentification SAML
:::
::::
# Paramètres d’aperçu
:::hint{type="warning"}
Cette fonctionnalité vous permet de simuler les paramètres d’authentification dans un environnement d’aperçu contrôlé avant de les rendre actifs pour les utilisateurs internes.
:::
## Objectif
Activez ce paramètre pour appliquer `une protection par authentification à votre environnement d’aperçu`, en restreignant l’accès aux `utilisateurs internes uniquement`. Cela aide à vérifier vos configurations d’authentification, les flux d’accès utilisateur et les paramètres de protection `sans exposer les changements au public`.
## Comment activer
- Accédez à la section Public Access Control lorsque vous êtes dans Space Settings
- Sélectionnez les méthodes d’authentification souhaitées
- Désactivez le paramètre `Paramètres d’aperçu`
- Publiez vos modifications dans l’aperçu et testez l’authentification
# Multi-authentification
La fonctionnalité Multi-authentification vous permet d’activer plus d’une méthode d’authentification pour accéder à votre portail de documentation. Cela offre davantage de flexibilité à vos utilisateurs et améliore l’accessibilité.
## Fonctionnement
:::hint{type="success"}
Depuis les paramètres Public Access Control, vous pouvez activer simultanément plusieurs méthodes d’authentification. Les utilisateurs accédant à votre portail pourront s’authentifier en utilisant l’une des méthodes activées.
:::
## Exemple de cas d’usage
Si vous activez à la fois **Lien privé** et **Mot de passe**, les utilisateurs peuvent accéder à votre documentation en utilisant soit :
- Un lien privé sécurisé que vous partagez avec eux
- Ou un mot de passe commun que vous définissez
:::hint{type="warning"}
Seuls les utilisateurs répondant à l’une des méthodes d’authentification activées se verront accorder l’accès. Vous pouvez désactiver n’importe quelle méthode à tout moment via l’interrupteur dans les paramètres Public Access Control.
:::