Napraw sprawdzanie hosta WOPI w CODE, dopasowując źródło hosta

Gdy Collabora Online CODE zgłasza „Nieautoryzowany host WOPI”, dodaj faktycznego hosta magazynu plików – zazwyczaj źródło Nextcloud – do listy dozwolonych hostów WOPI w CODE. Host musi być zgodny ze źródłem, które CODE otrzymuje w żądaniu WOPI, a nie z publicznym adresem URL serwera Collabora. W Dockerze jest to zazwyczaj konfigurowane za pomocą aliasgroup1zmiennej środowiskowej.

Co CODE odrzuca

WOPI oznacza Web Application Open Platform Interface, protokół używany przez serwer biurowy do otwierania i zapisywania plików za pośrednictwem platformy pamięci masowej. Host WOPI to właśnie ta platforma pamięci masowej, taka jak NextCloud. CODE sprawdza, czy host wskazany w żądaniu WOPI jest hostem zaufanym. Jeśli nazwa hosta w żądaniu cloud.example.comjest skonfigurowana jako zaufana office.example.com, edytor może odrzucić sesję przed jej otwarciem.

W przypadku konfiguracji hostowanej samodzielnie, nazwa hosta w żądaniu może być wewnętrzną nazwą Dockera, taką jak nextcloudnazwa hosta wyświetlana w przeglądarce. Odwrotny serwer proxy, inny port lub oddzielne publiczne i wewnętrzne adresy URL również mogą powodować różnice w pochodzeniu. Skonfiguruj nazwę, której żądanie faktycznie używa, a nie nazwę serwera, która wydaje się być „główną”.

Znajdź kod hosta, który odrzuca

1. Odtwórz awarię raz, a następnie sprawdź dziennik kontenera CODE mniej więcej w tym samym czasie. W Docker Compose uruchom docker compose logs --since=10m collabora, zastępując collaborago nazwą swojej usługi.
2. Poszukaj komunikatu takiego jak No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Zapisz host docelowy podany w nawiasach. Nie kopiuj ani nie udostępniaj pełnego adresu URL WOPI: może on zawierać krótkotrwały token dostępu.
3. Porównaj tę nazwę hosta i schemat z adresem URL, który Twoja integracja z magazynem danych reklamuje w CODE. W NextCloud, wskazówki dotyczące rozwiązywania problemów zalecają sprawdzenie, czy skonfigurowany adres URL to adres URL NextCloud i czy CODE może się z nim połączyć. Sprawdź hosta WOPISrc, jeśli jest dostępny w logach integracji, zachowując jednocześnie prywatność tokenów ciągu zapytania.

Zezwól na poprawne pochodzenie w CODE

W przypadku oficjalnego obrazu CODE Docker należy ustawić aliasgroup1dokładne, zaufane źródło WOPI. W przypadku pojedynczej instalacji Nextcloud usługa Compose może obejmować:

services:
  collabora:
    image: collabora/code
    environment:
      aliasgroup1: "https://cloud.example.com:443"

Zastąp przykład swoim prawdziwym hostem Nextcloud oraz schematem i portem używanym przez żądanie WOPI. Zachowaj istniejący tag obrazu, ustawienia administratora, sieć i inne opcje usługi w pliku Compose. Przykład używa źródła HTTPS z portem 443; inne wdrożenie może używać innego portu lub źródła wewnętrznego.

Po edycji pliku Compose utwórz ponownie kontener CODE, aby otrzymał zaktualizowane środowisko:

docker compose up -d --force-recreate collabora

Użyj rzeczywistej nazwy usługi Compose zamiast collabora. Zwykły restart może nie załadować zmienionych wartości środowiska kontenera; ponowne utworzenie usługi spowoduje zastosowanie zaktualizowanej konfiguracji. Jeśli konfigurujesz CODE za pomocą pliku XML, sprawdź storage.wopigrupy aliasów w konfiguracji obowiązującej. Oficjalny podręcznik Collabora SDK dokumentuje grupy aliasów Dockera i aliasy hosta WOPI; postępuj zgodnie ze składnią odpowiednią dla uruchomionej wersji CODE.

Trzymaj dwie listy dozwolone oddzielnie

Collabora i Nextcloud mogą egzekwować ograniczenia związane z WOPI, ale odpowiadają na różne pytania:

Zmiana listy dozwolonych adresów IP źródłowych w Nextcloud nie naprawi problemu odrzucania nazwy hosta przez CODE. Z kolei dodanie nazwy hosta do CODE nie autoryzuje źródłowego adresu IP CODE w Nextcloud. Dokumentacja Nextcloud zaleca ograniczenie żądań WOPI do adresów IP serwera Collabora; należy używać adresu obserwowanego przez Nextcloud, który może się różnić w przypadku kontenerów lub odwrotnego proxy.

Szybkie kontrole przed zamknięciem incydentu

• Cel mówi cloud.example.com: zezwól hostowi Nextcloud i odpowiedniemu pochodzeniu w KODZIE.
• Target wskazuje nextcloud: CODE prawdopodobnie otrzymuje nazwę hosta sieci Docker; zdecyduj, czy to wewnętrzne pochodzenie jest właściwe, następnie skonfiguruj odpowiedni zaufany host i upewnij się, że jest dostępny przez DNS/sieć.
• Cel pasuje, ale nadal występuje to samo odrzucenie: sprawdź, czy edytowana zmienna należy do uruchomionej usługi CODE, czy Compose odtworzył kontener i czy żadna późniejsza konfiguracja środowiska lub XML nie zastępuje tego ustawienia.
• Rejestr zmienia się na błąd DNS, TLS, przekroczenia limitu czasu lub błędu CheckFileInfo: kontrola autoryzacji hosta może teraz przebiegać pomyślnie. Zamiast rozszerzać listę hostów WOPI, zbadaj rozpoznawanie nazw, zaufanie certyfikatu, routing lub odpowiedź na zapytanie o plik z integracji pamięci masowej.
• Nextcloud zgłasza adres nieautoryzowanego żądania: sprawdź listę dozwolonych adresów IP źródłowych Nextcloud i adres IP klienta, który faktycznie widzi.

Nie rozwiązuj problemu niezgodności, ufając każdemu hostowi lub używając nieograniczonego symbolu wieloznacznego we wdrożeniu produkcyjnym. Ogranicz listę dozwolonych do znanych źródeł pamięci masowej. Jeśli celowo używasz wielu hostów pamięci masowej, skonfiguruj udokumentowane grupy aliasów dla zainstalowanej wersji CODE, zamiast zgadywać, jak działa symbol wieloznaczny.

Sprawdź poprawność

Otwórz dokument za pomocą tej samej integracji Nextcloud, która się nie powiodła. Następnie sprawdź nowe logi CODE: odrzucenie „Brak akceptowalnych hostów WOPI” powinno zniknąć. Upewnij się, że dokument został załadowany i można go zapisać; jeśli pojawi się nowy błąd, użyj jego komunikatu, aby zidentyfikować kolejną warstwę. Informacje na temat dwóch sprawdzeń hosta i procedury rozwiązywania problemów z Nextcloud można znaleźć w sekcji „ Rozwiązywanie problemów z Nextcloud Office” i „Konfiguracja Nextcloud Office” . Informacje na temat grup aliasów Dockera w CODE można znaleźć w podręczniku Collabora Online SDK 25.04 ; jeśli konfiguracja jest inna, skorzystaj z dokumentacji odpowiadającej zainstalowanej wersji.