Documentation › Configurer la plateforme
Configurer la plateforme (première installation)
Une plateforme SerenForce neuve n’a aucune base de données. La première fois que vous ouvrez l’application, la page Set up SerenForce (/app/setup) vous guide : la page enregistre l’application de connexion Microsoft et nomme le premier administrateur. La base du catalogue est créée et tenue à jour par l’application elle-même, à son démarrage.
Avant de commencer
- Le catalogue est la base qui connaît tous les tenants, leurs abonnements et les super administrateurs. Chaque étape de cette installation y est écrite : vous pouvez vous arrêter à n’importe quelle étape et reprendre plus tard, depuis n’importe quel navigateur, et la page montre toujours ce qui est fait et la suite.
- Sa chaîne de connexion est le seul paramètre du déploiement dont vous avez besoin : un secret,
PLATFORM_CATALOG_CONNECTION_STRINGdans la bibliothèqueback-prodd’Azure DevOps. Il n’y a aucune étape pour créer la base : à chaque démarrage, l’application crée la base si elle n’existe pas encore, met ses tables à jour et ajoute les permissions et le rôle de super administrateur. Tant que ce n’est pas fait, la page dit seulement ce qui manque (la chaîne n’est pas dans les paramètres, ou la base est inaccessible : l’application réessaie toutes les 30 secondes, vérifiez la chaîne de connexion et que le serveur laisse entrer l’application, puis appuyez sur Check again). - Le catalogue fonctionne sur SQL Server (par défaut) ou sur PostgreSQL : le paramètre
PLATFORM_CATALOG_DATABASE_ENGINEdeback-prod(SqlServerouPostgreSql) le dit, et la chaîne de connexion est écrite pour ce moteur (pour PostgreSQL :Host=…;Database=…;Username=…;Password=…). La page d’attente affiche le moteur sous son message, et le résumé de la dernière étape l’affiche sous Catalog database. Les tenants que vous inscrivez ensuite choisissent aussi leur Database engine (SQL Server ou PostgreSQL) ; une base On the same server as the catalog prend le moteur du catalogue (la liste Database engine n’est alors pas affichée), et Create it on Azure (Bicep file or deployment) n’est proposé que pour SQL Server. - Sur Azure SQL, l’application crée le catalogue en base Standard S0 (la taille comprise dans le compte gratuit Azure, environ 13 EUR par mois ensuite), jamais en General Purpose. Son nom par défaut est
sqldb-sf-catalog-prod, et la base d’un tenant sur le même serveur est proposée sous le nomsqldb-sf-<identifiant>-prod. Une base qui existe déjà garde son nom et sa taille. - À l’étape Database de l’inscription d’un tenant, la liste How do you get the database? propose trois façons d’avoir la base :
- On the same server as the catalog (par défaut) : seul le nom de la base est demandé ; elle est créée sur le serveur du catalogue, avec le même compte, quel que soit l’endroit où se trouve ce serveur (Azure, un autre cloud, un serveur de l’entreprise). Le nom de la base du catalogue lui-même est refusé.
- Use an existing database : seule la Connection string de la base est demandée.
- Create a new database : le formulaire complet (Where is it hosted?, puis sur Azure How is it created? : fichier Bicep ou chaîne de connexion ; fichier Terraform pour AWS et Google Cloud).
- Ouvrez l’adresse de l’application peu après le déploiement : tant que la plateforme n’est pas installée, vous arrivez sur la page d’installation. Les premières étapes n’exigent aucun mot de passe (personne ne peut encore se connecter) : elles sont limitées en débit et refusées dès que la plateforme est installée ; ne laissez donc pas un déploiement neuf sans surveillance. Une fois installée, la page indique simplement The platform is already set up.
- Chaque champ affiche un exemple grisé et une explication. Chaque étape crée sa propre ressource avec son propre bouton (Register the application, Save the email service, Save the cache, Save the logs destination) : quand c’est fait, la page remonte en haut et affiche un message de succès vert sous le titre de l’étape, et une coche verte apparaît dans l’étape et dans la barre latérale. C’est aussi le cas quand vous gardez Memory (each instance has its own) ou No cache pour le cache, ou No service pour les journaux : ces choix comptent comme une étape faite. Next et Back ne font que passer d’une étape à l’autre et ne créent rien : vous pouvez ignorer une étape facultative.
1. Authentification (Microsoft Entra ID : enregistrement et connexion)
Dès que vous appuyez sur Enregistrer l’application, un message vert au-dessus des boutons Précédent et Suivant confirme l’enregistrement : cliquez sur Suivant pour continuer.
La plateforme fait se connecter les utilisateurs avec une seule application Microsoft Entra ID, partagée par l’installation et l’administration (chaque tenant a ensuite la sienne). L’installation l’enregistre pour vous, avant que quiconque se connecte.
- Qui enregistre l : Créer maintenant, avec un accès à Azure (par défaut), ou Générer un script et reprendre ici une fois exécuté si vous préférez ne pas donner à l’application un accès à Azure (voir Enregistrer l’application avec un script ci-dessous).
- S’authentifier pour créer l’App registration Azure (seulement quand cette page enregistre l’application) : l’identité de l’API ou un principal de service. Elle doit avoir la permission Microsoft Graph Application.ReadWrite.All (ou le rôle Application Administrator). Pour cette requête seulement, jamais conservée.
- Me connecter avec mon compte Azure (choix de S’authentifier pour créer l’App registration Azure) : à utiliser si l’enregistrement échoue avec « Privilèges insuffisants ». Cliquez sur Se connecter à Azure, ouvrez la page Microsoft indiquée, saisissez le code affiché et connectez-vous avec un compte Administrateur d’application ou Administrateur général ; la page le détecte, puis vous enregistrez l’application avec ce compte. Rien n’est conservé.
- Obtenir un jeton Azure (choix de S’authentifier pour créer l’App registration Azure) : à utiliser si votre organisation refuse la connexion avec un code (par exemple « erreur 530035 », appareil non inscrit). Obtenez un jeton là où vous pouvez vous connecter, comme l’Azure Cloud Shell du portail, avec
az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv(le bouton Copy the command à côté la copie en un clic : « Copier la commande »), et collez-le dans Jeton d’accès. Le jeton dure environ une heure et n’est jamais conservé. - Application name : le nom affiché dans Entra ID et sur la page de connexion Microsoft, proposé selon la convention sp-<produit>-<catalogue>-<environnement>, par exemple sp-sf-catalog-prod (l’environnement suit l’adresse web : local, dev, test, staging… ou prod). Vous pouvez le modifier.
- Web address of the application : l’adresse où vos utilisateurs ouvrent SerenForce, sans
/app, par exemple https://www.serenforce.com. Après la connexion, Microsoft ne les renvoie que vers cette adresse (https, ou http://localhost en développement). - Allow personal Microsoft accounts : choisissez maintenant, cela change l’enregistrement de l’application. Si activé, les comptes Outlook, Hotmail et Live pourront se connecter à un tenant qui les accueille, où chacun travaille dans une organisation (l’audience de connexion devient comptes professionnels, scolaires et personnels). L’administration reste réservée aux comptes de votre annuaire, même avec cet interrupteur : voir Un compte personnel comme super administrateur.
- Secret lifetime : la durée de validité du secret client que SerenForce crée avec l’application (1, 3, 6, 12, 18 ou 24 mois ; 12 mois par défaut). La date d’expiration d’un secret créé aujourd’hui s’affiche dessous. Le script utilise la même durée. Voir Secrets clients et alertes.
- AI assistant addresses (facultatif) : les adresses où un assistant IA installé sur l’ordinateur d’une personne (comme Claude Code) revient après la connexion, une par ligne, par exemple http://localhost/callback. Laissé vide, l’application n’accepte aucun assistant. Sont acceptées les adresses https://, http:// de la machine locale seulement (localhost, 127.0.0.1, [::1]) et celles d’une application de bureau (monapp://callback), sans #. Chaque organisation a ses propres adresses, saisies à son inscription. Le bouton (i) à côté du champ explique pourquoi il existe, quoi saisir et comment connecter ensuite l’assistant (exemple de commande pour Claude Code). Voir Connecter un assistant IA.
- Permissions given to the application (Autorisations données à l’application en français) : la liste des scopes que reçoit l’application, à quoi sert chacun et comment le consentement est donné. Lisez-la avant d’enregistrer l’application, et ajoutez les mêmes scopes si vous l’enregistrez vous-même. Voir Autorisations des applications.
Appuyez sur Register the application (ou Use this application si vous l’avez enregistrée vous-même) : l’application est enregistrée (une seule fois) et l’étape reçoit sa coche verte. Appuyez ensuite sur Next pour passer à l’étape Email (puis aux étapes Cache et Journaux) ; Back revient à l’étape précédente en gardant votre saisie. À l’étape Journaux, appuyez sur Finish the setup (possible seulement quand l’application est enregistrée) : l’installation est terminée. La page affiche alors un résumé de ce qui a été enregistré et un lien vers ce guide ; appuyez sur Se connecter à l’administration et connectez-vous avec cette application.
Enregistrer l’application avec un script
Avec Générer un script et reprendre ici une fois exécuté, vous enregistrez vous-même la même application, une fois le script exécuté. Remplissez d’abord le nom, l’adresse web et le choix sur les comptes personnels : le script décrit exactement cette application.
- Téléchargez le script
Choisissez le Script format (Bicep, modèle ARM (JSON) ou Terraform), puis appuyez sur Download the script.
- Exécutez-le
Avec un compte qui a le rôle Administrateur d’application (ou la permission Application.ReadWrite.All) dans votre annuaire, après
az login. Bicep (0.36 ou plus récent) et modèle ARM :az group create --name serenforce-setup --location westeurope, puisaz deployment group create --resource-group serenforce-setup --template-file serenforce-entra.bicep(ouserenforce-entra.json), puis exécutez la commande donnée par la sortie identifierUriCommand. Terraform :terraform init, puisterraform applydans le dossier deserenforce-entra.tf. - Notez les identifiants qu’il donne, puis saisissez-les
Notez-les : SerenForce en a besoin. Saisissez Application (client) ID : la sortie clientId (client_id avec Terraform). Directory (tenant) ID : la sortie directoryTenantId (directory_tenant_id). Appuyez sur Use this application : l’étape reçoit sa coche verte ; continuez avec Next et terminez à l’étape Journaux.
Vérifiez bien les deux identifiants : l’installation n’enregistre l’application qu’une seule fois.
Google Cloud ou AWS à la place de Microsoft Entra ID
Si votre organisation se connecte avec Google ou avec Amazon Cognito, choisissez la plateforme dans Cloud platform (Google Cloud (Google sign-in) ou Amazon Web Services (Cognito)). SerenForce ne peut pas enregistrer l’application chez ces fournisseurs à votre place : vous la créez vous-même dans la console du fournisseur, puis vous donnez deux informations à l’installation.
- Sur Google Cloud : créez un client OAuth de type Application Web et ajoutez les adresses listées sous les champs comme URI de redirection autorisés. L’Authority (address of the issuer) est toujours https://accounts.google.com.
- Sur AWS : créez un client d’application dans votre groupe d’utilisateurs Amazon Cognito (page de connexion hébergée, octroi implicite) et ajoutez les adresses listées sous les champs comme URL de rappel. L’Authority (address of the issuer) est l’adresse du groupe d’utilisateurs, par exemple https://cognito-idp.eu-west-1.amazonaws.com/eu-west-1_AbCdEf123.
- Saisissez le Client id de l’application, puis appuyez sur Use this application, continuez avec Next et terminez à l’étape Journaux avec Finish the setup. Aucun accès à Azure n’est nécessaire, et le choix des comptes personnels Microsoft ne s’applique pas.
Quand l’adresse web de l’application commence par www. (https://www.serenforce.com), la liste donne aussi les mêmes adresses sans www. (https://serenforce.com/app/admin/callback) : le site répond aux deux, enregistrez-les toutes. Le fichier Terraform d’Amazon Cognito les contient déjà. Avec Microsoft Entra ID, l’installation enregistre les deux toute seule.
Les personnes se connectent avec leur compte Google ou Cognito, avec l’adresse email qui s’y trouve. Le premier tenant, et chaque tenant inscrit ensuite, peuvent aussi choisir Cloud platform à l’étape Authentication : la base de données et le stockage de fichiers d’un tenant qui se connecte avec Google ou AWS ne sont jamais préparés dans Azure.
Où le tenant garde ses fichiers
À l’étape File storage de l’inscription, Storage provider propose quatre choix. On-premise : un dossier du serveur de SerenForce. Azure : un conteneur Azure Blob Storage (adresse du compte, nom du conteneur, et nom et clé du compte si vous ne passez pas par la connexion Azure) ou un partage Azure file storage. AWS : un bucket Amazon S3 ; donnez l’adresse de la région du bucket (par exemple https://s3.eu-west-3.amazonaws.com), le nom du bucket, l’Access key ID et la Secret access key d’un utilisateur IAM autorisé à lire, écrire et supprimer dans ce bucket. Google Cloud : un bucket Google Cloud Storage ; l’adresse est déjà remplie, donnez le nom du bucket et une clé HMAC d’un compte de service (console Google Cloud, paramètres de Cloud Storage, onglet Interopérabilité) : HMAC access ID et HMAC secret. Un bucket qui n’existe pas est créé à la fin de l’inscription ; vous pouvez aussi le créer ou le tester tout de suite avec Create the bucket now et Test the storage. Rien n’est préparé dans Azure pour un bucket. La clé secrète n’est jamais gardée dans l’inscription en cours : après un rechargement, saisissez-la de nouveau. Un tenant qui se connecte avec Google ou AWS peut garder ses fichiers dans Azure Blob Storage seulement avec le nom et la clé du compte. Le stockage d’un tenant inscrit se change dans l’onglet Storage de sa fiche (y compris Google Cloud Storage) ; les fichiers déjà enregistrés ne sont pas déplacés.
Avec Azure et Azure Blob Storage, choisissez d’abord le Storage account. Create a new storage account on Azure : décrivez le compte, puis téléchargez le fichier Bicep ou déployez-le tout de suite ; son conteneur est créé avec lui. Use a storage account that already exists : sous Find an existing storage account, donnez l’abonnement, connectez-vous à Azure puis appuyez sur Find the existing ones ; le compte choisi avec Use this storage account remplit son adresse et son nom (vous pouvez aussi les saisir). Choisissez ensuite le Container : Create a new container for this tenant (ses fichiers restent séparés, bouton Create the container now) ou Use a container that already exists in this storage account : appuyez sur List the containers et choisissez-le dans Existing container. L’abonnement, la façon de se connecter à Azure et le conteneur choisi sont gardés dans l’inscription en cours ; les secrets (clé du compte, secret client, jeton) ne le sont jamais.
Fichiers Terraform pour AWS et Google Cloud
Quand vous choisissez AWS ou Google Cloud, SerenForce donne le fichier Terraform qui y crée ce qu’il faut, comme il donne un fichier Bicep pour Azure : appuyez sur Télécharger le fichier Terraform sous Le créer sur Amazon Web Services avec Terraform (ou sur Google Cloud). SerenForce ne crée rien lui-même dans ces clouds. Lancez terraform init puis terraform apply avec un compte du cloud (sur Google Cloud, ajoutez -var="project_id=<votre projet>") ; les mots de passe et les clés sont créés par Terraform et se lisent avec terraform output -raw <nom>, ils ne sont jamais dans le fichier.
- Authentification avec Amazon Web Services (Cognito) (installation et inscription) : le groupe d’utilisateurs, ses pages de connexion et le client avec les adresses indiquées. Saisissez les sorties client_id et authority dans les champs de l’identifiant client et de l’autorité. Google ne permet pas de créer son client OAuth par un fichier : créez-le dans la console Google Cloud comme expliqué plus haut.
- Journaux avec Amazon CloudWatch ou Google Cloud Logging (installation, inscription, pages Journaux) : où arrivent les journaux, les traces et les métriques, et la clé du collecteur. La sortie collector_config est la configuration du collecteur OpenTelemetry ; saisissez l’adresse de ce collecteur dans l’étape.
- Base de données d’un tenant, Où est-ce hébergé ? = Amazon Web Services ou Google Cloud : un serveur SQL Server Express ou PostgreSQL (Amazon RDS, Cloud SQL) que seules les adresses données (allowed_cidr, l’adresse sortante de l’API) peuvent joindre. Collez la sortie connection_string dans Chaîne de connexion, puis créez la base.
- Stockage de fichiers d’un tenant sur AWS ou Google Cloud : le bucket privé et la clé qui l’atteint. Les sorties donnent l’adresse, le bucket, la clé d’accès et le secret à saisir dans l’étape.
2. Emails de la plateforme (facultatif)
SerenForce envoie lui-même quelques emails : les invitations des personnes d’un nouveau tenant et la confirmation d’une inscription. Ce ne sont pas les emails des étapes de process (ceux-là partent de la boîte aux lettres de la personne qui exécute l’étape). La deuxième étape de l’installation, Email, choisit le service qui les envoie ; laissez Decide later si vous n’êtes pas prêt, et choisissez-le plus tard sur la page Email de l’administration, où vous pouvez aussi le tester à tout moment. Cette page propose les mêmes étapes guidées pour Microsoft 365 (créer l’application sp-sf-catalog-email-prod maintenant, télécharger son script ou utiliser une application qui existe) ; appuyez ensuite sur Save.
- Sending service : Microsoft 365 (les emails partent d’une boîte aux lettres de votre entreprise, comme noreply@votresociete.com) ou Resend. Tant que vous n’en choisissez pas, la clé et l’expéditeur Resend des paramètres du déploiement sont utilisés, s’il y en a.
- Avec Microsoft 365, l’écran vous guide en trois étapes numérotées : Connect to Azure (choisissez New or existing application, connectez-vous à Azure puis appuyez sur Create the application : SerenForce l’enregistre, accorde l’autorisation et remplit l’étape suivante pour vous), Mailbox and credentials (vérifiez-les et saisissez la boîte aux lettres expéditrice) puis Check that it works (envoyez-vous un email de test). Si vous préférez tout faire à la main, voici les étapes. SerenForce se connecte comme une application Microsoft Entra ID et envoie depuis la boîte aux lettres que vous indiquez. À faire une fois, dans le portail Azure : enregistrez une application (Inscriptions d’applications › Nouvelle inscription) ; dans Autorisations d’API, ajoutez Microsoft Graph › Autorisations de l’application › Mail.Send puis Accorder le consentement administrateur ; dans Certificats et secrets, créez un secret client et copiez sa valeur tout de suite. Cette application n’est pas celle de la connexion : créez-en une autre.
- Laissez SerenForce créer cette application. Sous les champs, Create the application that sends the emails : avec Create it now, with access to Azure, choisissez comment SerenForce se connecte à Azure (les mêmes choix qu’à la première étape) et appuyez sur Create the application : l’application reçoit l’autorisation Mail.Send, un secret client valable un an, et ses identifiants remplissent les champs. Si un administrateur doit encore accorder l’autorisation, un administrateur général le fait dans le portail (Autorisations d’API › Accorder le consentement administrateur). Avec Generate a script and type its results here, téléchargez un fichier Bicep, un modèle ARM ou un fichier Terraform, exécutez-le, puis saisissez vous-même les identifiants et le secret (Bicep et ARM donnent la commande qui crée le secret ; Terraform le donne en sortie). Ou choisissez Use an application that exists : Find the existing ones liste les applications de votre annuaire qui peuvent envoyer du courrier, vous en choisissez une et SerenForce lui ajoute un nouveau secret (le secret d’une application existante ne peut pas être lu) et remplit les champs. Rien n’est gardé tant que vous n’appuyez pas sur Save the email service.
- Saisissez ensuite : Sender mailbox (l’adresse seule, sans nom), Directory (tenant) (l’ID ou le domaine de votre annuaire), Application (client) ID et Client secret. Le secret est conservé dans le catalogue et n’est plus jamais affiché : sur la page Email, laissez le champ vide pour le conserver.
- Limitez ce que l’application peut faire. Mail.Send de type application lui permet d’envoyer depuis n’importe quelle boîte de votre annuaire. Demandez à votre administrateur Exchange une stratégie d’accès aux applications (
New-ApplicationAccessPolicy, ou RBAC pour les applications) qui la restreint à cette seule boîte. - Avec Resend : Sender est une adresse d’un domaine vérifié dans Resend (avec ou sans nom, comme SerenForce <hello@votresociete.com>) et Resend API key la clé créée dans Resend.
- Test recipient et Send a test email envoient un message avec les réglages saisis, sans les enregistrer, et indiquent ce que le service a répondu quand il refuse (mauvais secret, consentement manquant, boîte inconnue…).
Un tenant peut avoir son propre service : à l’étape Email de son inscription, Emails about this tenant le choisit (par exemple le Microsoft 365 de son entreprise). Avec Decide later, le service de la plateforme les envoie. Vous pouvez le choisir ou le changer plus tard dans l’onglet Email de la page du tenant. Aux deux endroits, Microsoft 365 propose les mêmes trois étapes qu’ici : créer l’application maintenant avec un accès à Azure, télécharger son script (Bicep, ARM ou Terraform) ou utiliser une application qui existe ; l’application proposée s’appelle sp-sf-<tenant>-email-prod. Dans l’onglet, appuyez sur Save the email service pour garder le résultat.
3. Cache de la plateforme (facultatif)
Le catalogue lit le tenant de chaque requête. Un cache le garde quelques minutes au lieu de relire la base à chaque fois. Cette étape est facultative : Memory (each instance has its own) est le choix par défaut et suffit avec une seule instance.
- Memory (each instance has its own) : rien à installer. Chaque instance de l’application garde ce qu’elle a lu dans sa propre mémoire.
- Redis (shared by all the instances) : à utiliser quand l’application tourne sur plusieurs instances. Ce qu’une instance a lu, les autres le trouvent, et la mémoire de chaque instance reste devant le Redis. Choisissez Where does the Redis run? : A Redis server (your own), Azure Cache for Redis, Amazon ElastiCache (Redis OSS or Valkey) ou Google Cloud Memorystore for Redis ; ce choix ne change que l’exemple et l’aide sous Redis connection, tous s’utilisent de la même façon. Saisissez la connexion (adresse et port, puis options séparées par des virgules, par exemple password=… et ssl=True quand le serveur utilise TLS) et appuyez sur Test the connection : SerenForce écrit puis lit une valeur dans le serveur et dit ce qu’il a répondu. L’application doit pouvoir joindre le serveur (pare-feu, réseau privé). La connexion, mot de passe compris, est gardée dans le catalogue.
- No cache : rien n’est gardé, chaque requête lit la base. Plus lent, mais il n’y a rien à tenir à jour.
- Avec Azure Cache for Redis, Use an Azure Cache for Redis that exists demande l’abonnement et un accès Azure qui peut lister les clés du cache (Contributeur), liste les caches trouvés et remplit Redis connection et Access key (optional) avec celui que vous choisissez.
La connexion, mot de passe compris, est gardée dans le catalogue ; Access key (optional) contient la clé quand elle n’est pas déjà dans la connexion (password=…). Un tenant a sa propre étape Cache dans son inscription, avec les mêmes choix.
4. Journaux (facultatif)
Par défaut, les journaux de l’application restent dans sa console et ses fichiers. Cette étape les envoie au service de supervision que vous utilisez, par OpenTelemetry. Elle est facultative : laissez No service si vous n’êtes pas prêt.
Le service de la plateforme reçoit aussi les traces (chaque requête à laquelle l’application répond, avec les appels et les requêtes de base de données qu’elle a faits, et la durée de chacun) et les métriques (nombre de requêtes, temps de réponse, erreurs, mémoire). Elles disent ce qui a été lent ou a échoué, et les journaux écrits pendant une requête sont reliés à sa trace. Une requête d’un tenant porte l’identifiant du tenant : vous pouvez filtrer par tenant. Les traces et les métriques vont seulement au service de la plateforme, jamais à celui d’un tenant.
- Azure Application Insights : collez la chaîne de connexion de la ressource (InstrumentationKey=…;IngestionEndpoint=…) ; aucune clé n’est nécessaire. Ou laissez SerenForce la créer : Create Application Insights demande l’abonnement (déjà rempli avec celui où tourne SerenForce quand il tourne dans Azure), le groupe de ressources, la région et un nom, crée la ressource et sa ressource Log Analytics avec l’accès Azure que vous choisissez (les mêmes choix qu’à la première étape) et remplit la chaîne de connexion ; Use one that exists liste les Application Insights d’un abonnement (l’accès n’a besoin que du rôle Lecteur) et remplit la chaîne de connexion avec celui que vous choisissez ; Download the Bicep file donne les mêmes ressources à créer vous-même, la chaîne de connexion étant une sortie du fichier. Les champs Azure group of the Application Insights et Application Insights resource (facultatifs) sont remplis quand vous la créez ou choisissez une ressource existante ; vous pouvez aussi les saisir, et ils réapparaissent quand vous revenez sur cette étape.
- Datadog, Grafana (Loki), Dynatrace, SigNoz, Sentry : saisissez l’adresse OTLP du service (l’adresse de base, sans /v1/logs) et sa clé ou son jeton (Key or token) : la clé d’API de Datadog, ID d’instance:jeton sur Grafana Cloud, le jeton d’API Dynatrace avec les portées logs.ingest, openTelemetryTrace.ingest et metrics.ingest, la clé d’ingestion SigNoz, la clé publique du DSN Sentry. Un Loki ou un SigNoz que vous hébergez n’a pas besoin de clé.
- Amazon CloudWatch, Google Cloud Logging, Loggly, Exceptionless : ces services ne prennent pas OpenTelemetry directement (AWS exige des appels signés, Google une identité Google, les autres ont leur propre API). Lancez un collecteur OpenTelemetry qui leur transmet les journaux (l’AWS Distro for OpenTelemetry sur AWS, un collecteur avec l’exporteur Google sur Google Cloud) et saisissez son adresse OTLP, en général http://collecteur:4318. An OpenTelemetry Collector est le même choix pour tout autre point d’entrée OTLP.
- Service name (facultatif) : le nom que portent les journaux dans le service ; serenforce-api par défaut.
- Test the destination envoie une requête vide et dit si le service a répondu ou refusé la clé. Rien n’est enregistré.
La clé est gardée dans le catalogue et jamais réaffichée. Un tenant a sa propre étape Logs dans son inscription, avec les mêmes choix : ses journaux vont alors à son propre service, et sans lui ils vont là où vont ceux de la plateforme. Dès qu’un service est choisi, l’étape propose des noms tirés de l’identifiant du tenant : Service name serenforce-<tenant>-api-prod et, pour Application Insights, Application Insights name appi-sf-<tenant>-prod. Ils suivent l’identifiant tant que vous ne les changez pas ; un nom saisi est gardé.
L’inscription d’un tenant est gardée au fur et à mesure, sauf ses secrets (mots de passe, clés, secrets client, jetons Azure), qui ne sont jamais enregistrés : les étapes concernées le rappellent. Si vous actualisez ou quittez la page, saisissez-les de nouveau ; l’étape redevient verte sans nouveau test.
5. IA (facultatif)
L’assistant intégré et les hooks en mode IA utilisent un fournisseur d’IA et un de ses modèles. Cette étape choisit ceux de la plateforme et leur clé API. Elle est facultative : Decide later n’enregistre rien, et chaque tenant apporte alors sa propre clé.
- Choose a provider and a model : choisissez AI provider (Anthropic (Claude) ou Google (Gemini)), puis Model parmi les modèles proposés, et collez la clé dans API key. Appuyez sur Save the AI.
- La clé est gardée dans le coffre de secrets de la plateforme et n’est jamais réaffichée : l’étape dit seulement qu’une clé est enregistrée. Laissez le champ vide pour la garder ; si vous changez de fournisseur, saisissez la clé du nouveau.
- Aucune clé n’est à mettre dans les bibliothèques Azure DevOps : tout se règle ici, puis dans l’administration.
Un tenant a sa propre étape AI dans son inscription : Use the AI of the catalog (par défaut) reprend le fournisseur, le modèle et la clé choisis ici ; sinon il choisit son fournisseur et son modèle, et API key used : The key of the catalog (possible seulement si la plateforme a une clé pour ce fournisseur) ou Its own key (bring your own key), saisie une fois et jamais gardée dans l’inscription en cours.
6. Licence du catalogue (obligatoire)
SerenForce envoie une clé de licence pour chaque catalogue (elle commence par PN1.). Elle est émise pour cette installation seulement : l’étape Licence affiche d’abord l’Identifiant de l’installation, que vous copiez avec son bouton et envoyez à SerenForce pour recevoir la clé. Une clé émise pour une autre installation (par exemple celle de votre catalogue de production collée dans un catalogue de test) est refusée, et le message rappelle l’identifiant à envoyer. À l’étape Licence, collez-la dans Clé de licence et appuyez sur Enregistrer la licence. La page affiche alors ce que donne la licence : son type, le client, la période et son identifiant.
- SaaS : ni places ni fin. Une organisation que ses membres créent eux-mêmes paie ses places avec son propre abonnement ; l’organisation d’un tenant que vous inscrivez vous-même dans l’administration a toutes les fonctionnalités, sans offre à choisir ni limite de membres.
- Entreprise : un nombre de places d’utilisateurs pour une période (par exemple un an), payées directement à SerenForce. Chaque organisation du catalogue qui n’a pas d’abonnement à elle utilise ces places. La ligne Services en plus (IA) dit si l’IA est comprise : comprise, l’entreprise l’utilise avec sa propre clé IA ; non comprise, elle lui est refusée.
Une clé est refusée, avec la raison, si elle n’a pas été émise par SerenForce, si elle a été modifiée, si elle a été émise pour une autre installation, si elle est terminée, ou si c’est une clé émise pour un tenant avant novembre 2026 (ces clés ne servent plus). Jusqu’à la fin de l’installation, vous pouvez coller une autre clé dans Une autre clé de licence (remplace celle ci-dessus). La clé elle-même n’est jamais gardée dans l’installation en cours : seulement ce qu’elle donne. Les organisations inscrites ensuite n’ont pas de licence à elles.
Renouveler ou remplacer la licence
Après l’installation, la carte Licence du catalogue du tableau de bord de l’administration affiche la licence et l’Identifiant de l’installation à donner à SerenForce pour chaque nouvelle clé, et prévient quand une licence Entreprise se termine dans les 30 jours. Collez la nouvelle clé que SerenForce vous envoie dans Nouvelle clé de licence et appuyez sur Remplacer la licence : la nouvelle licence remplace l’ancienne tout de suite.
7. Chiffrement (facultatif)
SerenForce chiffre tous les secrets qu’il garde, avec une clé par organisation. Cette étape vient après la licence ; votre propre clé n’y demande aucune licence (SaaS comme Entreprise). À l’étape Chiffrement, répondez aux questions une par une : Avec la clé racine de l’installation (la page Statut affiche un avertissement) ou Avec une clé dans un coffre ; puis le coffre (Azure Key Vault ou Google Cloud KMS, AWS KMS arrive bientôt ; Google Cloud KMS se choisit avec un script ou une clé existante, et le compte de service affiché doit recevoir les rôles « Cloud KMS CryptoKey Encrypter/Decrypter » et « Cloud KMS Viewer » sur la clé) ; un nouveau coffre ou un coffre existant, que vous trouvez dans une liste après Se connecter à Azure ; dans un coffre existant, une nouvelle clé ou une clé existante ; enfin, pour ce qui est nouveau, SerenForce le crée maintenant ou vous exécutez un script (Bicep, ARM ou Terraform). Le bouton Vérifier la clé contrôle que tout fonctionne. Détails : Chiffrement et votre propre clé.
8. Se connecter à l’administration
Finish the setup n’est possible que quand toutes les étapes sont faites : l’application enregistrée, le service d’email enregistré (ou Use the email service of the deployment), le cache enregistré, les journaux enregistrés (No service est un choix qu’on enregistre aussi), l’IA enregistrée (ou Decide later) et la licence du catalogue enregistrée. La page liste les étapes qui restent à faire. Dès que vous appuyez sur Finish the setup, la plateforme est installée : chaque instance de l’application le constate en quelques secondes, et rien n’est à copier ailleurs (le catalogue contient tout). La page affiche un résumé (nom, adresse, identifiants, comptes personnels) et un lien vers ce guide ; appuyez sur Se connecter à l’administration et connectez-vous avec l’application qui vient d’être enregistrée.
La première personne qui se connecte à l’administration devient le super administrateur de la plateforme : connectez-vous donc tout de suite avec un compte professionnel ou scolaire de votre annuaire. Ensuite, personne d’autre ne devient super administrateur en se connectant. Pour être sûr de choisir le bon compte, la connexion demande toujours quel compte utiliser après l’installation, même si vous êtes déjà connecté à Microsoft avec un autre compte.
Un compte personnel comme super administrateur
L’administration n’accepte que les comptes de l’annuaire où son application est enregistrée. Un compte Microsoft personnel (Outlook, Hotmail, Live) qui se connecte directement est refusé, même si Allow personal Microsoft accounts est activé : cet interrupteur ouvre seulement les tenants aux comptes personnels. L’administration, qui contrôle tous les tenants, leurs bases et leurs secrets, reste ainsi derrière votre annuaire.
- Invitez le compte dans votre annuaire
Dans le portail Azure, Microsoft Entra ID › Utilisateurs › Nouvel utilisateur › Inviter un utilisateur externe : saisissez l’email du compte personnel. La personne accepte l’invitation depuis l’email qu’elle reçoit.
- Faites-en un super administrateur
Si personne ne s’est encore connecté à l’administration, l’invité peut se connecter le premier et devient le super administrateur. Sinon, un super administrateur ajoute la personne sur la page Utilisateurs de l’administration (Nouvel utilisateur, avec l’email du compte personnel et le rôle SuperAdmin).
- Connectez-vous
La personne se connecte à l’administration avec son compte personnel : Microsoft la laisse entrer comme invitée de votre annuaire.
Après l’installation
- Ouvrez l’administration
Quand vous appuyez sur Se connecter à l’administration sur la page de résumé, Microsoft vous demande de vous connecter avec l’application qui vient d’être enregistrée.
- Inscrivez le premier tenant
Aucun tenant n’est créé automatiquement : sur le tableau de bord, appuyez sur Inscrire un nouveau tenant. L’assistant vous demande d’abord l’organisation (Organization type : entreprise, gouvernementale, à but non lucratif, académique ou autre ; Organization name ; Allowed email domain, facultatif et limité à un seul domaine pour le moment, par exemple teqten.com ; laissez-le vide pour autoriser tous les domaines), puis l’identifiant et le nom du tenant avec ses administrateurs (au moins un), sa base de données, son stockage de fichiers, son authentification, son service d’email, son IA (voir IA) et ses administrateurs. Pour la base et le compte de stockage, vous choisissez le fournisseur, la région, la taille et les noms, puis téléchargez ou déployez le fichier Bicep, comme ici. Un compte de stockage créé ainsi laisse SerenForce atteindre lui-même les fichiers du tenant, sans clé de compte : la personne qui le crée doit avoir le rôle Owner, User Access Administrator ou Role Based Access Control Administrator sur le groupe de ressources. Azure peut mettre quelques minutes à appliquer cet accès ; d’ici là, la création du tenant attend, puis le signale s’il n’est toujours pas là : réessayez un peu plus tard. L’identifiant et l’application de connexion choisis à l’installation sont déjà remplis. Vous pouvez fermer l’assistant à tout moment : l’inscription est conservée (sauf les mots de passe et secrets) et apparaît dans la liste de la page Tenants avec le statut Draft et l’étape où vous vous êtes arrêté. Appuyez sur Continue pour reprendre à l’étape où vous vous étiez arrêté, ou sur Discard pour l’abandonner (la base, les fichiers et l’application déjà créés ne sont pas supprimés). À l’étape Authentication, l’application Microsoft Entra ID du tenant se choisit comme à l’installation : vous saisissez celle qui existe, Register the application in Microsoft Entra ID for me (avec l’identité de l’application, un principal de service ou votre propre compte Azure), ou vous téléchargez un script (Bicep, ARM, Terraform ou Azure CLI) et vous saisissez les identifiants qu’il donne. Le réglage Le Nom de l’application est proposé selon la convention sp-sf-<tenant>-<environnement> et se modifie dans sa zone de saisie. Allow personal Microsoft accounts se choisit tenant par tenant, avant l’enregistrement : il change l’application. Les Advanced settings restent disponibles pour une application saisie à la main. Secret lifetime fonctionne comme à l’installation : quand SerenForce enregistre l’application, il crée son secret client et le renseigne avec sa Secret expiry date. Si vous saisissez un secret vous-même, saisissez aussi sa Secret expiry date.
- Choisissez les administrateurs du tenant
La première étape, sous le nom du tenant, vous fait inviter les personnes du tenant et choisir le rôle de chacune (Administrator, User ou Viewer). Au moins une doit être administrateur. Vous pouvez vous inviter vous-même avec Add myself. Chaque personne reçoit un email avec le lien pour se connecter au tenant, et reçoit le rôle choisi dès sa première connexion avec cette adresse email. Si un email ne part pas (service d’envoi non configuré ou refusé : voir Emails de la plateforme), le tenant est quand même créé et l’écran vous indique les personnes à prévenir vous-même.
- Aucune licence pour le tenant
L’inscription ne demande aucune clé de licence : la licence est celle du catalogue (voir Licence du catalogue), et l’étape Authentification est suivie de l’étape Email. Sur un catalogue SaaS, chaque organisation paie ses places avec son abonnement ; sur un catalogue Entreprise, elle utilise les places de la licence. Pour un tenant Partagé entre plusieurs organisations, vous (le super administrateur qui l’inscrit) êtes invité comme un de ses administrateurs.
- Invitez les autres utilisateurs
Ils ouvrent l’adresse de l’application et saisissent leur email. Avec un compte personnel (si vous les avez autorisés), ils entrent dans une organisation du tenant : par invitation, par demande d’adhésion, ou en souscrivant un abonnement Team pour une nouvelle organisation. L’offre Team s’inscrit sur le premier tenant activé qui est Partagé entre plusieurs organisations et accueille les comptes personnels ; sans lui, la page d’abonnement indique que l’inscription n’est pas encore ouverte. Pour qu’un tenant existant le devienne, ouvrez-le depuis la page Tenants, activez Partagé entre plusieurs organisations et Accueillir les comptes Microsoft personnels, puis appuyez sur Enregistrer les modifications. Quand vous activez Partagé entre plusieurs organisations, un avertissement rappelle que les personnes des autres organisations se connectent avec leur propre annuaire : avant d’enregistrer, ouvrez-leur l’application de connexion du tenant dans Microsoft Entra ID (Inscriptions d’applications > Authentification, Types de comptes pris en charge réglé sur Comptes dans un annuaire organisationnel (multilocataire)), sinon Microsoft refuse leur connexion.
Inviter à nouveau une personne dans un tenant
Un lien d’invitation peut expirer, se perdre ou être ouvert par la mauvaise personne. Sur la page du tenant, ouvrez l’onglet Invitations (dans le menu ⋮ au bout des onglets s’il ne tient pas sur la ligne), saisissez l’Email of the person, choisissez son Role (Administrator, User ou Viewer, User par défaut) puis appuyez sur Send the invitation. La personne reçoit un nouvel email d’invitation. Sur un tenant ouvert à tous les annuaires (ou partagé entre plusieurs organisations), cet email contient un nouveau lien personnel, valable une seule fois pendant 7 jours, et le lien envoyé avant ne fonctionne plus ; la personne qui l’ouvre reçoit le rôle choisi ici, qui remplace celui de l’invitation précédente tant que personne ne l’a utilisée. Si l’email ne part pas, l’écran le dit : l’invitation est quand même enregistrée, vérifiez le service d’envoi (voir Emails de la plateforme) puis envoyez-la à nouveau. Vous pouvez aussi inviter ainsi une nouvelle personne.
Fuseau horaire d’un tenant
Les dates que SerenForce écrit lui-même (fin d’un lien d’invitation, renouvellement des jetons du mois, fin d’un secret client, date de suppression des données d’une organisation, nom des instances lancées par une routine) sont données dans le fuseau horaire de chaque personne : celui de son navigateur, noté chaque fois qu’elle ouvre l’application. Un email nomme toujours le fuseau, par exemple 18 novembre 2026 à 10:00 (Europe/Paris). Pour les personnes qui n’ont pas encore ouvert l’application, SerenForce prend le fuseau du tenant : celui de votre navigateur quand vous l’avez inscrit. Changez-le dans l’onglet General de la page du tenant, champ Time zone, puis Save changes ; None (UTC) écrit ces dates en UTC.
Journal d’audit d’un tenant
SerenForce garde, pour chaque tenant, ce qu’ont fait ses utilisateurs : chaque modification (créer, modifier, supprimer, envoyer), chaque téléchargement, chaque action refusée faute de permission ou qui a échoué, et chaque ouverture de l’application. Les simples consultations de pages ne sont pas gardées. Dans l’administration, ouvrez le tenant depuis la page Tenants, puis son onglet Audit trail.
- Choisir combien de temps il est conservé
Keep the audit trail for propose 1 month (la valeur par défaut tant que vous ne choisissez rien), 3 months, 6 months, 12 months ou 24 months. Appuyez sur Save the retention : la durée s’enregistre à part, pas avec les autres onglets. Les lignes plus anciennes sont supprimées dans l’heure, pour ce tenant seulement.
- Lire et chercher dans le journal
Les lignes les plus récentes viennent en premier, 25 par page : When, l’User (Removed user quand la personne n’existe plus), l’Action (ce qui a été demandé et sur quel élément), le Outcome (Succeeded, Denied ou Failed), sa Duration, le Correlation id et l’Address (survolez-la pour voir le navigateur). Tapez dans la zone de recherche un nom, un email, une adresse ou un identifiant de corrélation ; l’icône de filtre des colonnes When, Action et Outcome réduit la liste à une période, un type d’action ou un résultat. Clear the filters réaffiche tout.
- Diagnostiquer un problème
Quand un utilisateur signale une erreur, retrouvez sa ligne, puis donnez le Correlation id à la personne qui lit les journaux de la plateforme : le même identifiant figure sur chaque journal de cette requête.
Statut de la plateforme
La page Status de l’administration (menu Platform, réservée aux super administrateurs) dit si les ressources dont SerenForce a besoin répondent : une ligne pour le catalogue, puis une par tenant activé, et une colonne par ressource : Database (la base de données), Files (le conteneur, le bucket ou le dossier des fichiers), Cache (le serveur Redis) et Sign-in (l’annuaire Microsoft Entra ID). Un rond vert : la ressource répond ; un rond rouge : elle ne répond pas, pointez-le pour lire le message du service (par exemple une base introuvable sur son serveur) ; un tiret : il n’y a rien à joindre (cache en mémoire, aucun fichier pour le catalogue, connexion Google ou AWS). La colonne Overall résume la ligne. Chaque ressource a 10 secondes pour répondre ; tous les tenants sont vérifiés en méme temps. Chaque visite vérifie de nouveau, et Refresh relance la vérification.
Autorisations des applications
Chaque fois que SerenForce enregistre une application dans Microsoft Entra ID (ou vous donne le script pour le faire), l’écran liste sous Permissions given to the application ce que l’application aura le droit de faire. Une autorisation déléguée agit au nom de la personne qui se connecte ; une autorisation de type Application agit sans personne connectée.
- L’application de l’administration (première étape de l’installation) : openid et offline_access pour se connecter et rester connecté, User.Read (déléguée) pour lire le profil de la personne qui se connecte, et le scope qu’elle expose elle-même, api://<client id>/Read.All, que l’application web utilise pour appeler SerenForce.
- L’application d’un tenant (étape Authentication d’un nouveau tenant) : les mêmes, plus ces autorisations déléguées : User.ReadBasic.All (rechercher les personnes de l’annuaire pour choisir les participants), GroupMember.Read.All (lire les groupes et leurs membres), Mail.Read, Mail.Send et Mail.ReadWrite (lire, envoyer et écrire les emails de la personne qui se connecte) et Calendars.ReadWrite (créer des réunions dans son calendrier).
- L’application qui envoie les emails (étape Email, avec Microsoft 365) : seulement Mail.Send de type Application. Une application existante que vous choisissez doit l’avoir aussi.
- Consentement. Les autorisations déléguées sont accordées une fois pour tout l’annuaire, personne n’a à les accepter en se connectant : SerenForce le fait en enregistrant l’application, sinon un administrateur général appuie sur Accorder un consentement d’administrateur (Microsoft Entra ID > Inscriptions d’applications > Autorisations de l’API). Mail.Send de type Application demande toujours un administrateur général ou un administrateur de rôle privilégié, et doit être limitée à la boîte d’envoi (voir l’étape Email).
Inscription en ligne des organisations (libre-service)
Avec les offres Pro et Business, une entreprise s’inscrit seule sur /app/subscribe/organization. Cette inscription s’ouvre d’elle-même dès que la plateforme est installée : il n’y a rien à configurer.
Secrets clients et alertes
Chaque application (celle de l’administration et celle de chaque tenant) reçoit un secret client. SerenForce s’en sert pour rechercher les personnes et les groupes de votre annuaire, et pour envoyer des emails et créer des réunions pour vos utilisateurs. Le secret cesse de fonctionner à sa date d’expiration.
- Quand SerenForce enregistre l’application, il crée le secret avec la durée choisie dans Secret lifetime. Il demande aussi les autorisations Microsoft Graph nécessaires et accorde le consentement administrateur si votre accès Azure le permet. Sinon, la page vous indique qu’un administrateur général doit encore l’accorder (Microsoft Entra ID > Inscriptions d’applications > Autorisations d’API).
- La page Tenants vous prévient avant l’expiration d’un secret. Un badge à côté du statut du tenant affiche Secret expires within a month, Secret expires within a week, Secret expires within a day, puis Secret expired ; survolez-le pour voir la date. Un bandeau au-dessus de la liste fait de même pour le secret de l’application d’administration.
- Chaque semaine, SerenForce contrôle chaque secret auprès de Microsoft Entra ID. Un secret supprimé, remplacé ou mal saisi est repéré même avant sa date d’expiration : le badge affiche alors Secret refused. La fiche du tenant montre la même alerte dans un bandeau au-dessus de ses onglets, avec le jour du dernier contrôle.
- Quand un secret demande une action (il expire dans moins d’un mois, il a expiré ou il a été refusé), SerenForce envoie un email aux super administrateurs de la plateforme et, pour le secret d’un tenant, aux administrateurs de ce tenant, dans leur langue (pour un super administrateur, celle de sa dernière ouverture de l’administration ; l’anglais tant qu’il ne l’a pas ouverte). L’email revient chaque semaine tant que le secret n’est pas renouvelé.
- Pour renouveler un secret, créez-en un nouveau dans Microsoft Entra ID (Inscriptions d’applications > Certificats et secrets). Saisissez-le ensuite dans l’onglet Authentication du tenant avec sa Secret expiry date, puis appuyez sur Save changes. L’alerte disparaît et le nouveau secret est contrôlé dans l’heure.
- Le secret de l’application d’administration se renouvelle depuis le bandeau au-dessus de la liste de la page Tenants : appuyez sur Renew the secret. Choisissez Let SerenForce create it now in Microsoft Entra ID : choisissez la Secret lifetime et la façon dont SerenForce se connecte à Azure, puis appuyez sur Create the secret. L’accès Azure doit être propriétaire de l’application, ou avoir le rôle Administrateur d’applications ou Administrateur d’applications cloud, ou (pour une application) la permission Application.ReadWrite.All de Microsoft Graph : la fenêtre rappelle ces droits. Ou choisissez Type a secret created in Microsoft Entra ID : créez le secret dans le portail, ou avec la commande Azure CLI que donne la fenêtre (les secrets actuels restent valables), puis collez-le dans New secret value, indiquez sa Secret expiry date et appuyez sur Save. Dans les deux cas, le secret n’est plus jamais affiché, le bandeau disparaît et le nouveau secret est contrôlé dans l’heure. Une administration qui se connecte avec Google ou AWS n’a pas de secret à renouveler ici.
À savoir
- Si l’installation est interrompue (page fermée, nouveau déploiement, autre navigateur), rouvrez
/app/setup: les étapes déjà faites le restent. - L’application Microsoft Entra ID enregistrée reste dans votre annuaire (App registrations) si vous supprimez la plateforme : supprimez-la à la main.
- Pour recommencer, supprimez la base du catalogue et cette application, redémarrez l’application (elle recrée le catalogue à son démarrage), puis ouvrez
/app/setup.