# 02 – Projekt in Bitwarden anlegen

<p class="callout info">Zielgruppe: Consultants · Stand: 09.11.2026</p>

Für jedes neue Freeze-Projekt brauchst du eine eigene Collection mit genau einer sicheren Notiz namens `frz_project` und genau einem Login namens `frz_encryption`. Diese Seite zeigt, wie du Collection, Notiz, Lizenz und Schlüssel anlegst.

## 1. Die Projekt-Collection vorbereiten

1. Öffne den für die Zielumgebung vorgesehenen Tresor in Bitwarden (siehe **01 – Überblick und Voraussetzungen**).
2. Lege eine neue Collection an oder verwende die dafür bereitgestellte, noch nicht belegte Projekt-Collection.
3. Verwende einen eindeutigen Projektnamen, beispielsweise `Musterfirma Archiv`. Wähle einen einfachen Namen aus Buchstaben ohne Umlaute, Zahlen, Leerzeichen, Bindestrich und Unterstrich. Beginne mit einem Buchstaben oder einer Zahl und vermeide Leerzeichen am Anfang oder Ende. Verwende keine Schrägstriche, Punkte oder `&`.
4. Stelle sicher, dass sowohl die zuständigen Personen als auch der Automatisierungszugang Zugriff haben. Lass fehlende Berechtigungen durch die Verwaltung ergänzen.

Der vollständige Collection-Name wird als Projektname übernommen. Die Screenshots zur Collection-Anlage findest du im Breeze-Buch auf der Seite **02 – Projekt in Bitwarden anlegen**. Der Ablauf ist bei Freeze identisch.

## 2. Die sichere Notiz anlegen

1. Erstelle in der Collection einen Eintrag vom Typ **Sichere Notiz**.
2. Vergib exakt den Namen `frz_project`.
3. Lege in dieser Collection genau eine Notiz mit diesem Namen an.
4. Trage die Projektfelder als benutzerdefinierte Textfelder ein. Die Feldnamen und Werte stehen auf **03 – Projektfelder ausfüllen**.

## 3. Die EAS-Lizenz einfügen

Kopiere die vollständige, mehrzeilige EAS-Lizenz (`.pem`-Inhalt) in den großen Notiztext der Notiz `frz_project`. Die Zeilenumbrüche müssen erhalten bleiben. Schreibe keine Erläuterungen dazu und verwende weder ein einzeiliges Feld noch einen Anhang. Ohne Zeilenumbrüche im Notiztext wird das Projekt nicht eingerichtet. Der Lizenzinhalt gehört nicht in Chats, Tickets oder E-Mails.

## 4. Das Login `frz_encryption` anlegen

Jedes Freeze-Projekt braucht einen Verschlüsselungsschlüssel. Er verschlüsselt alle Stores des Projekts. Die Plattform erzeugt ihn nie selbst. Du erzeugst ihn mit dem Passwortgenerator von Bitwarden und hinterlegst ihn vor der Bereitstellung in der Projekt-Collection.

1. Erstelle in **derselben** Collection einen Eintrag vom Typ **Login**.
2. Vergib exakt den Namen `frz_encryption`.
3. Erzeuge im Feld **Passwort** mit dem Passwortgenerator einen Schlüssel: Typ **Passwort**, Länge **64**, Groß- und Kleinbuchstaben und Zahlen an, **Sonderzeichen aus**. So enthält der Schlüssel keine verbotenen Zeichen.
4. Lege genau ein Login mit diesem Namen in der Collection an.

| Regel | Wert |
|---|---|
| Länge | 32 bis 128 Zeichen |
| Verbotene Zeichen | Leerraum jeder Art sowie `$`, `;` und `#` |
| Anzahl | genau ein Login `frz_encryption` je Projekt-Collection |
| Änderung | nie ändern, überschreiben oder löschen |

<p class="callout danger">Der Schlüssel darf nach der ersten Verwendung nie geändert oder gelöscht werden. Ein anderer Schlüssel macht alle bereits verschlüsselten Archive des Projekts unlesbar. Der Schlüssel liegt ausschließlich in Bitwarden. Das gilt auch nach einer Kündigung des Projekts.</p>

## 5. Speichern und gegenprüfen

Speichere erst, wenn Projektfelder, Lizenz und Schlüssel vollständig sind. Öffne beide Einträge danach erneut und prüfe Collection-Zuordnung, Feldwerte, Zeilenumbrüche der Lizenz und die Schlüsselregeln. Der nächste automatische Durchlauf berücksichtigt die gespeicherten Einträge (Zeiten siehe **04 – Automatische Bereitstellung abwarten**).

## Die Statusnotiz `frz_project_status`

Neben `frz_project` legt die Plattform in der Projekt-Collection selbst eine zweite Notiz an: `frz_project_status`. Sie ist nur zum Lesen gedacht und deine Änderungen daran werden überschrieben. Sie nennt in Klartext:

- ob das Projekt in Ordnung ist (`Projekt: ok`) oder was an der Projektbeschreibung fehlerhaft ist, zum Beispiel ein fehlendes Pflichtfeld oder ein fehlendes Schlüssel-Login,
- welcher Server zugeteilt wurde, oder dass noch keiner zugeteilt ist,
- einen Hinweis, wenn eine Kündigung vorgemerkt ist, und
- einen Hinweis, wenn eine gelöschte Notiz wiederhergestellt wurde.

<p class="callout success">Die Statusnotiz ist deine erste Anlaufstelle, wenn etwas nicht wie erwartet läuft. Sie prüft allerdings nicht alles: Kurzname, Store-Liste und Lizenz fallen erst bei der Einrichtung auf (siehe <strong>06 – Probleme und spätere Änderungen</strong>).</p>

Weiter: **03 – Projektfelder ausfüllen**