Remediați verificarea gazdei WOPI din CODE prin potrivirea originii gazdei

Când Collabora Online CODE raportează „Gazdă WOPI neautorizată”, adăugați gazda de stocare a fișierelor propriu-zisă - de obicei originea Nextcloud - la lista de gazde WOPI permise a CODE. Gazda trebuie să corespundă cu originea pe care CODE o primește în solicitarea WOPI, nu cu adresa URL publică a serverului Collabora. În Docker, acest lucru este de obicei configurat cu aliasgroup1variabila de mediu.

Ce respinge CODUL

WOPI înseamnă Web Application Open Platform Interface (Interfață pentru Platformă Deschisă pentru Aplicații Web), protocolul utilizat de un server de birou pentru a deschide și salva fișiere prin intermediul unei platforme de stocare. Gazda WOPI este platforma de stocare respectivă, cum ar fi Nextcloud. CODE verifică gazda numită în solicitarea WOPI în raport cu gazdele în care are încredere. Dacă solicitarea numește, cloud.example.comdar CODE este configurat să aibă încredere doar în [trust only] office.example.com, editorul poate refuza sesiunea înainte de a se deschide.

Pentru o configurație auto-găzduită, numele de gazdă din cerere poate fi un nume Docker intern, cum ar fi [ nextcloudnumele de server], mai degrabă decât numele de gazdă afișat în browser. Un proxy invers, un port diferit sau adrese URL publice și interne separate pot, de asemenea, să facă originea diferită. Configurați ceea ce folosește de fapt cererea, nu ceea ce pare a fi numele serverului „principal”.

Găsiți gazda CODE care respinge

1. Reproduceți eroarea o dată, apoi inspectați jurnalul containerului CODE în jurul acelui moment. Cu Docker Compose, executați docker compose logs --since=10m collabora, înlocuind collaboracu numele serviciului dvs.
2. Căutați un mesaj precum No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Înregistrați gazda țintă afișată între paranteze. Nu copiați și nu partajați o adresă URL WOPI completă: aceasta poate conține un token de acces de scurtă durată.
3. Comparați numele de gazdă și schema cu adresa URL pe care integrarea dvs. de stocare o promovează către CODE. În Nextcloud, îndrumările de depanare recomandă verificarea faptului că adresa URL configurată este adresa URL Nextcloud și că CODE o poate accesa. Verificați gazda WOPISrc, dacă este disponibilă în jurnalele de integrare, păstrând în același timp privat orice token de șir de interogare.

Permiteți originea corectă în COD

Pentru imaginea oficială CODE Docker, setați aliasgroup1originea WOPI exactă de încredere. Pentru o singură instalare Nextcloud, un serviciu Compose poate include:

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

Înlocuiți exemplul cu gazda Nextcloud reală și cu schema și portul pe care le utilizează solicitarea WOPI. Păstrați eticheta de imagine existentă, setările de administrator, rețeaua și alte opțiuni de serviciu în fișierul Compose. Exemplul utilizează o origine HTTPS cu portul 443; o implementare diferită poate utiliza un alt port sau o origine internă.

După editarea fișierului Compose, recreați containerul CODE astfel încât să primească mediul actualizat:

docker compose up -d --force-recreate collabora

Folosește numele real al serviciului Compose în locul lui collabora. O simplă repornire poate să nu încarce valorile modificate ale mediului containerului; recrearea serviciului aplică configurația actualizată. Dacă configurați CODE prin fișierul său XML, verificați storage.wopigrupurile de aliasuri din configurația efectivă. Manualul oficial Collabora SDK documentează grupurile de aliasuri Docker și aliasurile gazdei WOPI; urmează sintaxa pentru versiunea de CODE pe care o rulezi.

Păstrați cele două liste de permisiuni separate

Collabora și Nextcloud pot aplica fiecare o restricție legată de WOPI, dar răspund la întrebări diferite:

Modificarea listei de adrese IP sursă permise a Nextcloud nu va corecta respingerea unui nume de gazdă de către CODE. În schimb, adăugarea unui nume de gazdă la CODE nu autorizează adresa IP sursă a CODE la Nextcloud. Documentația Nextcloud recomandă restricționarea solicitărilor WOPI la adresele IP ale serverului Collabora; utilizați adresa observată de Nextcloud, care poate diferi atunci când sunt implicate containere sau un proxy invers.

Verificări rapide înainte de închiderea incidentului

• Target spune cloud.example.com: permiteți acea gazdă Nextcloud și originea corespunzătoare în CODE.
• Target spune nextcloud: CODE primește probabil un nume de gazdă Docker-network; decideți dacă este intenționată acea origine internă, apoi configurați gazda de încredere corespunzătoare și asigurați accesibilitatea DNS/rețelei.
• Ținta se potrivește, dar aceeași respingere persistă: confirmați că variabila editată aparține serviciului CODE care rulează, că Compose a recreat containerul și că niciun mediu sau configurație XML ulterioară nu suprascrie setarea.
• Jurnalul se modifică la o eroare DNS, TLS, timeout sau CheckFileInfo: verificarea autorizării gazdei ar putea trece acum. Investigați rezoluția numelui, încrederea în certificat, rutarea sau răspunsul file-info al integrării de stocare în loc să extindeți lista de gazde WOPI.
• Nextcloud raportează o adresă de solicitare neautorizată: verificați lista de adrese IP sursă permise a Nextcloud și adresa IP client pe care o vede efectiv.

Nu rezolvați o neconcordanță acordând încredere fiecărei gazde sau utilizând un wildcard nerestricționat într-o implementare de producție. Mențineți lista de permisiuni limitată la originile de stocare cunoscute. Dacă se intenționează utilizarea mai multor gazde de stocare, configurați grupurile de alias documentate pentru versiunea de CODE instalată, în loc să ghiciți comportamentul wildcard-urilor.

Verificați remedierea

Deschideți un document prin aceeași integrare Nextcloud care a eșuat. Apoi verificați jurnalele CODE recente: mesajul de respingere „Fără gazde WOPI acceptabile” ar trebui să dispară. Confirmați că documentul se încarcă și poate fi salvat; dacă apare o eroare nouă, utilizați mesajul acesteia pentru a identifica următorul strat. Pentru cele două verificări ale gazdelor și fluxul de depanare Nextcloud, consultați depanarea Nextcloud Office și configurarea Nextcloud Office . Pentru grupurile de aliasuri CODE Docker, consultați manualul Collabora Online SDK 25.04 ; utilizați documentația corespunzătoare versiunii instalate dacă configurația acesteia diferă.