Files
Data-Coupler/CREDENTIAL_TROUBLESHOOTING.md
T
Alessio Dal Santo 562784e097 feat: Aggiunto sistema crittografia credenziali portabile e migrazione
Sostituita Windows ProtectedData con AES-256-GCM per compatibilità multi-macchina.
Aggiunta interfaccia migrazione guidata per credenziali legacy e gestione errori completa.

- Nuovo: Servizio crittografia AES con derivazione chiavi PBKDF2
- Nuovo: Interfaccia Blazor migrazione con rilevamento credenziali
- Nuovo: Documentazione utente per risoluzione problemi
- Fix: Errori compilazione e problemi binding componenti
- Miglioramento: Credenziali portabili funzionano su qualsiasi macchina dopo migrazione una-tantum

Completamente retrocompatibile - credenziali
2025-06-17 12:24:09 +02:00

1.9 KiB

Risoluzione Problemi Credenziali

Problema: "Errore durante la decrittografia"

Questo errore si verifica quando l'applicazione non riesce a decrittografare le credenziali salvate.

Cause Comuni

  1. Esecuzione su macchina diversa: Le credenziali sono state salvate su una macchina diversa da quella attuale
  2. Utente diverso: L'applicazione viene eseguita con un utente diverso da quello che ha creato le credenziali
  3. Sistema operativo diverso: Le credenziali sono state create su un sistema operativo diverso

Soluzioni

Opzione 1: Migrazione Automatica delle Credenziali

  1. Vai alla pagina Migrazione Credenziali
  2. Segui le istruzioni per re-inserire le credenziali che non possono essere decrittografate
  3. Le credenziali verranno automaticamente ri-crittografate per la macchina/utente corrente

Opzione 2: Backup e Ripristino Manuale

  1. Esporta le credenziali dalla macchina originale (se disponibile)
  2. Re-inserisci manualmente le credenziali nella pagina di Gestione Credenziali
  3. Elimina le credenziali problematiche

Opzione 3: Reset Completo

  1. Vai alla cartella dati dell'applicazione:
    • Windows: %LOCALAPPDATA%\\DataCoupler\\Credentials
    • Linux/Mac: ~/.local/share/DataCoupler/Credentials
  2. Elimina il file credential_profiles.json
  3. Riavvia l'applicazione
  4. Re-inserisci tutte le credenziali

Prevenzione

Per evitare questo problema in futuro:

  1. Backup regolari: Esporta periodicamente le credenziali
  2. Documentazione: Mantieni una documentazione delle credenziali in un luogo sicuro
  3. Configurazione centralizzata: Considera l'uso di un sistema di gestione credenziali centralizzato per ambienti enterprise

Contatti

Se il problema persiste, contatta il supporto tecnico con i seguenti dettagli:

  • Sistema operativo
  • Utente corrente
  • Messaggio di errore completo
  • Log dell'applicazione