# O Manual do &krfb;

## Introdução

O &krfb; é uma aplicação de servidor que lhe permite partilhar a sua sessão actual com um utilizador noutra máquina, o qual poderá usar um cliente de VNC para ver ou mesmo controlar o ecrã.

Você, tipicamente, iria usar o &krfb; com o cliente de VNC do &kde;, o &krdc;, dado que corresponde mais de perto às funcionalidades especiais do &krfb;.

O &krfb; não necessita que você inicie uma nova sessão de X - pode partilhar a actual. Isto torna-o muito útil quando você quiser que alguém o ajude a executar uma tarefa.

Por favor comunique quaisquer problemas ou pedidos de funcionalidades para as listas de correio do &kde; ou envie um erro para http://bugs.kde.org.

## O protocolo do 'Remote Frame Buffer'

Este capítulo contém uma breve descrição do protocolo do Remote Frame Buffer usado pelo &krfb; e pelos outros sistemas compatíveis. Se você já estiver familiarizado com o Remote Frame Buffer, poderá ignorar este capítulo em segurança.

A implementação de alto nível de um sistema que use o protocolo Remote Frame Buffer é conhecido como Virtual Network Computer (Computador de Rede Virtual), ou mais frequentemente por VNC.

O Remote Frame Buffer (ou RFB para abreviar) é um protocolo simples para o acesso remoto às interfaces gráficas dos utilizadores. Funciona ao nível do 'frame-buffer', o que corresponde de forma lata à imagem desenhada no ecrã, o que significa que pode ser aplicado a todos os sistemas de janelas (incluindo o X11, &MacOS; e &Microsoft; &Windows;). As aplicações do Remote Frame Buffer existem para várias plataformas e poderão ser redistribuídas livremente.

No protocolo do Remote Frame Buffer, a aplicação que executa na máquina onde o utilizador se encontra (que contém o ecrã, o teclado e o rato) é chamada de cliente. A aplicação que é executada na máquina onde se localiza o 'framebuffer' (o qual está a executar o sistema de janelas e as aplicações que o utilizador se encontra a controlar remotamente) é por sua vez chamada de servidor. O &krfb; é o servidor do &kde; para o protocolo do Remote Frame Buffer. O &krdc; é o cliente do &kde; para o protocolo do Remote Frame Buffer.

Ocupa uma quantidade razoável de tráfego de rede enviar uma mensagem do 'framebuffer', como tal o Remote Frame Buffer trabalha melhor com as ligações de alta largura de banda, como as das redes locais. É ainda possível usar o &krfb; sobre outras ligações, mas é improvável que a performance seja tão boa.

## Utilizar o &krfb;

É muito fácil usar o &krfb; - tem uma interface simples, tal como é mostrada na figura em baixo.

Aqui está uma imagem do &krfb; Janela principal do &krfb;

Quando você quiser permitir a alguém aceder ao seu ecrã, você poderá criar um convite pessoal usando o botão Criar um Convite Pessoal... , o qual fará aparecer uma janela que contém a informação necessária para aceder ao seu ecrã. É mostrado um exemplo em baixo.

Exemplo de convite pessoal do &krfb; Exemplo de convite pessoal do &krfb;

Para aumentar a segurança, o convite só é válido por uma hora depois de ser criado, e obviamente a pessoa que se ligue terá de ter a senha correcta.

Dado que você poderá querer convidar alguém para aceder ao seu ecrã por e-mail, o &krfb; pode criar os convites como mensagens de e-mail. Você poderá criar um desses convites usando o botão Convidar por E-mail... na janela principal do &krfb;. Isto fará aparecer frequentemente uma mensagem de e-mail parecida com a seguinte, pronta para você escrever o endereço de e-mail da pessoa para quem está a enviar o convite.

Convite por e-mail de exemplo do &krfb; Convite por e-mail de exemplo do &krfb;

O &krfb; avisá-lo-á sobre as implicações de segurança de enviar esta informação através de uma ligação insegura. Você tem de ter em atenção estes avisos.

Se você não conseguir cifrar o e-mail (ou tornar a ligação segura, em alternativa), o envio de convites por e-mail é um risco de segurança muito sério, dado que qualquer pessoa conseguirá ler a senha e o endereço do e-mail à medida que passa na rede. Isto significa que terceiros poderão tomar o controlo da sua máquina.

Se você não conseguir cifrar a mensagem de e-mail, talvez seja melhor usar um convite pessoal, telefonar à pessoa a quem vai dar o acesso, verificar a identidade dessa pessoa e fornecer a informação do convite dessa forma.

### Gerir convites do &krfb;

depois de criar um convite (seja este pessoal ou enviado por e-mail), o &krfb; permite-lhe gerir esses convites. A janela para os controlar está disponível usando a opção Gerir os Convites... na janela principal do &krfb;. Se você seleccionar este botão, o &krfb; fará aparecer uma janela como a apresentada em baixo.

Gestão de convites do &krfb; Gestão de convites do &krfb;

A janela de gestão dos convites permite-lhe criar mais convites (usando os botões Novo Convite Pessoal... e Novo Convite por E-mail..., os quais têm o mesmo efeito que os botões da janela principal do &krfb; Criar um Convite Pessoal... e Convidar por E-mail....

A janela de gestão dos convites também lhe permite remover os convites existentes. Para apagar apenas um dos convites, seleccione-o com o rato ou com o teclado (deverá ficar realçado), e seleccione de seguida o botão Remover. Para apagar todos os convites, basta seleccionar o botão Remover Tudo.

Se seleccionar Fechar, a janela fechar-se-á.

### Configuração do &krfb;

Para além da interface principal do &krfb; mostrada e descrita em baixo, você também poderá controlar o &krfb; usando o seu módulo de controlo, ao qual você poderá aceder usando o Centro de Controlo normal do &kde; e também através da opção Configurar... na janela principal do &krfb;. A configuração do &krfb; é controlada através de uma janela em páginas, tal como é mostrada em baixo:

Configuração do &krfb; (Página de Acesso) Configuração do &krfb; (Página de Acesso)

A página de Acesso permite-lhe configurar as opções relacionadas com o acesso ao servidor do &krfb;.

A opção Criar e Gerir os Convites... leva-o à janela de gestão de convites do &krfb;, a qual foi descrita anteriormente.

A opção de Anunciar o serviço na rede controla se o &krfb; notifica os convites na rede usando o SLP (Service Location Protocol). Esta é normalmente uma boa ideia, mas só funciona realmente bem com um cliente que entenda o Service Location Protocol como o &krdc;.

A opção Permitir as ligações sem convite controla se o &krfb; irá permitir uma ligação sem convite. Se as ligações sem convite forem permitidas, você deverá indicar uma senha. Também pode usar as opções aqui para escolher se terá de confirmar a ligação antes de esta prosseguir, e se a pessoa que se liga poderá controlar o ecrã, ou apenas vê-lo.

Se a máquina for uma estação de trabalho, e se você optar por permitir as ligações sem convite, você poderá querer seleccionar a opção Confirmar as ligações sem convite antes de aceitar. Da mesma forma, se a máquina for um servidor e se você estiver a usar o &krfb; para a sua administração remota, você poderá querer desligar a mesma opção.

O &krfb; usa o sistema de senhas normal do RFB, o qual não transfere a sua senha de forma legível pela rede. Em vez disso, usa um sistema de 'desafio e resposta'. Isto é razoavelmente seguro, desde que a senha seja guardada em segurança.

O &krfb; permite-lhe controlar se a imagem de fundo é passada para o cliente ou não. Isto é configurado através de uma opção na página Sessão, tal como mostrado em baixo.

Configuração do &krfb; (Página de Sessão) Configuração do &krfb; (Página de Sessão)

Se você assinalar a opção, o &krfb; não irá transferir a imagem de fundo. Se você a deixar em branco, depende do cliente se a imagem de fundo é transferida ou não.

A página de Rede permite o controlo do porto que o &krfb; usa, tal como mostrado em baixo.

Configuração do &krfb; (Página de Rede) Configuração do &krfb; (Página de Rede)

Se você seleccionar a opção Atribuir o porto automaticamente, então o &krfb; irá localizar um porto adequado, e os convites irão corresponder a esse porto. Se você deseleccionar a opção Atribuir o porto automaticamente poderá indicar um porto em particular. Indicar um porto personalizado poderá ser útil se você estiver a fazer redirecção de portos na 'firewall'. Repare que, se o protocolo SLP (Service Location Protocol) estiver activo, este irá tratar automaticamente da identificação do porto correcto.

### O que acontece quando alguém se liga ao &krfb;

Sempre que alguém se liga ao &krfb; na sua máquina, você irá receber uma notificação semelhante à da figura seguinte, a menos que você esteja a aceitar as ligações sem convite e sem aviso.

Janela de Ligação do &krfb; Janela de Ligação do &krfb;

Se você Aceitar a Ligação, o cliente poderá prosseguir com a autenticação (a qual necessita da senha correcta para um convite pessoal ou por e-mail). Se você Recusar a Ligação, então a tentativa de ligação será terminada.

A opção Permitir ao utilizador remoto controlar o teclado e o rato determina se este cliente só observa ou se pode tomar o controlo da sua máquina.

Se a ligação do cliente for bem sucedida, e se for usada a senha de um convite pessoal ou de um convite por e-mail, então esse convite será apagado e não poderá mais ser usado. Você também irá receber uma pequena janela acoplada na bandeja, a qual mostra que a ligação foi feita.

## Guia de Programação do &krfb;

O &krfb; suporta uma pequena quantidade de comandos do &DCOP;, os quais são descritos neste capítulo. Se você não está familiarizado com o &DCOP;, então não terá de se preocupar com isto. Contudo, se você quiser automatizar algumas das suas acções do &krfb; (ou outra aplicação do &kde;), o &DCOP; é uma ferramenta útil. Você poderá encontrar mais sobre o &DCOP; na sua documentação 'online' e nos tutoriais em http://developer.kde.org.

Você poderá desligar a aplicação &krfb; com o comando 'quit', tal como é mostrado neste exemplo:

    %dcop krfb-1507 MainApplication-Interface quit

Você terá de alterar o `krfb-1507` do exemplo para corresponder à instância do &krfb; que você deseja de facto desligar. Se você executar o `dcop` sem opções, você irá obter uma lista com todas as aplicações e que o &DCOP; consegue controlar.

## Perguntas e Respostas

&reporting.bugs; &updating.documentation;

## Créditos e Licença

&krfb;

Programa copyright 2002 Tim Jansen tim@tjansen.de

Contribuições:

- Ian Reinhart Geiser geiseri@kde.org

Documentação Copyright © 2003 &Brad.Hards; &Brad.Hards.mail;

Tradução de Pedro Morais morais@kde.org

&underFDL; &underGPL;

## Instalação

### Como obter o &krfb;

&install.intro.documentation;

### Compilação e Instalação

&install.compile.documentation;
&documentation.index;