Heading

Paramiko (połączenie esperanckich słów „paranoik” i „przyjaciel”) to moduł dla pythona 2.3 lub nowszego, który implementuje protokół SSH2 do bezpiecznych (szyfrowanych i uwierzytelnionych) połączeń ze zdalnymi maszynami. W przeciwieństwie do SSL (aka TLS), protokół SSH2 nie wymaga hierarchicznych certyfikatów podpisanych przez potężny centralny urząd. SSH2 jest znany jako protokół, który zastąpił telnet i rsh dla bezpiecznego dostępu do zdalnych powłok, ale protokół ten zawiera również możliwość otwierania dowolnych kanałów do zdalnych usług przez zaszyfrowany tunel. (Tak działa na przykład sftp.)

Wysokopoziomowe API klienta rozpoczyna się od utworzenia obiektu SSHClient. Dla bardziej bezpośredniej kontroli, przekaż gniazdo (lub obiekt podobny do gniazda) do Transportu, i użyj start_server lub start_client aby negocjować ze zdalnym hostem jako serwer lub klient. Jako klient, jesteś odpowiedzialny za uwierzytelnienie przy użyciu hasła lub klucza prywatnego i sprawdzenie klucza hosta serwera. (Podpisywanie i weryfikacja kluczy jest wykonywana przez Paramiko, ale będziesz musiał dostarczyć klucze prywatne i sprawdzić, czy zawartość klucza publicznego odpowiada temu, co spodziewałeś się zobaczyć). Jako serwer, jesteś odpowiedzialny za decydowanie, którzy użytkownicy, hasła i klucze mają być dozwolone i jakiego rodzaju kanały mają być dozwolone.

Gdy skończysz, każda ze stron może zażądać kanałów kontrolowanych przez przepływ do drugiej strony, które są obiektami Pythona, które działają jak gniazda, ale wysyłają i odbierają dane przez zaszyfrowaną sesję.

Paramiko jest napisane w całości w pythonie (bez kodu C lub kodu zależnego od platformy) i jest wydane na licencji GNU Lesser General Public License (LGPL).

Klasy:

classparamiko.SecurityOptionsś

Proste obiekty zawierające preferencje bezpieczeństwa transportu ssh.

classparamiko.Transportś

Transport SSH dołącza się do strumienia (zwykle gniazda), negocjuje zaszyfrowaną sesję, uwierzytelnia się, a następnie tworzy tunele strumieniowe, zwane kanałami, w poprzek sesji.

classparamiko.SSHClientś

Wysokopoziomowa reprezentacja sesji z serwerem SSH.

classparamiko.MissingHostKeyPolicy¶

Interfejs do definiowania polityki, której SSHClient powinien używać, gdy nazwa hosta serwera SSH nie znajduje się ani w kluczach hosta systemowego, ani w kluczach aplikacji.

classparamiko.AutoAddPolicy¶

Polityka automatycznego dodawania nazwy hosta i nowego klucza do lokalnego obiektu HostKeys i zapisywania go.

classparamiko.RejectPolicy¶

Polityka automatycznego odrzucania klucza nieznanej nazwy hosta &.

classparamiko.WarningPolicy¶

Polityka dla logowania ostrzeżenia w stylu python dla nieznanego klucza hosta, ale akceptowania go.

classparamiko.Channelś

Zabezpieczony tunel przez SSH Transport.

classparamiko.SSHException¶

Wygl±d wywoływany przez niepowodzenia w negocjacji protokołu SSH2 lub błędy logiczne.

classparamiko.PasswordRequiredException¶

Wygl±d wywoływany, gdy do odblokowania pliku klucza prywatnego potrzebne jest hasło.

classparamiko.BadAuthenticationType¶

Wygl±d podniesiony, gdy używany jest typ uwierzytelnienia (np. hasło), ale serwer nie zezwala na ten typ.

classparamiko.ChannelException¶

Wygl±d podniesiony, gdy próba otwarcia nowego kanału nie powiodła się.

classparamiko.BadHostKeyException

Klucz hosta podany przez serwer SSH nie odpowiadał temu, czego oczekiwaliśmy.

classAuthenticationExceptionś

Wyjątek podniesiony, gdy uwierzytelnianie nie powiodło się z jakiegoś powodu.

classparamiko.ServerInterface¶

Klasa ta definiuje interfejs kontroluj±cy zachowanie paramiko w trybie serwera.

classparamiko.SubsystemHandler¶

Handler dla podsytemu w trybie serwera.

classparamiko.RSAKeyś

Prezentacja klucza RSA, który może być użyty do podpisania i weryfikacji danych SSH2.

classparamiko.DSSKeyś

Prezentacja klucza DSS, który może być użyty do podpisywania i weryfikowania danych SSH2.

classparamiko.SFTPErrorś classparamiko.SFTPś

Alias dla SFTPClient. alias dla SFTPClient dla wstecznej kompatybilności

classparamiko.SFTPClientś

Obiekt klienta SFTP.

classparamiko.SFTPServer¶

Obsługa podsystemu SFTP po stronie serwera.

classparamiko.SFTPAttributesś

Reprezentacja atrybutów pliku (lub pliku proxy) dla SFTP w trybie klienta lub serwera.

classparamiko.SFTPHandleś

Abstrakcyjny obiekt reprezentujący uchwyt do otwartego pliku (lub folderu) w implementacji serwera SFTP.

classparamiko.SFTPServerInterfaceś

Klasa ta definiuje interfejs do kontrolowania zachowania paramiko, gdy używa podsystemu SFTPServer do zapewnienia serwera SFTP.

classparamiko.SFTPFile¶

Obiekt proxy dla pliku na zdalnym serwerze, w trybie klienta SFTP.

classparamiko.Message¶

Wiadomo¶ć SSH2 to strumień bajtów, który koduje pewn± kombinację ci±gów znaków, liczb całkowitych, bools i liczb całkowitych o nieskończonej precyzji (znanych w pythonie jako longs).

classparamiko.BufferedFileś

Reużywalna klasa bazowa do implementacji buforowania plików w stylu pythona wokół prostszego strumienia.

classparamiko.Agentś

Interfejs klienta do używania kluczy prywatnych z agenta SSH działającego na lokalnej maszynie.

classparamiko.AgentKeyś