Aller au contenu principal

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

ConditionClocheEmplacement du bandeauE-mailRemarques
PAT proche de l’expiration (au niveau de l’organisation)oui/_admin/api-tokensouiPaliers : 30 → 14 → 7 → 1 jour
Certificat SSO proche de l’expirationoui/_admin/ssoouiPaliers : 30 → 14 → 7 → 0 jour
Invitations en attenteoui/_admin/membersnonInvitations sans suite depuis plus de 30 jours
Documents juridiques modifiésoui/_admin/legal/changelognonAccusez réception pour faire disparaître l’alerte
Conservation légale activeoui/_admin/compliance/legal-holdouiLa cloche reste affichée jusqu’à la levée de la conservation
Intégrité de la chaîne d’auditoui/_admin/audit-lognonSignale broken, partial, anchor_mismatch
Projection de consommation des runnersoui/_admin/billingnonIgnorée le premier jour d’une nouvelle période de facturation
Quota de stockage presque atteintoui/_admin/billingouiSe déclenche à >=90 %, disparaît à <80 %
Résultats SAST critiques ouverts depuis plus de 7 joursoui/_admin/security/findings/sastnonGravité critical uniquement

Notifications propres à un utilisateur (également envoyées via Lettermint) :

ConditionDestinataireE-mail
PAT utilisateur proche de l’expirationPropriétaire du PAToui
Échec d’un exportDemandeuroui
Ticket dû demain ou en retardLes personnes assignées au ticket, sinon son auteuroui, 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 travailoui, 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/sso pour 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 :

  1. D’en documenter la raison (la piste d’audit est envoyée dans le bucket d’archive LTS).
  2. 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 de frem.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.