Iniciar sessãoAgendar apresentação
Parte 1: Para todos
Versão 1.0.0-alpha.1mais recente

Capítulo 1.9

Primeiros passos

As duas decisões antes de começar, o que faz a sua equipa de TI, a primeira execução tal como o primeiro administrador a vê e uma lista de verificação do que deve ter pronto no primeiro dia.

Esta página foi traduzida por IA a partir do original em inglês. Em caso de dúvida, a página em inglês serve de referência. Ler esta página em inglês

13 minutos de leitura

A primeira hora de Aoife Brennan com a nova instalação da Harrow Port Authority decorreu assim. Tomás Reilly, o seu engenheiro de plataforma, concluiu a instalação e enviou-lhe uma ligação com um código dividido em três grupos curtos. Ela introduziu o código e comparou oito grupos de letras no seu ecrã com os oito que constavam no dele. Em seguida, assinalou uma caixa e preencheu dois breves formulários. O seu portátil pediu uma chave de acesso (passkey), ela tocou no leitor de impressões digitais e deu por si a olhar para uma página Hoje (Today) que dizia, com toda a honestidade, que ainda nada tinha acontecido.

Uma primeira execução não tem muito mais do que isto. Este capítulo aborda as duas decisões prévias e o que a equipa de TI faz, seguindo-se cada passo dessa primeira hora e o primeiro dia após a mesma.

Duas decisões primeiro

Que edição escolher. A Community é a edição gratuita e de código aberto para uma organização. A Team adiciona um conjunto de funcionalidades na cloud da Adverant. A Enterprise é licenciada grupo de funcionalidades a grupo de funcionalidades, e é a edição que executa pacotes de domínio e suplementos (add-ons), incluindo as aplicações para telemóvel. O Capítulo 1.6, Edições e licenças em termos simples, descreve o que cada uma inclui. Pode mudar da edição Community para a Enterprise mais tarde e manter tudo o que já tem.

Onde é executado. As opções vão desde a cloud da Adverant na UE até ao seu próprio Kubernetes ou a um local sem qualquer ligação à internet, além de armazenamentos na cloud, appliances e dispositivos de campo. O Capítulo 1.8, Onde o Nexus é executado, explica cada opção. Na cloud da Adverant, basta registar-se e avançar diretamente para os primeiros cinco minutos, descritos no final deste capítulo.

O que faz a sua equipa de TI

Para qualquer instalação que execute por conta própria, a sua equipa de TI prepara o terreno. Verifica se a versão é genuína e executa uma verificação prévia (preflight check) que lista todos os problemas e a respetiva correção. Depois, procede à instalação e gera um código de reclamação de utilização única para o endereço de e-mail da pessoa que será o primeiro administrador. A Parte 2 foi escrita para a equipa de TI. Começa no capítulo 2.3, Planear uma instalação, e o capítulo 2.12, A primeira execução, aborda a parte que lhes compete na entrega.

O código de reclamação é válido durante 30 minutos e permite cinco tentativas. Combine uma hora com a equipa de TI, para que a pessoa que vai reclamar a instalação esteja em frente ao navegador quando o código chegar.

Reivindicar a instalação

A reclamação prova que o navegador à sua frente está a comunicar com a instalação que a sua equipa acabou de fazer. Ninguém pode iniciar sessão até que este passo esteja concluído.

  1. Abra o endereço de reclamação fornecido pela equipa de TI.
  2. Introduza o código nas três caixas, um grupo em cada uma.
  3. Compare a impressão digital (fingerprint) na página, composta por oito grupos de quatro caracteres, com a que a equipa de TI lhe ditar a partir do ecrã deles, grupo a grupo.
  4. Introduza o endereço de e-mail profissional para o qual o código foi criado.
  5. Assinale a caixa que confirma que todos os oito grupos coincidem e, em seguida, prima Reclamar esta instalação.
Reclamar esta instalação
Reclamar esta instalação
A página de reclamação pede o código do terminal e mostra a impressão digital completa em grupos de quatro, para que uma pessoa a possa comparar linha a linha. Um código expirado é recusado, com indicação do que aconteceu e de como obter um novo.

A reclamação faz três coisas. Torna este navegador o único local onde o primeiro administrador pode ser criado. Regista quem reclamou e quando. E desativa a página de reclamação em definitivo.

Se o código tiver mais de 30 minutos, a página informa-o disso e confirma que nada foi alterado. Prima Tenho um novo código. Peça um código novo à equipa de TI.

O primeiro administrador

A seguir surgem dois breves formulários numa única página. O primeiro é sobre si: o seu nome completo e e-mail profissional, além de uma palavra-passe. A primeira pessoa é sempre um administrador da organização. O segundo é sobre a organização. Pede o nome da organização e um nome curto utilizado nas ligações, depois o local onde os dados são guardados e, por fim, o idioma e o fuso horário.

Duas dessas caixas estão assinaladas como fixas. O nome curto aparece em todas as ligações e exportações, e não pode ser alterado mais tarde. O local onde os dados são guardados também não pode ser alterado; mover os dados mais tarde implica uma nova instalação. Pense bem antes de os preencher.

O primeiro administrador
O primeiro administrador
O primeiro administrador e a organização, numa única página. Repare nos dois campos assinalados como fixos e na nota de que a licença está em nome da empresa, nunca das pessoas que dela fazem parte.

Quando prime Criar e iniciar sessão, o seu computador pede-lhe para criar uma chave de acesso (passkey), um método de início de sessão que utiliza a sua impressão digital ou o rosto (ou o seu telemóvel) em vez de um segredo digitado. Um administrador nunca inicia sessão apenas com uma palavra-passe, pelo que a chave de acesso é sempre a segunda verificação. Se o seu computador não conseguir criar uma, a página mostra um código quadrado para a câmara do seu telemóvel. Tem dez minutos no mesmo navegador para concluir este passo.

O Nexus também cria um início de sessão de administrador de emergência neste momento. É selado e impresso uma única vez, para ser guardado no cofre. Só funciona quando o início de sessão da empresa está em baixo, e cada utilização é registada e comunicada a todos os administradores.

O seu primeiro dia

Depois de configurar a chave de acesso, entra na página Hoje (Today). Numa instalação nova, a página não finge estar movimentada. Cada lista vazia indica que tipo de vazio é («Ainda sem pedidos») e como começar. O assistente no painel lateral diz a mesma coisa numa frase: ainda não aconteceu nada aqui, e os primeiros passos habituais são ligar o início de sessão da empresa e um modelo.

A página Hoje, quando tudo é novo
A página Hoje, quando tudo é novo
A página Hoje no primeiro dia de uma nova organização. Todas as listas estão vazias e indicam-no, e a lista de verificação de configuração apresenta os passos seguintes em qualquer ordem.

A lista de verificação de configuração na página Hoje tem quatro itens, que pode concluir em qualquer ordem. Importe a licença se estiver na edição Enterprise. Ligue o início de sessão da empresa e um modelo. Convide os outros administradores. Recomenda-se a adição de mais dois administradores, porque algumas alterações precisam da aprovação de uma segunda pessoa.

Por trás desta está uma página para a própria instalação, Seis pontos antes de alguém iniciar sessão. Os seus seis itens são a licença e as cópias de segurança, o endereço e o respetivo certificado, o início de sessão da empresa e o correio eletrónico, e um modelo de inteligência artificial (IA). Cada um apresenta «true» quando está concluído. O botão Convidar pessoas fica disponível quando todos os seis estiverem como «true».

Ligar o início de sessão da empresa

A maioria das organizações pretende que as pessoas iniciem sessão com as contas que já possuem. Escolha o seu fornecedor e o Nexus encontra a maior parte das definições a partir dos detalhes publicados pelo fornecedor. Cole a identidade e o segredo da aplicação, que nunca mais é mostrado, e prima Testar início de sessão. O resultado explica em termos simples o que o fornecedor enviou e como o Nexus o irá utilizar. O nome da norma que o seu fornecedor utiliza aparece em letra pequena ao lado de uma breve explicação.

A edição Community liga um início de sessão da empresa através de OpenID Connect (OIDC). A Enterprise adiciona Security Assertion Markup Language (SAML) e mais duas funcionalidades: pode exigir o início de sessão da empresa a partir de uma data à sua escolha, após a qual as chaves de acesso dos membros deixam de funcionar isoladamente, e pode copiar pessoas e grupos do seu diretório a cada 15 minutos. Até que o início de sessão da empresa esteja ligado, apenas o utilizador atual pode iniciar sessão.

Ligar um modelo

Todas as respostas de IA no Nexus passam pela central de comutação de IA da organização, e a central precisa de, pelo menos, um modelo para onde enviar o trabalho. Pode ligar uma chave de um fornecedor alojado (Anthropic, Google Gemini, OpenRouter ou Scaleway) ou apontar o Nexus para um servidor de modelos que a sua organização execute no seu próprio hardware. O Nexus testa a ligação com uma pergunta curta antes de guardar, e nenhum dos seus ficheiros é enviado nesse teste.

A chave vai para o conjunto de chaves da organização. Depois de a guardar, apenas os últimos quatro caracteres voltam a ser mostrados, a quem quer que seja, incluindo a si. Como a chave pertence à organização e não a si, continua a funcionar se sair da organização. Um modelo no seu próprio hardware é tentado antes de qualquer modelo alojado.

Convidar pessoas

Um convite é definido antes de ser enviado. Introduz o endereço de e-mail e escolhe uma função, e a página mostra exatamente o que essa função pode e não pode fazer. Um membro, por exemplo, não pode ver chaves de modelos nem ler o registo de auditoria, e não pode convidar nem remover pessoas. A pessoa recebe um e-mail e o convite expira automaticamente após sete dias se ninguém o aceitar.

Convidar um colega
Convidar um colega
Convidar um colega. O que a função escolhida pode e não pode fazer é mostrado antes de o e-mail ser enviado.

As funções de administrador nunca são atribuídas com base no domínio de e-mail. Alguém cujo endereço termine no seu domínio pode pedir para aderir, mas isso torna-o apenas um membro, cabendo a decisão a um administrador.

Os primeiros cinco minutos para todos os outros

Quando uma pessoa convidada segue a ligação, a página de adesão indica-lhe quem a convidou e a função que terá. Para um administrador de uma unidade, também indica claramente o que não poderá ver, que é o conteúdo das mensagens ou ficheiros de qualquer outra pessoa. A pessoa inicia sessão com uma chave de acesso, com o Google ou GitHub, ou através do início de sessão da empresa, e configura a sua segunda verificação se a organização o exigir.

Em seguida, entra na sua própria página Hoje (Today) na consola, que é onde os membros fazem o seu trabalho diário: fazer perguntas ao assistente, conversar no chat de equipa, gerir ficheiros e blocos de notas, agentes e fluxos de trabalho. O que cada pessoa vê depende da sua função. Os administradores também vêem as páginas de administração, e um membro que abra uma delas depara-se com a página «Não é um administrador», que indica quem são os seus administradores.

Na cloud da Adverant, o primeiro administrador de uma nova organização recebe uma lista curta em vez de um instalador: executar um agente de exemplo com dados fictícios, ligar o seu próprio modelo, adicionar um documento, convidar um colega. A maioria das pessoas termina em menos de cinco minutos. A primeira resposta cita a página de onde provém e lista o que foi utilizado na leitura: que ficheiros e que modelo. A lista desaparece por si só quando os quatro passos estão concluídos, ou após sete dias.

O que ter pronto no primeiro dia

  • O nome e o endereço de e-mail do primeiro administrador, e uma hora combinada com a equipa de TI para a reclamação da instalação.
  • O nome da organização, o seu nome curto para as ligações e o local onde os dados devem ser guardados. Os dois últimos são permanentes.
  • Pelo menos duas outras pessoas que serão administradores.
  • Os detalhes de início de sessão da sua empresa, ou o contacto na equipa de TI que gere o seu fornecedor de identidade.
  • Um modelo: uma chave para um fornecedor alojado, ou o endereço de um servidor de modelos no seu próprio hardware.
  • O ficheiro de licença, se estiver na edição Enterprise.
  • Os detalhes do servidor de correio eletrónico que o Nexus utilizará para enviar convites.
  • Um documento real a partir do qual a sua equipa gostaria de obter respostas, para o primeiro teste.
  • Uma nota a indicar quem guarda o início de sessão de emergência impresso, e onde.