Heading

Paramiko (una combinazione delle parole esperanto per “paranoico” e “amico”) è un modulo per python 2.3 o superiore che implementa il protocollo SSH2 per connessioni sicure (criptate e autenticate) a macchine remote. A differenza di SSL (alias TLS), il protocollo SSH2 non richiede certificati gerarchici firmati da una potente autorità centrale. Potreste conoscere SSH2 come il protocollo che ha sostituito telnet e rsh per l’accesso sicuro alle shell remote, ma il protocollo include anche la capacità di aprire canali arbitrari a servizi remoti attraverso un tunnel criptato. (Questo è il modo in cui funziona sftp, per esempio.)

L’API client di alto livello inizia con la creazione di un oggetto SSHClient. Per un controllo più diretto, passate un socket (o un oggetto simile a un socket) a un Transport, e usate start_server o start_client per negoziare con l’host remoto come server o client. Come client, siete responsabili dell’autenticazione usando una password o una chiave privata, e della verifica della chiave host del server. (La firma e la verifica delle chiavi è fatta da paramiko, ma dovrete fornire le chiavi private e controllare che il contenuto di una chiave pubblica corrisponda a quello che vi aspettavate di vedere). Come server, siete responsabili di decidere quali utenti, password e chiavi permettere, e che tipo di canali permettere.

Una volta che avete finito, entrambe le parti possono richiedere canali controllati dal flusso all’altra parte, che sono oggetti python che agiscono come socket, ma inviano e ricevono dati sulla sessione criptata.

Paramiko è scritto interamente in python (nessun codice C o dipendente dalla piattaforma) ed è rilasciato sotto la GNU Lesser General Public License (LGPL).

Classi:

classparamiko.SecurityOptions¶

Semplice oggetto contenente le preferenze di sicurezza di un trasporto ssh.

classparamiko.Transport¶

Un trasporto SSH si attacca ad un flusso (di solito un socket), negozia una sessione criptata, si autentica, e poi crea tunnel di flusso, chiamati canali, attraverso la sessione.

classparamiko.SSHClient¶

una rappresentazione di alto livello di una sessione con un server SSH.

classparamiko.MissingHostKeyPolicy¶

Interfaccia per definire la politica che SSHClient dovrebbe usare quando l’hostname del server SSH non è nelle chiavi host di sistema o nelle chiavi dell’applicazione.

classparamiko.AutoAddPolicy¶

Policy per aggiungere automaticamente l’hostname e la nuova chiave host all’oggetto HostKeys locale, e salvarlo.

classparamiko.RejectPolicy¶

Politica per rifiutare automaticamente la chiave & hostname sconosciuto.

classparamiko.WarningPolicy¶

Politica per registrare un avviso in stile python per una chiave host sconosciuta, ma accettarla.

classparamiko.Channel¶

Un tunnel sicuro attraverso un trasporto SSH.

classparamiko.SSHException¶

Eccezione sollevata da fallimenti nella negoziazione del protocollo SSH2 o errori logici.

classparamiko.PasswordRequiredException¶

Eccezione sollevata quando è necessaria una password per sbloccare un file chiave privata.

classparamiko.BadAuthenticationType¶

Eccezione sollevata quando un tipo di autenticazione (come la password) è usato, ma il server non permette quel tipo.

classparamiko.ChannelException¶

Eccezione sollevata quando un tentativo di aprire un nuovo canale fallisce.

classparamiko.BadHostKeyException

La chiave host fornita dal server SSH non corrisponde a quella attesa.

classAuthenticationException¶

Eccezione sollevata quando l’autenticazione è fallita per qualche motivo.

classparamiko.ServerInterface¶

Questa classe definisce un’interfaccia per controllare il comportamento di paramiko in modalità server.

classparamiko.SubsystemHandler¶

Handler per un subsytem in modalità server.

classparamiko.RSAKey¶

Rappresentazione di una chiave RSA che può essere usata per firmare e verificare dati SSH2.

classparamiko.DSSKey¶

Rappresentazione di una chiave DSS che può essere usata per firmare e verificare i dati SSH2.

classparamiko.SFTPError¶ classparamiko.SFTP¶

un alias di SFTPClient per la compatibilità all’indietro

classparamiko.SFTPClient¶

oggetto client SFTP.

classparamiko.SFTPServer¶

Supporto sottosistema SFTP lato server.

classparamiko.SFTPAttributes¶

Rappresentazione degli attributi di un file (o file proxy) per SFTP in modalità client o server.

classparamiko.SFTPHandle¶

Oggetto astratto che rappresenta un handle di un file (o cartella) aperto in un’implementazione server SFTP.

classparamiko.SFTPServerInterface¶

Questa classe definisce un’interfaccia per controllare il comportamento di paramiko quando si usa il sottosistema SFTPServer per fornire un server SFTP.

classparamiko.SFTPFile¶

Oggetto proxy per un file sul server remoto, in modalità client SFTP.

classparamiko.Message¶

Un messaggio SSH2 è un flusso di byte che codifica una combinazione di stringhe, interi, boole e interi a precisione infinita (conosciuti in python come longs).

classparamiko.BufferedFile¶

Classe base riutilizzabile per implementare il buffering dei file in stile python attorno ad un flusso più semplice.

classparamiko.Agent¶

Interfaccia client per utilizzare le chiavi private di un agente SSH in esecuzione sulla macchina locale.

classparamiko.AgentKey