Benachrichtigungen für Admins

fremforge meldet betriebliche Probleme über drei Kanäle:

Glocke: das Glockensymbol in der oberen Leiste von /<org>/_admin/*. Pro Admin, die letzten 30 Tage, mit Klick zur passenden Einstellungsseite.
Banner auf der Einstellungsseite: ein fest stehendes Banner oben auf der passenden Einstellungsseite (z. B. zeigt die SSO-Einstellungsseite ein Banner zum Ablauf des SSO-Zertifikats). Es verschwindet, wenn die zugrunde liegende Bedingung nicht mehr besteht.
E-Mail: geht bei kritischen Bedingungen an die Admins der Organisation. Wir versenden über Lettermint (EU-Unterauftragsverarbeiter); der Quelltext der Vorlagen liegt im Repository, sodass der Inhalt prüfbar ist.

Dieselbe Bedingung kann auf mehreren Kanälen ausgelöst werden. E-Mail kommt immer zusammen mit Glocke und Banner; Banner kommen immer zusammen mit der Glocke; Meldungen nur in der Glocke sind nicht kritisch.

Bedingungen

Bedingung	Glocke	Ort des Banners	E-Mail	Hinweise
PAT läuft ab (Organisationsebene)	ja	`/_admin/api-tokens`	ja	Stufen: 30 → 14 → 7 → 1 Tag
SSO-Zertifikat läuft ab	ja	`/_admin/sso`	ja	Stufen: 30 → 14 → 7 → 0 Tage
Veraltete Einladungen	ja	`/_admin/members`	nein	Einladungen seit >30 Tagen unbearbeitet
Rechtsdokumente geändert	ja	`/_admin/legal/changelog`	nein	Zum Auflösen bestätigen
Legal Hold aktiv	ja	`/_admin/compliance/legal-hold`	ja	Glocke bleibt bestehen, bis der Hold aufgehoben ist
Integrität der Audit-Kette	ja	`/_admin/audit-log`	nein	Zeigt `broken`, `partial`, `anchor_mismatch`
Hochrechnung des Runner-Verbrauchs	ja	`/_admin/billing`	nein	Am 1. Tag eines neuen Abrechnungszeitraums ausgesetzt
Speicherkontingent fast erreicht	ja	`/_admin/billing`	ja	Ausgelöst bei >=90 %, aufgelöst bei <80 %
Kritische SAST-Befunde seit >7 Tagen offen	ja	`/_admin/security/findings/sast`	nein	Nur Schweregrad `critical`

Benachrichtigungen für einzelne Nutzer (ebenfalls über Lettermint zugestellt):

Bedingung	Empfänger	E-Mail
PAT eines Nutzers läuft ab	Eigentümer des PAT	ja
Export fehlgeschlagen	wer ihn angefordert hat	ja
Issue morgen fällig oder überfällig	die zugewiesenen Personen des Issues, sonst sein Autor	ja, ein täglicher Digest; siehe Erinnerungen an Fälligkeitsdaten
Deine Pull Requests und Branches ohne Push seit 14 Tagen (Organisationen mit eingeschaltetem Active work)	die Person, der die Arbeit gehört	ja, höchstens ein täglicher Digest; siehe Ruhende Arbeit

So löst du jede Meldung auf

PAT läuft ab

Rotiere das PAT unter /<org>/_admin/api-tokens und stelle es neu aus. Das neue PAT startet eine neue Ablauffrist; die Glocke verschwindet am nächsten Morgen.

Hat der Eigentümer die Organisation verlassen, kannst du das PAT auf derselben Seite direkt widerrufen. Ein „Verlängern“ gibt es nicht, mit Absicht.

SSO-Zertifikat läuft ab

Rotiere das Signaturzertifikat in deinem IdP und dann entweder:

Warte: fremforge erkennt das neue Zertifikat automatisch innerhalb von 24 Stunden und beendet die Warnstufen.
Klicke auf „Test SSO“ unter /<org>/_admin/sso, um sofort erneut zu prüfen.

Die Prüfung des Zertifikats läuft über fremforges ausgehenden Proxy (kein direkter Ausgang aus dem API-Pod), daher gelten dessen Allowlist-Regeln. Schlägt die Prüfung fehl, stelle sicher, dass dein IdP vom ausgehenden Proxy aus erreichbar ist.

Veraltete Einladungen

Sende sie entweder erneut (das erneuert die Ablauffrist) oder widerrufe sie. Veraltete Einladungen legen keine Daten der Organisation offen; die Glocke soll nur die Mitgliederliste aufgeräumt halten.

Rechtsdokumente geändert

Wenn fremverk eine neue Version der Nutzungsbedingungen, des AVV oder der AUP veröffentlicht, wird die Glocke für jede Organisation ausgelöst. Öffne /<org>/_admin/legal/changelog, sieh dir die Änderungen an und bestätige sie; dann verschwindet die Glocke für deine Organisation.

Die Bestätigung hält fest, wer sie wann abgegeben hat, für die Kundenakte.

Legal Hold aktiv

Diese Glocke verschwindet NICHT automatisch. Um einen Legal Hold aufzuheben, braucht es:

Eine Begründung (der Audit-Trail geht in den LTS-Archiv-Bucket).
Eine Operator-Aktion unter /<org>/_admin/compliance/legal-hold.

Die Glocke bleibt absichtlich bestehen, damit sie während der gesamten Dauer des Holds für jeden Admin sichtbar ist. Abweichungen von der Aufbewahrung nach AVV §9 dürfen nicht in Vergessenheit geraten.

Integrität der Audit-Kette

Drei mögliche Zustände außer ok:

broken: Die Prüfung der Kette ist an einer Zeile gescheitert. Rufbereitschaft alarmieren.
partial: Die Prüfung der Kette wurde durch die Zeilenobergrenze abgeschnitten (sehr große Organisationen). Mit einem geplanten Zeitfenster und höherer Obergrenze erneut ausführen.
anchor_mismatch: Die gespeicherte Hash-Kette stimmt nicht mit dem WORM-Anker in OBS überein. Sofort die Rufbereitschaft alarmieren.

Wende dich in jedem Zustand außer ok mit dem Slug der Organisation an support@frem.sh; wir kümmern uns darum.

Hochrechnung des Runner-Verbrauchs

Erscheint, wenn dein monatlicher Verbrauch an Runner-Minuten hochgerechnet das enthaltene Kontingent übersteigt. Möglichkeiten:

Erweitere deinen Tarif (einmalige Aufstockungen unter /<org>/_admin/billing).
Bestätige die Meldung, um sie für den Rest des laufenden Zeitraums auszublenden.

Speicherkontingent

Hysterese: Die Meldung wird bei ≥90 % des Speichers im Tarif ausgelöst und bei <80 % aufgelöst. Möglichkeiten:

Lösche ungenutzte Repositorys oder LFS-Objekte.
Lagere große Artefakte in deinen eigenen OBS-Bucket aus und verweise per URL darauf.
Wechsle in einen größeren Tarif.

E-Mail-Zustellung

Alle E-Mails kommen von notifications@frem.sh. Die Antwortadresse ist support@frem.sh (Antworten landen in der Support-Warteschlange, nicht bei einer Adresse, die alles verschluckt).

Falls dir Benachrichtigungs-E-Mails fehlen:

Prüfe unter /<org>/_admin/members, ob die E-Mail-Adresse des Admins aktuell ist.
Prüfe, dass notifications@frem.sh (und SPF für frem.sh) auf deiner Seite nicht in Quarantäne landet.
Prüfe, ob die Meldung tatsächlich ausgelöst wird: Die Glocke ist maßgeblich, E-Mail ist eine Gefälligkeit.

Unzustellbare Benachrichtigungs-E-Mails senden wir nicht erneut. Die Glocke leuchtet, bis die zugrunde liegende Bedingung nicht mehr besteht; die Glocke ist die verlässliche Quelle.

Was NICHT gemeldet wird

Dinge, die bewusst nicht in den Benachrichtigungen der Verwaltung erscheinen:

Benachrichtigungen pro Pull Request / pro Commit: Die liegen in den Benachrichtigungseinstellungen deines Repositorys, nicht in der Verwaltungskonsole.
Systemmeldungen von Forgejo (fehlgeschlagene Mirror-Synchronisierung, Verstöße gegen Push-Regeln): Die gehen auf die Einstellungsseite des betroffenen Repositorys, nicht in die Glocke der Verwaltung.
Fehlgeschlagene Zahlungen: Die laufen über die Abrechnungs-E-Mail und das Mahnverfahren, nicht über die Glocke.

Fehlt dir etwas, lege ein Issue unter frem.sh/_app/feedback an. Wir fügen Meldungen hinzu, wo die Kosten eines verpassten Ereignisses höher sind als die Kosten des Lärms; die Hürde ist wirklich hoch.

Lebenszyklus Allowlist für E-Mail-Domains