SharePoint

Caratteristiche principali

• Modifica documenti di testo, fogli di calcolo e presentazioni selezionando Modifica in ONLYOFFICE dal menu contestuale del file o dalla barra multifunzione (quando si utilizza il connettore ufficiale), o semplicemente cliccando sul file (quando si utilizza WOPI).
• Collabora sui documenti in tempo reale con due modalità di co-editing: Veloce e Rigida (disponibili con il connettore ufficiale; solo Veloce con WOPI). Sfrutta funzionalità come il tracciamento delle modifiche, i commenti e la chat integrata per un lavoro di squadra senza interruzioni.

Formati supportati

Per il connettore ufficiale:

• Per visualizzazione e modifica: DOCX, XLSX, PPTX, PPSX
• Solo per visualizzazione: PDF, DJVU, TXT, CSV, ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM, MHT, XPS

Per WOPI:

• Per visualizzazione e modifica: DOCX, XLSX, PPTX, DOCM, XLSM, PPTM, ODT, ODS, ODP, CSV, PDF
• Solo per visualizzazione: DJVU, XPS

Novità nella versione 3.0.0

Aggiunto

• Supporto JWT
• Il Document Server v6.0 e precedenti non è più supportato

Il registro completo delle modifiche è disponibile qui.

Requisiti

• ONLYOFFICE Document Server v7.1 (server o versione cloud) o successiva
  Devi abilitare WOPI seguendo questa istruzione.

  Hai bisogno di un'istanza di ONLYOFFICE Docs che sia risolvibile e connessa sia da SharePoint che da qualsiasi client finale. Deve anche essere in grado di inviare POST direttamente a SharePoint.

  Si prega di fare riferimento alla pagina di documentazione ufficiale per saperne di più sull'installazione di ONLYOFFICE Docs.
• SharePoint 2019
• Connettore ONLYOFFICE 3.0 per SharePoint

Installazione e configurazione di ONLYOFFICE e SharePoint

La soluzione di integrazione ONLYOFFICE SharePoint è un connettore ufficiale di ONLYOFFICE disponibile sulla pagina GitHub sotto la licenza GNU AGPL v.3.

1. Clicca su Start, vai su Tutti i Programmi, vai su Strumenti Amministrativi, quindi clicca su Servizi, e assicurati che il servizio Amministrazione SharePoint sia avviato.
2. Clicca su Start, apri la Shell di Gestione SharePoint, e naviga nella directory contenente il file .wsp.
3. Esegui lo script Install.ps1:

   PS> .\Install.ps1

4. Inserisci l'indirizzo del tuo sito SharePoint:

   https://<yoursharepointsite>

   Invece dei passaggi 3 e 4 puoi digitare il seguente comando:

   Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp

   Sulla home page di Amministrazione Centrale SharePoint, clicca su Impostazioni di Sistema → Gestione Farm → Gestisci soluzioni farm. Nella pagina di Gestione Soluzioni, clicca su onlyoffice.wsp, quindi clicca su Distribuisci Soluzione.

5. Sulla home page di Amministrazione Centrale SharePoint, sotto Gestione Applicazioni, clicca su Gestisci applicazioni web.
6. Assicurati di selezionare il tuo sito e clicca sull'icona Provider di Autenticazione.
7. Nella finestra pop-up Provider di Autenticazione, clicca su Zona predefinita.
8. Sotto Modifica Autenticazione, seleziona Abilita accesso anonimo e clicca su Salva.
9. Tornando a Gestione Applicazioni Web, clicca sull'icona Politica Anonima.
10. Sotto Restrizioni Accesso Anonimo, seleziona la tua Zona e imposta la Politica Permessi a Nessuno – No e clicca su Salva.
11. In SharePoint, apri la pagina /_layouts/15/Onlyoffice/Settings.aspx con le impostazioni amministrative. Inserisci il seguente indirizzo:

    https://<documentserver>/

    Dove il documentserver è il nome del server con installato ONLYOFFICE Docs. L'indirizzo deve essere accessibile per il browser dell'utente e dal server SharePoint. L'indirizzo del server SharePoint deve anche essere accessibile da ONLYOFFICE Docs per un corretto funzionamento.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato di default e la chiave segreta è generata automaticamente. Devi abilitarla anche dal lato SharePoint: trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specifica la stessa chiave segreta nelle impostazioni amministrative di SharePoint. Per ulteriori dettagli, consulta la sezione Abilitazione JWT per l'integrazione di ONLYOFFICE e SharePoint di questo articolo.

Se la protezione JWT è abilitata, è necessario specificare un nome di intestazione personalizzato, poiché la politica di sicurezza di SharePoint blocca le intestazioni 'Authorization' esterne. Questa intestazione deve essere specificata anche nelle impostazioni della firma di ONLYOFFICE Docs (ulteriori informazioni possono essere trovate qui).

Compilazione della soluzione di integrazione ONLYOFFICE SharePoint

Ci sono due modi per compilare la soluzione di integrazione ONLYOFFICE SharePoint:

• Utilizzando MS Visual Studio:
  1. Inserisci il server SharePoint e apri questo progetto in Visual Studio.
  2. In Esplora Soluzioni, apri il menu di scelta rapida per il progetto e poi scegli Pubblica.
  3. Nella finestra di dialogo Pubblica, scegli l'opzione Pubblica su File System.
  4. Clicca sul pulsante Pubblica. Quando il processo di pubblicazione è terminato, il file di soluzione .wsp verrà creato.
  5. Copia il file risultante nella cartella con il file Install.ps1 (cartella BuildAndInstall per impostazione predefinita).
• Con l'aiuto del file build.bat fornito:
  1. Vai alla cartella BuildAndInstall.
  2. Esegui il file build.bat.
  3. Il file di soluzione risultante .wsp verrà creato e posizionato nella cartella BuildAndInstall.

Come funziona

L'integrazione di ONLYOFFICE segue l'API documentata qui.

1. L'utente naviga verso un documento all'interno di SharePoint e seleziona l'azione Modifica in ONLYOFFICE nel menu contestuale o sulla barra multifunzione.
2. SharePoint effettua una richiesta alla pagina dell'editor (URL del tipo: /_layouts/15/Onlyoffice/editorPage.aspx?SPListItemId={ItemId}&SPListURLDir={ListUrlDir}&action=track).
3. SharePoint prepara un oggetto JSON con le seguenti proprietà:
   • url - l'URL che ONLYOFFICE Docs utilizza per scaricare il documento;
   • callbackUrl - l'URL che ONLYOFFICE Docs informa sullo stato della modifica del documento;
   • DocumentSeverHost - l'URL a cui il client deve rispondere al ONLYOFFICE Document Server (può essere impostato nella pagina delle impostazioni);
   • Key - l'identificatore del file da SharePoint;
   • FileName - il titolo del documento (nome);
   • CurrentUserId - l'identificatore dell'utente;
   • CurrentUserName - il nome utente.
4. SharePoint costruisce una pagina, riempiendo tutti questi valori in modo che il browser del client possa caricare l'editor.
5. Il browser del client effettua una richiesta alla libreria JavaScript di ONLYOFFICE Docs e invia a ONLYOFFICE Docs la configurazione DocEditor con le proprietà sopra elencate.
6. Quindi ONLYOFFICE Docs scarica il documento da SharePoint e l'utente inizia a modificarlo.
7. Quando tutti gli utenti e i browser dei client hanno terminato la modifica, chiudono la finestra di modifica.
8. Dopo 10 secondi di inattività, ONLYOFFICE Docs invia un POST a callbackUrl informando la soluzione SharePoint ONLYOFFICE che i client hanno terminato la modifica del documento e lo hanno chiuso.
9. SharePoint scarica una nuova versione del documento, sostituendo quella vecchia.

Abilitazione JWT per l'integrazione di ONLYOFFICE e SharePoint

Per proteggere i documenti da accessi non autorizzati, gli editor di ONLYOFFICE utilizzano il JSON Web Token (JWT). Il token viene aggiunto nella configurazione quando il Document Editor viene inizializzato e durante lo scambio di comandi tra i servizi interni di ONLYOFFICE Docs. La chiave segreta viene utilizzata per firmare il token web JSON e convalidare il token alla richiesta di ONLYOFFICE Docs.

A partire da ONLYOFFICE Docs v7.2, JWT è abilitato di default e la chiave segreta è generata automaticamente. Devi trovare la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs, quindi specificare la stessa chiave segreta nelle impostazioni del connettore.

Passo 1: Trova la tua chiave segreta nel file di configurazione di ONLYOFFICE Docs

1. Apri il file local.json con qualsiasi editor di testo disponibile.
   • Per Linux - /etc/onlyoffice/documentserver/local.json
   • Per Windows - %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
   • Per Docker – entra nel container di ONLYOFFICE Docs utilizzando il comando docker exec -it <containerID> bash e apri /etc/onlyoffice/documentserver/local.json

     In alternativa, puoi utilizzare il seguente comando per trovare la chiave segreta predefinita senza aprire local.json:

     sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

   Il file local.json dovrebbe apparire così:

   {"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}

2. Il valore true è specificato in tre sezioni. Significa che la convalida del token è abilitata.
   • services.CoAuthoring.token.enable.browser
   • services.CoAuthoring.token.enable.request.inbox
   • services.CoAuthoring.token.enable.request.outbox
3. La chiave segreta generata automaticamente è specificata in tre sezioni. Puoi sostituire il valore segreto predefinito con la tua chiave segreta. La chiave segreta deve essere la stessa in tre sezioni.
   • services.CoAuthoring.secret.inbox.string
   • services.CoAuthoring.secret.outbox.string
   • services.CoAuthoring.secret.session.string
4. Se apporti modifiche, salvale e riavvia i servizi affinché le modifiche alla configurazione abbiano effetto.

   supervisorctl restart all

Passo 2: Specifica la stessa chiave segreta nelle impostazioni del connettore

Nelle impostazioni del connettore, specifica lo stesso segreto nel campo Chiave segreta e salva le impostazioni.