Versão 1.0.0-alpha.1mais recente
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

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.
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.examplenexusctl 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
- 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. - 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.
- Compare a Impressão digital desta instalação na página com a do terminal, todos os oito grupos, um de cada vez.
- Se todos os grupos coincidirem, assinale Todos os oito grupos coincidem com o que o meu terminal apresenta.
- Prima Reclamar esta instalação; a página confirma a reclamação e encaminha-o para o primeiro administrador.
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.
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."
A chave de acesso (passkey): a segunda verificação
- Prima Configurar a chave de acesso e iniciar sessão.
- 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.
- 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.
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.
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.
- Escolha o fornecedor e a norma que este utiliza.
- 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.
- Indique quem pode iniciar sessão, por exemplo, qualquer pessoa com um endereço
@harrow.example. - 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.
- 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.
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.
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.






