# Connexion et accès

Configurez les fournisseurs de connexion et le courriel pour Oleafly Server, décidez qui peut entrer grâce aux règles d'accès, à l'inscription ouverte, aux rôles et aux invités, activez l'accès par navigateur, et gérez le serveur depuis la console d'administration.

Les personnes se connectent à Oleafly Server via des fournisseurs que vous configurez, si bien que le serveur ne manipule jamais de mots de passe. Les règles d'accès décident qui peut entrer. Les administrateurs gèrent le reste depuis la console d'administration dans Oleafly.

## Fournisseurs de connexion

Configurez au moins un fournisseur. Sans fournisseur, le serveur ne démarre pas, et son journal nomme les paramètres à ajouter. Le premier administrateur s'y connecte, car la [connexion par lien courriel](#sign-in-by-email-link) reste désactivée tant qu'un administrateur ne l'active pas. Chaque fournisseur renvoie les personnes vers une adresse de rappel sur votre serveur :

`https://collab.example.org/auth/callback/<provider>`

Si `OLEAFLY_PUBLIC_URL` contient un chemin, l'adresse de rappel en contient un aussi, par exemple `https://www.cs.example.edu/oleafly/auth/callback/github`.

### GitHub

1. Sur GitHub, sélectionnez votre photo de profil, puis **Settings › Developer settings › OAuth apps**, et sélectionnez **New OAuth App**. Pour une application appartenant à une organisation, utilisez plutôt **Developer settings** dans les paramètres de l'organisation.
2. Renseignez **Application name** (par exemple `Smith Lab Oleafly`), **Homepage URL** (`https://collab.example.org`) et **Authorization callback URL** (`https://collab.example.org/auth/callback/github`). Laissez **Enable Device Flow** désactivé.
3. Sélectionnez **Register application**. Copiez le **Client ID**, puis sélectionnez **Generate a new client secret** et copiez la clé secrète.
4. Définissez `OLEAFLY_GITHUB_CLIENT_ID` et `OLEAFLY_GITHUB_CLIENT_SECRET`, puis redémarrez le serveur.

Le serveur ne demande à GitHub que le profil et les adresses courriel de la personne (`read:user` et `user:email`). `OLEAFLY_GITHUB_LABEL` change le texte du bouton de connexion.

Pour GitHub Enterprise Server, enregistrez l'application là-bas et définissez aussi `OLEAFLY_GITHUB_URL` avec son adresse, par exemple `https://github.example.edu`. Ne définissez `OLEAFLY_GITHUB_API_URL` que si l'adresse de votre API est inhabituelle.

### OpenID Connect

OpenID Connect couvre GitLab, Google, Microsoft Entra ID, Keycloak, Authentik, Okta et la plupart des systèmes d'authentification unique des universités. Si votre université n'offre que le SAML, intercalez Keycloak ou Dex.

1. Choisissez un nom court composé de lettres et de chiffres, par exemple `GITLAB`. Il fait partie des noms de variables et, en minuscules, de l'adresse de rappel. Dans le `.env` de Compose, renommez les lignes `UNIVERSITY` ou ajoutez un second bloc.
2. Enregistrez une application auprès de votre fournisseur. Choisissez une application confidentielle ou web, définissez l'URI de redirection sur `https://collab.example.org/auth/callback/gitlab` et autorisez les scopes `openid`, `email` et `profile`.
3. Ajoutez les informations du fournisseur :

   ```ini
   OLEAFLY_OIDC_GITLAB_ISSUER=https://gitlab.com
   OLEAFLY_OIDC_GITLAB_CLIENT_ID=example-client-id
   OLEAFLY_OIDC_GITLAB_CLIENT_SECRET=example-client-secret
   OLEAFLY_OIDC_GITLAB_LABEL=GitLab
   ```

4. Redémarrez le serveur.

Le libellé est le texte du bouton de connexion, par exemple `University login`. L'émetteur est l'adresse sous laquelle le fournisseur publie `/.well-known/openid-configuration`. En voici quelques-uns courants :

| Fournisseur | Émetteur |
| --- | --- |
| GitLab.com | `https://gitlab.com` |
| GitLab auto-hébergé | L'adresse de votre GitLab, par exemple `https://gitlab.example.edu` |
| Google | `https://accounts.google.com` |
| Microsoft Entra ID | `https://login.microsoftonline.com/` suivi de l'identifiant de votre locataire et de `/v2.0` |
| Keycloak | `https://sso.example.edu/realms/` suivi du nom du realm |

### Adresses courriel vérifiées

Les entrées de la liste des personnes autorisées et les règles de domaine ne correspondent qu'aux adresses courriel vérifiées. Le serveur considère une adresse comme vérifiée uniquement quand le fournisseur le dit : GitHub la marque vérifiée, ou le claim OpenID Connect `email_verified` vaut `true`.

Certains fournisseurs institutionnels omettent ce claim. Si c'est le cas du vôtre, et s'il ne délivre que des adresses contrôlées par votre institution, définissez `OLEAFLY_OIDC_<NAME>_TRUST_EMAIL=true`. Ne le définissez jamais pour un fournisseur où l'on peut saisir n'importe quelle adresse courriel. N'importe qui pourrait alors se connecter sous l'identité d'une personne figurant sur votre liste des personnes autorisées.

### Certificats signés par votre université

Si votre université signe ses propres certificats, pour son proxy ou son service de connexion, le serveur doit faire confiance à cette autorité de certification. Chaque ordinateur qui exécute Oleafly aussi.

Sans Docker, ajoutez le certificat au système d'exploitation. Sur Debian et Ubuntu, copiez-le dans `/usr/local/share/ca-certificates/` avec un nom se terminant par `.crt` et exécutez `sudo update-ca-certificates`.

L'image Docker n'a pas de gestionnaire de paquets, donnez-lui donc une liste de certificats qui inclut le vôtre. À côté de `docker-compose.yml`, sur une machine Debian ou Ubuntu :

```sh
cat /etc/ssl/certs/ca-certificates.crt university-ca.pem > ca-bundle.pem
chmod 644 ca-bundle.pem
```

Ajoutez ensuite le fichier au serveur dans `docker-compose.override.yml` et relancez `docker compose up -d` :

```yaml
services:
  oleafly-server:
    volumes:
      - ./ca-bundle.pem:/etc/ssl/certs/ca-certificates.crt:ro
```

## Courriel

Le courriel est facultatif, et tout le reste fonctionne sans lui. Sans courriel, c'est vous qui envoyez vous-même l'adresse du serveur aux personnes, et Oleafly liste sous **Partagés avec vous** les projets partagés avec chacune.

Pour le configurer, donnez au serveur un compte SMTP :

```ini
OLEAFLY_SMTP_URL=smtps://oleafly%40example.org:example-app-password@smtp.example.org:465
OLEAFLY_MAIL_FROM=Smith Lab <oleafly@example.org>
```

Définissez les deux lignes ou aucune. Écrivez les caractères spéciaux du nom d'utilisateur et du mot de passe sous forme URL, par exemple `%40` pour `@`.

- `smtps://` utilise TLS dès le départ, sur le port 465 sauf si vous en indiquez un autre.
- `smtp://` utilise le port 587 sauf si vous en indiquez un autre, puis passe à TLS avec STARTTLS. Si le serveur de messagerie n'offre pas STARTTLS, le serveur n'envoie rien.
- Un relais de messagerie sur la même machine fait exception : `smtp://localhost`, `smtp://127.0.0.1` et `smtp://[::1]` envoient sans TLS.
- Un relais sur le même réseau privé peut se passer de TLS si vous ajoutez `?tls=none`, comme dans `smtp://mailpit:1025?tls=none`. L'adresse ne peut alors contenir ni nom d'utilisateur ni mot de passe, car ils traverseraient le réseau non chiffrés. Ne l'utilisez que lorsque personne d'autre ne peut atteindre ce réseau.

Le serveur vérifie le certificat du serveur de messagerie auprès des certificats de confiance du système.

### Ce que le serveur envoie

Il existe six sortes de courriels. Les courriels destinés à une personne qui a déjà un compte ne partent que vers ses adresses vérifiées, et les adresses noreply de GitHub sont toujours ignorées.

| Courriel | Quand il part |
| --- | --- |
| Ajout au serveur | Un administrateur ajoute quelqu'un à la liste des personnes autorisées par adresse courriel. Il contient le nom du serveur, un lien **Ajouter à Oleafly** et l'adresse du serveur. Ajouter quelqu'un par nom d'utilisateur GitHub ou via une règle de domaine n'envoie rien, car le serveur n'a pas encore son adresse. |
| Projet partagé | Le propriétaire d'un projet ajoute quelqu'un à un projet. Il contient le titre du projet, qui l'a partagé, le rôle de la personne et un lien qui ouvre le projet, plus la page web du projet pour le cas où le lien n'ouvre pas l'application. Un changement de rôle ultérieur n'envoie rien. Chacun peut les désactiver sur la carte du serveur dans **Paramètres → Collaboration**. |
| Nouvel appareil | Un compte se connecte sur un autre appareil. Il contient le nom de l'appareil, son système et l'heure dans le fuseau horaire du serveur, avec un rappel de déconnecter cet appareil si la personne n'est pas à l'origine de la connexion. Le premier appareil d'un nouveau compte ne reçoit pas de courriel. Définissez `TZ`, par exemple `TZ=Europe/Berlin`, pour choisir le fuseau horaire. |
| Invitation d'invité | Le propriétaire d'un projet invite un invité. Il contient le titre du projet, la personne qui a envoyé l'invitation, un lien **Ajouter à Oleafly** et l'adresse de connexion. Quand l'approbation est activée, il part une fois l'invitation approuvée. |
| Mention | Quelqu'un mentionne un membre dans un commentaire ou une réponse. Il indique qui a fait la mention, le projet et le fichier, le texte commenté et le commentaire, avec un lien qui ouvre le commentaire dans Oleafly. Il part environ une minute après l'arrivée du commentaire au serveur, et les mentions pour une même personne durant cette minute arrivent ensemble dans un seul courriel. Personne n'en reçoit pour ses propres commentaires ni pour un projet qu'elle ne peut pas ouvrir, et modifier un commentaire n'envoie jamais deux fois la même mention. Chacun peut les désactiver avec **M'envoyer un courriel quand quelqu'un me mentionne dans un commentaire** sur la carte du serveur dans **Paramètres → Collaboration**. |
| Lien de connexion | Quelqu'un en demande un sur la page de connexion du serveur. |

Avec **Notifications par courriel** dans les paramètres du serveur, les administrateurs peuvent arrêter toutes ces sorties de courriels, sauf les liens de connexion. Les liens de connexion partent toujours, car personne ne peut se connecter sans eux.

### Le tester

Dans la [console d'administration](#admin-console), ouvrez **Courriel**. Elle indique si le courriel est activé et l'adresse d'expédition, jamais le mot de passe. Un administrateur peut sélectionner **Envoyer un courriel de test** pour en envoyer un à sa propre adresse vérifiée. La page dit alors s'il est parti, ou ce que le serveur de messagerie a répondu.

Quand le courriel est désactivé, la page affiche le lien **Ajouter à Oleafly** et l'adresse du serveur, pour que vous puissiez les envoyer vous-même.

### Quand le serveur de messagerie est en panne

L'envoi ne bloque jamais l'action qui le déclenche. Le serveur garde les courriels dans une file en mémoire et réessaie après 30 secondes, 2 minutes, 10 minutes, 30 minutes et 2 heures. Chaque tentative échouée est un avertissement dans le journal du serveur, et la page **Courriel** affiche le dernier échec. Si la dernière tentative échoue aussi, le serveur consigne une erreur et abandonne ce courriel. Les courriels encore en attente au redémarrage du serveur sont perdus.

## Connexion par lien courriel

Les personnes peuvent aussi se connecter avec un lien que le serveur leur envoie par courriel, pour ne pas avoir besoin d'un compte GitHub ou OpenID Connect. Cela nécessite le [courriel](#email). Un administrateur active ensuite **Connexion par courriel** dans les paramètres du serveur. C'est désactivé par défaut.

La personne sélectionne **Continuer avec Courriel** dans Oleafly, saisit son adresse dans le navigateur et sélectionne **M'envoyer un lien par courriel**. Le lien fonctionne une seule fois, pendant 15 minutes, sur l'ordinateur qui l'a demandé. Ouvrir le lien affiche une page avec un bouton **Se connecter**. Sa simple ouverture n'utilise pas le lien, donc un analyseur de courriels qui suit les liens ne peut pas l'épuiser.

Vos règles d'accès décident toujours qui entre : une entrée de la liste des personnes autorisées pour cette adresse courriel, une règle de domaine ou une invitation d'invité. Une entrée par nom d'utilisateur GitHub ne correspond pas à un lien courriel. La page dit la même chose que le serveur accepte ou non l'adresse, donc personne ne peut s'en servir pour découvrir qui a un compte.

L'activer ouvre aussi les comptes existants aux liens courriel. Un lien connecte au compte qui possède déjà cette adresse comme adresse vérifiée. Le serveur conserve toutes les adresses vérifiées qu'un fournisseur a signalées pour un compte, pas seulement la principale, et il conserve une adresse même après que la personne l'a retirée auprès du fournisseur. GitHub, par exemple, signale toutes les adresses vérifiées du compte GitHub. Quiconque peut lire le courriel d'une de ces adresses peut donc se connecter à ce compte. Avant de l'activer, vérifiez que les personnes contrôlent encore toutes les adresses de leurs comptes.

Si une adresse appartient à plus d'un compte, le lien ne connecte à aucun d'eux. Si le seul compte possédant cette adresse est suspendu ou supprimé, le lien est refusé jusqu'à ce que vous laissiez cette personne revenir.

Le serveur envoie au plus 3 liens à une même adresse courriel et 100 liens à une même adresse IP en 15 minutes, donc une classe de 50 derrière une même adresse peut se connecter au complet. `OLEAFLY_EMAIL_LINKS_PER_ADDRESS` et `OLEAFLY_EMAIL_LINKS_PER_IP` changent ces nombres. Toutes les adresses IPv6 d'un même réseau `/64` comptent pour une seule adresse. Désactiver **Connexion par courriel** arrête les liens déjà envoyés.

## Se connecter avec un code

Quand le navigateur ne peut pas revenir vers Oleafly après une connexion, par exemple sur un ordinateur verrouillé, les personnes peuvent se connecter avec un code. Aucun paramètre n'est nécessaire et cela fonctionne avec toutes les options de connexion du serveur.

Oleafly affiche l'adresse de votre serveur suivie de `/auth/device` et d'un code de huit lettres. La personne ouvre cette adresse sur n'importe quel téléphone ou ordinateur, saisit le code, vérifie le nom d'ordinateur affiché par la page, puis se connecte. La connexion doit se terminer dans le navigateur où le code a été saisi, donc une page de connexion que quelqu'un d'autre envoie en lien ne connecte personne.

Un code fonctionne une seule fois, cesse de fonctionner après 10 minutes, et seule la copie d'Oleafly qui l'a demandé peut terminer la connexion. **Arrêter, ce n'était pas moi** l'annule. Une adresse IP peut demander 100 codes et saisir 10 codes erronés en 10 minutes. C'est suffisant pour une classe de 50 partageant une même adresse, et `OLEAFLY_DEVICE_CODES_PER_IP` change cette limite.

## Règles d'accès

Se connecter ne suffit pas pour entrer. Une règle d'accès doit laisser la personne entrer. Gérez-les sous **Règles d'accès** dans la console d'administration :

- **Personnes autorisées** : ajoutez une personne par adresse courriel, ou par nom d'utilisateur GitHub, avec le rôle qu'elle obtient. Les noms d'utilisateur ne fonctionnent que pour GitHub, car les autres fournisseurs laissent les personnes choisir ou changer le leur. Si le serveur envoie des courriels, ajouter quelqu'un par adresse courriel lui envoie l'adresse du serveur et un lien **Ajouter à Oleafly**.
- **Domaines** : laissez toutes les personnes ayant une adresse courriel vérifiée sur un domaine, comme `cs.example.edu`, se connecter avec le rôle de votre choix.

Une fois les personnes ajoutées, elles peuvent ajouter le serveur dans Oleafly et se connecter.

Sous **Personnes**, vous pouvez changer le rôle d'une personne, la suspendre ou la réactiver, la retirer et déconnecter ses appareils. Une personne suspendue garde son compte mais ne peut pas se synchroniser jusqu'à sa réactivation. Ses modifications restent sur son ordinateur.

Une personne retirée reste dehors, même si une règle de domaine couvre son adresse ou si un propriétaire de projet l'invite comme invité. Pour la laisser revenir, ajoutez-la de nouveau par adresse courriel ou par nom d'utilisateur. Elle retrouve son ancien compte, avec tous les projets qu'elle avait.

### Inscription ouverte

Pour un serveur que tout le monde peut utiliser, définissez `OLEAFLY_OPEN_SIGNUP=true` et redémarrez-le. Toute personne qui se connecte avec l'un de vos fournisseurs reçoit alors un compte avec le rôle Membre, sans entrée dans la liste des personnes autorisées ni règle de domaine. Avec **Connexion par courriel** activé, un lien courriel fonctionne de la même façon.

L'inscription ouverte tient toujours à l'écart les personnes que vous avez retirées ou suspendues, et toute personne dont l'adresse vérifiée appartient à un compte retiré. Quand les invités sont autorisés, une personne qui a une invitation d'invité et qui se connecte devient membre, et reçoit quand même les projets auxquels elle a été invitée.

Elle active aussi les [limites par compte](/docs/collaboration/server-operations/#limits-per-account) : sauf si vous définissez d'autres valeurs, chaque compte peut stocker 100 Mo, posséder 50 projets partagés et faire 300 téléversements par heure.

La console d'administration n'indique pas si l'inscription ouverte est activée. Le journal du serveur le dit à chaque démarrage : « Open sign-up is on, so anyone who signs in gets an account as a member. » Les membres peuvent se rechercher entre eux quand ils partagent un projet, donc sur un serveur ouvert, pensez à désactiver **Annuaire des membres** dans les paramètres du serveur.

## Rôles et permissions

Chaque personne possède un rôle sur le serveur, attribué par les administrateurs et les mainteneurs. Dans chaque projet auquel elle est ajoutée, elle possède aussi un rôle de projet, attribué par le propriétaire de ce projet. La page [Rôles](/docs/collaboration/sharing/#roles) liste les rôles de projet : Propriétaire, Éditeur, Relecteur, Commentateur et Lecteur.

Aucun rôle de serveur n'ouvre un projet à lui seul. L'accès à un projet ne vient que du propriétaire du projet.

| Action | Administrateur | Mainteneur | Membre | Invité |
| --- | --- | --- | --- | --- |
| Ajouter le serveur à Oleafly | Oui | Oui | Oui | Oui |
| Voir la liste des membres | Oui | Oui | Oui, sauf si un administrateur la masque | Non |
| Partager un projet | Oui | Oui | Oui | Non |
| Lire le journal de sécurité | Oui | Oui | Non | Non |
| Ajouter des membres au serveur | Oui | Oui | Non | Non |
| Nommer des mainteneurs | Oui | Non | Non | Non |
| Changer les paramètres du serveur | Oui | Non | Non | Non |
| Supprimer un projet pour libérer du stockage | Oui | Non | Non | Non |
| Déconnecter l'appareil de quelqu'un | Oui | Oui, mais pas ceux des autres administrateurs ou mainteneurs | Ses propres appareils uniquement | Ses propres appareils uniquement |
| Lire les projets stockés avec un accès direct au serveur | Pas depuis l'application | Pas depuis l'application | Pas depuis l'application | Pas depuis l'application |

La dernière ligne compte le plus. Les projets ne sont pas chiffrés sur le serveur, donc quiconque gère la machine peut lire chaque projet stocké, quel que soit son rôle. Oleafly ne donne à aucun rôle, administrateur compris, de moyen de le faire depuis l'application. Quand un administrateur supprime un projet pour libérer du stockage, son propriétaire et ses membres en sont informés, et leurs propres copies restent sur leurs ordinateurs.

## Invités

Un invité est une personne extérieure à votre serveur, comme un co-auteur d'une autre université, qu'un propriétaire de projet invite à un projet. Les invités ne voient que les projets auxquels ils sont invités.

### Activer les invités

Les invités sont désactivés sur un nouveau serveur. Un administrateur les active avec **Autoriser les invités** dans les paramètres du serveur. **Approuver d'abord les invités** est activé par défaut, donc un administrateur ou un mainteneur approuve chaque invitation avant qu'elle prenne effet. Désactivez-le pour que les invitations fonctionnent immédiatement. Quand un administrateur ou un mainteneur envoie une invitation, elle est approuvée d'emblée.

Si vous désactivez plus tard **Autoriser les invités**, les propriétaires ne peuvent plus envoyer d'invitations et les invitations inutilisées cessent de fonctionner. Les invités déjà connectés gardent leurs projets jusqu'à ce qu'un propriétaire les retire ou que vous les retiriez sous **Personnes**.

### Invitations

Seul le propriétaire d'un projet peut y inviter des invités, depuis la boîte de dialogue **Partager** du projet.

- Une invitation vaut pour une adresse et un projet, et elle expire après 14 jours.
- Une personne peut envoyer jusqu'à 20 invitations par heure.
- Quand l'approbation est activée, l'invitation attend sous **Invités en attente**, en haut de **Personnes**. Les administrateurs et mainteneurs l'approuvent, la refusent ou la retirent là. Le propriétaire peut aussi la retirer.
- Si le serveur envoie des courriels et que **Notifications par courriel** est activé, l'invité reçoit un courriel d'invitation. Sinon, Oleafly donne au propriétaire un lien **Ajouter à Oleafly** à envoyer lui-même.
- Si le projet compte déjà autant de personnes que le serveur le permet, l'invitation attend, et fonctionne à la connexion suivante de la personne après le départ de quelqu'un.

L'invité ajoute le serveur et se connecte avec toute option qui donne au serveur l'adresse invitée comme adresse vérifiée : GitHub, un fournisseur OpenID Connect ou un lien courriel. Une adresse non vérifiée ne compte pas. La première connexion crée un compte d'invité et ouvre tous les projets auxquels cette adresse a été invitée.

### Ce que les invités peuvent faire

Les invités peuvent ouvrir et compiler les projets auxquels ils ont été invités, les modifier si leur rôle le permet, et déconnecter leurs propres appareils. Ils ne peuvent pas voir l'annuaire des membres ni l'adresse courriel de quiconque, partager des projets, inviter d'autres personnes, ni rejoindre un projet par son lien. Pour donner un autre projet à un invité, le propriétaire de ce projet invite la même adresse.

Quand un invité est retiré de son dernier projet, ou le quitte, le serveur met fin à son accès. Il supprime le compte et déconnecte tous les appareils. Une nouvelle invitation ramène le même compte. Si vous retirez un invité sous **Personnes** alors qu'il a encore des projets, une nouvelle invitation ne le ramènera pas.

### Le retrait persiste

Quand un propriétaire retire quelqu'un d'un projet, invité ou non, cette personne ne peut pas revenir par le lien du projet, même avec le partage par lien activé. Chaque tentative apparaît dans le journal de sécurité. Pour la laisser revenir, le propriétaire l'ajoute de nouveau, ou envoie une nouvelle invitation s'il s'agit d'un invité. Une personne qui quitte un projet d'elle-même peut toujours le rejoindre par son lien.

## Accès par navigateur

Quand l'accès par navigateur est activé, les personnes peuvent ouvrir les projets partagés avec elles dans un navigateur web, sans installer Oleafly. Elles y modifient le texte, proposent des modifications, commentent, discutent dans le chat et lisent le PDF compilé le plus récent. La page [Travailler dans un navigateur](/docs/collaboration/browser/) décrit ce qu'elles voient.

Définissez `OLEAFLY_WEB=true` et redémarrez le serveur. L'image de conteneur publiée inclut l'application pour navigateur. Une version compilée sans elle écrit dans le journal « OLEAFLY_WEB is true, but this build of Oleafly Server has no browser app, so browser access stays off. »

Une fois l'accès activé :

- L'application pour navigateur se trouve à l'adresse de votre serveur suivie de `/web/`, par exemple `https://collab.example.org/web/`. La page de chaque projet sous `/p/` reçoit aussi un lien **Ouvrir dans le navigateur**.
- Les personnes se connectent sur `/web/sign-in` avec les mêmes fournisseurs et les mêmes liens courriel que dans Oleafly, et les mêmes règles d'accès décident qui entre. Un navigateur reste connecté pendant 30 jours.
- Chaque navigateur compte comme un appareil de ce compte, avec un nom comme « Safari on macOS ». Il apparaît dans la liste des appareils de la personne et dans le journal de sécurité, et le déconnecter met fin à la session de ce navigateur.
- Le navigateur se connecte à `/web/ws` par WebSocket et n'a pas de solution de repli plus lente, donc votre proxy doit laisser passer les mises à niveau WebSocket à cet endroit. Caddy et les exemples nginx et Apache de [Derrière un proxy inverse](/docs/collaboration/server-operations/#behind-a-reverse-proxy) le font déjà.
- Le PDF que les personnes lisent est le plus récent qu'un propriétaire ou un éditeur a compilé dans Oleafly. La section [PDF compilés](/docs/collaboration/server-operations/#compiled-pdfs) explique comment il arrive sur le serveur.

L'application pour navigateur ne peut pas s'afficher dans un cadre sur un autre site. Elle se connecte uniquement à votre serveur, sauf pour charger les avatars des personnes.

## Console d'administration

La console d'administration est une fenêtre pour gérer un serveur depuis Oleafly. Les administrateurs et mainteneurs peuvent l'ouvrir. Dans **Paramètres → Collaboration**, sélectionnez **Ouvrir la console d'administration** sur la carte du serveur, ou en haut de **Gérer le serveur**. Chaque serveur a sa propre fenêtre.

| Section | Ce qu'elle affiche et fait |
| --- | --- |
| **Vue d'ensemble** | L'état du serveur, son nombre de personnes, d'appareils et de projets, qui est en ligne, l'espace de stockage utilisé, ses options de courriel et de connexion, et ses paramètres en un coup d'œil. Elle avertit **Personne ne peut se connecter** quand le serveur n'a pas d'option de connexion, et **Le serveur ne peut pas enregistrer de fichiers** quand le dossier de données est inaccessible en écriture. |
| **Personnes** | Toutes les personnes qui se sont connectées. Changez les rôles, suspendez ou retirez des personnes, déconnectez leurs appareils. Les invitations d'invités en attente d'approbation sont en haut. |
| **Règles d'accès** | La liste des personnes autorisées et les règles de domaine. |
| **Projets** | Chaque projet partagé sur le serveur, avec son propriétaire, son nombre de personnes, sa taille et sa dernière activité. Recherchez par titre ou propriétaire, n'affichez que les projets partagés, archivés ou en cours d'envoi, et archivez ou restaurez un projet. |
| **Paramètres du serveur** | Les [paramètres du serveur](#server-settings). |
| **Courriel** | Si le courriel est configuré, l'adresse d'expédition et le dernier échec. Envoyez un courriel de test d'ici. |
| **Journal de sécurité** | Connexions et connexions refusées, appareils, personnes, paramètres, projets et invités. Chaque entrée indique qui l'a faite, quand et depuis quelle adresse IP, avec des détails comme le projet, l'option de connexion utilisée ou la raison d'un refus. |
| **Tests de connexion** | Les mêmes vérifications que **Tester la connexion**, exécutées de votre ordinateur vers le serveur. |

Les mainteneurs peuvent utiliser chaque section, mais ils ne peuvent nommer personne administrateur ou mainteneur, voir ou déconnecter les appareils d'un autre administrateur ou mainteneur, voir l'utilisation du stockage, archiver ou restaurer des projets, changer les paramètres du serveur ni envoyer un courriel de test. Les administrateurs peuvent tout faire.

Archiver un projet arrête son partage pour tout le monde. Les personnes cessent de le synchroniser et gardent leurs propres copies, et le serveur le supprime après `OLEAFLY_ARCHIVE_DAYS` jours, sauf si un administrateur le restaure avant. La restauration le partage de nouveau avec les mêmes personnes. Un projet qui n'a jamais terminé son premier envoi ne peut pas être restauré. Les deux apparaissent dans le journal de sécurité.

La console n'ouvre jamais un projet. Elle affiche des titres, des propriétaires et des tailles, et rien de leur contenu.

### Paramètres du serveur

Ils s'appliquent à toutes les personnes du serveur. Seuls les administrateurs peuvent les changer.

| Paramètre | Ce qu'il fait |
| --- | --- |
| **Autoriser les invités** | Les membres peuvent inviter des personnes extérieures au serveur sur les projets dont ils sont propriétaires. |
| **Approuver d'abord les invités** | Un mainteneur ou un administrateur approuve chaque invitation d'invité avant qu'elle prenne effet. |
| **Annuaire des membres** | Les membres peuvent se rechercher par nom quand ils partagent un projet. |
| **Afficher les adresses électroniques dans l'annuaire** | Les membres voient les adresses électroniques des autres quand ils recherchent quelqu'un. |
| **Autoriser le partage par lien** | Les propriétaires de projet peuvent permettre à n'importe quel membre d'ouvrir un projet depuis son lien. |
| **Autoriser les liens publics vers des notes** | Les membres peuvent publier une copie en lecture seule d'une note à un lien que n'importe qui peut ouvrir sans se connecter. C'est désactivé par défaut. Le désactiver coupe tous les liens publiés jusqu'à ce que vous le réactiviez. Voir [Publier une copie en lecture seule](/docs/notes/projects-and-sharing/#publish-a-read-only-copy). |
| **Autoriser les journaux d'accès aux projets** | Les propriétaires de projet peuvent conserver un journal des personnes qui ont ouvert leur projet. |
| **Autoriser les commentaires** | Les personnes des projets partagés peuvent commenter le texte et répondre. Désactivé, les commentaires sont masqués partout et restent enregistrés. |
| **Notifications par courriel** | Désactivez cette option pour arrêter les courriels du serveur pour tout le monde, sauf les liens de connexion. |
| **Connexion par courriel** | Les personnes peuvent se connecter avec un lien envoyé à leur adresse courriel. Cela nécessite les paramètres de courriel du serveur. |
