Aller au contenu principal

Faire passer ONLYOFFICE Docs sous Windows vers HTTPS

Introduction​

Dans la plupart des cas, l'accès à ONLYOFFICE Docs via le protocole HTTPS est beaucoup plus sûr que via le protocole HTTP qui est utilisé par défaut. Pour changer la méthode d'accès aux éditeurs, il faut réaliser certaines actions. Veuillez suivre les étapes ci-dessous pour savoir comment basculer votre ONLYOFFICE Docs vers le protocole HTTPS.

Faire passer ONLYOFFICE Docs v5.3 et versions ultérieures vers HTTPS​

Avant de pouvoir commencer à faire passer votre ONLYOFFICE Docs vers le protocole HTTPS, vous devrez créer un certificat de sécurité et la clé privée du certificat. Placez-les dans un dossier sur l'ordinateur où ONLYOFFICE Docs est installé.

Une fois que vous avez le certificat, procédez comme suit :

remarque

Toutes les commandes doivent être exécutées avec des privilèges administratifs. Pour démarrer une invite de commandes en tant qu'administrateur, cliquez avec le bouton droit sur le bouton du menu Démarrer dans le coin inférieur gauche du bureau et cliquez sur l'option Invite de commandes (Admin).

  1. Arrêtez le service ONLYOFFICE DocumentServer Proxy :

    net stop DsProxySvc

  2. Copiez le fichier %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl dans le fichier %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf en utilisant la commande suivante :

    COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds-ssl.conf.tmpl" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf"

  3. Modifiez le fichier %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx\conf\ds.conf en remplaçant tous les paramètres entre doubles accolades {{...}} par les valeurs réelles :

    remarque

    Veuillez noter que les caractères antislash ( \ ) doivent être échappés de l'une des manières suivantes : C:\\yourfolder\\certificates\\onlyoffice.key ou C:/yourfolder/certificates/onlyoffice.key. S'il y a des espaces dans le chemin, vous devez tout mettre entre guillemets, par ex. : "C:/yourfolder/my certificates/onlyoffice.key".

    • {{SSL_CERTIFICATE_PATH}} - le chemin d'accès au certificat SSL que vous avez obtenu ;
    • {{SSL_KEY_PATH}} - le chemin d'accès à la clé privée du certificat SSL ;
    • {{SSL_VERIFY_CLIENT}} - si la vérification des certificats clients est activée ou pas (avec les valeurs disponibles on, off, optional et optional_no_ca) ;
    • {{CA_CERTIFICATES_PATH}} - le chemin d'accès au certificat client qui sera vérifié s'il est activé selon le paramètre précédent ;
    • {{ONLYOFFICE_HTTPS_HSTS_MAXAGE}} - option de configuration avancée pour définir l'âge maximal du HSTS dans la configuration du vHost NGINX de ONLYOFFICE Docs, et applicable uniquement lorsque SSL est utilisé (la valeur par défaut est généralement 31536000, ce qui est considéré comme suffisamment sûr) ;
    • {{SSL_DHPARAM_PATH}} - le chemin d'accès du paramètre Diffie-Hellman ;

    Veuillez consulter la documentation NGINX pour plus d'informations sur les paramètres SSL utilisés dans le fichier de configuration.

  4. Lorsque toutes les modifications sont enregistrées, redémarrez le service ONLYOFFICE DocumentServer Proxy :

    net start DsProxySvc
    remarque

    Le port 443 doit être ouvert pour un fonctionnement correct de ONLYOFFICE Docs.

  5. Exécutez %ProgramFiles%\ONLYOFFICE\DocumentServer\bin\documentserver-update-securelink.bat

Faire passer ONLYOFFICE Docs v4.3 à v5.2 vers HTTPS​

remarque

Ces instructions s'appliquent aux anciennes versions de ONLYOFFICE Docs (v4.3 à v5.2). Nous vous recommandons de passer à la dernière version. Si vous ne pouvez pas mettre à jour, suivez ces étapes en complément des instructions principales ci-dessus, en tenant compte du fait que les étapes 2 et 3 diffèrent comme décrit ci-dessous.

  1. Copiez le fichier %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template dans le fichier %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf en utilisant la commande suivante :

    COPY /Y "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver-ssl.conf.template" "%ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf"

  2. Modifiez le fichier %ProgramFiles%\ONLYOFFICE\DocumentServer\nginx-1.11.4\conf\onlyoffice-documentserver.conf en remplaçant tous les paramètres entre doubles accolades {{...}} par les valeurs réelles, comme décrit à l'étape 3 ci-dessus.