WOPI

⚙️ Accès dans le backoffice :
Services web > Ajouter un connecteur > WOPI

WOPI (Web Application Open Platform Interface) est un protocole permettant à un serveur — ici Publik — d'échanger avec une suite bureautique web (LibreOffice Online, par exemple) pour permettre à des utilisateurs d'éditer des fichiers fournis par le serveur.

Comment déployer le connecteur WOPI ?

Les paramètres attendus sont : 

• Titre
• Identifiant
• Description
• Identifiant d’authentification basique
• Mot de passe pour l’authentification basique
• Certificat TLS client
• Autorités de confiance
• Vérification des certificats (case cochée par défaut)
• Proxy HTTP et HTTPS
• URL de découverte du client WOPI (discover URL) : par exemple https://wopiserver.example.com/hosting/
• URL du serveur WOPI ( URL de passerelle par défaut ) : laisser vide en cas de doute (utile pour les tests via un VPN)
• Vérifier les preuves d’identité du client WOPI (case cochée par défaut)

Quelles sont les principaux usages de ce connecteur ?

Le connecteur expose plusieurs points d'accès (endpoints) appelables depuis une action Webservice dans un workflow.

Mettre un fichier en édition

Le premier appel (POST) envoie le fichier au connecteur pour l'ouvrir en édition dans la suite bureautique.
Envoyer un fichier pour le rendre éditable : /wopi/IDENTIFIANT/prepare_edition

Générer un lien d'édition

Une fois le fichier mis en édition, un second appel (GET) permet de générer un jeton d'accès et un lien d'édition pour un utilisateur donné. Ce lien peut ensuite être transmis à l'agent ou à l'usager concerné.
Rediriger l’utilisateur vers cette URL, avec les jetons nécessaire, ouvre le client WOPI et permet l’édition du fichier : /wopi/IDENTIFIANT/host_page

Clore l'édition et récupérer le fichier modifié

Un appel indique la fin de l'édition (POST) et permet de récupérer la version modifiée du fichier, qui peut alors être enregistrée dans les données de la demande.
Termine l’édition du fichier indiqué (interdit les futurs demande d’édition) et ré : /wopi/IDENTIFIANT/end_edition

Quels sont les autres points d'accès du connecteur WOPI ?

• Vérifier la disponibilité du service : /wopi/IDENTIFIANT/up
• Vérifie l’état du verroux sur le fichier (renvoie une erreur applicative si le fichier est vérouillé) : /wopi/IDENTIFIANT/check_lock
• Récupérer un jeton (token) utilisateur autorisant l’édition du fichier : /wopi/IDENTIFIANT/get_user_token
• Renvoie le status du fichier et l’historique des actions : /wopi/IDENTIFIANT/status
• Télécharger le fichier édité (échouera si le fichier est vérouillé) : /wopi/IDENTIFIANT/download
• Point d’accès du client WOPI (ne jamais appeler avec Publik) : /wopi/IDENTIFIANT/wopi/files/FILE_ID