---
title: "Réserver une appli à l’entreprise : la doc de while.sh"
url: https://while.sh/fr/docs/briques/acces-interne/
updated: 2026-11-21
---

# Accès interne

Une appli réservée aux personnes de votre organisation, qui y entrent avec leur compte habituel. Votre appli reçoit leur identité, sans page de connexion à coder.

> Vous, à votre IA : Réserve l'appli aux personnes de l'entreprise.

## Ce que votre agent écrit

Votre agent l'écrit dans while.yaml, à la racine de votre appli :

```yaml titre="while.yaml"
apiVersion: while/v1
project: my-app
services:
  - name: web
    port: 3000
    access: internal
```

## Quand vous en servir

Servez-vous-en pour une appli destinée aux personnes de l'organisation : elles entrent avec leur compte, et rien n'est public sur Internet.

## Comment ça marche

Un service `access: internal` ne répond qu'après connexion, par un compte while ou par la connexion d'entreprise de l'organisation. L'appli reçoit l'identité de la personne, sans authentification à coder.

Qui y entre : les rôles sur l'appli ou sur l'organisation, qui comprennent tous Accès. Une personne sans compte dans l'organisation y entre par `invite_member` `{ email, role: "access", project }`, en une confirmation. Par la connexion d'entreprise, un groupe ou un domaine d'adresse y entre sans invitation, par `grant_role` { who, role: `access`, `scope: { project }` }. Chacun retrouve ses applis sur « Vos applis ».

## Ce qu'il faut savoir

La connexion d'entreprise passe par OpenID Connect (Keycloak, Google Workspace, Microsoft 365), avec les offres Pro et Entreprise. Un rôle sur un outil ne vaut que pour lui, et un domaine d'adresse (« @exemple.fr ») ne reçoit que le rôle Accès. Google Workspace ne transmet pas les groupes. Avec Google, on entre dans un outil réservé à quelques personnes par « Demander l'accès » : une personne connectée clique dessus, sur la page de l'outil. Un admin valide d'un clic, et l'accès n'a pas d'échéance. Un nouvel arrivant fait de même. Microsoft 365 et Keycloak peuvent transmettre les groupes (revendication groups) : `grant_role` sur un groupe y fait alors entrer les nouveaux arrivants, sans autre démarche.

L'appli reçoit `X-While-Identity`, un JWT ES256 signé par while. Ce jeton prouve qui est la personne. Pour décider, l'appli en vérifie la signature (clé publique à `WHILE_IDENTITY_JWKS_URL`), l'émetteur (`WHILE_IDENTITY_ISSUER`) et l'échéance. Elle compare aussi les champs `while_projet`, `while_service` et `while_environnement` à ses `WHILE_PROJECT`, `WHILE_SERVICE` et `WHILE_ENVIRONMENT`. L'adresse de la clé est dans le réseau de while : l'appli la joint même quand Internet lui est fermé. La personne est dans ces champs du jeton : sub (son identifiant), email, name et groups. Quand `groups_complete` vaut false, groups n'est qu'une partie des groupes de la personne : la liste entière se lit alors à `WHILE_IDENTITY_GROUPS_URL`, avec le jeton reçu (Authorization: While-Identity \<jeton>). `X-While-Email`, `X-While-Name` et `X-While-Groups` servent à l'affichage seulement.

L'IA d'une personne qui a un terminal ou un navigateur se sert de l'outil comme elle, pour une heure. `open_internal_app` (POST `/v1/projects/:slug/app-access`) lui donne un identifiant à poser dans l'en-tête Cookie (`__Host-while-agent`), jamais dans l'adresse. `read_only` le borne à la lecture, et l'appli le sait (`while_agent` dans `X-While-Identity`). Dans une conversation, la personne y va elle-même : `open_internal_app` lui en donne l'adresse.

Passer de public à interne est immédiat. Rendre publique une appli interne se fait valider par un développeur ; un admin le fait lui-même (son agent le lui fait confirmer) ; une règle de l'organisation peut l'assouplir. Un retour arrière ne change pas l'accès en vigueur.

while envoie deux requêtes sans `X-While-Identity` : sa sonde, sur le chemin de santé, et la lecture de l'icône (`/favicon.ico`, `/apple-touch-icon.png`), 20 secondes après chaque version en production. Elles ne comptent ni comme une ouverture ni comme une visite. Une icône servie sans connexion à ces chemins s'affiche sur « Vos applis ».

Quand une fonction est placée devant une connexion, l'outil transmet `X-While-Identity` dans ses appels à `<NOM>_URL` : la fonction sait ainsi qui se sert de l'outil. Les revendications gardées de la connexion d'entreprise (`claims`) ne sont jamais dans ce jeton, seule la fonction les reçoit ([Fonction devant une connexion](/fr/docs/briques/fonctions/)).

## Les outils MCP de votre agent

Votre agent s'en occupe avec les outils `plan_deploy`, `get_app_status` et `list_tokens`.

## Guides

- [Réserver un outil fait avec l'IA à vos collègues, avec Google Workspace ou Microsoft 365 (2026)](/fr/guides/outil-interne-compte-entreprise/)
- [Donner accès à un outil à un client avec un lien et un mot de passe, sans compte (2026)](/fr/guides/lien-avec-mot-de-passe/)
