Iniciar sessãoAgendar apresentação

Capítulo 2.12

A primeira execução

De uma instalação não reivindicada até às pessoas a trabalhar. Gere o código de reivindicação, reivindique a instalação num navegador, crie o primeiro administrador com uma chave de acesso (passkey) e, em seguida, ligue o início de sessão da empresa e convide todos os outros.

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

18 minutos de leitura

Quando uma instalação termina, não pertence a ninguém. Não tem organização, nem pessoa, nem sessão, e ninguém consegue iniciar sessão. Aguarda que uma pessoa prove, num navegador, que está a comunicar com a instalação que acabou de ser criada. Na Harrow Port Authority, essa pessoa foi Aoife Brennan, diretora de TI, com Tomás Reilly ao seu lado no terminal. Este capítulo acompanha os seus primeiros vinte minutos.

A ordem é fixa e cada passo encerra definitivamente o anterior: reclamar a instalação, criar o primeiro administrador e a organização, configurar uma chave de acesso (passkey) e chegar à página Hoje. Depois disso, seguem-se os seis pontos a preparar, o início de sessão da empresa e o convite às restantes pessoas, pela ordem que lhe for mais conveniente.

Uma cadeia de caixas da esquerda para a direita: "nexusctl claim-code (terminal)", "Reclamar esta instalação (navegador: código + impressão digital)", "O primeiro administrador e a organização", "Chave de acesso (segunda verificação)", "Hoje, quando tudo é novo", "Seis pontos antes de alguém iniciar sessão", "Convidar pessoas". Sob a caixa de reclamação, descem duas ramificações vermelhas: "código demasiado antigo: CLAIM_CODE_EXPIRED, gerar um novo código" e "as impressões digitais divergem: CLAIM_FINGERPRINT_MISMATCH, parar". Uma linha fina sob as três primeiras caixas tem a legenda "cada passo desativa definitivamente o anterior".
A primeira execução, do terminal até à primeira página Hoje, e os dois pontos onde pode parar.

Gerar o código de reivindicação

O código de reclamação prova que a pessoa em frente ao navegador também consegue ver o terminal de alguém com acesso ao cluster. Apenas essa pessoa o pode gerar. Execute isto onde o seu kubeconfig alcança o cluster:

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-code pede ao serviço de chaves da instalação, nexus-keys, para gerar o código. Sem nexusctl, o mesmo comando é executado no próprio pod do serviço de chaves:

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--source consiste em algumas palavras que indicam quem gerou o código. A página de reclamação apresenta-as sob "Criado por", para que a pessoa que reclama saiba de onde veio o código.

 Code  7KQM-4TXD-PL9R  works once, for 30 minutes, until 09:55 · 5 tries
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Há três aspetos importantes sobre o código.

  • Dura 30 minutos. Um código visto por cima do ombro de alguém rapidamente se torna inútil.
  • Permite 5 tentativas. Após a quinta tentativa errada, fica esgotado, independentemente do tempo restante.
  • Destina-se a uma única pessoa. O email que indicar é o do primeiro administrador. Segue juntamente com a reclamação, e o formulário do primeiro administrador apresenta-o como fixo, sem necessidade de o voltar a escrever.

A impressão digital é composta por oito grupos de quatro caracteres, a própria identidade da instalação. Deixe-a no ecrã. Irá compará-la, grupo a grupo, no navegador.

Reivindicar a instalação

  1. No computador que irá utilizar como primeiro administrador, abra o endereço de instalação da consola, neste caso https://console.harrow.example/install. Este encaminha-o para a página correta consoante o estado da instalação: a página de reclamação enquanto estiver aberta, a página do primeiro administrador assim que for reclamada, e a consola se já tiver sessão iniciada.
  2. Em Reclamar esta instalação, escreva o código no Grupo um, Grupo dois e Grupo três, um grupo de quatro em cada um.
  3. Compare a Impressão digital desta instalação na página com a do terminal, todos os oito grupos, um de cada vez.
  4. Se todos os grupos coincidirem, assinale Todos os oito grupos coincidem com o que o meu terminal apresenta.
  5. Prima Reclamar esta instalação; a página confirma a reclamação e encaminha-o para o primeiro administrador.
Reclamar esta instalação
Reclamar esta instalação
A página de reclamação. O código é introduzido em três grupos, a impressão digital completa é apresentada em oito grupos de quatro para comparação com o terminal, e o cartão à direita indica a origem do código e quantas tentativas restam.

A reclamação faz três coisas. Torna este navegador o único local onde o primeiro administrador pode ser criado. Regista quem reclamou a instalação, e quando, no registo de auditoria. E desativa definitivamente a página de reclamação. A partir desse momento, o endereço de reclamação responde que a instalação já foi reclamada.

Se a impressão digital não coincidir, pare

Uma impressão digital diferente significa que outra instalação está a responder neste endereço. Pode tratar-se de um endereço mal escrito, de um registo de DNS (Domain Name System) desatualizado ou de uma máquina configurada para intercetar o primeiro administrador. Se a reclamasse, essa máquina ficaria com a sua organização.

Não reclame nem escreva o código nessa página. Feche a página e, em seguida, verifique duas coisas: se console.harrow.example resolve para o seu ingress e se o certificado que o navegador apresenta foi emitido pela CA (autoridade de certificação) esperada. A sua própria instalação permanece inalterada e ainda por reclamar.

Se uma reclamação for enviada com uma impressão digital que não corresponda à da instalação, o serviço de chaves recusa-a com CLAIM_FINGERPRINT_MISMATCH (403). Nada é reclamado. A página apresenta então as duas impressões digitais lado a lado, com os grupos divergentes assinalados, bem como os passos para verificar o endereço e o certificado.

A impressão digital não coincide
A impressão digital não coincide
A página resultante de uma impressão digital que não coincide. Os grupos divergentes estão assinalados e os passos verificam o endereço e o certificado antes que algo mais seja escrito.

Criar o primeiro administrador e a organização

A página seguinte intitula-se "Dois breves formulários, e depois está dentro". O primeiro administrador pode adicionar todas as outras pessoas, e quase tudo aqui pode ser alterado mais tarde. Duas coisas não podem ser alteradas, e a página assinala-as.

Campo O que é introduzido Pode ser alterado mais tarde?
Nome completo O seu nome Sim
Email profissional O endereço para o qual o código de reclamação foi gerado, apresentado e não escrito novamente É o endereço do administrador
Função no Nexus Administrador da organização. A primeira pessoa é sempre um administrador. Não é escolhido aqui
Segunda verificação Chave de acesso neste portátil Sim, podem ser adicionadas mais
Nome (da organização) Harrow Port Authority Sim
País Onde a organização está sediada Sim
Nome curto nos endereços Criado a partir do nome, como harrow-port-authority Não. As hiperligações e as exportações utilizam-no.
Onde os dados são guardados Esta instalação Não. Alterá-lo mais tarde implica uma nova instalação.
Idioma e datas Inglês (Reino Unido), com a data de hoje Sim
Fuso horário O fuso horário do servidor Cada pessoa vê as horas no seu próprio fuso horário

O nome curto é composto por letras minúsculas, dígitos e hífenes, até 100 caracteres, criado a partir do nome da organização sem acentos. Verifique-o antes de premir qualquer botão. Aparece em todas as hiperligações que as pessoas partilham e em todas as exportações que fazem, durante todo o tempo de existência da organização.

Também define uma palavra-passe nesta página. Nunca é suficiente por si só: um administrador nunca inicia sessão apenas com uma palavra-passe. A segunda verificação, abaixo, é o que lhe permite iniciar sessão.

É criado em simultâneo um início de sessão de administrador de emergência. É selado e impresso uma única vez, para guardar no cofre. Funciona apenas quando o início de sessão da empresa está inoperacional, e cada utilização é registada e comunicada a todos os administradores. Guarde-o no cofre no mesmo dia em que o imprimir.

A página indica igualmente que a Adverant não é informada sobre a sua identidade. Estes detalhes permanecem na instalação. Uma licença identifica a empresa, nunca as pessoas que a integram.

Prima Criar e iniciar sessão. A criação do administrador e da organização demora alguns segundos. A página responde "Criado para aoife.brennan@harrow.example. Configure agora a sua chave de acesso: é através dela que inicia sessão."

O primeiro administrador
O primeiro administrador
O primeiro administrador e a organização numa única página. As duas opções que nunca podem ser alteradas, o nome curto e o local onde os dados são guardados, indicam-no ao lado do campo, e o início de sessão de emergência é selado para guardar no cofre.

A chave de acesso (passkey): a segunda verificação

  1. Prima Configurar a chave de acesso e iniciar sessão.
  2. O seu navegador pede-lhe para criar uma chave de acesso. Num portátil com Touch ID ou Windows Hello, confirme com o seu dedo, rosto ou PIN. Se o próprio computador não puder criar uma chave de acesso, o navegador apresenta um código QR (quick response): aponte a câmara do seu telemóvel para o código e siga as instruções no telemóvel.
  3. A página responde "A sua chave de acesso está configurada e tem sessão iniciada como aoife.brennan@harrow.example." e abre a consola.

Tem dez minutos a partir de Criar e iniciar sessão para criar a chave de acesso, no mesmo navegador. Após esse período, a configuração é encerrada e o administrador fica criado sem chave de acesso. Um operador terá de ajudar, conforme descrito abaixo na secção de novas tentativas.

A partir de agora, o primeiro administrador inicia sessão com essa chave de acesso. A palavra-passe de um administrador principal, introduzida isoladamente, nunca cria uma sessão: o serviço de início de sessão responde com um pedido para a segunda verificação. Trata-se de uma caraterística da arquitetura e a razão pela qual a chave de acesso é importante. Uma chave de acesso perdida significa perder a forma de entrar, pelo que deve adicionar uma segunda chave, num telemóvel ou numa chave de segurança física, logo no primeiro dia.

Mais tarde, as pessoas iniciam sessão na instalação com uma chave de acesso, com o Google, com o GitHub ou com o início de sessão da empresa, consoante o que a organização permitir.

Código O que significa O que fazer
PASSKEY_UNSUPPORTED Este navegador não consegue criar uma chave de acesso. Nada foi configurado. Abra a página num navegador que suporte chaves de acesso, no mesmo computador.
PASSKEY_CANCELLED O pedido foi fechado ou nada foi escolhido a tempo. Nada foi enviado. Prima o botão novamente.

A primeira página Today

A consola abre na página Hoje e, no primeiro dia, quase tudo nela está vazio. Cada área vazia indica o que irá aparecer ali e disponibiliza o botão que o inicia; assim, "Requer um administrador" indica que os pedidos ficarão ali a aguardar assim que as pessoas aderirem, com Convidar pessoas ao lado. A lista de verificação de configuração indica quantos dos seus passos estão concluídos, por qualquer ordem. O único histórico real, a própria configuração, já se encontra sob "O que mudou": a instalação configurada e a chave de acesso do primeiro administrador criada.

A página Hoje, quando tudo é novo
A página Hoje, quando tudo é novo
A página Hoje no primeiro dia. Cada área vazia indica o que irá aparecer ali e como iniciá-lo, e "O que mudou" já contém a própria configuração.

Seis coisas antes de alguém iniciar sessão

A página Seis pontos antes de alguém iniciar sessão enumera o que tem de se verificar antes de as pessoas serem convidadas. Não se trata de um assistente passo a passo. Realize-os por qualquer ordem e a página contabiliza-os ("Três de seis concluídos").

Ponto O que o valida
Licença Uma licença Enterprise importada. Capítulo 2.13, Licenças. A versão Community não necessita de licença.
Endereço e certificado O endereço público responde com um certificado cuja cadeia está completa.
Cópias de segurança Um agendamento de cópias de segurança definido, com um destino onde seja possível escrever.
Início de sessão da empresa Ligado e testado. Até lá, as pessoas utilizam chaves de acesso.
Correio eletrónico Um servidor de correio configurado. Até lá, não é possível enviar convites.
Modelo de IA Um modelo de IA (inteligência artificial): uma chave de modelo da organização ou um modelo no seu próprio hardware. Até lá, o assistente aguarda. Capítulo 2.14, Fornecedores e modelos de IA.

Convidar pessoas fica disponível quando todos os seis pontos se verificarem.

A mesma página enumera o que fica fixo assim que as pessoas iniciam sessão, com a razão para cada um: o nome curto nos endereços, o local onde os dados são guardados e o custodiante de chaves (as chaves podem passar de um custodiante de software para hardware, mas nunca o inverso). O nome da organização também é listado, porque vale a pena verificá-lo, embora possa ser alterado.

O Nexus não responderá ao pedido de IA de ninguém até que a organização tenha um modelo. Não existe uma chave partilhada por trás de uma instalação nem qualquer alternativa de recurso, pelo que uma organização sem chave de modelo recebe uma recusa simples que indica a um administrador o que deve adicionar.

Seis pontos antes de alguém iniciar sessão
Seis coisas antes de alguém iniciar sessão
Seis verificações por qualquer ordem, contabilizadas por extenso. As opções que ficam fixas assim que as pessoas iniciam sessão são listadas com a respetiva razão, para que ninguém seja surpreendido mais tarde.

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. Ligue o seu fornecedor de identidade na página de início de sessão da empresa: através de OIDC (OpenID Connect) na versão Community, ou através de OIDC ou SAML (Security Assertion Markup Language) na versão Enterprise.

  1. Escolha o fornecedor e a norma que este utiliza.
  2. Introduza a identidade da aplicação e o segredo da aplicação que o seu fornecedor de identidade lhe atribuiu. O segredo nunca mais é apresentado depois de o guardar.
  3. Indique quem pode iniciar sessão, por exemplo, qualquer pessoa com um endereço @harrow.example.
  4. Prima Testar início de sessão e inicie sessão com a sua própria conta. O resultado indica, por extenso, quem iniciou sessão e o que o fornecedor enviou.
  5. Guarde.

A versão Community dispõe de um início de sessão da empresa para a organização. A versão Enterprise adiciona a imposição e a sincronização de diretório. A imposição desativa as palavras-passe, para que todos tenham de utilizar o início de sessão da empresa, e uma tentativa com palavra-passe é recusada com SSO_REQUIRED e um botão para a forma correta de entrar. A sincronização de diretório copia pessoas e grupos do seu diretório a cada 15 minutos e pode atribuir a função de administrador a partir de um grupo designado.

Quando o início de sessão da empresa deixa de responder, as pessoas que já têm sessão iniciada mantêm-na, e um novo início de sessão é recusado com IDP_UNREACHABLE (503). Um administrador pode então utilizar o início de sessão de administrador de emergência guardado no cofre, juntamente com a sua chave de acesso. Cada utilização é registada no registo de auditoria, comunicada a todos os administradores e termina após quatro horas ou quando o início de sessão da empresa regressa.

Ligue o seu fornecedor de identidade
Ligue o seu fornecedor de identidade
Início de sessão da empresa com um teste. O fornecedor, a norma em letra pequena e um início de sessão de teste cujo resultado é apresentado por extenso antes que alguém dependa dele.

Convidar pessoas

Com o correio eletrónico configurado, convide pessoas a partir da página Pessoas. Para cada uma, indique o respetivo email e uma função:

  • O Membro utiliza tudo o que a organização tem e não altera definições.
  • O Administrador gere também pessoas, modelos, orçamentos e definições.

Um convite dura 7 dias. A pessoa abre-o, vê quem a convidou, a sua função e o que irá ver, e inicia sessão. É pedida uma segunda verificação no seu primeiro início de sessão.

Os membros convidados iniciam sessão na consola e realizam aí o seu trabalho diário: Hoje, o assistente, o chat de equipa, ficheiros e pesquisa, blocos de notas, agentes e fluxos de trabalho, conforme a sua função o permita. Os administradores vêem também as páginas de administração. Um membro que abra uma página de administrador recebe a página "Não é um administrador". Esta apresenta as definições apenas de leitura, explica o motivo e disponibiliza a opção de pedir a um administrador.

Convidar um colega
Convidar um colega
Um convite define a função da pessoa antes de esta chegar, Membro ou Administrador, e pode incluir uma breve nota.

Os registos requerem aprovação

As pessoas também podem pedir para aderir registando-se por iniciativa própria. Numa instalação, o registo de um estranho não cria uma conta funcional. O nexus-auth recusa-o com SIGNUP_REQUIRES_APPROVAL (403) e retém-no para aprovação de um administrador.

Existem outros dois controlos de registo no serviço alojado da Adverant, que estão desativados em todas as instalações, sem qualquer opção para os ativar. O CAPTCHA da Internet necessitaria de acesso à Internet em cada registo. O filtro de rede de registo necessitaria de uma base de dados de geolocalização licenciada que a instalação não inclui. A aprovação funciona como a porta de controlo da instalação.

Novas tentativas, códigos expirados e outras recusas

Cada recusa na primeira execução indica o que aconteceu, confirma que nada foi alterado quando assim for, e explica o que fazer a seguir.

Código Estado Quando O que fazer
CLAIM_CODE_EXPIRED 410 Passaram os 30 minutos. Nada foi reclamado e nada foi alterado. Gere um novo código com nexusctl claim-code --administrator <email> e, em seguida, prima Tenho um novo código.
CLAIM_FINGERPRINT_MISMATCH 403 A impressão digital enviada não pertence a esta instalação. Pare. Verifique o endereço e o certificado.
TRANSITION_NOT_PERMITTED 409 Foi solicitado novamente um passo que já ocorreu: a reclamação numa instalação já reclamada, ou o primeiro administrador pela segunda vez. Inicie sessão na consola; o primeiro administrador adiciona todas as outras pessoas.
TRANSITION_NOT_PERMITTED 409 O passo da chave de acesso, a partir de um navegador sem primeiro administrador em espera, ou após os seus dez minutos. Veja abaixo.
RATE_LIMITED 429 Demasiadas tentativas nas páginas da primeira execução num minuto. Nada foi enviado. Aguarde os segundos indicados pela página e tente novamente.

Um código sem tentativas restantes apresenta a mensagem "Este código não tem tentativas restantes". Gere um novo, tal como faria para um código expirado. Apenas alguém com acesso ao cluster o pode fazer, sendo esse mesmo o objetivo.

As páginas da primeira execução aceitam 20 tentativas por minuto no seu conjunto. Se não foi o utilizador a fazer essas tentativas, outra pessoa na sua rede está a tentar aceder à página, e convém sabê-lo.

Quando o passo da chave de acesso falhou

Se o primeiro administrador foi criado mas nenhuma chave de acesso foi gerada no prazo de dez minutos, ou se o navegador foi fechado, o administrador existe mas não tem forma de iniciar sessão. O passo da chave de acesso responde TRANSITION_NOT_PERMITTED com as palavras "Se criou o primeiro administrador neste navegador há mais de dez minutos, peça ajuda a um operador: o administrador existe e ainda não tem chave de acesso". A reclamação já foi utilizada nessa fase, pelo que um novo código de reclamação não ajudará. Peça ajuda ao operador que executou a instalação antes de tentar qualquer outra coisa.

Quando o navegador perdeu a reclamação

A reclamação reside no navegador que a efetuou, num cookie que a página não consegue ler. Se esse navegador a perder entre a reclamação e a criação do primeiro administrador, por exemplo numa janela privada que foi fechada, o formulário do primeiro administrador também aceita o ficheiro de reclamação e o respetivo segredo de configuração, colados manualmente.

Assim que Aoife obteve a sua chave de acesso, Tomás fechou o seu terminal. A página de reclamação estava desativada, o primeiro administrador existia e qualquer outra forma de acesso passava agora por ela.