Como configurar a senha do console de administração do Collabora Online

Se você consegue abrir o Collabora Online, mas não consegue entrar no Console de Administração, as credenciais podem não ter sido configuradas para o servidor Collabora. A solução depende de como o Collabora foi instalado: uma instalação via pacote Linux utiliza o coolconfigutilitário `colaborative`, enquanto a imagem oficial do Docker do CODE aceita as variáveis ​​de ambiente `CODE_HOME` usernamee ` passwordCODE_HOME`. Esses são caminhos de instalação diferentes; escolha o que corresponde à sua implementação.

O Console de Administração é uma página de gerenciamento do lado do servidor. Não se trata da mesma conta que o administrador do Nextcloud, o login de um usuário de documento ou uma credencial de integração WOPI. O Manual do SDK da Collabora 24.04 documenta o endereço do console, o método de configuração do Linux e as variáveis ​​da imagem Docker. Como os detalhes de implantação podem mudar entre versões, verifique a documentação da versão que você está executando antes de aplicar uma alteração em produção: Manual do SDK Online da Collabora 24.04 .

Escolha o método de configuração que melhor se adapta à sua instalação.

Primeiro, identifique a implantação. Se coolwsdo serviço for executado diretamente como um serviço do sistema e o host tiver o coolconfigcomando, use o método de pacote. Se o serviço for executado em um contêiner baseado em collabora/code, configure o ambiente dele. Evite definir uma senha no host e esperar que ela altere um contêiner já em execução.

Para instalar um pacote Linux, defina uma senha interativamente.

1. Abra um terminal no servidor Collabora ou conecte-se via SSH usando uma conta com acesso sudo.
2. Correr sudo coolconfig set-admin-password.
3. Quando solicitado, insira o nome de usuário e a senha do Console de Administração e, em seguida, confirme a senha. O terminal não deve exibir a senha enquanto você digita.
4. Se a sua instalação exigir a reinicialização do serviço após uma alteração de configuração, execute sudo systemctl restart coolwsd. Verifique o estado do serviço com sudo systemctl status coolwsd.
5. Abra o URL do Console de Administração e faça login com as credenciais que você acabou de configurar.

O utilitário documentado solicita o nome de usuário e a senha interativamente e armazena a senha como um hash com salt no arquivo de configuração. Isso é preferível a inserir uma senha em texto simples diretamente na linha de comando ou escrever manualmente uma senha em XML. Trate o comando como uma ação administrativa: execute-o no host do Collabora, não no host do Nextcloud, a menos que o Collabora também esteja instalado lá.

Caso coolconfignão seja encontrado, confirme se esta é uma instalação do Collabora baseada em pacote e se você está no servidor correto. Um contêiner CODE possui seu próprio mecanismo de configuração. Se o comando for bem-sucedido, mas a autenticação ainda falhar, verifique o nome do host e a porta, tente novamente com o mesmo nome de usuário que você definiu e inspecione os logs de serviço antes de alterar configurações de proxy ou WOPI não relacionadas.

Para a imagem Docker CODE, defina ambas as variáveis ​​de ambiente.

A imagem oficial do CODE lê usernameo passwordarquivo de ambiente quando o contêiner é iniciado. Adicione ambos os valores à configuração do contêiner; definir apenas uma senha não é suficiente. Para o Docker Compose, um mapeamento pode ser semelhante a este:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      username: collabora_admin
      password: ${COLLABORA_ADMIN_PASSWORD}

Mantenha a senha real em um arquivo de ambiente protegido ou em um repositório de segredos de implantação, em vez de enviá-la para um repositório de código-fonte ou colá-la em uma solicitação de suporte pública. Um .envarquivo Compose é conveniente para substituição de variáveis, mas ainda é um arquivo que contém dados confidenciais: restrinja quem pode lê-lo. Qualquer pessoa com acesso ao daemon do Docker geralmente pode inspecionar a configuração do contêiner, portanto, as variáveis ​​de ambiente não substituem os controles de acesso no host.

Salve o arquivo Compose e recrie o contêiner para que o Docker passe o ambiente atualizado na inicialização. Para um serviço chamado `service` collabora, geralmente é `service` docker compose up -d --force-recreate collabora. Uma simples reinicialização do contêiner não substitui os valores de ambiente armazenados quando o contêiner foi criado. Verifique a versão do Compose e o nome do serviço antes de executar o comando e evite exibir uma senha literal no histórico do shell.

Para uma docker runimplantação direta, as configurações equivalentes são variáveis ​​de ambiente passadas com `--env` -e, como -e username=collabora_admin`--secret` e `--secret` -e password=.... Use sua abordagem de gerenciamento de segredos para fornecer o valor; não copie uma senha de exemplo de um tutorial para um serviço exposto à internet.

Abra o Console de Administração e verifique o login.

O caminho do console documentado é /browser/dist/admin/admin.html. Na porta padrão, o URL completo é https://your-collabora-host:9980/browser/dist/admin/admin.html. Se o TLS terminar em um proxy reverso, use o nome de host e a porta HTTPS públicos expostos por esse proxy. O endereço pode ser diferente se o administrador configurou uma porta ou roteamento de URL não padrão.

Faça login e confirme se o console carrega as informações de monitoramento. O Manual do SDK descreve o monitoramento de sessões em tempo real, incluindo documentos abertos e usuários. Como o console pode expor detalhes operacionais e permite ações administrativas, como o encerramento de sessões de documentos, limite o acesso a administradores confiáveis, use HTTPS e evite expor o endpoint de gerenciamento amplamente à internet pública. Aplique restrições de rede no firewall ou proxy reverso, se sua implementação as suportar.

Para a instalação de um pacote, confirme se o serviço está íntegro com `service status` sudo systemctl status coolwsd. Para o Docker, inspecione o estado do contêiner com `docker status` docker compose pse seus logs recentes com `docker logs` docker compose logs --tail=100 collabora. Um serviço íntegro por si só não comprova que a senha está correta; a verificação final é o login bem-sucedido no URL do Console de Administração.

Conceitos errôneos comuns e o que fazer em vez disso.

“O painel de administração usa minha senha do Nextcloud.”

Não por padrão. As credenciais do Console de Administração do Collabora são configuradas no servidor Collabora, independentemente das contas de usuário do Nextcloud. Ação: use coolconfig set-admin-passwordem uma instalação de pacote ou atualize o ambiente do contêiner CODE e recrie o contêiner.

"Eu alterei o arquivo Docker Compose, então o contêiner em execução agora tem a nova senha."

Editar o arquivo não altera o ambiente salvo de um contêiner existente. Ação: recrie o serviço Compose relevante e teste as novas credenciais. Mantenha a senha fora da saída do comando e do controle de versão.

“Se o URL do Console de Administração abrir, o servidor está seguro.”

O acesso à página apenas comprova que a rota responde; não comprova que credenciais fortes estão configuradas ou que o acesso à rede está restrito. O Manual do SDK informa que o console é desativado quando o nome de usuário ou a senha necessários não são definidos e descreve as funções de monitoramento administrativo. Ação: defina uma senha exclusiva, confirme se a autenticação é necessária e restrinja quem pode acessar o endpoint do console.

“O Console de Administração é o local para definir as credenciais de edição de documentos.”

A senha do console protege a interface de gerenciamento. Ela não substitui a configuração do host WOPI nem o sistema de identidade usado pela sua plataforma de arquivos. Ação: deixe as configurações do WOPI e do proxy reverso inalteradas, a menos que você esteja solucionando problemas dessas conexões separadas.

Se o login ainda falhar

• Confirme se o Collabora está sendo executado como um serviço host ou em um contêiner CODE e, em seguida, use apenas o caminho de configuração correspondente.
• Verifique o URL exato do console público, incluindo HTTPS, porta e /browser/dist/admin/admin.html.
• Para o Docker, confirme se ambos os parâmetros `--service` usernamee password`--service-config` estão presentes na configuração efetiva do serviço e recrie o contêiner após as alterações.
• Para instalar um pacote, execute novamente o coolconfigcomando interativo no host do Collabora e verifique coolwsdo status e os registros.
• Se um proxy reverso estiver envolvido, peça ao administrador para verificar se a rota do Console de Administração e todo o tráfego WebSocket necessário estão sendo encaminhados corretamente. Não enfraqueça a autenticação para contornar um problema de proxy.

Após conseguir iniciar sessão e o serviço estiver funcionando corretamente, armazene as novas credenciais em seu gerenciador de senhas aprovado e registre qual host ou contêiner é o proprietário delas. A configuração do Console de Administração do Collabora pode variar de acordo com a versão e o método de empacotamento; o Manual do SDK 24.04 citado acima é específico para esta versão, portanto, use a documentação correspondente para uma implementação mais recente ou personalizada pelo fornecedor.