Exportação de arquivos em bloco no Collabora CODE através do WOPI

Para impedir que os usuários exportem um documento aberto no Collabora Online CODE, configure seu host WOPI para retornar `checkFileInfo` na resposta "DisableExport": truedo documento . A documentação de integração do Collabora descreve isso como desabilitar a funcionalidade de exportação; quando configurado, a opção de menu "Baixar como" também fica oculta. `checkFileInfo` sozinho altera apenas a interface, portanto, não é o controle adequado quando o objetivo é proibir a exportação. Consulte as propriedades de resposta estendidas de `CheckFileInfo` do Collabora .CheckFileInfoHideExportOption

Use a permissão WOPI, não uma configuração exclusiva do menu.

O CODE é o componente de edição em uma integração WOPI. Seu serviço de armazenamento ou aplicativo atua como o host WOPI e fornece informações por arquivo quando o Collabora abre um documento. Isso torna o host o local apropriado para decidir se um determinado usuário pode exportar um arquivo específico.

No objeto JSON retornado pelo CheckFileInfoendpoint do host, inclua a propriedade booleana:

{
  "BaseFileName": "quarterly-plan.docx",
  "Size": 24576,
  "UserCanWrite": true,
  "DisableExport": true
}

Este é um fragmento ilustrativo, não uma resposta completa do CheckFileInfo. Mantenha os outros campos obrigatórios e quaisquer propriedades de integração existentes que seu host já retorne. O valor da chave deve ser um booleano JSON, não uma string de texto "true". Defina-o usando a mesma decisão de autorização que seu aplicativo usa para o arquivo e o usuário atual.

Por exemplo, uma organização pode permitir que os funcionários editem uma planilha de orçamento confidencial, impedindo-os de usar as funções de exportação do Collabora. Quando o host WOPI abre essa planilha para um funcionário, ele retorna um valor DisableExport: true. Para um modelo público ou um documento comum, o host pode retornar falseum valor de acordo com sua política. Um valor estático aplicado a todos os documentos é apropriado somente se todos os usuários e documentos devem receber a mesma restrição.

Atualize o host WOPI que serve o arquivo.

1. Identifique o ponto de extremidade de integração. Encontre a rota do host que responde CheckFileInfoà solicitação WOPI do Collabora para o arquivo. No Nextcloud, ownCloud ou outro produto de armazenamento, isso normalmente significa alterar a camada de integração ou política que gera a resposta; editar a configuração global do contêiner do Collabora não substitui a permissão por arquivo do host.
2. Aplique a regra no escopo correto. Obtenha o valor a partir do usuário autenticado, da classificação do arquivo, das permissões de compartilhamento ou de outra regra em seu aplicativo. Para uma política simples para todos os usuários, retorne verdadeiro para cada documento relevante. Evite depender de uma preferência de menu do navegador ou de um valor fornecido pelo cliente.
3. Retorne o valor booleano em CheckFileInfo. Certifique-se de que a resposta seja um JSON válido e inclua a propriedade na resposta recebida pelo Collabora. Uma alteração na política em nível de código pode exigir a implantação ou reinicialização do aplicativo host WOPI, dependendo de sua estrutura; o próprio CODE pode não precisar de uma alteração de configuração quando o host fornece o campo dinamicamente.
4. Reabra o documento. Feche a sessão atual do editor e abra o arquivo novamente na conta afetada. O CheckFileInfo é consultado como parte do fluxo de abertura do documento, portanto, uma sessão já aberta pode não refletir uma alteração de permissão.

O arquivo, classe, configuração ou interface administrativa exatos variam de acordo com o host WOPI e a versão do produto. A documentação da Collabora define o campo, mas não prescreve uma configuração universal para Nextcloud ou aplicativos de terceiros. Se o seu host não expõe uma restrição de download, verifique a documentação administrativa atual desse produto ou implemente a política no caminho de resposta WOPI compatível.

Quando você também deve definir HideExportOption?

Defina HideExportOptioncomo verdadeiro truequando desejar que o controle "Download as" fique oculto sem impor a proibição de exportação. Para uma restrição real, prefira `true` DisableExport: true; o guia de integração da Collabora afirma que isso também implica o comportamento de ocultação do menu. Retornar ambos os campos como verdadeiro pode explicitar a intenção em uma integração, mas não deve ser necessário para o comportamento documentado.

Não confunda isso com as extra_export_formatsentradas em coolwsd.xml. O modelo de configuração atual do Collabora afirma explicitamente que desabilitar esses formatos opcionais apenas os oculta visualmente e não desabilita a exportação do lado do servidor. Essas opções controlam quais formatos extras são oferecidos, não se um usuário está autorizado a exportar um documento. Revise o modelo de configuração atual do Collabora Online antes de alterar as configurações globais.

O que essa restrição protege — e o que ela não protege.

DisableExportAplica-se à funcionalidade de exportação do Collabora para a sessão. É útil quando os usuários devem editar um arquivo no navegador, mas não devem usar os recursos de exportação ou download do editor. Essa configuração, por si só, não remove o acesso do usuário ao arquivo original no serviço de armazenamento. Se o host ainda permitir que o usuário baixe o arquivo de origem em outro local, a configuração do Collabora não bloqueia esse acesso.

Da mesma forma, um usuário que pode visualizar o conteúdo pode copiar informações manualmente, fazer capturas de tela ou usar outros recursos do aplicativo permitidos pela sua política. Não descreva essa configuração como uma prevenção completa da exfiltração de dados ou como uma garantia de que o conteúdo não pode ser copiado. Para limitar o acesso ao original, aplique regras de download e compartilhamento também no host WOPI e no aplicativo de armazenamento. Se o seu requisito for que o usuário não veja o conteúdo de forma alguma, negue o acesso ao documento em vez de depender de um sinalizador de exportação.

Há também uma distinção entre ocultar um item da interface e desabilitar uma operação. O modelo de configuração do Collabora faz essa distinção para suas configurações opcionais de formato de exportação, enquanto o campo de resposta WOPI representa a restrição em nível de integração. A primeira ação é útil para simplificar menus; a segunda é a configuração destinada a bloquear exportações pelo Collabora. Se uma integração existente se comportar de maneira diferente, verifique a versão do Collabora e inspecione a resposta real do CheckFileInfo, em vez de presumir que um determinado produto host mapeia sua própria caixa de seleção "desabilitar download" para ambos os campos.

Verifique a restrição com uma conta de teste.

1. Utilize uma conta que não seja de administrador e que esteja em conformidade com a política de restrições e abra um documento de teste em uma nova sessão.
2. Confirme se a opção "Baixar como" do editor não está mais disponível. Se ainda aparecer, inspecione a resposta CheckFileInfo gerada para esse usuário e arquivo específicos; confirme se o campo é booleano truee se a nova resposta está sendo exibida.
3. Teste a ação de exportação através da interface normal do Collabora. A política do host deve ser refletida no comportamento do editor. Não conclua que o controle está sendo aplicado simplesmente porque o item de menu está oculto.
4. Verifique o aplicativo de armazenamento separadamente: tente usar a rota de download específica dele somente se o seu plano de testes permitir. Um download bem-sucedido significa que a política de acesso ao arquivo de origem ainda o permite, mesmo que o Collabora bloqueie as exportações.
5. Abra um documento para um usuário que tenha permissão para exportar e confirme se o seu host retorna a permissão pretendida para esse caso. Isso detecta regras que foram aplicadas globalmente por engano.

Para detalhes de implementação, utilize a referência de integração WOPI da Collabora e o modelo de configuração do projeto . O comportamento suportado pelo CODE pode variar entre versões e integrações de host, portanto, valide a resposta e o resultado na versão que você implantar. Não garantimos que uma versão de host específica ou uma implantação de exemplo tenha sido testada.