Handbuch

Erste Schritte

Bossanova ist ein digitaler Tresor, der Texte und Bilder verschlüsselt auf Ihrem Computer speichert. Sie müssen sich in der App anmelden, auch mit einem kostenlosen Konto. Die Kontoanmeldung ist unabhängig vom Master-Passwort, mit dem Sie den Tresor öffnen.

Wenn Google meldet, dass das Konto bereits auf Ihrem Gerät vorhanden ist, kehren Sie hierher zurück und wählen Sie „Mit E-Mail fortfahren“ mit derselben Google-E-Mail-Adresse. Wenn Sie bereits mit dieser E-Mail-Adresse bei Bossanova registriert sind, melden Sie sich damit bei Ihrem bestehenden Konto an. Sie können auch einen anderen Browser ausprobieren.

Das aktuelle Installationsprogramm ist für Windows 10/11 x64. Windows-32-Bit- und native ARM64-Versionen werden nicht angeboten. Die Installation oder Aktualisierung von WebView2 kann eine Internetverbindung erfordern.

1. Laden Sie auf der Downloadseite das Installationsprogramm für Ihr Betriebssystem herunter und installieren Sie es.
2. Schließen Sie die Installation ab und öffnen Sie Bossanova über das Startmenü. Windows 10/11 x64 wird unterstützt. Wenn WebView2 fehlt, richtet das Installationsprogramm es ein. Wenden Sie sich an Ihre Administration, wenn die Installation auf einem Arbeitscomputer blockiert ist.
3. Registrieren Sie sich auf dem Anmeldebildschirm der App mit Google, Apple oder Ihrer E-Mail-Adresse oder melden Sie sich an und genehmigen Sie dieses Gerät. Mit einem kostenlosen Konto können Sie zehn Datenelemente speichern.
4. Erstellen Sie auf dem ersten Bildschirm einen Tresor mit langem Master-Passwort und bewahren Sie es sicher auf. Einen vorhandenen Tresor übertragen Sie vor dem Erstellen über den Import von einem anderen Gerät. Für Backup-Dateien gibt es die separate Wiederherstellung aus einem Backup.
5. Speichern Sie zunächst ein harmloses Beispiel. Testen Sie daran die Suche, das Anzeigen und das Kopieren. Fügen Sie anschließend echte Informationen hinzu und erstellen Sie ein externes Backup.

Der Entwickler kann ein vergessenes Master-Passwort nicht wiederherstellen. Die Anmeldung mit Google, Apple oder per E-Mail kann das Master-Passwort nicht zurücksetzen.

Daten speichern und organisieren

Ein Bossanova-Tresor ist als Ordner → Gruppe → Datenelement organisiert. Ein Datenelement besteht aus einem Namen und einem Wert (Text oder Bild); eine Gruppe bündelt zusammengehörige Datenelemente. Ein Ordner enthält Gruppen und nicht gruppierte Datenelemente, und der Tresor ist die Gesamtheit der Ordner. Beispielsweise kann ein Ordner „API-Schlüssel“ eine Gruppe „bossanova“ mit den Datenelementen „Dodo-API-Schlüssel“ und „Verlängerungsdatum“ enthalten. Jedes Text- oder Bild-Datenelement zählt als eines.

Ordner organisieren Gruppen und Datenelemente. Ziehe die Griffe, um die Reihenfolge zu ändern. Beim Löschen eines Ordners kannst du wählen, ob du seine Inhalte behalten oder löschen möchtest.

Schalten Sie den KI-Zugriff über das Sternsymbol um. Beim Darüberfahren erscheint der Name; ein hellgrüner Hintergrund bedeutet eingeschaltet; der Stern bleibt als Umriss sichtbar. Die Schaltfläche ist in Listen, Details und Formularen für Daten und Gruppen gleich. Alle Einträge und Ordner teilen die Sortierung: Standard, neueste, älteste, häufigste, seltenste, Name A–Z und Z–A. Die letzte Wahl wird im Tresor für den nächsten Start gespeichert. Namen folgen der Anzeigesprache, mit 2 vor 10. Wählen Sie Standard, um Einträge im Ordner zu verschieben; andere Sortierungen bewahren die manuelle Reihenfolge.

Unter Einstellungen → KI → KI-Zugriff ist der Zugriff für neue Daten zunächst aus. Der Standard gilt für neue Texte und Bilder, neue Daten beim Erstellen oder Bearbeiten von Gruppen, Vorlagen und .env-Importe. Vor dem Speichern lässt sich jedes KI-Symbol ändern. Bestehende Daten, nicht geheime Freigaben und Ausführungsgenehmigungen bleiben unverändert. Die Wahl wird in diesem Tresor gespeichert.

1. Erstellen Sie im linken Menü unter „Ordner hinzufügen und verwalten“ Ordner und ziehen Sie die Griffe, um sie neu anzuordnen.
2. Geben Sie unter „Daten hinzufügen“ einen Namen, einen Typ (Text oder Bild; ältere Datenelemente behalten ihren Typ Passwort, Zahl oder Datum) und einen Wert ein. Ohne Gruppe wird das Datenelement direkt im Ordner abgelegt. Bilder (PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, TGA, PNM, QOI, HDR, bis zu 10MiB) können Sie hineinziehen oder einfügen. Wenn Sie auf ein Datenelement klicken, werden seine Details geöffnet. Mit „Bearbeiten“ öffnen Sie den Bearbeitungsdialog, in dem der gespeicherte Wert bereits eingetragen ist (mit „Wert anzeigen“ können Sie ihn prüfen).
3. Ziehen Sie ein Datenelement auf ein anderes, um eine Gruppe zu erstellen, oder eine Gruppe auf eine Gruppe, um sie zusammenzuführen. Mit den Griffen können Sie alles neu anordnen.
4. Verwenden Sie bei Bedarf die Aktionen zum Anzeigen oder Kopieren eines Datenelements. Die Ziel-App oder das Zieldokument kann eingefügte Werte sehen. Prüfen Sie daher, wohin Sie sie einfügen.
5. Plus und Pro enthalten Vorlagen für häufig verwendete Gruppen. Die tatsächlichen Werte müssen Sie trotzdem selbst eingeben.

Geben Sie Geheimnisse ausschließlich in Wertefelder ein. Datenname, Beschreibung sowie Gruppen- und Ordnernamen können je nach Ihren Einstellungen an die KI weitergegeben werden.

Eine .env-Datei importieren

Sie können die Geheimnisse aus der .env-Datei eines Projekts in einem Schritt in den Tresor übernehmen. Klicken Sie unten links im Dialog „Neue Gruppe“ auf „.env importieren“ oder ziehen Sie die Datei auf die Tresoransicht. Aus einer Datei wird eine Gruppe, und aus jeder Variablen wird ein nach dem Variablennamen benanntes Datenelement. Die Elemente bleiben geheim; der KI-Zugriff folgt dem Standard für neue Daten.

1. In der Vorschau werden nur die Variablennamen angezeigt; Werte erscheinen nie auf dem Bildschirm. Legen Sie einen Gruppennamen fest (zum Beispiel web .env) und prüfen Sie die Liste.
2. Werte, die wahrscheinlich keine Geheimnisse sind, etwa Ports oder öffentliche URLs, werden als Kandidaten für „Kein Geheimnis“ markiert. Standardmäßig ist alles ein Geheimnis; nur von Ihnen ausgewählte Datenelemente werden nach Bestätigung eines Warnhinweises als „Kein Geheimnis“ markiert.
3. Wenn Sie über die Dateiauswahl importiert haben, können Sie die ursprüngliche .env-Datei löschen lassen. Hineingezogene Dateien werden nicht gelöscht.
4. Der Import wird als ein einziger Vorgang gespeichert. Wenn dadurch das Datenlimit Ihres Tarifs überschritten würde, wird nichts gespeichert und eine Aufforderung zum Tarifwechsel angezeigt; vorhandene Informationen bleiben unverändert.

Die KI kann eine importierte Gruppe in „In eine Ausführung einfügen“ als Ganzes verwenden: Jedes Datenelement der Gruppe mit aktiviertem KI-Zugriff wird als Umgebungsvariable mit dem Namen des Datenelements eingefügt. Eine im Projekt verbliebene .env-Datei kann von der KI gelesen werden. Entfernen Sie sie daher, sobald ihr Inhalt im Tresor liegt.

Informationen finden

Geben Sie bei geöffnetem Tresor einen Namen oder ein Stichwort in das Suchfeld ein. Die Ergebnisse ändern sich bereits vor dem Drücken der Eingabetaste. Beginnen Sie mit einem kurzen Teil des Namens; exakte Treffer werden gegenüber Teiltreffern und ähnlichen Treffern bevorzugt.

Die Suche wird lokal mit Algorithmen ausgeführt, ohne den Suchbegriff an die KI oder den Kontoserver zu senden. Standardmäßig werden Namen und Beschreibungen durchsucht. Aktivieren Sie die Option, zusätzlich Werte zu durchsuchen, um auch Textwerte zu finden. Übereinstimmende geheime Werte werden in der Ergebnisvorschau nicht angezeigt. Bilder werden nicht per OCR durchsucht. Wählen Sie ein Ergebnis aus und verwenden Sie im benötigten Feld die Funktion zum Anzeigen oder Kopieren.

Wenn nichts gefunden wird, verkürzen Sie den Suchbegriff oder ändern Sie die Leerzeichen. Löschen Sie den Suchbegriff, um zur vollständigen Liste zurückzukehren. Bei gesperrtem Tresor ist die Suche nicht verfügbar.

Sprache

Einstellungen → Allgemein → Sprache — Die auf dem Bildschirm verwendete Sprache. Die Auswahl wird sofort angewendet und in diesem Tresor gespeichert. Der Sperrbildschirm verwendet die Sprache Ihres Computers.

Sperren und beenden

Sperren Sie den Tresor, wenn Sie den Computer verlassen. Neue Tresore werden standardmäßig nach fünf Minuten Inaktivität gesperrt; die Einstellungen vorhandener Tresore bleiben erhalten. Sie können die Zeit in den Einstellungen ändern. KI-Aufgaben, die geheime Werte verwenden, können bei gesperrtem Tresor nicht fortgesetzt werden. Während die KI Anfragen stellt, wird die automatische Sperre bis zu 12 Stunden nach dem Entsperren des Tresors verlängert. Außerdem wird der Tresor innerhalb von 60 Minuten nach der letzten KI-Anfrage nicht automatisch gesperrt, selbst wenn Sie den Computer verlassen. So wird ein längerer Build nicht durch eine Sperre unterbrochen.

Beim Schließen des Fensters bleibt Bossanova im Infobereich geöffnet. Klicken Sie zum erneuten Öffnen auf das Bossanova-Symbol im Infobereich oder wählen Sie im Infobereichsmenü „Beenden“, um die App vollständig zu schließen. Wenn der Computer ausgeschaltet oder Bossanova beendet ist, kann die KI den lokalen Tresor nicht verwenden.

Wenn Sie die automatische Sperrung deaktivieren, sperren Sie den Tresor oder drücken Sie Ctrl/Cmd+L, bevor Sie Ihren Platz verlassen.

Start und Entsperren

Aktivieren Sie unter Einstellungen → Allgemein → Start und Entsperren die Option „Beim PC-Start öffnen“. Bossanova wird bei Ihrer nächsten Anmeldung geöffnet. Standardmäßig ist diese Option deaktiviert.

„Tresor nach der Computeranmeldung automatisch öffnen“ ist eine separate Einstellung. Lesen Sie den Hinweis und bestätigen Sie Ihr Master-Passwort, um ein Entsperrungskennzeichen im sicheren Speicher dieses Geräts zu hinterlegen. Wenn beide Einstellungen aktiviert sind, startet Bossanova bei der nächsten Computeranmeldung im Infobereich, ohne ein Fenster zu öffnen.

Das automatische Öffnen funktioniert einmal pro Anmeldung am Betriebssystem. Nach einer manuellen Sperre, dem Energiesparmodus, einer Bildschirmsperre oder dem Neustart der App ist Ihr Passwort erforderlich. Durch eine Passwortänderung oder das Zurücksetzen der Sicherheit wird das automatische Öffnen deaktiviert. Das Entsperrungskennzeichen für das Gerät wird nicht mit Backups übertragen.

Das automatische Öffnen erhöht das Risiko, dass Programme mit den Rechten Ihres Betriebssystembenutzers auf den Tresor zugreifen. Verwenden Sie diese Funktion nicht auf gemeinsam genutzten Computern. Bewahren Sie Ihr Master-Passwort und externe verschlüsselte Backups weiterhin auf.

Geräteübertragung und verschlüsselte Backups

Der Tresor befindet sich im App-Datenordner und sicheren Speicher Ihres Betriebssystembenutzers, nicht im Ordner neben der EXE-Datei. Wenn Sie nur die ausführbare Datei verschieben, wird der Tresor nicht mitverschoben. Geräte werden nicht automatisch synchronisiert.

Für den normalen Wechsel zwischen Geräten verwenden Sie die direkte Übertragung im selben WLAN/LAN. Tresor und Bilder werden verschlüsselt nur zwischen Ihren Geräten übertragen, ohne Bossanova-Server. Sie müssen keine Backupdatei auf einem USB-Stick transportieren. Bossanova (Windows) unterstützt verschlüsselte Übertragungen bis 2 GiB einschließlich der Bilder. Beide Geräte benötigen eine Version, die dieses Backupformat unterstützt.

Ein Gerät, das den Tresor erstmals empfängt, tritt demselben Tresor bei. Spätere Importe führen Änderungen an Ordnern, Gruppen und Daten zusammen. Nur wenn beide Geräte denselben Eintrag unterschiedlich geändert haben, wählen Sie die gewünschte Fassung. Es gibt keine automatische Synchronisierung: Starten Sie für jeden Austausch einen Import. KI-Verbindungen und Freigaben werden nicht übertragen.

Ein verschlüsseltes Backup ist eine separate Kopie zur Wiederherstellung nach einem Ausfall. Sie können es in der Desktop-App unter Einstellungen → Backup erstellen oder wiederherstellen. Bewahren Sie eine zusätzliche Kopie an einem sicheren Ort auf, der einen Festplattenausfall übersteht. Eine Wiederherstellung setzt den Stand auf den Zeitpunkt des Backups zurück. Sichern Sie vorher den aktuellen Stand und behalten Sie die Originale bis zur Prüfung der Wiederherstellung.

Wenn beschädigte oder fehlende Bilder das Öffnen des Tresors verhindern, wählen Sie auf dem Sperrbildschirm Aus Sicherung wiederherstellen. Wählen Sie eine intakte Sicherung desselben Tresors und geben Sie das aktuelle Master-Passwort sowie das Passwort der Sicherung ein; sie können unterschiedlich sein. Die App bewahrt das beschädigte Original und die übrigen verschlüsselten Dateien auf, kann verlorene Inhalte aber nicht neu erstellen. Der Sicherungsstand wird wiederhergestellt, das aktuelle Master-Passwort bleibt erhalten. Prüfen Sie danach KI-Verbindungen, Freigaben und die Weitergabe von Werten.

Automatische Backups sind Kopien, die auf diesem PC (im App-Datenordner) aufbewahrt werden, um versehentlich gelöschte Informationen wiederherzustellen. Exportieren Sie den Tresor nach einer Passwortänderung oder einer Sicherheitszurücksetzung erneut.

Stelle die Informationen aus dem Backup wieder her und ersetze damit spätere Ergänzungen und Änderungen. Vor der Wiederherstellung wird automatisch eine verschlüsselte Kopie des aktuellen Tresors auf diesem PC gespeichert. Der vorhandene Zugriffsverlauf bleibt erhalten; KI-Verbindungen und die Freigabe von Werten werden zurückgesetzt.

1. Verbinden Sie beide Geräte mit demselben normalen WLAN/LAN und melden Sie sich mit demselben Bossanova-Konto an. Öffnen Sie beide Apps und entsperren Sie vorhandene Tresore. Hat das empfangende Gerät noch keinen Tresor, beginnen Sie auf dem Startbildschirm mit „Von einem anderen Gerät importieren“.
2. Wählen Sie auf dem sendenden Gerät Einstellungen → Backup → „Diesen Tresor senden“. Der angezeigte Code gilt einmal und läuft nach 3 Minuten ab.
3. Wählen Sie auf dem empfangenden Gerät „Von einem anderen Gerät importieren“. Geben Sie den Code des Senders und das Hauptpasswort dieses Tresors ein. Die App findet den Sender im selben LAN automatisch.
4. Lassen Sie beide Apps bis zum Abschluss im Vordergrund und vorhandene Tresore entsperrt. Ein Wechsel in den Hintergrund oder das Sperren eines Tresors kann die Übertragung abbrechen. Prüfen Sie die importierten Daten und wählen Sie bei Konflikten die Fassungen, die erhalten bleiben sollen.

Die Geräteisolierung eines Gast-WLANs, ein VPN oder eine Firewall kann die Suche verhindern. Verwenden Sie auf beiden Geräten dasselbe normale WLAN, erlauben Sie den lokalen Netzwerkzugriff und versuchen Sie es erneut. Es gibt keinen automatischen Wechsel zu einer Internetvermittlung. Auch Löschungen und Fehler können auf andere Geräte übertragen werden; die Übertragung ersetzt deshalb kein separates Backup.

Sicherheit

Einstellungen → Sicherheit → Masterpasswort ändern — Eine normale Änderung ändert nur das Passwort, mit dem der Tresor entsperrt wird. Der interne Verschlüsselungsschlüssel und alte Backups bleiben unverändert. Wenn du eine Offenlegung vermutest, verwende „Reaktion auf Sicherheitsvorfall · Sicherheit zurücksetzen“.

Einstellungen → Sicherheit → Reaktion auf Sicherheitsvorfall · Sicherheit zurücksetzen — Schütze die aktuellen Informationen mit einem neuen Verschlüsselungsschlüssel und einem neuen Passwort. Felder und Werte bleiben erhalten; alle KI-Verbindungen, Zugriffe und Freigaben von Werten werden zurückgesetzt. Ein neuer Zugriffsverlauf beginnt; der bisherige Verlauf bleibt im Backup von vor der Änderung erhalten.

Ein verschlüsseltes Backup von vor der Änderung wird auf diesem PC aufbewahrt. Alte Backups lassen sich weiterhin mit ihrem alten Passwort öffnen und können den neuen Tresor nicht direkt überschreiben. Du kannst sie an einem separaten leeren Speicherort wiederherstellen.

Wenn du eine Infektion des PCs vermutest, handle zuerst auf einem vertrauenswürdigen Gerät. Nur das Passwort auf einem infizierten PC zu ändern, schützt dich nicht.

Bereits offengelegte frühere Inhalte können nicht zurückgeholt werden. Ändere oder widerrufe offengelegte Dienstpasswörter und API-Schlüssel bei den jeweiligen Diensten. Erstelle anschließend ein neues externes Backup.

Die endgültige Löschung erfordert das Master-Passwort und entfernt Tresor und interne Backups dieses PCs unwiderruflich. Externe Backups an anderen Orten bleiben erhalten.

Konten, Tarife und Geräte

Für alle Tarife einschließlich Free ist eine Anmeldung in der App erforderlich. Melden Sie sich mit Google, Apple oder Ihrer E-Mail-Adresse an und genehmigen Sie das angezeigte Gerät. Wenn Sie bereits angemeldet sind, können Sie den Verbindungsstatus unter Konto und Abonnement in den Einstellungen prüfen.

Wenn Sie bei Apple „Meine E-Mail-Adresse verbergen“ auswählen, kann dadurch ein separates Konto entstehen, das sich von Ihrem bestehenden Google- oder E-Mail-Konto unterscheidet. Um ein bestehendes Abonnement weiter zu verwenden, melden Sie sich mit der für dieses Konto verwendeten Methode an.

Das Eintragslimit des Tarifs gilt für neue Daten und die Bearbeitung bestehender Inhalte. KI-Abfragen und die Nutzung gespeicherter Daten unterliegen diesem Limit nicht. KI-Zugriff und die Freigabe als nicht geheim lassen sich auch bei schreibgeschützten Daten ein- und ausschalten. Die Freigabe erfordert Zustimmung; die Ausführung erfordert einen entsperrten Tresor, eine genehmigte Verbindung, ein aktives Gerät und eine Vorgangsgenehmigung.

Auch nach Ablauf Ihres Abonnements können Sie vorhandene Daten weiterhin anzeigen, durchsuchen, kopieren, sichern und wiederherstellen. Die zehn festen Basisfelder des kostenlosen Tarifs bleiben bearbeitbar; Zusatzfelder sind schreibgeschützt. Durch Umbenennen oder Neuordnen ändert sich diese Zuordnung nicht. Vorlagen erfordern Plus oder Pro.

Lösen Sie einen kostenlosen Pass in der App unter Einstellungen → Konto und Abonnement → Aktionscode oder im Codefeld Ihres Onlinekontos ein. Rabattcodes können Sie nach der Tarifauswahl im Paddle-Checkout eingeben.

Ein kostenloser Pass benötigt keine Karte und endet am angezeigten Datum ohne automatische Abbuchung. Pässe derselben Tarifstufe verlängern die verbleibende Laufzeit. Bei bezahltem Zugang oder einem Pass einer anderen Stufe warte bis zum Ablauf. Einen unvollständigen Zahlungsvorgang kannst du vorher auf der Kontoseite abbrechen.

Wende den Rabattcode an, wähle einen passenden Tarif und schließe die Zahlung bei Paddle ab. Du benötigst ein Zahlungsmittel; das Abonnement verlängert sich bis zur Kündigung. Prüfe Rabatt, Anzahl der rabattierten Zahlungen und den gesamten Jahrespreis. Danach gilt bei Verlängerungen der reguläre Preis. Unter Zahlungen verwalten kannst du Zahlungsmittel ändern, Belege ansehen und kündigen.

Melden Sie sich auf der Preisseite an, um Tarif oder Zahlungsintervall zu ändern. Nach Prüfung und Bestätigung der Beträge gilt die Änderung sofort. Kündigen können Sie über die Abonnementverwaltung. Während eines Passes können Sie Plus oder Pro wählen und ein Abonnement vormerken. Jetzt wird nichts abgebucht: Hinterlegen Sie eine Zahlungsmethode und bestätigen Sie den ersten Zahlungstermin und Verlängerungsbetrag. Der gewählte Tarif beginnt nach Ablauf des Passes und erfolgreicher erster Zahlung. Bei Stornierung bleibt die ursprüngliche Restlaufzeit erhalten. Stornieren Sie vor dem Hinzufügen eines weiteren Passes. Manche preisgebundenen Rabatte gelten nicht für Vormerkungen. In Regionen wie Südkorea, in denen eine zusätzliche Zustimmung erforderlich ist, bittet Paddle vor der ersten kostenpflichtigen Verlängerung um Bestätigung. Ohne Zustimmung wird die Reservierung ohne Abbuchung storniert.

Angemeldete Geräte zeigt die mit Ihrem Konto verbundenen Apps. Nur Geräte mit Bearbeitungsrecht für den Tresor zählen zum Tariflimit. Bearbeitung deaktivieren schaltet das Gerät bei der nächsten Kontoprüfung auf Nur-Lesen; Abmelden neben einem Gerät erfordert eine erneute Anmeldung. Tresordateien und Backups bleiben bei beiden Aktionen erhalten.

Durch das Abmelden wird Ihr Tresor gesperrt. Zur weiteren Verwendung müssen Sie sich erneut anmelden. Ihr ursprünglicher Tresor und Ihre Backups werden nicht gelöscht. Wenn Sie sich nicht anmelden können, verwenden Sie auf dem Anmeldebildschirm den Notfall-Backup-Export, um einmalig mit Ihrem Master-Passwort ein verschlüsseltes Backup zu exportieren. Wenn ein kostenpflichtiger Tarif während der Anmeldung abläuft, können Sie weiterhin zehn Basisfelder bearbeiten; zusätzliche Felder bleiben schreibgeschützt erhalten. Kostenpflichtige Funktionen sind bis zu sieben Tage offline gültig.

KI verbinden

Bossanova kann ohne KI verwendet werden. Nach der Verbindung übergibt die KI alle Aufgaben, für die ein Wert erforderlich ist, an Bossanova, ohne den Wert selbst zu erhalten. Wenn Sie für ein Datenelement den KI-Zugriff aktivieren, sieht die KI nur dessen Namen, Beschreibung und Gruppe, niemals den Wert. Sie entscheiden in einer Genehmigungskarte der App, wo ein Wert verwendet werden darf, wenn die KI ihn zum ersten Mal verwenden möchte.

Der Papierkorb oben rechts widerruft nur diese Genehmigung. Verbindungshilfe und manuelle Einrichtung dient zum Reparieren oder Hinzufügen einer nicht aufgeführten KI-App; im normalen Betrieb ist dort keine Änderung nötig.

1. Entsperren Sie Bossanova und aktivieren Sie Claude Desktop unter Einstellungen → KI → „AI auf diesem Computer finden“. Beenden und öffnen Sie Claude vollständig neu. Verbinden Sie normalen ChatGPT Chat separat über die Karte „ChatGPT“.
2. Verbinden Sie jede KI über ihren Schalter. Claude Desktop installiert bsnv auch für den lokalen Code-Tab: /mcp prüft die Verbindung, /bsnv zeigt die Anleitung. In Chat nutzen Sie + → Konnektoren; die Anleitung kommt über MCP. Nach einem Update werden die Skills bestehender Verbindungen beim Entsperren aktualisiert. Alle verbinden lässt natives Claude Code aus, um Duplikate zu vermeiden, schließt WSL aber ein.
3. Der Eintrag „Codex“ konfiguriert den Codex-Host. Allein damit wird normaler Chat nicht verbunden. Normaler Chat in App und Web verwendet den offiziellen OpenAI-Tunnel.
4. Öffnen Sie bei CLI-Hosts eine neue Unterhaltung und prüfen Sie, ob die Bossanova-Tools aufgelistet werden. Aktivieren Sie den KI-Zugriff für die benötigten Datenelemente und bitten Sie die KI anschließend wie gewohnt um die Aufgabe (zum Beispiel „Mit dem in Bossanova gespeicherten Bereitstellungstoken deployen“). Die KI wählt die Datenelemente anhand ihres Namens und ihrer Beschreibung aus.
5. Wenn die KI ein Datenelement zum ersten Mal verwenden möchte, erscheint in Bossanova eine Genehmigungskarte. Prüfen Sie das Datenelement und das Ziel (einen Dienst oder eine ausführbare Datei, einen Ordner, einen Variablennamen und einen Übermittlungsweg) und wählen Sie „Ablehnen“, „Nur dieses Mal“, „24 Stunden“, „7 Tage“, „30 Tage“ oder „Immer“. Nach der Genehmigung wird für dasselbe Ziel nicht erneut gefragt.

Die Projektsteuerung unterstützt normalen Chat in der ChatGPT-App und im Web sowie Claude Desktop. Claude Web wird nicht unterstützt. Tresorwerte und Projektzugriff erfordern getrennte Berechtigungen. Anmeldung und Verbindungseinwilligung erledigen Sie selbst. Fehlen Werkzeuge, aktualisieren Sie die Werkzeugliste oder beginnen Sie einen neuen Chat; alte Chats können eine frühere Verbindung behalten. OpenAI-Rechte, Verfügbarkeit und Freikontingente werden nicht garantiert. WSL- und Windows-Verbindungen sind getrennt.

So verwendet die KI einen Wert

Die KI erhält den Wert nie. Aufgaben, für die ein Wert erforderlich ist, erledigt Bossanova in Ihrem Namen auf eine von zwei Arten.

„In meinem Namen senden“: Die KI übergibt eine HTTPS-Anfrage (Methode, URL, Header und Body) mit einem Platzhalter an der Stelle, an der der Wert benötigt wird. Bossanova sendet die Anfrage selbst und setzt den Wert nur dort ein. Der Wert kommt weder im Code noch in der Anfrage oder Antwort der KI vor. Bei der ersten Verwendung eines Dienstes werden auf der Genehmigungskarte das Datenelement und die Hostgruppe des Dienstes angezeigt (bei bekannten Diensten wie GitHub werden die zugehörigen Hosts gemeinsam gruppiert). Für andere Pfade und Methoden desselben Dienstes wird nicht erneut gefragt. Nur HTTPS über Port 443 an öffentliche Adressen ist zulässig, Weiterleitungen werden nicht verfolgt und die Antwort wird an die KI zurückgegeben, nachdem darin enthaltene zurückgesendete Werte maskiert wurden. Diese Methode eignet sich für Geheimnisse, die an einen Server gesendet werden, etwa Bereitstellungstoken sowie Zahlungs-, Mail- oder Cloud-API-Schlüssel.

„In eine Ausführung einfügen“: Die KI gibt eine ausführbare Datei (absoluter Pfad; bei Skripten die Datei selbst), einen Arbeitsordner, die Argumente dieser Ausführung und einen Umgebungsvariablennamen an. Bei der ersten Verwendung erscheint die Genehmigungskarte. Nach der Genehmigung startet Bossanova das Programm selbst und übergibt den Wert ausschließlich über den auf der Karte angegebenen Übermittlungsweg. Die Argumente können bei jeder Ausführung frei geändert werden und sind nicht Teil der Genehmigung. Bei einer Änderung der ausführbaren Datei, des Ordners, des Variablennamens, des Übermittlungswegs oder des Skriptinhalts wird erneut gefragt. Es gibt vier Übermittlungswege: Umgebungsvariable (der unveränderte Wert), temporäre Datei (ihr Pfad wird in der Variable übergeben und die Datei nach der Ausführung gelöscht), Proxy (der Prozess erhält nur ein gefälschtes Token; der HTTPS-Proxy von Bossanova ersetzt es pro Ausführung nur bei Anfragen an die auf der Karte angegebenen Hosts durch den echten Wert) und SSH-Agent (der Schlüssel signiert ausschließlich innerhalb von Bossanova). Bei den Übermittlungswegen Proxy und Agent erhält der Prozess den Wert selbst nie (ein in einer Antwort zurückgesendeter Wert wird wieder in das gefälschte Token umgewandelt). Anders als bei „In meinem Namen senden“ sieht der Prozess Antworten zuerst. Beim SSH-Agent kann das Programm mit diesem Schlüssel eine Signatur für jeden Server anfordern; darauf weist die Genehmigungskarte hin.

Werte, die in einer App landen müssen, etwa für Build-Tools und Client-SDK-Schlüssel, gehören in eine Umgebungsvariable. Der Wert befindet sich dann innerhalb dieses Prozesses und kann im Programm, in seinen untergeordneten Prozessen und in deren Ausgaben verbleiben. Datenelemente, die bereits über „In meinem Namen senden“ an einen Dienst gebunden sind, können nicht über die Übermittlungswege Umgebungsvariable oder temporäre Datei in eine Ausführung eingefügt werden (damit Geheimnisse für Server nicht in von der KI geschriebenen Code gelangen). Eine aus .env importierte Gruppe kann als Ganzes eingefügt werden. Befehle, die nie enden, etwa ein Entwicklungsserver, werden als Sitzung ausgeführt, sodass die KI das laufende Protokoll lesen und das Beenden anfordern kann. Linux-Pfade in WSL werden innerhalb dieser Distribution ausgeführt. Eine Ausführung ist auf 24 Stunden begrenzt.

Die KI erhält den Exit-Code, die Dauer und das Ausführungsprotokoll mit maskiertem Wert zurück (Klartext sowie Base64- und URL-kodierte Formen werden maskiert und Zeichenfolgen entfernt, die wie Geheimnisse aussehen). Wenn der Befehl den Wert ausgegeben hat, wird das Protokoll der KI vorenthalten und nur der Grund zurückgegeben. Sie können das maskierte Protokoll unter „Letzte Ausführungen“ im KI-Tab lesen.

Für jedes Datenelement und jedes Ziel gibt es unabhängig davon, welche KI die Anfrage gestellt hat, genau eine Genehmigung (die anfragende KI wird nur im Zugriffsprotokoll erfasst). Die Zeiträume sind „Nur dieses Mal“, „24 Stunden“, „7 Tage“, „30 Tage“ und „Immer“. Genehmigungen können Sie in der Genehmigungsliste des KI-Tabs widerrufen. Durch den Widerruf wird weder eine bereits am Ziel eingetroffene Anfrage rückgängig gemacht noch ein Wert zurückgeholt, der bereits an ein laufendes Programm übergeben wurde.

Bilder wie Stempel und Unterschriften werden gespeichert, damit Sie sie anzeigen und kopieren können. Es gibt keine Funktion, mit der die KI sie automatisch verwendet. Ebenso gibt es keine Funktion, die Browserformulare ausfüllt oder Dokumente in Ihrem Namen fertigstellt.

Bei env und file erhält der genehmigte Prozess den echten Wert. Auch send, proxy und agent können Geheimnisse indirekt offenlegen, wenn diese im genehmigten Dienst gespeichert und später anders gelesen werden. Keine Geheimnisse in KI-lesbaren Dokumenten, Protokollen oder Nachrichten speichern. Betriebssystem, App und Ziel müssen vertrauenswürdig sein.

Wenn Sie den KI-Zugriff ausschalten, wird die Nutzung des Geheimnisses pausiert. Zeitlich erteilte Genehmigungen einschließlich Immer bleiben erhalten. Nach dem Einschalten gelten sie für neue Anfragen, sofern Wert und Ziel unverändert sind; der ursprüngliche Ablaufzeitpunkt bleibt bestehen. Frühere wartende Anfragen und einmalige Genehmigungen werden nicht fortgesetzt. Mit Genehmigung widerrufen heben Sie eine Genehmigung auf. Die Freigabe als nicht geheim ist eine separate Einstellung.

Als „Kein Geheimnis“ markieren

Einstellungen, die die KI unverändert lesen muss, etwa Portnummern, öffentliche URLs und Projekt-IDs, werden in der Detailansicht des Datenelements als „Kein Geheimnis“ markiert. Dies ist unabhängig vom KI-Zugriff und standardmäßig deaktiviert. Eine verbundene KI liest einen als „Kein Geheimnis“ markierten Wert direkt über ein eigenes Lesewerkzeug; auch später verbundene KIs können ihn lesen. Selbst wenn der KI-Zugriff deaktiviert ist, kann ein als „Kein Geheimnis“ markierter Wert über das Lesewerkzeug gelesen werden. Er erscheint lediglich nicht in den Listen für „In eine Ausführung einfügen“ und „In meinem Namen senden“. Auf dem Bildschirm werden solche Werte nicht maskiert: Text wird in der Liste und in der Detailansicht vollständig angezeigt, Bilder als kleine Vorschau in der Liste und als großes Bild in der Detailansicht.

In den Dialogen zum Hinzufügen und Bearbeiten wird ein als „Kein Geheimnis“ markierter Wert sofort angezeigt. Das Augensymbol bleibt sichtbar, ist aber ausgegraut und deaktiviert.

1. Öffnen Sie die Datendetails oder den Bearbeitungsdialog und aktivieren Sie „Kein Geheimnis“. Lesen Sie die Warnung, dass bereits an die KI gesendete Werte nicht zurückgeholt werden können, und wählen Sie dann »Ich habe verstanden, als „Kein Geheimnis“ markieren«. Diese Einstellung kann nicht in einer Listenzeile geändert werden. In Listen und Details wird das Augensymbol in einer Warnfarbe angezeigt.
2. Auch in der Vorschau des .env-Imports können Kandidaten auf dieselbe Weise markiert werden.
3. Das Ausschalten verhindert weitere Zugriffe, kann aber bereits an die KI gesendete Werte nicht zurückholen. Beim Erstellen oder Bearbeiten von Daten und Gruppen bleibt die Einstellung während der Eingabe aktiv und der Text sichtbar. Beim Speichern mit aktivierter Einstellung wird auch der geänderte Wert geteilt. Das Wiederherstellen einer Sicherung schaltet die Markierung aus.

Ein als „Kein Geheimnis“ markierter Wert kann an den ausgewählten KI-Dienst gelangen und kann nach dem Senden nicht mehr zurückgeholt werden. Markieren Sie Passwörter oder API-Schlüssel nicht auf diese Weise; verwenden Sie stattdessen „In meinem Namen senden“ oder „In eine Ausführung einfügen“.

Updates und Dateiprüfung

Aktivieren Sie unter Einstellungen → Allgemein → App-Updates die automatische Suche und den automatischen Download, oder suchen Sie manuell nach Updates. Während des Downloads können Sie den Tresor weiter verwenden. Ein bereitstehendes Update wird beim nächsten Start der App installiert. Alternativ können Sie nach Abschluss Ihrer Bearbeitung „Aktualisieren und neu starten“ wählen. Wenn signierte Updates noch nicht bereitstehen, prüfen Sie die offizielle Downloadseite.

Beim Aktualisieren wird der Tresor gesperrt und die App-Dateien werden ersetzt; gespeicherte Informationen bleiben erhalten. Führen Sie für ein manuelles Update das neue offizielle Installationsprogramm aus und verwenden Sie weiterhin den vorhandenen Installationsort. Bei einer signierten öffentlichen Veröffentlichung können Sie den Herausgeber unter „Digitale Signaturen“ in den Windows-Dateieigenschaften prüfen. Nicht signierte interne Testversionen sind keine signierten öffentlichen Veröffentlichungen. SHA-256 ist eine zusätzliche Integritätsprüfung.

Ab Bossanova 0.1.41 werden Sie unter Windows beim Deinstallieren abgemeldet. Wenn Sie den Tresor behalten, melden Sie sich nach der Neuinstallation mit demselben Konto an und öffnen ihn mit dem Master-Passwort. Bei der Deinstallation bleiben die Tresordaten standardmäßig erhalten. Wenn Sie im Windows-Deinstallationsprogramm die Datenlöschung auswählen, kann auch der Tresor gelöscht werden. Externe Backups sind davon unabhängig. Für einen neuen PC verwenden Sie Export und Import im selben WLAN. Auch externe Backups lassen sich wiederherstellen.

Updates werden im Hintergrund vorbereitet, ohne Tresorinhalte oder Kontodaten zu übertragen.

Get-FileHash .\Bossanova-Setup.exe -Algorithm SHA256

Löschen Sie den Tresordatenordner nicht. Wenn eine Signatur oder Prüfsumme nicht übereinstimmt, führen Sie die Datei nicht aus, sondern prüfen Sie die offizielle Veröffentlichung.

Fehlerbehebung

1. Wenn die App nicht geöffnet wird, prüfen Sie die Windows-Version, die x64-Unterstützung und Hinweise zu WebView2. Prüfen Sie den Veröffentlichungsstatus und die Datei auf der offiziellen Downloadseite, bevor Sie auf Sicherheitswarnungen reagieren.
2. Wenn die Suche leer bleibt, prüfen Sie den Sperrstatus und den Suchbegriff. Wenn das Hinzufügen von Daten oder der Import von .env blockiert ist, prüfen Sie das Datenlimit Ihres Tarifs (10 bei Free) und den Abonnementstatus.
3. Wenn KI-Tools fehlen, prüfen Sie unter Einstellungen → KI, ob der Verbindungsschalter dieser KI aktiviert ist, und öffnen Sie eine neue Unterhaltung. KIs in WSL und unter Windows werden getrennt aufgeführt. Verbinden Sie daher die tatsächlich verwendete Version. Die Claude-App und die ChatGPT-App müssen nach dem Verbinden neu gestartet werden, bevor die Tools angezeigt werden.
4. Das Einschalten einer Verbindung unter Einstellungen → AI erteilt die Verbindungsberechtigung. Eine zweite Freigabekarte entfällt; Freigaben für die Datennutzung bleiben getrennt. Alte ausstehende oder abgelehnte Verbindungen müssen ausdrücklich eingeschaltet werden. Prüfen Sie bei DENIED die Felder reason, detail und connection. Erneutes Verbinden erteilt keine Berechtigung.
5. Wenn die KI meldet, dass sie das Ausführungsprotokoll nicht erhalten hat, hat der Befehl den Wert ausgegeben. Lesen Sie das maskierte Protokoll unter „Letzte Ausführungen“ im KI-Tab und ändern Sie den Befehl so, dass er den Wert nicht ausgibt.
6. Windows curl mit Schannel ignoriert SSL_CERT_FILE. Übergeben Sie dessen Pfad im genehmigten Prozess mit --cacert. --ssl-revoke-best-effort nur bei fehlenden/offline Sperrlisten, niemals --insecure. Für Windows gh kommt WSL infrage. AWS-Signaturen brauchen einen passenden Transportweg wie env oder file. Bei docker login kann der Prozess die Datei des file-Transportwegs an --password-stdin übergeben. Temporäres DOCKER_CONFIG danach löschen.
7. Wenn das Problem weiterhin besteht, senden Sie den Fehlertext, das Betriebssystem, die App-Version und die Schritte zur Reproduktion an den Support. Senden Sie keine Passwörter, Tresordateien, geheimen Werte oder Verbindungstoken.

Bossanova kontrolliert weder das Betriebssystem noch andere Programme. Weitreichende KI-Berechtigungen für Administrationsfunktionen, Dateien, Bildschirme oder den Speicher sowie ein kompromittierter Computer können Informationen über andere Wege offenlegen. Einzelheiten finden Sie im Hinweis zum Schutz geheimer Daten.