Como restringir as opções de exportação de arquivos no Collabora Online CODE

Para restringir a exportação de arquivos no Collabora Online CODE, faça com que o host WOPI retorne DisableExport: trueem sua CheckFileInforesposta o arquivo e o usuário afetados. Adicione HideExportOption: truetambém a opção para remover o comando "Baixar como" do menu do editor. A primeira propriedade desativa a função de exportação do Collabora no backend; a segunda controla a visibilidade. Definir apenas o sinalizador de visibilidade não é uma medida de controle de acesso.

O CODE é o editor de documentos. Em uma integração padrão, um host WOPI separado, como Nextcloud, ownCloud ou um aplicativo personalizado, armazena o arquivo original e fornece ao Collabora os metadados e permissões do arquivo. É por isso que as permissões de exportação geralmente são configuradas na integração do host, e não como uma opção universal no contêiner do Collabora coolwsd.xml.

Um diagrama de sequência mostra o Collabora Online solicitando CheckFileInfo de um host WOPI e recebendo campos de permissão de exportação.
O Collabora Online solicita informações sobre o arquivo ao host WOPI; a resposta do host pode conter restrições de exportação para aquela sessão do documento.

Selecione o controle que corresponde à ação.

Propriedade ou controle da WOPIO que fazQuando usar
HideExportOptionOculta a opção “Baixar como” no menu Arquivo.Como complemento à aplicação de políticas no backend, para que os usuários não vejam um comando indisponível.
DisableExportDesativa a funcionalidade de exportação do Collabora e implica em HideExportOption.Quando a exportação a partir do documento aberto deve ser bloqueada para um determinado arquivo ou sessão.
UserCanNotWriteRelativeInforma ao host que o usuário não pode salvar uma cópia relativa ou uma cópia "Salvar como" de volta através do WOPI. O host deve rejeitar essa solicitação.Ao usar a opção "Salvar como" ou criar uma cópia através do editor, essa ação também deve ser impedida.
DisablePrintDesativa a impressão no painel administrativo do Collabora e implica que a opção de impressão está oculta.Somente quando a impressão também é restrita; é um processo separado da exportação.

Use os dois primeiros campos para a tarefa específica de bloquear o recurso "Baixar como" ou "Exportar" do Collabora. Adicione os outros controles somente se sua política também abranger essas ações separadas. A ausência de um item de menu, por si só, não comprova que os downloads estão bloqueados.

Decida onde aplicar a restrição.

Primeiro, identifique o aplicativo que armazena o arquivo e o abre no Collabora. Na terminologia WOPI, esse aplicativo é o host. O Collabora chama o CheckFileInfoendpoint do host para obter informações e recursos do arquivo. O host sabe quem abriu o documento e se uma política de compartilhamento, conta ou arquivo permite downloads.

  • Nextcloud ou outra plataforma de arquivos integrada: use a configuração de compartilhamento ou visualização segura compatível, caso sua versão instalada ofereça uma política de "Ocultar download" ou equivalente. A integração pode traduzir essa política em permissões WOPI. Verifique a resposta do host ou a documentação atual da plataforma antes de presumir quais caminhos de exportação, impressão, cópia ou download direto ela bloqueia.
  • Seu próprio host WOPI: atualize o código que gera a CheckFileInforesposta JSON. Calcule a restrição a partir das permissões do usuário autenticado e da política de compartilhamento do arquivo.
  • Administrador do contêiner CODE sem controle do host: solicite ao administrador do host ou ao desenvolvedor de integração que aplique essa configuração. Editar apenas o contêiner CODE pode ocultar certos formatos opcionais da interface, mas não fornece uma política de permissões WOPI por arquivo.

A configuração atual do Collabora descreve extra_export_formatsessas opções como opções de nível de interface: desabilitar esses formatos opcionais apenas os oculta visualmente. Não considere essa configuração como uma imposição de exportação no servidor. Ela se destina à apresentação do menu de formatos, não como um substituto para permissões do host.

Defina as permissões de exportação em um host WOPI personalizado.

1. Localize o manipulador de resposta CheckFileInfo

Localize a rota que responde à GET /wopi/files/{id}solicitação WOPI do Collabora. Confirme como ela autentica o token de acesso e o mapeia para o usuário e arquivo atuais. Não confie em um sinalizador fornecido pelo navegador, a ?disableExport=truemenos que o host o valide de acordo com suas próprias regras de autorização.

2. Derive a decisão da política do anfitrião.

Use os dados de controle de acesso do servidor para determinar se essa pessoa pode exportar este arquivo. O proprietário do arquivo, um editor interno e um visualizador de link público podem ter direitos diferentes. Se a restrição for para um único compartilhamento, determine-a com base na política desse compartilhamento, e não em uma variável de ambiente global que afete acidentalmente todos os usuários.

O pseudocódigo ilustrativo mapeia uma política de acesso a documentos para DisableExport, HideExportOption e UserCanNotWriteRelative.
Pseudocódigo ilustrativo: derive os sinalizadores WOPI do arquivo e da política de acesso real do usuário, em vez de definir a escolha de um usuário globalmente.

3. Retornar campos WOPI booleanos

Adicione os dois campos booleanos à resposta JSON. Este é um fragmento a ser mesclado à sua CheckFileInforesposta completa existente, e não uma substituição para as propriedades de arquivo e usuário obrigatórias:

Um editor JSON mostra HideExportOption, DisableExport e UserCanNotWriteRelative definidos como verdadeiros.
Exemplos de campos de permissão CheckFileInfo. Defina a propriedade Salvar como somente quando o host também recusar solicitações de salvamento relativo.
{
  "BaseFileName": "budget.xlsx",
  "Size": 48123,
  "UserId": "viewer-42",
  "OwnerId": "team-7",
  "UserCanWrite": false,
  "HideExportOption": true,
  "DisableExport": true
}

Mantenha os campos obrigatórios e os indicadores de capacidade que sua integração já fornece. Use valores booleanos JSON , truee falsenão strings como ` "true"true` ou `false` "1". Quando a exportação for permitida, retorne `false` ou omita as propriedades opcionais de acordo com o comportamento suportado pela sua integração e versão do Collabora.

4. Bloqueie a opção "Salvar como" separadamente, se a política assim o exigir.

Exportar para um formato local e salvar uma cópia de volta no host WOPI são operações diferentes. Se os usuários não puderem criar uma cópia "Salvar como" por meio do editor, retorne UserCanNotWriteRelative: truee faça com que o host rejeite a solicitação de gravação relativa correspondente. Não presuma que isso DisableExportbloqueie todas as cópias ou caminhos de salvamento. Da mesma forma, inclua DisablePrint: truesomente quando a impressão for coberta pela política.

Um menu Arquivo no estilo Collabora omite a opção Baixar, enquanto um cartão de permissão WOPI próximo mostra a permissão UserCanNotWriteRelative ativada.
O modelo de menu omite a opção "Baixar como"; "Salvar como" é uma ação separada que o host WOPI deve rejeitar quando o salvamento relativo não é permitido.

Aplique a configuração equivalente em uma plataforma integrada.

Quando o Nextcloud gerencia o arquivo e o compartilhamento, a abordagem menos invasiva é usar suas próprias permissões de ocultar download ou visualização segura, se disponíveis para esse tipo e versão de compartilhamento. O código-fonte atual do Nextcloud Richdocuments mapeia uma política de ocultar download do lado do host para DisableExportos HideExportOptioncampos do Collabora, juntamente com restrições de impressão e cópia. Os controles exatos expostos a um administrador podem variar de acordo com a versão, edição e tipo de compartilhamento do Nextcloud; portanto, confirme o comportamento no produto instalado em vez de copiar um patch WOPI personalizado para os arquivos do aplicativo.

Se você mantiver um host WOPI diferente, implemente os campos na resposta CheckFileInfo dele. Evite modificar a configuração do contêiner gerada pelo Collabora para adicionar chaves não documentadas: a resposta WOPI é onde as permissões por arquivo são comunicadas. Após uma alteração no código do host, implante-a usando o processo de lançamento normal desse aplicativo. Reiniciar o Collabora geralmente não altera uma decisão de permissão gerada pelo host; feche e abra o documento novamente para obter uma nova resposta CheckFileInfo.

Verifique se a restrição funciona.

  1. Abra um documento de teste usando uma conta que deve ser restrita.
  2. Inspecione a resposta CheckFileInfo do host WOPI nos logs do aplicativo ou em um rastreamento de desenvolvimento seguro. Confirme se ambos os campos são booleanos JSON definidos como verdadeiros para esta sessão.
  3. No Collabora, verifique se a opção “Baixar como” está ausente e teste a ação de exportação correspondente. Não utilize um arquivo confidencial real durante a verificação inicial.
  4. Se a opção "Salvar como" também precisar ser bloqueada, verifique se a solicitação de gravação relativa do lado do host é rejeitada. O item de menu pode permanecer visível mesmo que o host recuse a operação.
  5. Abra um documento separado com permissão de exportação. Confirme se a alteração não desativou inadvertidamente a exportação para todos os usuários ou arquivos.
  6. Teste o download direto da plataforma de armazenamento separadamente. O recurso de exportação do Collabora não revoga automaticamente a permissão do usuário para baixar o arquivo original do Nextcloud, ownCloud, WebDAV ou outro endpoint de host.

Se o comando permanecer visível, confirme se a resposta corresponde ao arquivo e ao usuário testados, reabra o documento para criar uma nova sessão e verifique se o host realmente envia a mensagem HideExportOption. Se o botão desaparecer, mas a exportação ainda funcionar por outro caminho, verifique se a condição DisableExporté verdadeira e se a ação é realmente uma exportação do Collabora, e não um download oferecido pelo host de armazenamento ou por um manipulador postMessage específico da integração.

Limites de segurança e recomendações práticas

Essas configurações controlam as operações de exportação e salvamento suportadas pelo Collabora; elas não impedem que um usuário que possa visualizar o documento faça capturas de tela, fotografe a tela ou copie manualmente informações que o aplicativo permite visualizar. O Collabora também precisa receber o conteúdo do documento para renderizá-lo. Para controles de dados mais rigorosos, combine as restrições do editor com a autorização de download do host do arquivo, o escopo do token de acesso, a política de compartilhamento, o registro de auditoria e quaisquer controles de marca d'água ou prevenção de perda de dados aprovados pela organização. Descreva o resultado como uma restrição aos caminhos de exportação suportados, e não como uma impossibilidade de copiar o conteúdo visível.

Para a maioria das instalações do CODE, utilize `--user` DisableExporte HideExportOption`--document` na resposta `WOPI CheckFileInfo` gerada pelo host, com escopo definido para o usuário e documento aplicáveis. Imponha downloads diretos e a opção "Salvar como" no host e verifique as sessões restritas e permitidas após a implantação.

Referências

Deixar um comentário

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O Microsoft Access é um aplicativo de banco de dados para Windows que permite armazenar registros relacionados, criar consultas, elaborar formulários de entrada de dados e gerar relatórios. Saiba como ele funciona e quando é adequado para você.

Alterar a altura e a largura das linhas de grade no Word 2010

Alterar a altura e a largura das linhas de grade no Word 2010

Aprenda como ajustar a altura e a largura das linhas de grade no Word 2010, alterar a frequência das linhas visíveis e definir o espaçamento horizontal e vertical da grade de desenho subjacente.

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Aprenda como importar um arquivo PST para o Outlook 2010 ou exportar emails, contatos, calendário e tarefas. Siga os menus corretos e evite pastas ausentes ou duplicadas.

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere uma senha esquecida de um arquivo PST do Outlook seguindo os passos atuais do Kernel, incluindo como identificar o arquivo correto, fazer um backup e verificar as limitações da ferramenta.

Como inserir uma página da web em um slide do PowerPoint

Como inserir uma página da web em um slide do PowerPoint

Use o suplemento LiveWeb para inserir um site em um slide do PowerPoint, definir seu tamanho e comportamento de atualização e verificar a compatibilidade antes da apresentação.

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Aprenda como criar e organizar contatos no Outlook 2010, criar um grupo de contatos e selecionar pessoas salvas na Agenda de Endereços ao endereçar um e-mail.

Como criar um campo de hiperlink no Access 2010

Como criar um campo de hiperlink no Access 2010

Crie um campo de Hiperlink no Access 2010 no Modo de Exibição de Design e, em seguida, adicione e teste links para sites, e-mails ou arquivos compartilhados com os detalhes de destino corretos.

Como remover metadados e conteúdo ocultos de um documento do Word

Como remover metadados e conteúdo ocultos de um documento do Word

Use o Inspetor de Documentos do Word para revisar detalhes do autor, comentários, alterações controladas, texto oculto e outros dados antes de compartilhar, e descubra o que a verificação pode não detectar.

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Mova guias personalizadas da Faixa de Opções e comandos da Barra de Ferramentas de Acesso Rápido no Office 2010 com um arquivo .exportedUI e proteja as configurações já existentes no seu computador de destino.

Converter uma planilha do Excel em papel quadriculado imprimível

Converter uma planilha do Excel em papel quadriculado imprimível

Crie papel quadriculado imprimível no Excel ajustando as dimensões das células, definindo uma área de impressão, escolhendo papel A4 e ativando a impressão de linhas de grade no Excel para desktop.