📖 Dokumentation

Willkommen zur technischen Dokumentation von iKeePass. Hier findest du alle Informationen zur Nutzung und den unterstützten Formaten.

📚 Dokumentations-Uebersicht

Thema Beschreibung
📱 iOS App Features Alle Funktionen der iPhone & iPad App
🖥️ macOS App Features Alle Funktionen der Mac App
⌨️ AutoType Automatisches Eintippen von Anmeldedaten (macOS)
🔑 AutoFill Automatisches Ausfuellen von Passwoertern (iOS/iPadOS)
📱 AutoFill Anleitung Schritt-fuer-Schritt: Einrichten, Testen, Multi-Provider
☁️ Cloud-Speicherung Datenbank in der Cloud speichern (iOS)
📜 Versionshistorie Alle Versionen seit 2009

🔐 Unterstützte Formate

KDBX 3.x ✅ Vollständig unterstützt

Komponente Status
Verschlüsselung AES-256-CBC
KDF AES-KDF
Kompression GZIP
Passwort ✅ Unterstützt
Keyfile ✅ Unterstützt

KDBX 4.x ✅ Unterstützt

Komponente Status
Verschlüsselung AES-256-CBC, ChaCha20
KDF AES-KDF, Argon2d, Argon2id
Kompression GZIP
HMAC-Authentifizierung ✅ Unterstützt

🔒 Sicherheitsarchitektur

Verschlüsselungs-Pipeline

┌─────────────────┐
│   KDBX File     │
└────────┬────────┘
         ▼
┌─────────────────┐
│  Header Parse   │ ← Field IDs: 0-10
└────────┬────────┘
         ▼
┌─────────────────┐
│  Key Derivation │ ← AES-KDF / Argon2
└────────┬────────┘
         ▼
┌─────────────────┐
│  AES Decrypt    │ ← AES-256-CBC / ChaCha20
└────────┬────────┘
         ▼
┌─────────────────┐
│ Block Stream    │ ← SHA-256 verified
└────────┬────────┘
         ▼
┌─────────────────┐
│ GZIP Decompress │
└────────┬────────┘
         ▼
┌─────────────────┐
│   XML Parse     │ ← KeePassFile
└─────────────────┘

Key Derivation Functions

AES-KDF

  • Standard KDF für KDBX 3.x
  • Konfigurierbare Rundenzahl
  • Typisch: 6.000 - 60.000 Runden

Argon2d

  • Memory-hard KDF
  • Resistent gegen GPU/ASIC Angriffe
  • Parameter: Memory, Iterations, Parallelism

Argon2id

  • Hybrid aus Argon2d und Argon2i
  • Beste Balance aus Sicherheit und Performance
  • Empfohlen für neue Datenbanken

☁️ Cloud-Speicherung (iOS)

iKeePass iOS nutzt den nativen iOS-Dateien-Dialog, um deine Datenbank in verschiedenen Cloud-Diensten zu speichern:

Cloud-Dienst Status
Apple iCloud Drive ✅ Nativ integriert
Nextcloud ✅ Unterstuetzt
Google Drive ✅ Unterstuetzt
Microsoft OneDrive ✅ Unterstuetzt
Dropbox ✅ Unterstuetzt

So funktioniert’s

  1. Installiere die Cloud-App (z.B. Nextcloud, Google Drive)
  2. Aktiviere den Dienst in der iOS “Dateien”-App
  3. Waehle beim Speichern/Oeffnen in iKeePass den Cloud-Speicherort

Vollstaendige Anleitung zur Cloud-Speicherung

📱 Plattform-Spezifisches

macOS (iKeePass)

Komponente Technologie
Language Swift 6.0
UI Framework SwiftUI
Min. OS macOS 14.0 (Sonoma)
State @Observable
Layout NavigationSplitView

iOS (iKeePassIOS)

Komponente Technologie
Language Swift 5.9
UI Framework SwiftUI
Min. OS iOS 17.0
State @Observable
Navigation TabView + NavigationStack
Biometrie LocalAuthentication

🔧 KeePass-Kompatibilität

iKeePass ist vollständig kompatibel mit:

  • ✅ KeePass 2.x (Windows)
  • ✅ KeePassXC (Cross-Platform)
  • ✅ KeePassium (iOS/macOS)
  • ✅ KeePass2Android (Android)
  • ✅ MacPass (macOS)

Getestete Datenbanken

Format Version Status
KDBX 3.1 ✅ Vollständig
KDBX 4.0 ✅ Vollständig
KDBX 4.1 ✅ Vollständig
KDB 1.x ⏳ Geplant

📊 Features im Detail

Security Dashboard

Das integrierte Dashboard analysiert deine Passwörter:

Analyse Beschreibung
Security Score Gesamtbewertung 0-100%
Schwache Passwörter Kurz, einfach, keine Sonderzeichen
Doppelte Passwörter Gleiche Passwörter mehrfach verwendet
Alte Passwörter Nicht geändert seit >90 Tagen

TOTP/OTP Support

Integrierte Zwei-Faktor-Authentifizierung:

  • TOTP (Time-based One-Time Password)
  • RFC 6238 kompatibel
  • 30-Sekunden Intervalle
  • 6-stellige Codes (Standard)

🛠️ Entwickler-Informationen

Architektur

┌─────────────────────────────────────────────┐
│                   Views                      │
│  (SwiftUI - ContentView, EntryDetailView)   │
└─────────────────────┬───────────────────────┘
                      │
┌─────────────────────▼───────────────────────┐
│                  AppState                    │
│           (@Observable, @MainActor)          │
└─────────────────────┬───────────────────────┘
                      │
┌─────────────────────▼───────────────────────┐
│           KeePassDatabaseService             │
│     (CRUD, Encryption, Decryption)          │
└─────────────────────┬───────────────────────┘
                      │
┌─────────────────────▼───────────────────────┐
│              KeePassModels                   │
│  (iKeePassDatabase, iKeePassEntry, etc.)    │
└─────────────────────────────────────────────┘

Dependencies

  • CommonCrypto - AES Verschlüsselung
  • CryptoKit - SHA-256, HMAC
  • zlib - GZIP Kompression
  • Argon2 - Key Derivation (extern)