Questa guida ti aiuta a risolvere i problemi più comuni relativi alle chiavi SSH in Kuboide.

Problemi di Connessione al Server

Errore: "Permission denied (publickey)"

Questo errore indica che la chiave SSH non è stata riconosciuta dal server.

Cause possibili:

1. La chiave non è stata copiata correttamente
2. I permessi dei file sono errati
3. La chiave è stata aggiunta all'utente sbagliato

Soluzione:

# Connettiti al server con password (se disponibile)
ssh root@IP_SERVER

# Verifica il contenuto di authorized_keys
cat ~/.ssh/authorized_keys

# Controlla i permessi
ls -la ~/.ssh/
# .ssh deve essere 700 (drwx------)
# authorized_keys deve essere 600 (-rw-------)

# Correggi i permessi se necessario
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

Errore: "Connection refused"

Il server non accetta connessioni SSH sulla porta specificata.

Soluzioni:

1. Verifica che SSH sia in esecuzione sul server:

sudo systemctl status sshd

2. Controlla la porta SSH configurata in Kuboide
3. Verifica che il firewall non blocchi la porta

Errore: "Host key verification failed"

Il server ha cambiato la sua chiave host.

Soluzione:

# Rimuovi la vecchia chiave host
ssh-keygen -R IP_SERVER

Problemi con Git

Errore: "Repository not found"

Il provider Git non riconosce la deploy key o il repository non esiste.

Cause possibili:

1. La deploy key non è stata aggiunta al repository
2. L'URL del repository è errato
3. Il repository è privato e la chiave non ha accesso

Soluzioni:

1. Verifica che la deploy key sia presente nelle impostazioni del repository
2. Controlla che l'URL sia nel formato SSH: git@provider.com:username/repo.git
3. Assicurati di usare l'URL SSH (non HTTPS)

Errore: "Permission denied" su Git

La chiave non ha i permessi necessari.

Soluzioni:

1. Verifica che la deploy key sia quella corretta (confronta le chiavi pubbliche)
2. Se hai bisogno di push, assicurati che i permessi di scrittura siano abilitati

Verifiche Generali

Controllare Quale Chiave è Associata

1. Vai su SSH Keys in Kuboide
2. Verifica quale chiave è selezionata nel server o progetto
3. Confronta la chiave pubblica con quella installata

Rigenerare una Chiave

Se sospetti che una chiave sia compromessa:

1. Elimina la chiave esistente da Kuboide
2. Crea una nuova chiave SSH
3. Reinstalla la nuova chiave pubblica sul server o provider Git
4. Aggiorna il server o progetto per usare la nuova chiave

Prossimi Passi

• Chiavi Server - Reinstalla la chiave sul server
• Chiavi Git - Riconfigura la deploy key