Notifications d’administration
fremforge signale les problèmes opérationnels par trois canaux :
- Cloche : l’icône en forme de cloche dans la barre supérieure de
/<org>/_admin/*. Propre à chaque administrateur, sur les 30 derniers jours, avec un lien vers la page de paramètres concernée. - Bandeau de la page de paramètres : un bandeau fixe en haut de la page de paramètres concernée (par exemple, la page des paramètres SSO affiche un bandeau sur l’expiration du certificat SSO). Il disparaît lorsque la condition sous-jacente est résolue.
- E-mail : envoyé aux administrateurs de l’organisation pour les conditions critiques. Nous les envoyons via Lettermint (sous-traitant européen) ; le code source des modèles se trouve dans le dépôt, de sorte que le contenu est vérifiable.
Une même condition peut se déclencher sur plusieurs canaux. Un e-mail s’accompagne toujours de la cloche et d’un bandeau ; un bandeau s’accompagne toujours de la cloche ; les éléments signalés uniquement par la cloche ne sont pas critiques.
Conditions
| Condition | Cloche | Emplacement du bandeau | Remarques | |
|---|---|---|---|---|
| PAT proche de l’expiration (au niveau de l’organisation) | oui | /_admin/api-tokens | oui | Paliers : 30 → 14 → 7 → 1 jour |
| Certificat SSO proche de l’expiration | oui | /_admin/sso | oui | Paliers : 30 → 14 → 7 → 0 jour |
| Invitations en attente | oui | /_admin/members | non | Invitations sans suite depuis plus de 30 jours |
| Documents juridiques modifiés | oui | /_admin/legal/changelog | non | Accusez réception pour faire disparaître l’alerte |
| Conservation légale active | oui | /_admin/compliance/legal-hold | oui | La cloche reste affichée jusqu’à la levée de la conservation |
| Intégrité de la chaîne d’audit | oui | /_admin/audit-log | non | Signale broken, partial, anchor_mismatch |
| Projection de consommation des runners | oui | /_admin/billing | non | Ignorée le premier jour d’une nouvelle période de facturation |
| Quota de stockage presque atteint | oui | /_admin/billing | oui | Se déclenche à >=90 %, disparaît à <80 % |
| Résultats SAST critiques ouverts depuis plus de 7 jours | oui | /_admin/security/findings/sast | non | Gravité critical uniquement |
Notifications propres à un utilisateur (également envoyées via Lettermint) :
| Condition | Destinataire | |
|---|---|---|
| PAT utilisateur proche de l’expiration | Propriétaire du PAT | oui |
| Échec d’un export | Demandeur | oui |
| Ticket dû demain ou en retard | Les personnes assignées au ticket, sinon son auteur | oui, un récapitulatif quotidien ; voir Rappels d’échéance |
| Vos pull requests et branches sans push depuis 14 jours (organisations où Travail en cours est activé) | La personne à qui appartient le travail | oui, au plus un récapitulatif quotidien ; voir Travail inactif |
Comment faire disparaître chaque alerte
PAT proche de l’expiration
Renouvelez le PAT sur /<org>/_admin/api-tokens et émettez-en un nouveau. Le nouveau PAT démarre un nouveau délai d’expiration ; la cloche disparaît le lendemain matin.
Si le propriétaire a quitté l’organisation, le PAT peut être révoqué directement depuis la même page. Il n’existe pas d’option de « prolongation », et c’est voulu.
Certificat SSO proche de l’expiration
Renouvelez le certificat de signature dans votre IdP, puis au choix :
- Attendez : fremforge détecte automatiquement le nouveau certificat sous 24 heures et met fin aux paliers d’avertissement.
- Cliquez sur « Test SSO » sur
/<org>/_admin/ssopour relancer immédiatement la vérification.
La vérification du certificat passe par le proxy sortant de fremforge (aucune sortie directe depuis le pod de l’API) : les règles de liste d’autorisation s’appliquent donc. Si la vérification échoue, assurez-vous que votre IdP est joignable depuis le proxy sortant.
Invitations en attente
Renvoyez l’invitation (ce qui renouvelle son délai d’expiration) ou révoquez-la. Les invitations en attente n’exposent aucune donnée du tenant : la cloche sert simplement à garder la liste des membres en ordre.
Documents juridiques modifiés
Lorsque fremverk publie une nouvelle version des Conditions, du DPA ou de l’AUP, la cloche se déclenche pour toutes les organisations. Rendez-vous sur /<org>/_admin/legal/changelog pour consulter les différences et en accuser réception : la cloche disparaît pour votre organisation.
L’accusé de réception enregistre qui l’a donné et quand, pour le dossier client.
Conservation légale active
Cette cloche ne disparaît PAS automatiquement. Lever une conservation légale exige :
- D’en documenter la raison (la piste d’audit est envoyée dans le bucket d’archive LTS).
- Une action d’un opérateur sur
/<org>/_admin/compliance/legal-hold.
La cloche reste volontairement affichée pour être visible de tous les administrateurs pendant toute la durée de la conservation : les dérogations aux règles de conservation du DPA §9 ne doivent pas pouvoir être oubliées.
Intégrité de la chaîne d’audit
Trois états possibles autres que ok :
broken: le parcours de la chaîne a échoué sur une ligne. Alertez l’astreinte.partial: le parcours de la chaîne a été tronqué par la limite de lignes (très gros tenants). Relancez-le en programmant une fenêtre avec une limite plus élevée.anchor_mismatch: la chaîne de hachage sur disque ne correspond pas à l’ancre WORM sur OBS. Alertez immédiatement l’astreinte.
Dans tout état autre que ok, contactez support@frem.sh en indiquant le slug du tenant : nous prendrons le relais.
Projection de consommation des runners
S’affiche si la projection de votre consommation mensuelle de minutes de runner dépasse le quota inclus. Actions possibles :
- Passer à une offre supérieure (des augmentations ponctuelles sont disponibles sur
/<org>/_admin/billing). - Accuser réception pour masquer l’alerte jusqu’à la fin de la période en cours.
Quota de stockage
Hystérésis : l’alerte se déclenche à ≥90 % du stockage de l’offre et disparaît à <80 %. Actions possibles :
- Supprimer les dépôts ou objets LFS inutilisés.
- Déplacer les gros artefacts vers votre propre bucket OBS et les référencer par URL.
- Passer à une offre supérieure.
Envoi des e-mails
Tous les e-mails proviennent de notifications@frem.sh. L’adresse de réponse est support@frem.sh (les réponses arrivent dans la file du support, pas dans une adresse qui les ignore).
S’il vous manque des e-mails de notification :
- Vérifiez que l’adresse e-mail de l’administrateur de l’organisation est à jour sur
/<org>/_admin/members. - Vérifiez que
notifications@frem.sh(et le SPF defrem.sh) n’est pas mis en quarantaine en amont. - Vérifiez que l’alerte se déclenche réellement : la cloche fait foi ; l’e-mail n’est qu’une courtoisie.
Nous ne renvoyons pas les e-mails de notification rejetés. La cloche reste allumée jusqu’à la résolution de la condition sous-jacente : c’est elle la source de vérité.
Ce qui n’est PAS signalé
Éléments volontairement absents des notifications d’administration :
- Notifications par PR / par commit : elles relèvent des paramètres de notification de votre dépôt, pas de la console d’administration.
- Alertes système de Forgejo (échecs de synchronisation de miroirs, violations de règles de push) : elles s’affichent sur la page de paramètres du dépôt concerné, pas dans la cloche d’administration.
- Échecs de facturation : gérés par l’e-mail de facturation et le processus de relance, pas par la cloche.
S’il vous semble manquer quelque chose, ouvrez un ticket sur frem.sh/_app/feedback. Nous ajoutons une alerte lorsque le coût de rater l’événement dépasse le coût du bruit, et la barre est réellement haute.