Heading

Paramiko (uma combinação das palavras esperanto para “paranóico” e “amigo”) é um módulo para o python 2.3 ou superior que implementa o protocolo SSH2 para ligações seguras (encriptadas e autenticadas) a máquinas remotas. Ao contrário do SSL (aka TLS), o protocolo SSH2 não requer certificados hierárquicos assinados por uma autoridade central poderosa. Pode conhecer o SSH2 como o protocolo que substituiu o telnet e o rsh para acesso seguro a shells remotas, mas o protocolo também inclui a capacidade de abrir canais arbitrários para serviços remotos através de um túnel criptografado. (É assim que o sftp funciona, por exemplo.)

A API de cliente de alto nível começa com a criação de um objecto SSHClient. Para um controlo mais directo, passar um socket (ou objecto semelhante a um socket) para um Transport, e usar start_server ou start_client para negoatite com o host remoto como servidor ou cliente. Como cliente, é responsável por autenticar usando uma palavra-passe ou chave privada, e verificar a chave de anfitrião do servidor. (A assinatura e verificação da chave é feita por paramiko, mas terá de fornecer chaves privadas e verificar se o conteúdo de uma chave pública corresponde ao que esperava ver). Como servidor, é responsável por decidir quais os utilizadores, senhas e chaves a permitir, e que tipo de canais permitir.

Após ter terminado, qualquer um dos lados pode solicitar Canais controlados por fluxo para o outro lado, que são objectos python que actuam como tomadas, mas enviam e recebem dados ao longo da sessão encriptada.

Paramiko é escrito inteiramente em python (sem C ou código dependente de plataforma) e é lançado sob a Licença Pública Geral Menor GNU (LGPL).

Classes:

classparamiko.SecurityOptions¶

Objecto simples contendo as preferências de segurança de um transporte ssh.

classeparamiko.Transport¶

Um transporte SSH liga-se a um fluxo (geralmente uma tomada), negoceia uma sessão encriptada, autentica, e depois cria túneis de fluxo, chamados Canais, ao longo da sessão.

classeparamiko.SSHClient¶

Uma representação de alto nível de uma sessão com um servidor SSH.

classeparamiko.MissingHostKeyPolicy¶

Interface para definir a política que o Cliente SSH deve utilizar quando o nome de anfitrião do servidor SSH não se encontra nem nas chaves de anfitrião do sistema nem nas chaves da aplicação.

classeparamiko.AutoAddPolicy¶

Política para adicionar automaticamente o nome de anfitrião e a nova chave de anfitrião ao objecto local HostKeys, e guardá-la.

classeparamiko.RejectPolicy¶

Política para rejeitar automaticamente o nome de anfitrião desconhecido & chave.

classeparamiko.WarningPolicy¶

Política para registar um aviso ao estilo python para uma chave de hospedeiro desconhecida, mas aceitando-a.

classeparamiko.Channel¶

Um túnel seguro através de um Transporte SSH.

classeparamiko.SSHException¶

Excepção suscitada por falhas na negociação do protocolo SSH2 ou erros lógicos.

classeparamiko.PasswordRequiredException¶

Excepção levantada quando é necessária uma palavra-passe para desbloquear um ficheiro de chave privada.

classeparamiko.BadAuthenticationType¶

Excepção levantada quando é utilizado um tipo de autenticação (como senha), mas o servidor não permite esse tipo.

classeparamiko.ChannelException¶

Excepção levantada quando uma tentativa de abertura de um novo Canal falha.

classeparamiko.BadHostKeyException

A chave de anfitrião dada pelo servidor SSH não correspondia ao que esperávamos.

classeAuthenticationExceptionp>Excepção levantada quando a autenticação falhou por alguma razão. classeparamiko.ServerInterface¶

Esta classe define uma interface para controlar o comportamento do paramiko em modo servidor.

classeparamiko.SubsystemHandler¶

Handler para um sub-sistema em modo servidor.

classeparamiko.RSAKey¶

Representação de uma chave RSA que pode ser usada para assinar e verificar dados SSH2.

classeparamiko.DSSKey¶

Representação de uma chave DSS que pode ser usada para assinar e verificar dados SSH2.

classeparamiko.SFTPError¶ classeparamiko.SFTPp>an alias para SFTPClient for backwards compatability classparamiko.SFTPClientp>SFTP objecto cliente. classeparamiko.SFTPServer¶

Suporte do subsistema SFTP do lado do servidor.

classeparamiko.SFTPAttributes¶

Representação dos atributos de um ficheiro (ou ficheiro proxied) para SFTP em modo cliente ou servidor.

classeparamiko.SFTPHandle¶

Objecto de resumo representando um cabo para um ficheiro aberto (ou pasta) numa implementação de servidor SFTP.

classeparamiko.SFTPServerInterface

Esta classe define uma interface para controlar o comportamento do paramiko quando se utiliza o subsistema SFTPServer para fornecer um servidor SFTP.

classparamiko.SFTPFile¶

Proxy object for a file on the remote server, in client mode SFTP.

classeparamiko.Message¶

Uma mensagem SSH2 é um fluxo de bytes que codifica alguma combinação de cordas, inteiros, bools, e inteiros de precisão infinita (conhecidos em python como longs).

classeparamiko.BufferedFilep>Classe base reutilizável para implementar buffering de ficheiro ao estilo python em torno de um fluxo mais simples. classeparamiko.Agent

Interface do cliente para usar chaves privadas de um agente SSH a correr na máquina local.

classeparamiko.AgentKey