Integração VSCode com DataDike via SSH

1. Visão Geral

Esta documentação descreve o processo para estabelecer conexões SSH entre o Visual Studio Code e ativos gerenciados pelo sistema DataDike PAM (Privileged Access Management).

Pré-requisitos

Ambiente Cliente (VSCode)

• Visual Studio Code instalado

• Extensão Remote-SSH instalada e configurada

• Conectividade de rede com o servidor DataDike PAM

Asset de Destino

• Linux: OpenSSH Server instalado e configurado

• Windows: OpenSSH Server habilitado

• Protocolo SSH configurado no registro do asset no PAM

• Credenciais válidas cadastradas no sistema

2. String de Conexão SSH

A string de conexão segue o formato específico do DataDike PAM:

ssh [fsaferUsername]@[assetUsername]@[assetIP]@[fsaferHostIP] -p2222

2.1 Parâmetros da String de Conexão

Parâmetro	Descrição	Exemplo
fsaferUsername	Usuário autenticado no DataDike PAM	admin.user
assetUsername	Usuário do sistema no asset de destino	root, administrator
assetIP	Endereço IP do asset de destino	192.168.1.100
fsaferHostIP	Endereço IP do servidor DataDike PAM	10.0.0.50
porta	Porta SSH	2222

2.2 Exemplo Prático

ssh admin.user@[email protected]@10.0.0.50 -p2222

3. Procedimento de Conexão

3.1 Passo 1: Iniciar Conexão Remota

1. Abrir o Visual Studio Code

2. Localizar o botão "Open a Remote Window" no canto inferior esquerdo da interface

3. Clicar no botão para abrir o menu de conexões remotas

4. Selecionar a opção "Connect to Host..."

3.2 Passo 2: Adicionar Novo Host SSH

1. No menu apresentado, selecionar "Add New SSH Host..."

2. Será exibida uma caixa de diálogo para inserção da string de conexão

3.3 Passo 3: Configurar String de Conexão

1. Inserir a string de conexão SSH no formato especificado

ssh [fsaferUsername]@[assetUsername]@[assetIP]@[fsaferHostIP] -p2222

3.4 Passo 4: Salvar Configuração

1. O VSCode solicitará a seleção do arquivo de configuração SSH

2. Escolher o arquivo de configuração apropriado (geralmente o padrão do usuário)

3. O sistema criará automaticamente uma entrada no arquivo SSH config

3.5 Passo 5: Estabelecer Conexão

1. Retornar ao menu "Connect to Host..."

2. Selecionar o host recém-configurado na lista

3. Aguardar a inicialização da conexão

4. Quando solicitado, fornecer as credenciais do DataDike PAM

5. Aguardar o estabelecimento completo da sessão remota

4.6 Verificação da Conexão

Após o estabelecimento da conexão, verificar:

• Indicador de Status: Verificar o indicador de conexão remota no canto inferior esquerdo do VSCode

• Acesso ao Sistema: Confirmar acesso ao sistema de arquivos do asset através do explorador de arquivos

• Terminal Integrado: Testar a funcionalidade do terminal integrado para validar a conectividade completa

5 Problemas Comuns

Falha na Conexão SSH

Sintomas: Timeout ou recusa de conexão

Soluções:

• Verificar conectividade de rede entre cliente e servidor F-Safer

• Confirmar disponibilidade da porta 2222 no servidor

• Validar configurações de firewall

Falha de Autenticação

Sintomas: Credenciais rejeitadas

Soluções:

• Verificar credenciais do usuário no F-Safer PAM

• Confirmar registro correto do asset no sistema

• Validar permissões do usuário no asset de destino

String de Conexão Inválida

Sintomas: Erro de formato na string de conexão

Soluções:

• Verificar a sintaxe da string de conexão

• Confirmar todos os parâmetros obrigatórios

• Validar endereços IP e nomes de usuário