Połącz Seafile i Collabora z poprawnym adresem URL WOPI
Włącz bezpieczne edytowanie dokumentów w Seafile, konfigurując adres URL wykrywania, protokół HTTPS i dostęp WOPI Collabora dla swojego wdrożenia.
Zacznij od przetestowania zwykłego tekstu i klawiatury: skopiuj z aplikacji lokalnej, kliknij w dokumencie Collabora i naciśnij Ctrl+V(lub Command+Vw systemie macOS). Aby skopiować, zaznacz tekst w Collabora, naciśnij Ctrl+Club Command+C, a następnie wklej do aplikacji lokalnej. Jeśli skróty działają, ale pasek narzędzi lub opcja Wklej po kliknięciu prawym przyciskiem myszy nie działają, prawdopodobnym problemem jest ścieżka uprawnień schowka w przeglądarce. Jeśli skróty również zawodzą, przetestuj oba kierunki i sprawdź, czy Collabora jest osadzona w innej witrynie.
Schowek systemowy to współdzielony bufor, który przesyła dane między aplikacjami. Collabora Online działa w przeglądarce, więc kopiowanie poza jej granice również podlega regułom bezpieczeństwa przeglądarki.
Do pierwszego testu użyj zwykłego tekstu. Obrazy, tabele, zakresy arkuszy kalkulacyjnych i sformatowany tekst mogą korzystać z różnych formatów schowka, dlatego test zwykłego tekstu oddziela problemy z dostępem podstawowym od problemów z konwersją formatu.

Kliknij obszar edycji dokumentu, aby go zaznaczyć. Użyj skrótu systemowego zamiast paska narzędzi edytora lub menu kontekstowego przeglądarki. W systemach Windows i Linux użyj Ctrl+Ci Ctrl+V; w systemie macOS użyj Command+Ci Command+V. Gdy w aplikacji Collabora pojawi się komunikat informujący o ograniczonym dostępie przeglądarki do schowka i proszący o użycie skrótów, postępuj zgodnie z tą instrukcją. Akcja klawiatury jest bezpośrednio powiązana z gestem użytkownika i może działać nawet wtedy, gdy zablokowana jest akcja menu wywołująca asynchroniczne API schowka.
Jeśli nie, upewnij się, że dokument jest edytowalny, kursor znajduje się w dokumencie, a nie w polu wyszukiwania lub pasku narzędzi, oraz że tekst źródłowy został faktycznie zaznaczony. Zamknij i ponownie otwórz dokument po zmianie uprawnień; nieaktualna ramka edytora może zachować poprzednią politykę.
Najpierw sprawdź, czy zwykły tekst dociera. Następnie przetestuj potrzebną treść rozszerzoną; czcionki, formuły, obrazy i formaty komórek mogą nie zostać przeniesione identycznie. Użyj opcji Wklej specjalnie, gdy miejsce docelowe ją oferuje.
Nowoczesne API Schowka jest ograniczone do bezpiecznych kontekstów, zazwyczaj HTTPS, a przeglądarki mogą wymagać gestu lub zgody użytkownika. W Chrome lub Edge otwórz kontrolkę informacji o witrynie obok adresu, otwórz ustawienia witryny i ustaw Schowek na Zezwalaj dla zaufanej witryny, gdy to uprawnienie jest dostępne. Jeśli po wybraniu opcji Wklej w przeglądarce pojawi się monit, zezwól na wklejanie tylko w przypadku zaufanej usługi pakietu Office. Załaduj ponownie dokument i powtórz test tekstu dwukierunkowego.

Etykiety i zachowanie uprawnień w schowku różnią się w zależności od przeglądarki. Niektóre przeglądarki używają gestu użytkownika lub krótkotrwałego monitu o wklejenie zamiast stałego uprawnienia. Przeglądarka zarządzana może również wymusić politykę, która zastępuje Twój wybór; jeśli kontrola jest zablokowana lub uprawnienie jest odrzucane przez politykę, poproś administratora przeglądarki o sprawdzenie reguły dla witryny biurowej. Utrzymuj witrynę w protokole HTTPS: udzielenie uprawnienia nie zmienia niebezpiecznego źródła w bezpieczny kontekst.
Ramka iframe to strona internetowa osadzona w innej stronie. Wiele wdrożeń Collabora korzysta z niej, aby platforma hostująca mogła wyświetlić edytor. W przeglądarkach opartych na Chromium ramka międzydomenowa może wymagać strony osadzenia, aby delegować dostęp do schowka. Podręcznik Collabora SDK opisuje ten atrybut ramki iframe dla zapytania o uprawnienia do schowka:
<iframe allow="clipboard-read *; clipboard-write *">
To ustawienie integracji, która tworzy ramkę, a nie ustawienie Dockera na serwerze Collabora. Jeśli zarządzasz aplikacją hosta, zweryfikuj rzeczywistą ramkę iframe edytora w narzędziach programistycznych przeglądarki i upewnij się, że Permissions-Policynagłówek odpowiedzi strony nadrzędnej nie blokuje clipboard-readani nie blokuje clipboard-write. Restrykcyjna polityka nadrzędna może nadal odmawiać dostępu, nawet gdy ramka iframe ma allowatrybut. Deleguj uprawnienia tylko do ramki Collabora, której potrzebują Twoi użytkownicy; nie udzielaj szerokiego dostępu do schowka do niepowiązanej, osadzonej zawartości.
Jeśli korzystasz z hostowanej usługi NextCloud, platformy edukacyjnej lub portalu dokumentów i nie możesz edytować znaczników ramki ani nagłówków odpowiedzi, wyślij administratorowi informacje o przeglądarce i jej wersji, informację o tym, który kierunek nie został wybrany, czy skróty klawiaturowe działają oraz wszelkie błędy konsoli związane ze schowkiem. Może być konieczna aktualizacja integracji. Zmiana portów sieciowych CODE lub ponowne uruchomienie kontenera nie przyzna uprawnień do obsługi ramek iframe w przeglądarce.
| To, co obserwujesz | Co sprawdzić dalej |
|---|---|
Wklejanie paska narzędzi nie powiodło się, ale Ctrl+Vdziała | Użyj skrótu lub przyznaj przeglądarce uprawnienia do dostępu do zaufanej witryny. |
| Tylko kopiowanie na komputer stacjonarny za pomocą funkcji Collabora-in kończy się niepowodzeniem | Sprawdź ograniczenia kopiowania lub uprawnienia zapisu przeglądarki; potwierdź, że skopiowany został zaznaczony tekst. |
| Tylko wklejanie z pulpitu do aplikacji Collabora kończy się niepowodzeniem | Sprawdź uprawnienia przeglądarki do wklejania, fokus w dokumencie i czy ramka hosta deleguje dostęp do odczytu. |
| Konsola informuje: „Interfejs API schowka został zablokowany przez zasady uprawnień” | Strona osadzania lub jej nagłówek odpowiedzi blokuje dostęp. Właściciel integracji musi to poprawić. |
| Zwykły tekst działa, ale bogata treść nie | Porównaj obsługiwane formaty schowka i opcje wklejania w aplikacji docelowej. Może to być ograniczenie dotyczące wierności formatu, a nie całkowita awaria schowka. |

Po zmianie uprawnień lub integracji otwórz ponownie dokument i powtórz oba testy zwykłego tekstu: z aplikacji lokalnej do Collabora, a następnie z Collabora do aplikacji lokalnej. Upewnij się, że tekst pojawia się w odpowiednim miejscu, a następnie przetestuj konkretną, rozbudowaną zawartość, na której polegasz. Jeśli po zmianie działa tylko menu, sprawdź również ścieżkę klawiatury; jeśli działają tylko skróty, główna ścieżka do schowka jest użyteczna, ale asynchroniczna ścieżka uprawnień przeglądarki może być nadal zablokowana.
Aby zapoznać się z zasadami bezpieczeństwa dotyczącymi dostępu do schowka przeglądarki, zapoznaj się z dokumentacją API schowka MDN . Aby uzyskać informacje o kontroli uprawnień witryny Chrome, skorzystaj z pomocy dotyczącej ustawień witryny Chrome . Właściciele integracji mogą zapoznać się z zaawansowaną dokumentacją integracji Collabora , aby uzyskać informacje o wymaganiach dotyczących uprawnień schowka iframe.
Włącz bezpieczne edytowanie dokumentów w Seafile, konfigurując adres URL wykrywania, protokół HTTPS i dostęp WOPI Collabora dla swojego wdrożenia.
Przetestuj schowek systemowy, dostosuj uprawnienia przeglądarki i zidentyfikuj, kiedy wbudowana integracja Collabora wymaga zmiany zasad dotyczących ramek iframe.
Zamontuj pliki czcionek w systemie Docker i Collabora, aby niestandardowe czcionki były wyświetlane w edytorze i poprawnie renderowane w dokumentach.
Utwórz kopię zapasową pliku coolwsd.xml i jego źródeł wdrożeniowych, przywróć je w bezpieczny sposób i zweryfikuj KOD przed ponownym rozpoczęciem edycji przez użytkowników.
Zezwól na konkretne źródło Nextcloud lub inne źródło WOPI w KODZIE, a następnie zweryfikuj listę dozwolonych hostów i odróżnij je od ograniczeń adresu IP źródłowego Nextcloud.
Prześledź połączenia przeglądarki, WOPI i WebSocket Collabora, aby dowiedzieć się, dlaczego dokument się nie otwiera, a następnie zastosuj poprawkę odpowiadającą konfiguracji Nextcloud.
Wdrażaj repliki Collabora CODE za pomocą Helm, przechowuj każdy dokument w jednym podzie dzięki powinowactwu WOPI i weryfikuj przychodzące dane, rozmieszczenie węzłów i edycję w Nextcloud.
Prześledź nieudaną wymianę danych między przeglądarką a coolwsd, a następnie dopasuj trasę odwrotnego serwera proxy do swojej wersji Collabora, włączając w to zmianę w kodzie CODE 26.04 Apache.
Śledź błędy dowodowe Collabora WOPI w przypadku niedopasowanych kluczy, nieaktualnych danych wykrywania, przesunięcia zegara lub zmian adresu URL serwera proxy — bez osłabiania walidacji.
Zresetuj powiększenie przeglądarki, przetestuj czystą sesję i zidentyfikuj, kiedy nieprawidłowo sformatowane menu rozmiarów wymaga aktualizacji serwera Collabora.