Heading

Paramiko (eine Kombination aus den Esperanto-Wörtern für „paranoid“ und „Freund“) ist ein Modul für Python 2.3 oder höher, das das SSH2-Protokoll für sichere (verschlüsselte und authentifizierte) Verbindungen zu entfernten Maschinen implementiert. Im Gegensatz zu SSL (alias TLS) benötigt das SSH2-Protokoll keine hierarchischen Zertifikate, die von einer mächtigen zentralen Autorität signiert werden. Sie kennen SSH2 vielleicht als das Protokoll, das telnet und rsh für den sicheren Zugriff auf entfernte Shells ersetzt hat, aber das Protokoll beinhaltet auch die Fähigkeit, beliebige Kanäle zu entfernten Diensten über einen verschlüsselten Tunnel zu öffnen. (So funktioniert zum Beispiel sftp.)

Die High-Level-Client-API beginnt mit der Erzeugung eines SSHClient-Objekts. Für eine direktere Steuerung übergeben Sie einen Socket (oder ein Socket-ähnliches Objekt) an einen Transport und verwenden start_server oder start_client, um mit dem entfernten Host entweder als Server oder als Client zu verhandeln. Als Client sind Sie für die Authentifizierung mit einem Kennwort oder einem privaten Schlüssel und die Überprüfung des Host-Schlüssels des Servers verantwortlich. (Die Schlüsselsignatur und -überprüfung wird von paramiko durchgeführt, aber Sie müssen private Schlüssel bereitstellen und überprüfen, ob der Inhalt eines öffentlichen Schlüssels mit dem übereinstimmt, was Sie erwartet haben). Als Server sind Sie dafür verantwortlich, zu entscheiden, welche Benutzer, Passwörter und Schlüssel zugelassen werden sollen und welche Art von Kanälen zugelassen werden sollen.

Nachdem Sie das erledigt haben, kann jede Seite flussgesteuerte Kanäle zur anderen Seite anfordern, die Python-Objekte sind, die sich wie Sockets verhalten, aber Daten über die verschlüsselte Sitzung senden und empfangen.

Paramiko ist komplett in Python geschrieben (kein C oder plattformabhängiger Code) und wird unter der GNU Lesser General Public License (LGPL) veröffentlicht.

Klassen:

classparamiko.SecurityOptions¶

Ein einfaches Objekt, das die Sicherheitseinstellungen eines ssh-Transports enthält.

classparamiko.Transport¶

Ein SSH-Transport verbindet sich mit einem Stream (normalerweise ein Socket), handelt eine verschlüsselte Sitzung aus, authentifiziert sich und erstellt dann Stream-Tunnel, Channels genannt, über die Sitzung.

classparamiko.SSHClient¶

Eine High-Level-Darstellung einer Sitzung mit einem SSH-Server.

classparamiko.MissingHostKeyPolicy¶

Schnittstelle zur Definition der Richtlinie, die SSHClient verwenden soll, wenn der Hostname des SSH-Servers weder in den System-Hostschlüsseln noch in den Schlüsseln der Anwendung enthalten ist.

classparamiko.AutoAddPolicy¶

Richtlinie zum automatischen Hinzufügen des Hostnamens und des neuen Hostschlüssels zum lokalen HostKeys-Objekt und zum Speichern.

classparamiko.RejectPolicy¶

Richtlinie für das automatische Ablehnen des unbekannten Hostname &-Schlüssels.

classparamiko.WarningPolicy¶

Richtlinie für die Protokollierung einer Warnung im Python-Stil für einen unbekannten Host-Schlüssel, der aber akzeptiert wird.

classparamiko.Channel¶

Ein sicherer Tunnel über einen SSH-Transport.

classparamiko.SSHException¶

Ausnahme, die durch Fehler bei der SSH2-Protokollaushandlung oder Logikfehler ausgelöst wird.

classparamiko.PasswordRequiredException¶

Ausnahme, die ausgelöst wird, wenn ein Passwort zum Entsperren einer privaten Schlüsseldatei benötigt wird.

classparamiko.BadAuthenticationType¶

Ausnahme, die ausgelöst wird, wenn ein Authentifizierungstyp (wie Passwort) verwendet wird, aber der Server diesen Typ nicht zulässt.

classparamiko.ChannelException¶

Ausnahme, die ausgelöst wird, wenn ein Versuch, einen neuen Channel zu öffnen, fehlschlägt.

classparamiko.BadHostKeyException

Der vom SSH-Server angegebene Host-Schlüssel entsprach nicht dem, was wir erwartet haben.

classAuthenticationException¶

Eine Ausnahme wurde ausgelöst, als die Authentifizierung aus irgendeinem Grund fehlschlug.

classparamiko.ServerInterface¶

Diese Klasse definiert eine Schnittstelle zur Steuerung des Verhaltens von paramiko im Server-Modus.

classparamiko.SubsystemHandler¶

Handler für ein Subsytem im Server-Modus.

classparamiko.RSAKey¶

Repräsentation eines RSA-Schlüssels, der zum Signieren und Verifizieren von SSH2-Daten verwendet werden kann.

classparamiko.DSSKey¶

Darstellung eines DSS-Schlüssels, der zum Signieren und Verifizieren von SSH2-Daten verwendet werden kann.

classparamiko.SFTPError¶ classparamiko.SFTP¶

ein Alias für SFTPClient für Rückwärtskompatibilität

classparamiko.SFTPClient¶

SFTP-Client-Objekt.

classparamiko.SFTPServer¶

Server-seitige Unterstützung des SFTP-Subsystems.

classparamiko.SFTPAttributes¶

Darstellung der Attribute einer Datei (oder Proxydatei) für SFTP im Client- oder Servermodus.

classparamiko.SFTPHandle¶

Abstract object representing a handle to an open file (or folder) in an SFTP server implementation.

classparamiko.SFTPServerInterface¶

Diese Klasse definiert eine Schnittstelle zur Steuerung des Verhaltens von paramiko bei der Verwendung des SFTPServer-Subsystems zur Bereitstellung eines SFTP-Servers.

classparamiko.SFTPFile¶

Proxy-Objekt für eine Datei auf dem Remote-Server, im Client-Modus SFTP.

classparamiko.Message¶

Eine SSH2-Nachricht ist ein Strom von Bytes, der eine Kombination von Strings, Integers, Bools und Infinite-Precision-Integers (in Python als Longs bekannt) kodiert.

classparamiko.BufferedFile¶

Wiederverwendbare Basisklasse zur Implementierung von Dateipufferung im Python-Stil um einen einfacheren Stream.

classparamiko.Agent¶

Client-Schnittstelle zur Verwendung privater Schlüssel von einem SSH-Agenten, der auf dem lokalen Rechner läuft.

classparamiko.AgentKey