Hébergement mutualisé

Configurer l'hébergement mutualisé

Installez le serveur de l'édition Développeur

Pour activer le mode mutualisé, une licence d'hébergement mutualisé est requise.

remarque
Veuillez contacter votre assistant des ventes pour obtenir la licence.

Veuillez enregistrer la solution selon les instructions fournies.
Ouvrez le config local.json et définissez le chemin d'accès au dossier contenant les paramètres du client dans le champ baseDir. Nous recommandons d'utiliser /var/www/onlyoffice/Data/tenants.
Dans le champ baseDomain du fichier local.json, définissez le domaine de second niveau en tant que domaine de base pour tous vos clients.
Les statistiques sur la licence principale sont collectées sur le client par défaut.
- Le nom du client par défaut est défini dans le champ defaultTenant du fichier defaultTenant.
  
  remarque
  Vous ne pouvez pas créer un autre client avec le même nom.
- Les demandes vers baseDomain sans nom du client sont automatiquement acheminées vers le client par défaut.
- Vous n'avez pas besoin d'une configuration supplémentaire du client. Toutefois, les demandes vers ce client sont signées par une clé secrète du fichier local.json.
- Les statistiques sont affichées sur la page Informations du client par défaut.

Ajouter un nouveau client

Pour ajouter un nouveau client :
- Créez un nouveau dossier dans le répertoire baseDir sur le serveur.
- Le nom du client est créé sur la base du nom du dossier et de baseDomain (par exemple, si le nom du dossier est tenant1 et baseDomain est example.com, le nom du client sera tenant1.example.com).
  
  remarque
  Veuillez créer ce dossier dans le système de fichiers où se trouve default.json.
Il est obligatoire d'ajouter les deux fichiers suivants dans le dossier de chaque client :

default.json :
```
"tenants": {
    "baseDir": "/var/www/onlyoffice/Data/tenants",
    "baseDomain": "mydomain.example",
    "filenameConfig": "config.json",
    "filenameSecret": "secret.key",
    "filenameLicense": "license.lic",
    "defaultTenant": "localhost",
    "cache": {
        "stdTTL": 300,
        "checkperiod": 60,
        "useClones": false
    }
}
```
remarque
Ajoutez le fichier secret.key à chaque client pour assurer l'isolation et la sécurité. En l'absence de clé, la clé secrète du client principal sera utilisée. Lorsque la clé secrète JWT est indiquée, la clé du config.json a la priorité.

système de fichiers :
```
root@3694c287928a:/var/www/onlyoffice/Data/tenants# 1s -a
. .. tenant1 tenant2
root@3694c287928a:/var/www/onlyoffice/Data/tenants#
```
```
root@3694c287928a:~# 1s /var/www/onlyoffice/Data/tenants/tenant1
config.json license.lic
root@3694c287928a:~#
```
- license.lic – un fichier obligatoire pour la licence du client
- config.json – un fichier config obligatoire qui remplace le fichier config principal du serveur
remarque
Il est obligatoire de saisir le secret jwt.
Le fichier license.lic remplace certains champs de la licence principale du client. Les règles sont les suivantes :
- Signature : Une signature de licence n'est pas requise.
- Héritage des champs : Vous pouvez inclure les champs spécifiques ou tous les champs de la licence principale. Les champs qu'on n'a pas paramétrés prennent les valeurs par défaut de la licence principale et sont validés en conséquence.
- Limites des arguments : Vous ne pouvez pas augmenter les valeurs de la licence principale, mais vous pouvez les diminuer. Les champs pertinents sont les suivants : connections, connections_view, users_count, users_expire, users_view_count, end_date, timelimited, advanced_api, branding, customization.
  
  Exemple : Vous pouvez supprimer branding et customization ou définir le mode d'essai.
  
  remarque
  Il est inutile d'augmenter les valeurs car les vérifications périodiques de la licence principale sont réalisées.
- Mise en cache : La mise en cache des valeurs de licence a une durée de vie de 5 minutes.
Par exemple, le contenu du fichier license.lic peut être le suivant :
```
{"branding":false,"connections":100,"users_count":0}
```
Le fichier config.json vous permet de substituer certains paramètres du serveur. Les règles sont les suivantes :
- Paramètres non modifiables : Les paramètres utilisés lors du démarrage du serveur (tels que les adresses des services externes, les chemins d'accès aux journaux, les licences et le cache des fichiers) ne peuvent pas être remplacés.
- Paramètres modifiables : Vous pouvez remplacer les paramètres liés aux opérations runtime y compris la configuration WOPI, le filtre d'IP, le secret JWT, la désactivation de l'accès anonyme et les limites de la taille de fichiers.
- Mise en cache : La mise en cache de la configuration a une durée de vie de 5 minutes.
Par exemple, le contenu du fichier config.json peut être le suivant :
```
{
 "wopi": {
  "enable": true
 },
 "services": {
  "CoAuthoring": {
   "secret": {
    "inbox": {"string": "secret", "file": ""},
    "outbox": {"string": "secret", "file": ""},
    "session": {"string": "secret", "file": ""}
   },
   "token": {
    "enable": {
     "browser": true,
     "request": {
      "inbox": true,
      "outbox": true
     }
    }
   }
  }
 }
}
```

Configurer l'hébergement mutualisé​

Ajouter un nouveau client​

Configurer l'hébergement mutualisé

Ajouter un nouveau client