Skip to content

About

Een volledig offline, lokale digitale kluis voor puur persoonlijk gebruik.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Digitale Kloon

Build iOS Swift SwiftUI SwiftData XcodeGen Offline Encrypted Face ID

Een volledig offline, lokale digitale kluis voor puur persoonlijk gebruik. Digitale Kloon is je "tweede brein" waarin je veilig wachtwoorden, API-keys, IBAN-rekeningnummers, accountgegevens en crypto-wallet credentials bewaart — naast notities en logs met volledige tijd- en datumregistratie.

Privacy-first ontwerp: de app doet letterlijk nooit een netwerkoproep. Er is geen cloud, geen analytics en geen derde-partij SDK. Data verlaat de app uitsluitend wanneer jij expliciet iets deelt of kopieert.


Inhoud


Functies

  • Kluis met categorieën en eigen veldtemplates:
    • wachtwoord — gebruikersnaam + wachtwoord
    • apiKey — naam + key
    • bank — IBAN + naam rekeninghouder
    • crypto — wallet + private key / seed
    • account — accountnaam + wachtwoord
  • Toon/verberg + kopieer per geheim veld, met automatische klembord-wissing.
  • Wachtwoordgenerator met instelbare lengte en tekenset + lokale sterkte-indicator.
  • Favorieten, zoeken en categoriefilter.
  • Notities en Logs met automatische registratie van aangemaakt, bewerkt en laatst geopend.
  • Instellingen: Face ID/Touch ID aan/uit, klembord-timer, standaardcategorie, versleutelde export/import, gegevens wissen.
  • App-intro en een modern, minimalistisch donker design.

Beveiligingsarchitectuur

Maatregel Implementatie
Geen netwerk Geen URLSession/Network-framework/derde-partij SDK. Geen CloudKit, geen analytics.
Vergrendeling LocalAuthentication (Face ID / Touch ID) bij elke koude start én bij terugkeer uit de achtergrond.
Geen inhoud in app-switcher Cover-view bij .background; geheime velden gemarkeerd .privacySensitive().
Encryptie op rust Master-sleutel (willekeurig, 256-bit) in de Keychain. Geheime velden versleuteld met AES-GCM (CryptoKit), ciphertext opgeslagen in SwiftData.
Geen OS-backup SwiftData-store en bestanden gemarkeerd isExcludedFromBackup (geen iCloud/device/Mac-backup).
Klembord Geheimen worden tijdelijk gekopieerd en na N seconden automatisch gewist (instelbaar).

Eén uitgangspunt: data kan alleen de app verlaten via een expliciete share of copy van jouw kant, of via de versleutelde back-up die jij zelf start.

Datamodel

SwiftData-@Model-typen (DigitaleKloon/Models/Models.swift):

  • VaultItem — een geheim: title, categoryRaw, notes, favorite, createdAt, updatedAt, lastOpenedAt, en een relatie naar VaultField.
  • VaultField — label + waarde. Open velden worden als plaintext opgeslagen; geheime velden als AES-GCM combined-data (secretData).
  • Note — title, body, pinned, plus de drie tijdstempels.
  • LogEntry — text, plus de drie tijdstempels.

Categorieën en hun veldtemplates staan in DigitaleKloon/Models/VaultCategory.swift.

Snel starten

  1. Installeer XcodeGen (indien nog niet aanwezig):

    brew install xcodegen
  2. Genereer het Xcode-project en open het:

    xcodegen generate
    open DigitaleKloon.xcodeproj
  3. Stel je eigen Apple Developer-team in (zie Signing & distributie) en bouw naar je toestel.

Projectstructuur

digitale-kloon-ios/
├── project.yml                    # XcodeGen als bron van waarheid
├── .github/workflows/ios.yml      # CI (build + test)
├── DigitaleKloon/
│   ├── DigitaleKloonApp.swift     # @main, intro-overlay, lock-gate, scenePhase
│   ├── BackupService.swift        # versleutelde export/import
│   ├── App/
│   │   ├── RootView.swift         # (via SecurityState)
│   │   ├── SecurityState.swift    # lock-state + ModelContainer (excludedFromBackup)
│   │   ├── SplashView.swift       # app-intro
│   │   ├── LockView.swift         # Face ID / Touch ID
│   │   └── IdentifiableExtensions.swift
│   ├── Models/
│   │   ├── Models.swift           # VaultItem, VaultField, Note, LogEntry
│   │   └── VaultCategory.swift
│   ├── Security/
│   │   ├── MasterKeyService.swift # Keychain master-sleutel
│   │   ├── CryptoService.swift    # AES-GCM encrypt/decrypt + backup-key
│   │   ├── SecretStore.swift      # gecachte sleutel + VaultField lees/schrijf
│   │   ├── BiometricGate.swift    # LocalAuthentication
│   │   ├── ClipboardService.swift # klembord + AppSettings
│   │   └── PasswordGenerator.swift
│   ├── Views/
│   │   ├── MainTabView.swift
│   │   ├── VaultListView.swift
│   │   ├── VaultItemDetailView.swift
│   │   ├── VaultItemFormView.swift
│   │   ├── PasswordGeneratorView.swift
│   │   ├── NotesListView.swift
│   │   ├── LogsListView.swift
│   │   ├── SettingsView.swift
│   │   └── Components/            # Theme, SecretField, ActivityView
│   └── Resources/
│       └── Assets.xcassets/       # kleuren, app-icon, logo
└── DigitaleKloonTests/            # unit-tests

Back-ups

Vanuit Instellingen → Back-up:

  • Exporteren — de volledige kluis wordt geserialiseerd en versleuteld met een eigen wachtzin (PBKDF2-HMAC-SHA256 met 600.000 iteraties + AES-GCM). Het resultaat is een .kloonbackup-bestand dat je via de deel-sheet verstuurt of bewaart.
  • Importeren — kies het bestand, geef de wachtzin en de kluis wordt hersteld. Geheime velden worden opnieuw versleuteld met de huidige master-sleutel van het toestel, zodat back-ups tussen apparaten overdraagbaar zijn.

Bewaar je wachtzin goed: zonder wachtzin is een back-up niet te openen.

Bouwen & testen

Lokaal:

xcodegen generate

# Bouwen voor de simulator
xcodebuild -project DigitaleKloon.xcodeproj -scheme DigitaleKloon \
  -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' \
  CODE_SIGNING_ALLOWED=NO build

# Tests uitvoeren (vereist een beschikbare simulator)
xcodebuild -project DigitaleKloon.xcodeproj -scheme DigitaleKloon \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  CODE_SIGNING_ALLOWED=NO test

CI (GitHub Actions) draait automatisch build + test op elke push naar main.

Signing & distributie

Dit is een persoonlijke, lokale app en is niet bedoeld voor de App Store.

  • Bundle identifier: nl.tiendo.digitalekloon
  • Code signing staat standaard op Automatic. Voor een toestel-build selecteer je je eigen Apple Developer-team in Xcode (Signing & Capabilities) of configureer je DEVELOPMENT_TEAM in project.yml.
  • Let op: Face ID/Touch ID en Keychain-gedrag werken niet (volledig) op de simulator; test biometrie op een echt toestel.

Volledig lokaal. Volledig versleuteld. Alleen van jou.

About

Een volledig offline, lokale digitale kluis voor puur persoonlijk gebruik.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages