Blokowanie eksportu plików w Collabora CODE przez WOPI

Aby uniemożliwić użytkownikom eksportowanie otwartego dokumentu w usłudze Collabora Online CODE, host WOPI powinien zwrócić odpowiedź "DisableExport": truetego dokumentu CheckFileInfo. Dokumentacja integracji Collabora opisuje to jako wyłączenie funkcji eksportu; po ustawieniu tej opcji, opcja menu „Pobierz jako” również jest ukryta. HideExportOptionSamo to zmienia jedynie interfejs, więc nie jest to właściwe ustawienie, gdy celem jest zablokowanie eksportu. Zobacz rozszerzone właściwości odpowiedzi CheckFileInfo usługi Collabora .

Użyj uprawnienia WOPI, a nie ustawienia dostępnego tylko w menu

CODE to komponent edycyjny w integracji WOPI. Usługa pamięci masowej lub aplikacji pełni rolę hosta WOPI i dostarcza informacje o każdym pliku, gdy Collabora otwiera dokument. Dzięki temu host jest właściwym miejscem do decydowania, czy dany użytkownik może wyeksportować konkretny plik.

W obiekcie JSON zwróconym przez punkt końcowy hosta CheckFileInfonależy uwzględnić właściwość logiczną:

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

To fragment przykładowy, a nie kompletna odpowiedź CheckFileInfo. Zachowaj pozostałe wymagane pola i wszelkie istniejące właściwości integracji, które Twój host już zwraca. Wartość klucza musi być wartością logiczną JSON, a nie ciągiem tekstowym "true". Ustaw ją, używając tej samej decyzji autoryzacyjnej, której Twoja aplikacja używa dla pliku i bieżącego użytkownika.

Na przykład organizacja może zezwolić pracownikom na edycję poufnego skoroszytu budżetowego, jednocześnie uniemożliwiając im korzystanie z funkcji eksportu Collabora. Gdy host WOPI otwiera ten skoroszyt dla pracownika, zwraca DisableExport: true. W przypadku szablonu publicznego lub zwykłego dokumentu host może zwrócić wartość falsezgodnie ze swoją polityką. Wartość statyczna zastosowana do każdego dokumentu jest odpowiednia tylko wtedy, gdy każdy użytkownik i każdy dokument powinien mieć takie samo ograniczenie.

Zaktualizuj hosta WOPI, który obsługuje plik

1. Zidentyfikuj punkt końcowy integracji. Znajdź trasę hosta odpowiadającą CheckFileInfona żądanie WOPI usługi Collabora dotyczące pliku. W NextCloud, OwnCloud lub innym produkcie do przechowywania danych zazwyczaj oznacza to zmianę warstwy integracji lub polityki, która generuje odpowiedź; edycja globalnej konfiguracji kontenera Collabora nie zastępuje uprawnień hosta dla każdego pliku.
2. Zastosuj regułę w odpowiednim zakresie. Wyprowadź wartość z uwierzytelnionego użytkownika, klasyfikacji pliku, uprawnień udziału lub innej reguły w aplikacji. Aby uzyskać prostą politykę dla wszystkich użytkowników, zwróć wartość true dla każdego odpowiedniego dokumentu. Unikaj polegania na preferencjach menu po stronie przeglądarki lub wartościach dostarczonych przez klienta.
3. Zwróć wartość logiczną w CheckFileInfo. Upewnij się, że odpowiedź jest poprawnym formatem JSON i zawiera właściwość w odpowiedzi otrzymanej przez Collabora. Zmiana zasad na poziomie kodu może wymagać wdrożenia lub ponownego uruchomienia aplikacji hosta WOPI, w zależności od jej struktury; sam CODE może nie wymagać zmiany konfiguracji, gdy host dynamicznie dostarcza pole.
4. Otwórz ponownie dokument. Zamknij bieżącą sesję edytora i otwórz plik ponownie na koncie, którego dotyczy problem. Kontrola CheckFileInfo jest przeprowadzana w ramach procesu otwierania dokumentu, więc otwarta sesja może nie odzwierciedlać zmiany uprawnień.

Dokładny plik, klasa, ustawienie lub interfejs administracyjny różnią się w zależności od hosta WOPI i wersji produktu. Dokumentacja Collabora definiuje to pole, ale nie określa uniwersalnego ustawienia NextCloud ani aplikacji innych firm. Jeśli Twój host nie udostępnia ograniczenia pobierania, sprawdź aktualną dokumentację administracyjną tego produktu lub zaimplementuj politykę w obsługiwanej ścieżce odpowiedzi WOPI.

Kiedy należy ustawić HideExportOption?

Ustaw HideExportOption, trueaby ukryć kontrolkę „Pobierz jako” bez egzekwowania zakazu eksportu. W przypadku faktycznego ograniczenia, preferuj DisableExport: true; przewodnik integracji Collabora mówi, że implikuje to również zachowanie ukrywania menu. Zwrócenie obu pól jako „prawda” może wyraźnie określić intencję w integracji, ale nie powinno być konieczne dla udokumentowanego zachowania.

Nie należy mylić tego z extra_export_formatswpisami w coolwsd.xml. Aktualny szablon konfiguracji Collabora wyraźnie stwierdza, że ​​wyłączenie tych opcjonalnych formatów powoduje jedynie ich wizualne ukrycie i nie wyłącza eksportu po stronie serwera. Opcje te kontrolują, jakie dodatkowe formaty są oferowane, a nie to, czy użytkownik jest upoważniony do eksportu dokumentu. Przed zmianą ustawień globalnych należy zapoznać się z aktualnym szablonem konfiguracji Collabora Online .

Czego to ograniczenie chroni, a czego nie

DisableExportDotyczy funkcji eksportu Collabora dla sesji. Jest to przydatne, gdy użytkownicy powinni edytować plik w przeglądarce, ale nie powinni korzystać z funkcji eksportu ani pobierania edytora. Samo w sobie nie blokuje dostępu użytkownika do oryginalnego pliku w usłudze przechowywania. Jeśli host nadal pozwala użytkownikowi pobrać plik źródłowy z innego miejsca, ustawienie Collabora nie zamyka tej ścieżki.

Podobnie, użytkownik, który może przeglądać zawartość, może kopiować informacje ręcznie, robić zrzuty ekranu lub korzystać z innych funkcji aplikacji dozwolonych przez Twoją politykę. Nie należy opisywać tego ustawienia jako zapobiegającego wszelkiemu wyciekowi danych ani gwarantującego, że zawartość nie może zostać skopiowana. Aby ograniczyć dostęp do oryginału, należy wymusić reguły pobierania i udostępniania również w aplikacji hostującej WOPI i aplikacji pamięci masowej. Jeśli wymagane jest, aby użytkownik w ogóle nie widział zawartości, należy zablokować dostęp do dokumentu zamiast polegać na fladze eksportu.

Istnieje również rozróżnienie między ukryciem elementu interfejsu a wyłączeniem operacji. Szablon konfiguracji Collabora uwzględnia to rozróżnienie w opcjonalnych ustawieniach formatu eksportu, natomiast pole odpowiedzi WOPI stanowi ograniczenie na poziomie integracji. Pierwsza czynność jest przydatna do uproszczenia menu; druga to ustawienie mające na celu zablokowanie eksportu przez Collabora. Jeśli istniejąca integracja zachowuje się inaczej, należy zweryfikować jej wersję Collabora i sprawdzić rzeczywistą odpowiedź CheckFileInfo, zamiast zakładać, że konkretny produkt hosta mapuje własne pole wyboru „wyłącz pobieranie” na oba pola.

Sprawdź ograniczenie za pomocą konta testowego

1. Użyj konta innego niż konto administratora, które spełnia zasady ograniczeń, i otwórz dokument testowy w nowej sesji.
2. Sprawdź, czy opcja „Pobierz jako” w edytorze nie jest już dostępna. Jeśli nadal się pojawia, sprawdź odpowiedź CheckFileInfo wygenerowaną dla tego konkretnego użytkownika i pliku; upewnij się, że pole jest wartością logiczną truei że nowa odpowiedź jest wyświetlana.
3. Przetestuj akcję eksportu za pomocą standardowego interfejsu Collabora. Polityka hosta powinna być odzwierciedlona w działaniu edytora. Nie wyciągaj wniosku, że kontrolka jest wymuszana tylko dlatego, że element menu jest ukryty.
4. Sprawdź aplikację do przechowywania danych osobno: wypróbuj jej własną ścieżkę pobierania tylko wtedy, gdy Twój plan testowy na to pozwala. Pomyślne pobranie oznacza, że ​​polityka dostępu do pliku źródłowego nadal na to pozwala, nawet jeśli Collabora blokuje eksport.
5. Otwórz dokument dla użytkownika, który ma uprawnienia do eksportu i sprawdź, czy Twój host zwraca odpowiednie uprawnienia w tym przypadku. To wychwyci reguły, które zostały zastosowane globalnie przez pomyłkę.

Aby uzyskać szczegółowe informacje na temat implementacji, skorzystaj z dokumentacji integracji WOPI Collabora oraz szablonu konfiguracji projektu . Obsługiwane zachowanie CODE może się różnić w zależności od wersji i integracji hosta, dlatego należy zweryfikować odpowiedź i wynik w wersji, którą wdrażasz. Nie twierdzimy, że przetestowano konkretną wersję hosta lub przykładowe wdrożenie.