O editor de pacotes

Abrir um pacote a partir de Pacotes (ou de Editar na sua página do catálogo) abre o editor. A sua barra lateral substitui a da aplicação:

• Os meus pacotes para voltar, o seletor Pacote (escolher outro pacote abre a mesma secção desse pacote), e o estado de gravação: Guardado, A guardar…, Sem ligação: as alterações são mantidas ou Ainda não guardado: a tentar de novo;
• as secções, organizadas como o menu de tenant da plataforma: Apresentação, Gestão de nós (Fabricantes, Modelos, Perfis com SNMP e CLI; as entradas marcadas Em breve chegam numa versão posterior) e, depois, Versões;
• Definições em baixo.

Editar em conjunto, em direto

Não existe botão Guardar no editor: cada alteração é guardada à medida que escreve. Vários editores podem trabalhar no mesmo pacote ao mesmo tempo; as suas alterações aparecem à medida que escrevem, a barra lateral mostra quem está a editar, e um campo que outra pessoa está a editar é contornado na cor dessa pessoa. Se a sua ligação cair, as suas alterações são mantidas e enviadas quando a ligação voltar.

As suas alterações não chegam às plataformas enquanto não publicar uma versão: o cabeçalho de cada secção mostra Alterações não publicadas quando o conteúdo difere da última versão.

Listas e páginas de itens

Cada parte do conteúdo é uma tabela com uma caixa de pesquisa: Fabricantes, Modelos, Perfis SNMP, Perfis CLI e Perfis. Selecione linhas para remover vários itens de uma só vez. O botão Novo … no topo pede um nome (e alguns elementos essenciais) e, depois, abre a página do novo item, onde tudo o resto é preenchido, separador a separador.

Fabricantes

Um fabricante é um produtor de equipamentos de rede, como MikroTik. Novo fabricante pede o seu nome. A sua página tem dois separadores, Geral e Modelos.

Campo	Conteúdo
Nome	Obrigatório.
Logótipo	PNG, SVG, JPEG ou WebP, 512 KB no máximo. Também mostrado para os seus modelos.
Site	https://www.example.com
Site de suporte	https://support.example.com
Contacto de suporte	Endereço de e-mail ou número de telefone: support@example.com
Descrição	Apresentada na plataforma com o fabricante.

Um fabricante usado por modelos não pode ser removido: atribua-lhes outro fabricante ou remova-os primeiro.

Modelos

Um modelo é um tipo de equipamento de um fabricante do pacote, como CRS326-24G-2S+. Novo modelo pede o seu Nome e o seu Fabricante (adicione primeiro um fabricante: Cada modelo pertence a um fabricante). A sua página tem dois separadores:

• Geral: Nome, Fabricante (o seu logótipo é o logótipo do modelo), Descrição.
• Ligação: como a plataforma se comporta depois de abrir uma sessão CLI no equipamento.

Campo	Conteúdo
Tecla de controlo	Nenhuma, ou um caractere de controlo de Ctrl-A a Ctrl-Z, enviado logo após a abertura da ligação, antes do script. Alguns switches esperam por Ctrl-Y no seu banner.
Script de ligação	Linhas escritas uma a uma depois de ligado, após a tecla de controlo: normalmente comandos que desativam a paginação. 200 linhas e 10 000 caracteres no máximo.

Exemplo de um script de ligação para um switch que precisa do modo privilegiado e de nenhuma paginação:

enable
terminal more disable

Para outro fabricante, poderia ser um único terminal length 0.

Perfis SNMP

Como as plataformas comunicam em SNMP com os equipamentos. Novo perfil SNMP pede o seu nome e a sua Versão (SNMPv1, SNMPv2c ou SNMPv3). A sua página tem dois separadores:

• Geral: Nome, Versão, Porta (vazio: 161), Descrição.
• Credenciais: depende da versão. Os campos que não se aplicam ficam ocultos e são limpos.

SNMPv1 / SNMPv2c

Campo	Exemplo
Comunidade	public (enviada em texto simples pelo SNMPv1 e v2c)

SNMPv3

Campo	Exemplo
Nome de usuário	snmpadmin (o utilizador SNMPv3)
Nível de segurança	Autenticação e criptografia (authPriv); também noAuthNoPriv e authNoPriv
Protocolo de autenticação	SHA-256 (MD5, SHA-1, SHA-224, SHA-384, SHA-512 também propostos; a plataforma mostra MD5 e SHA-1 como MD-5 e SHA)
Senha de autenticação	s3cr3t-example, 8 caracteres no mínimo
Protocolo de criptografia	AES-128 (DES, AES-192, AES-256 também propostos)
Senha de criptografia	s3cr3t-example, 8 caracteres no mínimo
Nome do contexto	Opcional

Perfis CLI

Como as plataformas abrem uma sessão de linha de comandos. Novo perfil CLI pede o seu nome e o seu Protocolo (SSH ou Telnet). Separadores:

• Geral: Nome, Protocolo, Porta (vazio: 22 para SSH, 23 para Telnet), Descrição.
• Credenciais: Nome de usuário (opcional: o Telnet pode iniciar sessão só com uma senha), Método de autenticação (Senha ou Chave privada), Senha, Senha de enable (opcional, para o modo privilegiado).

Uma chave privada nunca faz parte de um pacote: com Chave privada, a chave e a sua frase secreta são fornecidas em cada plataforma.

Um perfil SNMP ou CLI usado por perfis não pode ser removido: atribua-lhes outro ou remova-os primeiro.

Perfis

Um perfil é uma forma já pronta de chegar a um tipo de equipamento, sob um único nome: um perfil SNMP, um perfil CLI ou ambos, mais quaisquer outros inícios de sessão e valores de que o equipamento precise. Na plataforma, aparece em Gestão de equipamentos › Perfis.

Novo perfil pede o seu Nome (como Campus access switch), o seu Perfil SNMP e o seu Perfil CLI (escolha pelo menos um; adicione-os primeiro em SNMP e CLI). A sua página tem três separadores: Geral, Credenciais adicionais e Variáveis personalizadas.

Credenciais adicionais

Outros inícios de sessão do equipamento além dos seus perfis SNMP e CLI: a sua interface web, a sua API… Novas credenciais abre uma janela com Nome (como Web UI ou REST API), Nome de usuário e Senha. Até 20 por perfil, cada uma com um nome único. A tabela mostra Armazenado em vez de uma senha.

Variáveis personalizadas

Valores livres para tudo o resto: endereços, portas, caminhos de API, tokens. Nova variável abre uma janela:

Campo	Regra
Nome	Letras, algarismos e _, sem começar por um algarismo, único no perfil: api_url
Valor	Texto livre, pode estar vazio: https://192.0.2.10:8443/rest
Secreta	Quando ativada, o valor é ocultado aqui e cifrado nas plataformas.
Descrição	Opcional, uma linha.

Até 50 por perfil. O valor é usado tal como está escrito, e cada tenant de uma plataforma pode definir o seu próprio valor: consulte Credenciais adicionais e variáveis personalizadas.

Exemplo: um perfil pronto a usar

O pacote Campus switching profiles usado nestas páginas inclui dois perfis. O primeiro, Campus access switch, combina:

Parte	Conteúdo
Perfil SNMP	Campus SNMPv3 (authPriv): SNMPv3, porta 161, utilizador campus-monitor, SHA-256 e AES-128
Perfil CLI	Campus SSH: SSH, porta 22, utilizador netops, uma senha e uma senha de enable
Credenciais adicionais	Web UI: admin / s3cr3t-example
Variáveis personalizadas	syslog_server = 192.0.2.10 (o coletor syslog do campus)

O segundo, Campus legacy switch, associa Campus SNMP v2c (comunidade public) a Campus Telnet console. Uma plataforma que instala o pacote recebe estes perfis prontos a usar; cada tenant substitui depois os valores de exemplo pelos seus.

Segredos nos pacotes

Os valores de um pacote podem ser lidos por quem o transferir

As comunidades, senhas, credenciais adicionais e variáveis secretas são ocultadas no editor (use o botão do olho para mostrar um valor), mas viajam em claro dentro do ficheiro do pacote. Qualquer pessoa que possa transferir o pacote pode lê-las. O editor indica-o em cada separador Credenciais: Qualquer pessoa que possa baixar este pacote pode ler estes valores. Limite-se aos valores padrão do fabricante (como public ou rwa): cada plataforma pode definir os seus.

Coloque num pacote apenas predefinições do fabricante: a comunidade ou a conta de fábrica documentada pelo fabricante. Nunca coloque as credenciais reais da sua rede.

Nas plataformas, estes valores são guardados cifrados, e cada tenant pode definir os seus próprios valores sobre eles. A página de catálogo de um pacote indica as credenciais e as variáveis, mas nunca mostra os seus valores.

Erros no conteúdo

Quando algo não pode ser mantido (um modelo sem fabricante, uma porta fora de 1–65535, uma senha SNMPv3 com menos de 8 caracteres, um nome duplicado…), o campo é marcado com o motivo e o separador ou a linha mostra um ícone de aviso. Corrija-o antes de publicar.