Team-Pakete
Ein Team-Paket ist eine JSON-Datei mit den gemeinsamen Einstellungen eines Teams – Host-Profile mit PROD-Kennzeichen, OData-Filter, Snippets, Maskierungsregeln und mehr. Es liegt auf einem Server deines Unternehmens; ein CloudDNA-Backend ist nicht beteiligt. Übernommen wird nie ohne Vorschau.
- Edition
- ab Team
- Tab
- „Team“
- Format
- JSON
fioritailor-team-package, Version 1 - Signatur
- optional, Ed25519 (JWS)
- Verteilen
- Datei, Zwischenablage, HTTPS-URL, Richtlinie
Was ein Paket enthält
Ein Paket kann diese Abschnitte enthalten; beim Export wählst du sie aus:
- Host-Profile (Name, Farbe, PROD-Kennzeichen) und URL-Profile
- OData-Filter und Replay-Requests
- Snippets und PII-Maskierungsregeln
- Palette-Favoriten, Lesezeichen, Bekannte Fehler, Morgencheck-Listen und Performance-Budgets
Pro Abschnitt gelten höchstens 500 Einträge, pro Paket höchstens 1 MB. Ungültige Einträge werden einzeln übersprungen und in der Vorschau gezählt; unbekannte Abschnitte aus neueren Versionen werden ignoriert.
Ein Paket erstellen
- Im DevTools-Panel oder Side-Panel den Tab Team öffnen.
- In der Karte Export den Paketnamen und den Autor eintragen.
- Unter Abschnitte wählen, was ins Paket soll. Neben jedem Abschnitt steht die Zahl der Einträge.
- Herunterladen speichert das Paket als Datei, Kopieren legt es in die Zwischenablage.
Der Export ist unsigniert und enthält die gewählten Abschnitte mit allen lokalen Einträgen.
Ein Paket signieren
Signiert wird außerhalb des Browsers, denn der private Schlüssel gehört nicht in die Extension. Das Skript scripts/sign-team-package.mjs aus dem Quellcode von FrontTailor braucht nur Node und keine Abhängigkeiten.
- Ein Schlüsselpaar erzeugen:
node scripts/sign-team-package.mjs --generate-key fiori-team-2026. - Den öffentlichen Teil für die Richtlinie ausgeben:
--public-key <datei>. Er kommt nachteamSync.trustedKeys. - Das Paket signieren:
--key <datei> team.json. Das Ergebnis ist eine JWS-Datei (Ed25519, flattened JSON), die du statt des Pakets ablegst. - Den privaten Schlüssel im Passwort-Tresor oder als CI-Secret aufbewahren, nie im Repository.
| Anzeige an der Quelle | Bedeutung | Verhalten |
|---|---|---|
| Signiert · <kid> | Signatur eines vertrauenswürdigen Schlüssels gültig | angenommen |
| Unbekannter Schlüssel · <kid> | Der Schlüssel steht nicht in der Richtlinie | angenommen, solange keine Signatur verlangt ist; Hinweis in der Vorschau |
| Unsigniert | keine Signatur | angenommen, solange keine Signatur verlangt ist; Warnung in der Vorschau |
| Ungültige Signatur | Signatur passt nicht oder Format kaputt | immer abgelehnt |
Ein Paket verteilen
| Kanal | So geht es |
|---|---|
| Datei | In der Karte Import unter Paketdatei eine .json-Datei wählen. |
| Zwischenablage | In der Karte Import das Paket einfügen und Paket prüfen klicken. |
| URL abonnieren | Unter Paket-URL abonnieren eine HTTPS-Adresse deines Teams eintragen (Git-Raw-Datei, SharePoint, interner Webserver) und Abonnieren klicken. Abrufen holt das Paket. |
| Richtlinie | Die Administration gibt die URL mit teamSync.packages vor. Das Paket erscheint mit dem Tag Administrator und ist schreibgeschützt. |
Die URL muss HTTPS sein (HTTP nur für localhost) und darf weder Benutzer, Passwort noch Token-Parameter enthalten. Braucht der Server eine Anmeldung, nutzt FrontTailor deine Browser-Sitzung bei diesem Host. Für den Abruf fragt FrontTailor einmal nach dem Zugriff auf den Paket-Server; bis dahin steht an der Quelle Zugriff erforderlich mit dem Knopf Zugriff erlauben.
Prüfen und übernehmen
Übernommen wird nie automatisch. Nach dem Abruf zeigt die Quelle Änderungen verfügbar, die Vorschau listet je Abschnitt neu, geändert und entfernt.
- An der Quelle Änderungen prüfen klicken. Die Vorschau zeigt Stand und Autor des Pakets.
- Die Änderungen durchsehen. Konflikte sind markiert und nicht vorausgewählt: Lokal geändert (aus dem Paket, seither lokal geändert) und Eigener lokaler Eintrag.
- Einzelne Änderungen oder ganze Abschnitte an- oder abwählen.
- Übernehmen wendet die Auswahl an; Ablehnen verwirft alle offenen Änderungen, sie werden erst bei einem neuen Wert wieder vorgeschlagen.
Einträge, die du selbst angelegt hast, löscht ein Paket nie. Entfernst du eine Quelle, bleiben ihre Einstellungen als lokale erhalten.
Richtlinie für Team-Pakete
| Schlüssel | Wirkung |
|---|---|
teamSync.packages | HTTPS-URLs, die jeder Nutzer schreibgeschützt bekommt, höchstens 10. URLs mit Zugangsdaten oder Token-Parametern werden ignoriert. |
teamSync.trustedKeys | Öffentliche Ed25519-Schlüssel als JWK mit kid. |
teamSync.requireSignature | Nur signierte Pakete dieser Schlüssel, auch bei eigenen Abos und Importen. Standard true, sobald trustedKeys gesetzt ist. |
teamSync.autoSyncMinutes | Ruft die vorgegebenen Pakete alle n Minuten ab (15 bis 10 080). Ohne den Schlüssel nur auf Klick. |
teamSync.allowUserPackages | false: keine eigenen Abos und Importe. |
modules.teamsync | false blendet den Tab „Team“ aus. |
{
"teamSync": {
"packages": ["https://git.example.com/fiori/fioritailor/raw/main/team.json"],
"trustedKeys": [{ "kid": "fiori-team-2026", "kty": "OKP", "crv": "Ed25519", "x": "<base64url>" }],
"autoSyncMinutes": 240
}
}
Auch nach einem geplanten Abruf liegt das Paket nur bereit; angewendet wird es erst nach der Vorschau mit Alle übernehmen. Wie die Richtlinie auf die Geräte kommt, steht unter Enterprise-Deployment.
Siehe auch
- Doku Team-Sync
- Doku Enterprise-Deployment
- Doku Host-Profile und PROD
- Belege ADR-0211 · ADR-0132