Bossanova

Beginnen

Bossanova is een digitale kluis waarin tekst en afbeeldingen versleuteld op je computer worden opgeslagen. Je moet bij de app inloggen, ook met een gratis account. Inloggen bij je account staat los van het hoofdwachtwoord waarmee je je kluis opent.

Als Google meldt dat het account al op je apparaat bestaat, ga dan terug en kies “Doorgaan met e-mail” met hetzelfde Google-e-mailadres. Als je al met dat e-mailadres bij Bossanova bent geregistreerd, log je zo in op je bestaande account. Je kunt ook een andere browser proberen.

Het huidige installatiebestand is voor Windows 10/11 x64. Er zijn geen installatiebestanden voor 32-bits Windows of native ARM64. Voor installatie of updates van WebView2 kan een internetverbinding nodig zijn.

Download het installatieprogramma voor je besturingssysteem op de downloadpagina en installeer het.
Voltooi de installatie en open Bossanova via het menu Start. Windows 10/11 x64 wordt ondersteund. Als WebView2 ontbreekt, installeert het installatieprogramma dit. Neem contact op met je beheerder als de installatie op een werkcomputer wordt geblokkeerd.
Registreer je op het inlogscherm van de app of log in met Google, Apple of e-mail, en keur dit apparaat goed. Met een gratis account kun je tien data-items opslaan.
Maak op het eerste scherm een kluis met een lang hoofdwachtwoord en bewaar dit veilig. Kies voor een bestaande kluis eerst importeren vanaf een ander apparaat. Back-upbestanden gebruiken de aparte herstelfunctie.
Sla eerst een onschadelijk voorbeeld op. Probeer het te zoeken, te bekijken en te kopiëren. Voeg daarna echte informatie toe en maak een externe back-up.

De ontwikkelaar kan een vergeten hoofdwachtwoord niet herstellen. Inloggen met Google, Apple of e-mail kan het hoofdwachtwoord niet opnieuw instellen.

Data opslaan en ordenen

Een Bossanova-kluis is georganiseerd als mappen → groepen → data-items. Een data-item is één naam met één waarde (tekst of afbeelding); een groep bundelt verwante data-items. Een map bevat groepen en data-items zonder groep, en de kluis is de verzameling mappen. Zo kan een map ‘API-sleutels’ een groep ‘bossanova’ bevatten met ‘OpenAI API-sleutel’ en ‘Verlengingsdatum’. Elk tekst- of afbeeldingsdata-item telt als één.

Mappen organiseren groepen en gegevensitems. Sleep de handvatten om de volgorde te wijzigen. Bij het verwijderen van een map kun je kiezen of je de inhoud wilt behouden of verwijderen.

Schakel AI-toegang met de ster in of uit. De naam verschijnt bij aanwijzen; een lichtgroene achtergrond betekent ingeschakeld; de ster blijft een omtrek. De knop is gelijk in lijsten, details en formulieren voor gegevens en groepen. Alle gegevens en mappen delen de sortering: standaard, nieuwste, oudste, meest gebruikt, minst gebruikt, naam A–Z en Z–A. De laatste keuze wordt in de kluis opgeslagen voor de volgende start. Namen volgen de schermtaal, met 2 vóór 10. Kies standaard om items binnen een map te verslepen; andere sorteringen bewaren de handmatige volgorde.

Onder Instellingen → AI → AI-toegang staat de standaardtoegang voor nieuwe gegevens uit. Deze geldt voor nieuwe tekst en afbeeldingen, gegevens toegevoegd bij het maken of bewerken van groepen, sjablonen en .env-imports. Elk AI-pictogram blijft vóór opslaan aanpasbaar. Bestaande gegevens, niet-geheime deling en uitvoeringsgoedkeuringen veranderen niet. De keuze wordt in deze kluis opgeslagen.

Maak mappen via ‘Mappen toevoegen en beheren’ in het linkermenu en sleep de handgrepen om ze opnieuw te ordenen.
Gebruik ‘Data toevoegen’ om een naam, type (tekst of afbeelding; oudere items behouden hun type wachtwoord, getal of datum) en waarde in te voeren. Zonder groep staat het data-item rechtstreeks in de map. Afbeeldingen (PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, TGA, PNM, QOI, HDR, maximaal 10MiB) kun je erin slepen of plakken. Als je op een data-item klikt, wordt de detailweergave geopend. Met ‘Bewerken’ open je het bewerkingsvenster waarin de opgeslagen waarde al is ingevuld (gebruik ‘Waarde tonen’ om die te controleren).
Sleep een data-item op een ander data-item om een groep te maken, en sleep een groep op een andere groep om ze samen te voegen. Met de handgrepen kun je alles opnieuw ordenen.
Gebruik de actie voor bekijken of kopiëren van een data-item wanneer je de waarde nodig hebt. De app of het document waarin je plakt kan geplakte waarden zien, dus controleer waar je ze plakt.
Plus en Pro bevatten sjablonen voor veelgebruikte groepen. Je moet de werkelijke waarden nog steeds zelf invoeren.

Zet geheimen alleen in waardevelden. Namen en beschrijvingen van data-items en namen van groepen en mappen kunnen, afhankelijk van je instellingen, met AI worden gedeeld.

Een .env-bestand importeren

Je kunt de geheimen uit het .env-bestand van een project in één stap naar de kluis verplaatsen. Klik linksonder in het venster ‘Nieuwe groep’ op ‘.env importeren’, of sleep het bestand naar de kluispagina. Eén bestand wordt één groep en elke variabele wordt één data-item met de naam van de variabele. Gegevens blijven geheim; AI-toegang volgt de standaard voor nieuwe gegevens.

De voorbeeldweergave toont alleen variabelenamen; waarden verschijnen nooit op het scherm. Kies een groepsnaam (bijvoorbeeld web .env) en controleer de lijst.
Waarden die waarschijnlijk geen geheim zijn, zoals poorten of openbare URL’s, worden gemarkeerd als kandidaten voor ‘Geen geheim’. Alles is standaard een geheim; alleen items die je zelf selecteert, worden na bevestiging van een waarschuwing als ‘Geen geheim’ gemarkeerd.
Als je via de bestandskiezer hebt geïmporteerd, kun je ervoor kiezen het oorspronkelijke .env-bestand te verwijderen. Bestanden die je hebt gesleept worden niet verwijderd.
De import wordt in één keer opgeslagen. Als daarmee de datalimiet van je abonnement zou worden overschreden, wordt niets opgeslagen en verschijnt er een upgradebericht; bestaande informatie blijft onaangeroerd.

AI kan een geïmporteerde groep als geheel gebruiken in ‘In een run injecteren’: elk item in de groep waarvoor AI-toegang is ingeschakeld, wordt als omgevingsvariabele met de naam van het item geïnjecteerd. Een .env-bestand dat in het project blijft staan, kan door AI worden gelezen. Ruim het daarom op zodra de inhoud in de kluis staat.

Informatie zoeken

Typ een naam of trefwoord in het zoekvak terwijl de kluis ontgrendeld is. De resultaten worden al bijgewerkt voordat je op Enter drukt. Begin met een kort deel van de naam; exacte overeenkomsten krijgen voorrang op gedeeltelijke en vergelijkbare overeenkomsten.

Zoeken gebeurt lokaal met algoritmen, zonder je zoekopdracht naar AI of de accountserver te sturen. Standaard worden namen en beschrijvingen doorzocht. Schakel de optie in om ook de inhoud van waarden te doorzoeken, zodat tekstwaarden worden meegenomen; overeenkomende geheime waarden verschijnen niet in de resultaatweergave. Afbeeldingen worden niet met OCR doorzocht. Selecteer een resultaat en bekijk of kopieer vervolgens het veld dat je nodig hebt.

Als niets overeenkomt, maak je de zoekopdracht korter of pas je de spatiëring aan. Wis de zoekopdracht om terug te keren naar de volledige lijst. Zoeken is niet beschikbaar zolang de kluis vergrendeld is.

Taal

Instellingen → Algemeen → Taal — De taal die op het scherm wordt gebruikt. De wijziging wordt meteen toegepast en in deze kluis opgeslagen. Het vergrendelscherm gebruikt de taal van je computer.

Vergrendelen en afsluiten

Vergrendel je kluis wanneer je je computer verlaat. Nieuwe kluizen worden standaard na vijf minuten inactiviteit vergrendeld; bestaande instellingen blijven behouden. Je kunt de tijd wijzigen in Instellingen. AI-taken die geheime waarden gebruiken, kunnen niet doorgaan zolang de kluis vergrendeld is. Terwijl AI verzoeken uitvoert, wordt automatisch vergrendelen tot twaalf uur na het ontgrendelen van de kluis uitgesteld. Ook binnen 60 minuten na het laatste AI-verzoek wordt de kluis niet automatisch vergrendeld, zelfs niet als je weggaat. Zo wordt een lange build niet door een vergrendeling onderbroken.

Als je het venster sluit, blijft Bossanova actief in het systeemvak. Klik op het pictogram in het systeemvak om de app opnieuw te openen, of kies ‘Afsluiten’ in het systeemvakmenu om de app volledig af te sluiten. AI kan de lokale kluis niet gebruiken wanneer de computer is uitgeschakeld of Bossanova is afgesloten.

Als je automatisch vergrendelen uitschakelt, vergrendel dan de kluis of druk op Ctrl/Cmd+L voordat je je werkplek verlaat.

Opstarten en ontgrendelen

Schakel in Instellingen → Algemeen → Opstarten en ontgrendelen de optie ‘Starten wanneer je je aanmeldt bij de computer’ in. Bossanova wordt dan geopend wanneer je je de volgende keer aanmeldt. Deze optie is standaard uitgeschakeld.

De kluis automatisch openen na het inloggen bij de computer is een aparte instelling. Lees de melding en bevestig je hoofdwachtwoord om een ontgrendelingsgegeven op te slaan in de beveiligde opslag van dit apparaat. Als beide instellingen zijn ingeschakeld, start Bossanova bij de volgende computeraanmelding in het systeemvak zonder een venster te openen.

Automatisch openen werkt één keer per OS-aanmelding. Na handmatig vergrendelen, slaapstand, schermvergrendeling en het opnieuw starten van de app is je wachtwoord nodig. Als je het wachtwoord wijzigt of de beveiliging opnieuw instelt, wordt automatisch openen uitgeschakeld. Back-ups nemen het ontgrendelingsgegeven van het apparaat niet over.

Automatisch openen vergroot het risico dat programma’s die onder jouw OS-gebruikersaccount draaien toegang krijgen. Gebruik dit niet op gedeelde computers. Bewaar je hoofdwachtwoord en externe versleutelde back-ups.

Overdracht tussen apparaten en versleutelde back-ups

De kluis gebruikt de appgegevensmap en beveiligde opslag van je OS-gebruiker, niet de map naast het EXE-bestand. Als je het uitvoerbare bestand verplaatst, wordt je kluis niet verplaatst. Apparaten worden niet automatisch gesynchroniseerd.

Gebruik voor gewone overdracht tussen apparaten de directe verbinding op hetzelfde wifi-/LAN-netwerk. De kluis en afbeeldingen worden versleuteld en gaan alleen tussen je apparaten, zonder Bossanova-servers. Je hoeft geen back-upbestand op een USB-stick mee te nemen. Bossanova (Windows) ondersteunt versleutelde overdrachten tot 2 GiB, inclusief afbeeldingen. Beide apparaten hebben een versie nodig die dit back-upformaat ondersteunt.

Een apparaat dat de kluis voor het eerst ontvangt, neemt deel aan dezelfde kluis. Latere imports voegen wijzigingen aan mappen, groepen en gegevens samen. Je kiest alleen welke versie blijft als beide apparaten hetzelfde onderdeel verschillend hebben gewijzigd. Dit is geen automatische synchronisatie: start een import telkens wanneer je wijzigingen wilt uitwisselen. AI-verbindingen en goedkeuringen worden niet overgedragen.

Een versleutelde back-up is een aparte kopie voor herstel na een storing of gegevensverlies. Maak of herstel deze in de desktopapp via Instellingen → Back-up. Bewaar een aparte kopie op een veilige plek die een schijfstoring overleeft. Herstellen zet de gegevens terug naar het moment van de back-up: maak eerst een back-up van de huidige toestand en bewaar de originelen totdat je het herstel hebt gecontroleerd.

Als beschadigde of ontbrekende afbeeldingen voorkomen dat de kluis opent, kies dan Herstellen vanuit back-up op het vergrendelscherm. Selecteer een intacte back-up van dezelfde kluis en voer het huidige hoofdwachtwoord en het wachtwoord van de back-up in; deze kunnen verschillen. De app bewaart het beschadigde origineel en de resterende versleutelde bestanden, maar kan verloren inhoud niet reconstrueren. De inhoud van de back-up wordt hersteld en het huidige hoofdwachtwoord blijft behouden. Controleer daarna de AI-verbindingen, goedkeuringen en het delen van waarden.

Automatische back-ups zijn kopieën op deze pc (in de app-gegevensmap) waarmee je per ongeluk verwijderde gegevens kunt herstellen. Exporteer de kluis opnieuw nadat je het wachtwoord hebt gewijzigd of een beveiligingsreset hebt uitgevoerd.

Zet de informatie uit de back-up terug; latere toevoegingen en wijzigingen worden vervangen. Voordat de informatie wordt teruggezet, wordt automatisch een versleutelde kopie van de huidige kluis op deze pc opgeslagen. Bestaande toegangsgeschiedenis blijft behouden; AI-verbindingen en het delen van waarden worden opnieuw ingesteld.

Verbind beide apparaten met hetzelfde gewone wifi-/LAN-netwerk en meld je aan met hetzelfde Bossanova-account. Open beide apps en ontgrendel bestaande kluizen. Heeft het ontvangende apparaat nog geen kluis, begin dan met ‘Importeren vanaf een ander apparaat’ op het eerste scherm.
Kies op het verzendende apparaat Instellingen → Back-up → ‘Deze kluis verzenden’. De getoonde code werkt één keer en verloopt na 3 minuten.
Kies op het ontvangende apparaat ‘Importeren vanaf een ander apparaat’ en voer de code van de verzender en het hoofdwachtwoord van die kluis in. De app vindt de verzender automatisch op hetzelfde LAN.
Houd beide apps zichtbaar en bestaande kluizen ontgrendeld totdat de overdracht is voltooid. Een app naar de achtergrond verplaatsen of een kluis vergrendelen kan de overdracht annuleren. Controleer de geïmporteerde gegevens en kies bij conflicten welke versies je wilt bewaren.

Apparaatisolatie op een gastnetwerk, een VPN of een firewall kan het vinden van het andere apparaat verhinderen. Gebruik op beide apparaten hetzelfde gewone wifi-netwerk, sta toegang tot het lokale netwerk toe en probeer opnieuw. Er is geen automatische terugval op een internetrelay. Ook verwijderingen en fouten kunnen worden overgenomen; overdracht vervangt daarom geen aparte back-up.

Beveiliging

Instellingen → Beveiliging → Hoofdwachtwoord wijzigen — Een gewone wijziging verandert alleen het wachtwoord waarmee de kluis wordt ontgrendeld. De interne versleutelingssleutel en oude back-ups blijven ongewijzigd. Als je vermoedt dat informatie is gelekt, gebruik je “Incidentrespons · Beveiliging opnieuw instellen”.

Instellingen → Beveiliging → Incidentrespons · Beveiliging opnieuw instellen — Beveilig de huidige informatie met een nieuwe versleutelingssleutel en een nieuw wachtwoord. Velden en waarden blijven behouden; alle AI-verbindingen, AI-toegang en het delen van waarden worden opnieuw ingesteld. Er wordt een nieuwe toegangsgeschiedenis gestart; de oude geschiedenis blijft in de back-up van vóór de wijziging staan.

Een versleutelde back-up van vóór de wijziging wordt op deze pc bewaard. Oude back-ups kunnen nog steeds met hun oude wachtwoord worden geopend en kunnen de nieuwe kluis niet rechtstreeks overschrijven. Zet ze afzonderlijk terug op een lege locatie.

Als je vermoedt dat de pc besmet is, handel dan eerst op een vertrouwd apparaat. Alleen het wachtwoord op een besmette pc wijzigen biedt geen bescherming.

Eerder gelekte informatie kan niet worden teruggehaald. Wijzig of trek blootgestelde servicewachtwoorden en API-sleutels in bij de betreffende services. Maak daarna een nieuwe externe back-up.

Definitief verwijderen vereist het hoofdwachtwoord en wist de kluis en interne back-ups van deze pc onherroepelijk. Externe back-ups op andere locaties blijven bestaan.

Accounts, abonnementen en apparaten

Voor alle abonnementen, ook Free, moet je inloggen bij de app. Log in met Google, Apple of e-mail en keur het weergegeven apparaat goed. Als je al bent ingelogd, kun je de verbindingsstatus controleren bij Account en abonnement in Instellingen.

Als je bij Apple ‘Verberg mijn e-mailadres’ kiest, kan er een ander account worden aangemaakt dan het account dat je al met Google of e-mail gebruikt. Log in met de methode die je voor dat account hebt gebruikt als je een bestaand abonnement wilt blijven gebruiken.

De itemlimiet van het abonnement geldt voor het toevoegen en bewerken van gegevens. Het opvragen en gebruiken van opgeslagen gegevens door AI heeft deze limiet niet. AI-toegang en delen als niet-geheim kunnen ook voor alleen-lezen gegevens worden in- en uitgeschakeld. Delen vereist toestemming; uitvoering vereist een ontgrendelde kluis, een goedgekeurde verbinding, een actief apparaat en toestemming voor de bewerking.

Ook na afloop van je abonnement kun je bestaande informatie blijven bekijken, zoeken, kopiëren, er back-ups van maken en deze herstellen. De tien vaste gratis basisvelden blijven bewerkbaar; extra velden zijn alleen-lezen. Door namen of volgorde te wijzigen verandert deze indeling niet. Voor sjablonen heb je Plus of Pro nodig.

Activeer een gratis pas in de app via Instellingen → Account en abonnement → Promotiecode, of via het codeveld op je accountpagina. Voer kortingscodes in bij Paddle nadat je een abonnement hebt gekozen.

Een gratis pas vereist geen kaart en eindigt op de aangegeven datum, zonder automatische afschrijving. Passen voor hetzelfde niveau verlengen de resterende periode. Heb je betaalde toegang of een pas voor een ander niveau, wacht dan tot die afloopt. Annuleer een onvoltooide, onbetaalde bestelling op je accountpagina voordat je een pas gebruikt.

Pas een kortingscode toe, kies een geschikt abonnement en rond de betaling af via Paddle. Een betaalmethode is vereist en het abonnement wordt verlengd totdat je opzegt. Controleer de korting, het aantal betalingen met korting en de volledige jaarprijs. Daarna geldt bij verlenging de normale prijs. Via Betalingen beheren kun je betaalmethoden wijzigen, bonnen bekijken en opzeggen.

Log in op de prijspagina om je abonnement of betaalinterval te wijzigen. Na bevestiging van de bedragen gaat de wijziging direct in. Opzeggen kan via abonnementsbeheer. Kies tijdens een pas Plus of Pro om een abonnement te reserveren. Er wordt nu niets afgeschreven: registreer een betaalmethode en bevestig de eerste betaaldatum en het verlengingsbedrag. Het gekozen abonnement begint na afloop van de pas en de eerste geslaagde betaling. Annulering behoudt de resterende looptijd van de oorspronkelijke pas. Annuleer voordat u een nieuwe pas toevoegt. Sommige prijsgebonden kortingen gelden niet voor reserveringen. In regio’s zoals Zuid-Korea waar aanvullende toestemming nodig is, vraagt Paddle om bevestiging vóór de eerste betaalde verlenging. Zonder toestemming wordt de reservering geannuleerd zonder kosten.

Ingelogde apparaten toont de apps die aan je account zijn gekoppeld. Alleen apparaten waarop je de kluis kunt bewerken tellen mee voor je limiet. Bewerken uitschakelen maakt het apparaat alleen-lezen bij de volgende accountcontrole; Uitloggen naast een apparaat vereist opnieuw inloggen. Geen van beide acties verwijdert kluisbestanden of back-ups.

Abonnement	Data-items	Verbonden apparaten
Free	10	1
Plus	100	2
Pro	Onbeperkt	5

Als je uitlogt, wordt je kluis vergrendeld; log opnieuw in om deze te gebruiken. Je oorspronkelijke kluis en back-ups worden niet verwijderd. Als je niet kunt inloggen, gebruik je op het inlogscherm ‘Noodexport van back-up’ om één keer met je hoofdwachtwoord een versleutelde back-up te exporteren. Terwijl je ingelogd bent, kun je met een verlopen betaald abonnement nog steeds tien basisdata-items bewerken; extra data-items blijven alleen-lezen. Betaalfuncties werken maximaal zeven dagen offline.

AI verbinden

AI is optioneel. Zodra AI is verbonden, geeft AI al het werk waarvoor een waarde nodig is uit handen aan Bossanova zonder de waarde ooit te ontvangen. Als je ‘AI-toegang’ inschakelt voor een data-item, ziet AI alleen de naam, beschrijving en groep, nooit de waarde. Jij bepaalt waar een waarde mag worden gebruikt via een goedkeuringskaart in de app, wanneer AI de waarde voor het eerst probeert te gebruiken.

De prullenbak rechtsboven trekt alleen die toestemming in. Verbindingshulp en handmatig toevoegen is voor herstel of een niet-vermelde AI-app; bij normaal gebruik is daar geen wijziging nodig.

Ontgrendel Bossanova en schakel Claude Desktop in bij Instellingen → AI → «AI zoeken op deze computer». Sluit Claude volledig en open het opnieuw. Verbind gewone ChatGPT Chat apart via de kaart «ChatGPT».
Verbind elke AI met de schakelaar. Claude Desktop installeert ook bsnv voor het lokale Code-tabblad: /mcp controleert de verbinding en /bsnv geeft uitleg. Gebruik in Chat + → Connectors; de uitleg wordt via MCP doorgegeven. Na een update worden skills van bestaande verbindingen bijgewerkt wanneer je Bossanova ontgrendelt. Alles verbinden slaat native Claude Code over om duplicaten te voorkomen, maar neemt WSL wel mee.
De rij «Codex» configureert de Codex-host. Alleen die instelling verbindt gewone Chat niet. Gewone Chat in de app en op het web gebruikt de officiële OpenAI-tunnel.
Open voor CLI-hosts een nieuw gesprek en controleer of de Bossanova-tools worden weergegeven. Schakel ‘AI-toegang’ in voor de data-items die je wilt gebruiken en vraag AI vervolgens zoals gewoonlijk om het werk uit te voeren (bijvoorbeeld: ‘Implementeer met het deploytoken dat in Bossanova is opgeslagen’). AI kiest data-items op basis van naam en beschrijving.
De eerste keer dat AI een data-item probeert te gebruiken, verschijnt er in Bossanova een goedkeuringskaart. Controleer de data en het doel (een service, of een uitvoerbaar bestand, map, variabelenaam en drager) en kies ‘Weigeren’, ‘Alleen deze keer’, ‘24 uur’, ‘7 dagen’, ‘30 dagen’ of ‘Altijd’. Na goedkeuring wordt niet opnieuw naar hetzelfde doel gevraagd.

Projectbediening ondersteunt gewone Chat in de ChatGPT-app en op het web, en Claude Desktop. Claude web wordt niet ondersteund. Kluisgegevens gebruiken en projecten benaderen vereisen aparte toestemming. Meld u zelf aan en geef zelf toestemming voor de verbinding. Ontbreken tools, vernieuw de lijst of begin een nieuw gesprek; oude gesprekken kunnen een eerdere verbinding vasthouden. OpenAI-rechten, beschikbaarheid en gratis quota worden niet gegarandeerd. WSL- en Windows-verbindingen zijn gescheiden.

Hoe AI een waarde gebruikt

AI ontvangt de waarde nooit. Werk waarvoor een waarde nodig is, wordt namens AI door Bossanova uitgevoerd op een van twee manieren.

‘Namens mij verzenden’: AI levert een HTTPS-verzoek (methode, URL, headers, body) aan met een plaatsaanduiding op de plek waar de waarde komt. Bossanova verstuurt het verzoek zelf en voegt de waarde alleen daar in. De waarde staat nooit in de code, het verzoek of het antwoord van AI. De eerste keer dat een service wordt gebruikt, vermeldt de goedkeuringskaart de data en de hostgroep van de service (bekende services zoals GitHub groeperen hun hosts); naar andere paden en methoden van dezelfde service wordt niet opnieuw gevraagd. Alleen https via poort 443 naar openbare adressen is toegestaan, omleidingen worden niet gevolgd en het antwoord wordt aan AI teruggegeven met teruggestuurde waarden afgeschermd. Dit is de juiste manier voor geheimen die naar een server worden verzonden, zoals deploytokens en betaal-, mail- of cloud-API-sleutels.

‘In een run injecteren’: AI geeft een uitvoerbaar bestand op (absoluut pad; scripts via hun bestand), een werkmap, de argumenten voor deze run en een naam van een omgevingsvariabele. Bij het eerste gebruik verschijnt de goedkeuringskaart. Na goedkeuring start Bossanova het programma zelf en geeft het de waarde alleen door via de drager die op de kaart staat. Argumenten mogen per run verschillen en maken geen deel uit van de goedkeuring; bij een gewijzigd uitvoerbaar bestand, een gewijzigde map, variabelenaam, drager of scriptinhoud wordt opnieuw om goedkeuring gevraagd. Er zijn vier dragers: omgevingsvariabele (de waarde ongewijzigd), tijdelijk bestand (het pad staat in de variabele en het bestand wordt na de run verwijderd), proxy (het proces krijgt alleen een neptoken; de HTTPS-proxy van Bossanova vervangt dit per run alleen in verzoeken naar de hosts op de kaart door de echte waarde) en SSH-agent (de sleutel ondertekent alleen binnen Bossanova). Met de proxy- en agentdrager ontvangt het proces de waarde zelf nooit (een waarde die in een antwoord wordt teruggestuurd, wordt weer in het neptoken veranderd). In tegenstelling tot ‘Namens mij verzenden’ ziet het proces antwoorden eerst. Met de SSH-agent kan het programma bovendien elke server met die sleutel laten ondertekenen; de goedkeuringskaart vermeldt dit.

Waarden die in een app terecht moeten komen, zoals sleutels voor buildtools en client-SDK’s, horen bij de drager omgevingsvariabele. De waarde bevindt zich dan in dat proces en kan in het programma, de onderliggende processen en de uitvoer ervan achterblijven. Data die via ‘Namens mij verzenden’ al aan een service is gekoppeld, kan niet via de dragers omgevingsvariabele of tijdelijk bestand in een run worden geïnjecteerd (zodat geheimen van servers nooit in door AI geschreven code terechtkomen). Een uit .env geïmporteerde groep kan als geheel worden geïnjecteerd. Commando’s die nooit eindigen, zoals een ontwikkelserver, worden als sessie uitgevoerd, zodat AI het lopende log kan lezen en kan vragen om de sessie te stoppen. Linux-paden in WSL worden binnen die distributie uitgevoerd. Een run duurt maximaal 24 uur.

AI ontvangt de afsluitcode, de duur en het uitvoeringslog met afgeschermde waarde (platte tekst, base64 en URL-gecodeerde vormen worden afgeschermd en tekenreeksen die op geheimen lijken, worden verwijderd). Als het commando de waarde heeft afgedrukt, wordt het log niet aan AI gegeven en wordt alleen de reden teruggestuurd. Je kunt het afgeschermde log bekijken bij ‘Recente uitvoeringen’ op het tabblad AI.

Er is één goedkeuring per data-item en doel, ongeacht welke AI erom heeft gevraagd (de aanvragende AI wordt alleen in het toegangslog vastgelegd). De perioden zijn ‘Alleen deze keer’, ‘24 uur’, ‘7 dagen’, ‘30 dagen’ en ‘Altijd’. Je kunt goedkeuringen intrekken in de goedkeuringslijst op het tabblad AI. Intrekken maakt een verzoek dat de bestemming al heeft bereikt, of een waarde die al aan een actief programma is doorgegeven, niet ongedaan.

Afbeeldingen zoals stempels en handtekeningen worden opgeslagen zodat je ze kunt bekijken en kopiëren; er is geen functie waarmee AI ze automatisch kan gebruiken. Er is ook geen functie die browserformulieren invult of namens jou documenten voltooit.

Bij env of file krijgt het goedgekeurde proces de echte waarde. Ook send, proxy en agent kunnen een geheim indirect blootleggen als het in een goedgekeurde dienst wordt opgeslagen en later anders wordt gelezen. Bewaar geen geheimen in voor AI leesbare documenten, logs of berichten. Het systeem, de app en de bestemming moeten betrouwbaar zijn.

Als u AI-toegang uitschakelt, wordt het gebruik van het geheim gepauzeerd. Goedkeuringen voor een bepaalde duur, inclusief Altijd, blijven behouden. Na inschakelen kunnen nieuwe verzoeken ze gebruiken als de waarde en bestemming ongewijzigd zijn; de oorspronkelijke vervaltijd blijft gelden. Eerdere wachtende verzoeken en eenmalige goedkeuringen worden niet hervat. Kies Goedkeuring intrekken om een goedkeuring te annuleren. Delen als niet-geheim is een aparte instelling.

Updates en bestandscontrole

Schakel in Instellingen → Algemeen → App-updates automatisch controleren en downloaden in, of controleer handmatig. Je kunt de kluis tijdens het downloaden blijven gebruiken. Een beschikbare update wordt geïnstalleerd wanneer je de app de volgende keer opent. Je kunt ook na het voltooien van je bewerkingen kiezen voor ‘Bijwerken en herstarten’. Als ondertekende updates nog niet klaar zijn, controleer je de officiële downloadpagina.

Bij het bijwerken wordt je kluis vergrendeld en worden de appbestanden vervangen, terwijl opgeslagen informatie behouden blijft. Voer voor een handmatige update het nieuwe officiële installatieprogramma uit en gebruik de bestaande installatielocatie. Controleer bij een ondertekende openbare release de uitgever onder Digitale handtekeningen in de bestandseigenschappen van Windows. Niet-ondertekende interne testbuilds zijn geen ondertekende openbare releases. SHA-256 is een aanvullende integriteitscontrole.

Vanaf Bossanova 0.1.41 word je in Windows bij het verwijderen van de app afgemeld. Als je de kluis bewaart, meld je dan na herinstallatie aan bij hetzelfde account en open de kluis met het hoofdwachtwoord. Bij het verwijderen van de app blijven je kluisgegevens standaard behouden. Als je in het Windows-verwijderprogramma kiest voor het verwijderen van gegevens, kan ook je kluis worden verwijderd. Externe back-ups staan hier los van. Gebruik exporteren en importeren via dezelfde wifi om naar een nieuwe pc te gaan. Herstel van een externe back-up is ook mogelijk.

Updates worden op de achtergrond gedownload zonder kluisinhoud of accountgegevens te versturen.

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

Verwijder de map met kluisgegevens niet. Als een handtekening of checksum niet overeenkomt, voer het bestand dan niet uit en controleer de officiële release.

Problemen oplossen

Als de app niet opent, controleer je de Windows-versie, x64-ondersteuning en eventuele melding over WebView2. Controleer eerst de releasestatus en het bestand op de officiële downloadpagina voordat je beveiligingswaarschuwingen opvolgt.
Als de zoekresultaten leeg zijn, controleer je de vergrendelingsstatus en de zoekopdracht. Als data toevoegen of .env importeren wordt geblokkeerd, controleer je de datalimiet van je abonnement (10 bij Free) en de status van je abonnement.
Als AI-tools ontbreken, controleer je of de verbindingsschakelaar van die AI is ingeschakeld in Instellingen → AI en start je daarna een nieuw gesprek. AI’s in WSL en Windows worden afzonderlijk weergegeven, dus verbind de versie die je daadwerkelijk gebruikt. De Claude-app en de ChatGPT-app moeten na het verbinden opnieuw worden gestart voordat de tools verschijnen.
Een verbinding inschakelen via Instellingen → AI geeft toestemming voor de verbinding. Er verschijnt geen tweede toestemmingskaart; toestemming voor gegevensgebruik blijft apart. Schakel oude wachtende of geweigerde verbindingen expliciet in. Controleer bij DENIED de velden reason, detail en connection. Opnieuw verbinden geeft op zichzelf geen toestemming.
Als AI meldt dat het uitvoeringslog niet is ontvangen, heeft het commando de waarde afgedrukt. Bekijk het afgeschermde log bij ‘Recente uitvoeringen’ op het tabblad AI en wijzig het commando zodat het de waarde niet afdrukt.
Windows curl met Schannel negeert SSL_CERT_FILE. Geef dat pad met --cacert door in het goedgekeurde proces. Gebruik --ssl-revoke-best-effort alleen bij ontbrekende/offline intrekkingslijsten, nooit --insecure. Overweeg WSL voor Windows gh. AWS-ondertekening vereist een geschikte drager zoals env of file. Voor docker login kan het proces het bestand van de file-drager aan --password-stdin doorgeven. Verwijder de tijdelijke DOCKER_CONFIG achteraf.
Stuur voor hulp de fouttekst, het OS, de appversie en de stappen om het probleem te reproduceren. Stuur geen wachtwoorden, kluisbestanden, geheime waarden of verbindingstokens.

Bossanova beheert het OS of andere programma’s niet. Ruime AI-toegang tot beheerdersfuncties, bestanden, schermen of geheugen, of een gehackte computer, kan via andere routes informatie blootleggen. Raadpleeg de mededeling over geheimbeveiliging voor meer informatie.

Handleiding voor geheimenbescherming Contact Terug naar boven