Como configurar o visualizador de arquivos e os plugins MDM do Kopano WebApp

Você pode habilitar o visualizador de arquivos do Kopano WebApp sem instalar um pacote "FileViewer" separado na configuração documentada, mas o MDM é um plugin separado que deve ser instalado e conectado ao Z-Push. Essa distinção é importante: o manual do administrador do WebApp documenta o visualizador por meio de ENABLE_FILE_PREVIEWERum arquivo de configuração, enquanto o manual do MDM documenta um pacote dedicado, um arquivo de configuração e dependências. Instalar o complemento "Files" errado não habilitará o visualizador.

Este guia destina-se a administradores de uma implementação existente do Kopano WebApp. Os manuais publicados pela Kopano para WebApp e MDM são documentação de versões antigas, portanto, verifique se os nomes e configurações dos pacotes correspondem exatamente às versões do WebApp, PHP, Z-Push e sistema operacional que você utiliza antes de alterar o ambiente de produção. Os passos a seguir explicam o caminho documentado e como verificá-lo com segurança.

Você se refere à pré-visualização do arquivo ou ao plugin Kopano Files?

Use a visualização de arquivos integrada quando os usuários precisarem visualizar anexos de arquivos compatíveis no WebApp. A opção de administrador documentada é ENABLE_FILE_PREVIEWER`<previewer>`; ela controla se os usuários têm acesso à visualização de arquivos. O manual do WebApp não descreve isso como um pacote FileViewer separado que você instala com um gerenciador de pacotes.

O Kopano Files é diferente. Ele adiciona uma área de Arquivos para navegar e gerenciar contas de armazenamento externas, como WebDAV ou outros back-ends configurados. Pode exigir pacotes e configurações de back-end separados. Se seu objetivo é visualizar anexos, comece com a configuração do visualizador, não com o Kopano Files. Se o objetivo é conectar o armazenamento compartilhado ao WebApp, siga o manual do Files, cujo link está no final.

O que faz o MDM e quando ele é útil?

O plugin de Gerenciamento de Dispositivos Móveis (MDM) do Kopano expõe informações e ações para dispositivos móveis que sincronizam com o Kopano por meio do Z-Push. Dependendo da implementação, os usuários podem visualizar detalhes do dispositivo e executar ações como ressincronizar, remover, atualizar ou apagar. É útil quando usuários ou administradores precisam desses controles de dispositivo no aplicativo web; não substitui o Z-Push e não estabelece a sincronização móvel por si só.

O manual do Kopano MDM lista o Z-Push 2.0 ou superior e o suporte a SOAP em PHP como dependências. Se o Z-Push estiver sendo executado em um host diferente do WebApp, a configuração do MDM deve apontar para esse servidor Z-Push. Antes de instalar qualquer coisa, confirme o endpoint do Z-Push, o ambiente de execução do PHP instalado e a compatibilidade dos pacotes com o seu ambiente.

Como faço para ativar a visualização de arquivos?

Primeiro, localize o WebApp ativo config.phpusado pela sua instalação. Em uma implantação baseada em pacotes, ele geralmente está em `/etc/webapp` /etc/kopano/webapp/, mas contêineres e instalações personalizadas podem montar a configuração em outro local. Faça um backup do arquivo original antes de editá-lo e evite criar uma segunda definição se a configuração já existir.

Na configuração ativa, encontre ENABLE_FILE_PREVIEWER. O Manual de Administração do Kopano WebApp documenta truecomo mostrando aos usuários a opção de habilitar a visualização de arquivos em suas configurações, e falsecomo ocultando essa opção e desabilitando as visualizações para todos os usuários. Por exemplo:

define("ENABLE_FILE_PREVIEWER", true);

Se a linha já existir, altere o valor dela em vez de adicionar uma duplicata define(). Mantenha a sintaxe PHP intacta. Se não houver tal linha, use o modelo ou as orientações de configuração que correspondam ao pacote WebApp instalado, em vez de copiar toda a configuração de exemplo para o arquivo em produção.

Após salvar, verifique se há erros de sintaxe PHP usando o interpretador PHP que serve o WebApp. Por exemplo, se o arquivo de configuração estiver no caminho de pacote padrão:

php -l /etc/kopano/webapp/config.php

Uma verificação de sintaxe valida apenas a análise sintática do PHP; ela não confirma se a configuração foi carregada pelo site em execução. Faça login como usuário de teste, abra as Configurações do Aplicativo Web e confirme se a opção de visualização de arquivos está disponível. Habilite-a, aplique a alteração e abra um anexo de um tipo compatível com seu Aplicativo Web. Se o controle estiver ausente, confirme se você editou a configuração ativa, se os plugins e configurações do Aplicativo Web estão disponíveis e se uma atualização de pacote ou montagem de contêiner não está fornecendo outro arquivo de configuração.

Como instalar o plugin MDM?

Utilize o pacote MDM criado para a mesma versão e distribuição do Kopano WebApp que o servidor. O manual do Kopano MDM documenta um pacote para a família Debian kopano-webapp-plugins-mdme um pacote RPM para distribuições baseadas em RPM. Ele mostra o padrão de instalação do Debian abaixo; substitua o marcador pela versão real do pacote obtida de sua fonte de pacotes confiável e compatível:

sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.deb

Não digite o marcador de posição entre colchetes angulares literalmente. Se a instalação do pacote relatar dependências não resolvidas, use o processo normal de gerenciamento de pacotes da sua distribuição para resolvê-las a partir de repositórios confiáveis ​​e, em seguida, confirme se o pacote MDM instalado e a versão do WebApp são compatíveis. Evite baixar uma versão aleatória do pacote ou misturar versões para satisfazer uma dependência.

Verifique se a extensão SOAP do PHP está habilitada no ambiente PHP usado pelo aplicativo web. Uma verificação rápida é:

php -m | grep -i '^soap$'

Se não houver saída, instale e habilite a extensão SOAP que corresponda à versão do PHP e ao ambiente de execução do servidor web usados ​​pelo WebApp. Uma verificação do PHP pela linha de comando pode ser diferente da verificação feita pelo PHP-FPM ou pelo módulo PHP do Apache; portanto, compare a configuração do servidor web se o comando mostrar a presença de SOAP, mas o MDM ainda reportar uma função SOAP ausente.

Como devo configurar a conexão com o servidor MDM?

O manual do MDM publicado coloca suas configurações em /etc/kopano/webapp/config-mdm.php. Faça backup do arquivo e verifique as opções documentadas:

• PLUGIN_MDM_USER_DEFAULT_ENABLE_MDMControla se o plugin está ativado por padrão para os usuários; o manual lista o padrão como false.
• PLUGIN_MDM_SERVERIdentifica o servidor Z-Push; o padrão documentado é localhost.
• PLUGIN_MDM_SERVER_SSLdeve ser definido como truequando a conexão usa SSL/TLS; o padrão documentado é false.

Se o WebApp e o Z-Push estiverem em hosts separados, substitua a configuração de servidor padrão pelo local real do Z-Push exigido pela sua implementação. Use o protocolo e o nome do host corretos e habilite a opção SSL quando o endpoint usar HTTPS. Não exponha o endpoint publicamente apenas para que o plugin responda; mantenha-o acessível pelo caminho de rede pretendido e com um certificado válido. Preserve a sintaxe PHP usada pelo arquivo instalado.

A configuração padrão nem sempre é a escolha certa para todas as organizações. Você pode permitir que os usuários habilitem o MDM por conta própria ou habilitá-lo por padrão, caso sua política permita. Se a configuração do seu aplicativo Web desabilitar plugins globalmente ou bloquear o plugin de MDM, resolva essa configuração central primeiro; alterar apenas a configuração padrão específica do MDM não substituirá um plugin explicitamente desabilitado no nível do aplicativo Web.

Como habilitar o MDM em uma conta de usuário?

Após a instalação e configuração do pacote, faça login no WebApp e abra as Configurações, depois a aba Plugins. Selecione MDM e aplique as alterações. O manual do MDM informa que a visão geral do dispositivo aparece em uma aba MDM separada nas Configurações e inclui informações do dispositivo, a última sincronização e um ID do dispositivo. Se o plugin não estiver listado, primeiro verifique se os arquivos do pacote estão instalados no diretório de plugins ativo do WebApp e se as configurações globais de plugins não o ocultam ou desativam.

Faça o teste com uma conta que já tenha um dispositivo sincronizando via Z-Push. Se a lista de dispositivos estiver vazia, verifique se essa conta possui um dispositivo Z-Push, se a configuração do servidor MDM aponta para o serviço Z-Push correto e se o PHP SOAP está disponível para o processo do WebApp. Analise os logs do WebApp e do Z-Push em torno de uma solicitação de teste antes de alterar configurações de servidor não relacionadas.

O que você deve saber antes de usar Wipe or Remove?

Considere as ações do MDM como controles operacionais, não como botões de atualização inofensivos. O manual do MDM da Kopano alerta que a opção "Limpar" remove todos os dados do dispositivo e recomenda cautela. Teste a interface com um dispositivo não crítico e compreenda o processo de recuperação da organização antes de disponibilizar a opção "Limpar" aos usuários. Confirme o ID do dispositivo e o usuário de destino antes de executá-la.

A opção Remover também tem consequências: o manual observa que remover um dispositivo da lista significa que o usuário deve remover e reconectar a conta no telefone para que ele apareça novamente. A opção Ressincronizar solicita outra sincronização; a opção Atualizar atualiza a lista de dispositivos exibida. Não use a opção Limpar como uma etapa geral de solução de problemas para um dispositivo que simplesmente está lento para sincronizar.

Como você pode verificar ambas as funcionalidades?

Para a pré-visualização de arquivos, confirme se o usuário consegue visualizar e ativar a configuração e, em seguida, abra um anexo compatível sem baixá-lo primeiro. Para MDM, confirme se o usuário de teste consegue visualizar as informações esperadas do dispositivo e se os detalhes da última sincronização correspondem a um dispositivo que se sabe estar sincronizando via Z-Push. Teste primeiro ações de menor risco, como Atualizar ou Ressincronizar. Mantenha a opção Limpar desativada ou limitada de acordo com a política da sua organização até que você tenha validado seu impacto.

Se os controles de pré-visualização estiverem ausentes, verifique novamente a configuração do WebApp ativo e as configurações do usuário. Se o MDM estiver ausente ou não exibir nenhum dispositivo, verifique a compatibilidade do pacote, o PHP SOAP, o caminho de configuração do MDM, o host do Z-Push e as restrições globais do plugin. Os manuais publicados pela Kopano descrevem os nomes das configurações e o padrão do pacote, mas não garantem a compatibilidade com todas as distribuições e versões do PHP atuais; utilize a documentação do pacote para a versão específica do servidor como referência final.

Referências oficiais de Kopano

• Manual do Administrador do Kopano WebApp: configurações de plugins e visualizador de arquivos
• Manual do Kopano MDM: instalação e dependências
• Manual do Kopano MDM: arquivo de configuração e opções
• Manual do Kopano MDM: habilitando o plugin e as ações do dispositivo
• Manual do Kopano WebApp Files: instalação separada do plugin Files