Como transformo um usuário em administrador no Nodaro self-hosted?

Depois que o usuário criar a conta, defina a coluna role do perfil dele como admin com um comando SQL, no SQL editor do Supabase ou com o psql no contêiner do banco de dados. O painel de administração só existe na Business edition.

A Community Edition tem administradores?

Não. A Community Edition não tem painel de administração nem função de administrador no produto. Nenhum usuário tem restrições, e qualquer usuário logado pode gerenciar as chaves de provedor.

Quanto tempo leva para uma promoção a administrador valer?

Até 5 minutos, porque o Nodaro guarda em cache o status de administrador de cada usuário por 5 minutos. Reinicie o contêiner do app para aplicá-la na hora.

Para que serve PLATFORM_OWNER_EMAIL?

Essa variável indica a conta do proprietário em uma instalação Business. Nenhum outro administrador pode alterar a função dessa conta. Se ela ficar vazia, nenhuma conta é protegida.

Criar o primeiro usuário e promover um administrador no Nodaro self-hosted

Crie o primeiro usuário de um Nodaro self-hosted e promova um administrador na Business edition com um comando SQL, com ou sem o painel do Supabase.

O primeiro usuário de um Nodaro self-hosted cria a conta no app como qualquer outra pessoa e se torna o operador da instalação. Na Community Edition, é só isso: não existe função de administrador no produto. Na Business edition, você então promove uma conta a administrador com um comando SQL, porque ainda não existe nenhum administrador para fazer isso no app.

Criar a primeira conta

Abra /setup e siga a etapa 1, Crie seu login do servidor. Essa conta pertence só ao seu servidor. Ela não é uma conta do Nodaro Cloud: essa vem na etapa 2, e só se você se conectar ao Nodaro Cloud.

O serviço de login cria o usuário, e o Nodaro cria o perfil do usuário automaticamente. Na stack do Compose incluída, nenhum e-mail de confirmação é enviado, então a conta funciona na hora.

Funções

Um perfil tem uma de três funções. As funções importam na Business edition, que tem o painel de administração.

Função	O que acrescenta
`user`	O padrão. Usa o editor.
`admin`	Abre o painel de administração e gerencia as chaves de provedor da instalação.
`super_admin`	Também altera as funções de outros usuários no painel de administração.

Na Community Edition, nenhum usuário tem restrições, e qualquer usuário logado pode gerenciar as chaves de provedor.

Promover uma conta

Abrir uma sessão SQL

Em um projeto gerenciado no Supabase, abra o painel do Supabase e escolha SQL editor.

Na stack incluída, que não tem painel, abra o psql no contêiner do banco de dados:

docker compose -f docker-compose.community.yml exec db sh -c 'PGPASSWORD="$POSTGRES_PASSWORD" psql -U supabase_admin -d postgres'

Encontrar o ID do usuário

No painel do Supabase, o ID fica em Authentication › Users. No psql, liste os usuários:

SELECT id, email FROM auth.users;

Definir a função

UPDATE profiles
   SET role = 'admin'
 WHERE id = '<user_uuid>';

Use 'super_admin' em vez de 'admin' para a conta que deve gerenciar as funções dos outros usuários.

Esperar ou reiniciar

A alteração passa a valer em até 5 minutos, porque o Nodaro guarda em cache o status de administrador de cada usuário por esse tempo. Para aplicá-la na hora, reinicie o app:

docker compose -f docker-compose.community.yml restart nodaro

Proteger a conta do proprietário

Em uma instalação Business, defina PLATFORM_OWNER_EMAIL com o endereço de e-mail da conta do proprietário. A partir daí, nenhum outro administrador pode alterar a função dessa conta. Quando a variável está vazia, que é o padrão, nenhuma conta é protegida.

O arquivo do Compose não repassa PLATFORM_OWNER_EMAIL do .env. Adicione-a em environment: do serviço nodaro:

  nodaro:
    environment:
      # ...the variables already listed...
      PLATFORM_OWNER_EMAIL: owner@example.com

O painel de administração exige a Business edition

A imagem publicada e o arquivo do Compose rodam a Community Edition, que não tem painel de administração. Para ter um, primeiro mude a instalação para a Business edition: veja Edições e perfis de superfície. Os recursos de administração da Business edition são recursos Enterprise: leia Licença antes de usá-los em produção.

Primeiro usuário e administrador