Aller au contenu

Aller au sommaire de la doc

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.

Mis à jour le 21 novembre 2026.

Voir en Markdown

Accès interne réservé aux collègues : on badge avec son compte d’entreprise Google ou Microsoft et l’appli s’ouvre, 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 :

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).

Les outils MCP de votre agent

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

Guides

Donnez la phrase à votre IA, elle s’occupe du reste

À donner à votre IA

Lis while.sh/agents et aide-moi à démarrer avec while.

Copier la phrase

En 3 minutes, sans inscription, l’outil a son adresse. Pour le garder, créez votre compte.

Pour un projet d’entreprise, écrivez à l’équipe de while : hello@while.sh