cf54f44377
Complete overhaul of all metadata and documentation for v1.8.1: F-Droid Critical: - Fix broken umlauts in de-DE/10.txt changelog (für, hinzugefügt, aufgeräumt) - Shorten de-DE/7.txt changelog for brevity - Remove trailing newline from en-US/title.txt Version & Accuracy: - Update README badges (Android 7.0+) and footer (v1.8.1) - Add widgets, sorting, parallel sync to highlights - Fix APK names in workflows (removed "universal") - Update cache action v3 → v4 in PR workflow - Fix CONTRIBUTING.md filename references - Update QUICKSTART guides (APK name, typo, Android version, docs links) Feature Documentation: - Update full_description.txt (both locales) - remove NEW/NEU labels, add v1.8.0+ features - Major FEATURES.md update - add Views & Layout, Widgets sections, updated tech stack - Add UPCOMING.md v1.7.0-1.8.1 as released sections - Update DOCS.md roadmap references and dates to Feb 2026 - Create missing en-US changelogs 1.txt, 2.txt Supplementary Fixes: - Update BACKUP.md - add encryption docs, fix cross-references - Add CHANGELOG.md reference links v1.2.1-v1.8.1 (15 missing) - Fix DEBUG_APK.md duplicate header - Rewrite fastlane/README.md with both locales and limits table - Create SELF_SIGNED_SSL.de.md (full German translation) Affects: 26 files across READMEs, docs/, fastlane/, workflows
147 lines
4.6 KiB
Markdown
147 lines
4.6 KiB
Markdown
# Selbstsignierte SSL-Zertifikate
|
||
|
||
**Seit:** v1.7.0
|
||
**Status:** ✅ Unterstützt
|
||
|
||
**🌍 Sprachen:** **Deutsch** · [English](SELF_SIGNED_SSL.md)
|
||
|
||
---
|
||
|
||
## Übersicht
|
||
|
||
Simple Notes Sync unterstützt die Verbindung zu WebDAV-Servern mit selbstsignierten SSL-Zertifikaten, z.B.:
|
||
- ownCloud/Nextcloud mit selbstsignierten Zertifikaten
|
||
- Synology NAS mit Standard-Zertifikaten
|
||
- Raspberry Pi oder Home-Server
|
||
- Interne Firmen-Server mit privaten CAs
|
||
|
||
## Anleitung
|
||
|
||
### Schritt 1: CA-Zertifikat des Servers exportieren
|
||
|
||
**Auf deinem Server:**
|
||
|
||
1. Finde deine Zertifikatsdatei (meist `.crt`, `.pem` oder `.der` Format)
|
||
2. Falls du das Zertifikat selbst erstellt hast, hast du es bereits
|
||
3. Für Synology NAS: Systemsteuerung → Sicherheit → Zertifikat → Exportieren
|
||
4. Für ownCloud/Nextcloud: Meist unter `/etc/ssl/certs/` auf dem Server
|
||
|
||
### Schritt 2: Zertifikat auf Android installieren
|
||
|
||
**Auf deinem Android-Gerät:**
|
||
|
||
1. **Übertrage** die `.crt` oder `.pem` Datei auf dein Handy (per E-Mail, USB, etc.)
|
||
|
||
2. **Öffne Einstellungen** → Sicherheit → Weitere Sicherheitseinstellungen (oder Verschlüsselung & Anmeldedaten)
|
||
|
||
3. **Von Speicher installieren** / "Zertifikat installieren"
|
||
- Wähle "CA-Zertifikat"
|
||
- **Warnung:** Android zeigt eine Sicherheitswarnung. Das ist normal.
|
||
- Tippe auf "Trotzdem installieren"
|
||
|
||
4. **Navigiere** zu deiner Zertifikatsdatei und wähle sie aus
|
||
|
||
5. **Benenne** es erkennbar (z.B. "Mein ownCloud CA")
|
||
|
||
6. ✅ **Fertig!** Das Zertifikat wird nun systemweit vertraut
|
||
|
||
### Schritt 3: Simple Notes Sync verbinden
|
||
|
||
1. Öffne Simple Notes Sync
|
||
2. Gehe zu **Einstellungen** → **Server-Einstellungen**
|
||
3. Gib deine **`https://` Server-URL** wie gewohnt ein
|
||
4. Die App vertraut nun deinem selbstsignierten Zertifikat ✅
|
||
|
||
---
|
||
|
||
## Sicherheitshinweise
|
||
|
||
### ⚠️ Wichtig
|
||
|
||
- Die Installation eines CA-Zertifikats gewährt Vertrauen für **alle** von dieser CA signierten Zertifikate
|
||
- Installiere nur Zertifikate aus vertrauenswürdigen Quellen
|
||
- Android warnt dich vor der Installation – lies die Warnung sorgfältig
|
||
|
||
### 🔒 Warum das sicher ist
|
||
|
||
- Du installierst das Zertifikat **manuell** (bewusste Entscheidung)
|
||
- Die App nutzt Androids nativen Trust Store (keine eigene Validierung)
|
||
- Du kannst das Zertifikat jederzeit in den Android-Einstellungen entfernen
|
||
- F-Droid und Google Play konform (kein "allen vertrauen" Hack)
|
||
|
||
---
|
||
|
||
## Fehlerbehebung
|
||
|
||
### Zertifikat nicht vertraut
|
||
|
||
**Problem:** App zeigt weiterhin SSL-Fehler nach Zertifikatsinstallation
|
||
|
||
**Lösungen:**
|
||
1. **Installation prüfen:** Einstellungen → Sicherheit → Vertrauenswürdige Anmeldedaten → Tab "Nutzer"
|
||
2. **Zertifikatstyp prüfen:** Muss ein CA-Zertifikat sein, kein Server-Zertifikat
|
||
3. **App neustarten:** Simple Notes Sync schließen und wieder öffnen
|
||
4. **URL prüfen:** Muss `https://` verwenden (nicht `http://`)
|
||
|
||
### Selbstsigniert vs. CA-signiert
|
||
|
||
| Typ | Installation nötig | Sicherheit |
|
||
|-----|-------------------|------------|
|
||
| **Selbstsigniert** | ✅ Ja | Manuelles Vertrauen |
|
||
| **Let's Encrypt** | ❌ Nein | Automatisch |
|
||
| **Private CA** | ✅ Ja (CA-Root) | Automatisch für alle CA-signierten Zertifikate |
|
||
|
||
---
|
||
|
||
## Alternative: Let's Encrypt (Empfohlen)
|
||
|
||
Wenn dein Server öffentlich erreichbar ist, erwäge **Let's Encrypt** für kostenlose, automatisch erneuerte SSL-Zertifikate:
|
||
|
||
- Keine manuelle Zertifikatsinstallation nötig
|
||
- Von allen Geräten automatisch vertraut
|
||
- Einfacher für Endbenutzer
|
||
|
||
---
|
||
|
||
## Technische Details
|
||
|
||
### Implementierung
|
||
|
||
- Nutzt Androids **Network Security Config**
|
||
- Vertraut sowohl System- als auch Benutzer-CA-Zertifikaten
|
||
- Kein eigener TrustManager oder HostnameVerifier
|
||
- F-Droid und Play Store konform
|
||
|
||
### Konfiguration
|
||
|
||
Datei: `android/app/src/main/res/xml/network_security_config.xml`
|
||
|
||
```xml
|
||
<base-config>
|
||
<trust-anchors>
|
||
<certificates src="system" />
|
||
<certificates src="user" /> <!-- ← Aktiviert Self-Signed Support -->
|
||
</trust-anchors>
|
||
</base-config>
|
||
```
|
||
|
||
---
|
||
|
||
## FAQ
|
||
|
||
**F: Muss ich das Zertifikat nach App-Updates neu installieren?**
|
||
A: Nein, Zertifikate werden systemweit gespeichert, nicht pro App.
|
||
|
||
**F: Kann ich dasselbe Zertifikat für mehrere Apps verwenden?**
|
||
A: Ja, einmal installiert funktioniert es für alle Apps die Benutzerzertifikaten vertrauen.
|
||
|
||
**F: Wie entferne ich ein Zertifikat?**
|
||
A: Einstellungen → Sicherheit → Vertrauenswürdige Anmeldedaten → Tab "Nutzer" → Zertifikat antippen → Entfernen
|
||
|
||
**F: Funktioniert das auf Android 14+?**
|
||
A: Ja, getestet auf Android 7 bis 15 (API 24-35).
|
||
|
||
---
|
||
|
||
**Hilfe nötig?** Erstelle ein Issue auf [GitHub](https://github.com/inventory69/simple-notes-sync/issues)
|