wopi: documentation
- Lenguaje dominante
- Python
- Estrellas
- 46.7k
- Forks
- 1.9k
- Merge medio
- 9 d 2 h
- PR fusionados (30 d)
- 4
Descripción
should probably provide a minimal working example for using copyparty with collabora and/or onlyoffice;
my extremely jank and dangerously unsafe testing setup was:
### copyparty server for collabora
```
rm -rf junk ; curl -LO http://192.168.123.1:3923/dist/copyparty-sfx.py && python3 copyparty-sfx.py -aed:wark -v junk::A,ed --wopi --wopi-url https://192.168.122.210:9980/ --wopi-crt no
```
### copyparty server for onlyoffice
```
rm -rf junk ; curl -LO http://192.168.123.1:3923/dist/copyparty-sfx.py && python3 copyparty-sfx.py -aed:wark -v junk::A,ed --wopi --wopi-url http://192.168.122.5:9980/ --wopi-crt no --ihead=\* --ohead=\*
```
### collabora itself (works)
```
podman run --rm -it --net=host -e server_name=192.168.122.210:9980 -e "extra_params=--o:ssl.enable=true --o:ssl.termination=true --o:storage.ssl.ssl_verification=false" collabora/code:latest
# then access https://192.168.122.210:9980/ from firefox to accept the selfsigned cert
```
### onlyoffice itself (failed attempt)
```
podman run --rm -it -p 9980:80 -p 9443:443 \
-v /home/ed/v/logs:/var/log/onlyoffice \
-v /home/ed/v/data:/var/www/onlyoffice/Data \
-v /home/ed/v/lib:/var/lib/onlyoffice \
-v /home/ed/v/etc:/etc/onlyoffice/documentserver \
-e WOPI_ENABLED=true -e USE_UNAUTHORIZED_STORAGE=true onlyoffice/documentserver
```
NOTE: the onlyoffice docs says setting up ip-address allow/deny-list is recommended to ensure only copyparty can connect, so should at least mention that; https://api.onlyoffice.com/docs/docs-api/more-information/faq/using-wopi/
NOTE: onlyoffice includes a "wopi proof key" in its requests which the server (copyparty) is expected to verify, to ensure that the document has not been tampered with and that it's coming from a trusted source, but is this necessary for our usecase? is the access-token sufficient, like for collabora?
this builds on #1495 and is related to #1574
Guía de contribución
Línea de trabajo
El issue solicita un ejemplo mínimo funcional para integrar copyparty con Collabora y OnlyOffice. Empieza examinando la implementación existente de WOPI del issue #1495 y el #1574 relacionado. Revisa las opciones de línea de comandos de copyparty para --wopi, --wopi-url y --wopi-crt. Prueba los comandos proporcionados en un entorno seguro y documenta los pasos, incluidas consideraciones de seguridad como las listas de allow/deny de IP para OnlyOffice. Verifica si la WOPI proof key es necesaria o si el access token es suficiente.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- docker, nginx
- Área
- backend, devops, documentation
- Tipo de issue
- Documentación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Estado de actividad
- Tranquilo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 55/100