- Accueil
- Docs
- Installation et réglage
- Installation et réglage
- Version sous Docker
- Configurer un filtre d'adresses IP pour ONLYOFFICE Docs
Configurer un filtre d'adresses IP pour ONLYOFFICE Docs
Vous pouvez configurer le filtre IP pour ONLYOFFICE Docs.
Les paramètres du filtre d'adresses IP sont stockés dans le fichier config ONLYOFFICE Docs: /etc/onlyoffice/documentserver/default.json. Ceux-ci se présentent comme suit ci-dessous:
"ipfilter": {
"rules": [
{
"address": "ip_address",
"allowed": true
},
{
"address": "*",
"allowed": false
}
],
"useforrequest": false,
"errorcode": 403
}
default.json, toutes les modifications seront perdues lors de la mise à jour de ONLYOFFICE Docs ou du redémarrage du conteneur Docker. Pour rendre vos modifications persistantes après la mise à jour, veuillez modifier ce fichier /etc/onlyoffice/documentserver/local.json, mais il faut préserver la structure.Une règle comprend deux parties: le nom d'hôte et la règle allowed elle-même qui prend la valeur vrai ou faux. Par défaut, il existe une règle: address * allowed true.
Une adresse doit être de la façon suivante:
- Une adresse IP au format
X.X.X.Xpour ipv4. - Une adresse IP au format
xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxxpour ipv6. - Un nom DNS.
C'est également possible d'utiliser le caractère générique *. Ce caractère est utilisé pour remplacer tout caractère autant de fois qu'il le faudra.
Tout d'abord, le nom d'hôte dans des liens est vérifié en tant qu'une adresse DNS, s'il ne correspond à aucune des règles, l'adresse IP est trouvée par le nom et la vérification est effectuée encore une fois.
"useforrequest": true est activée, il faut indiquer le paramètre address en tant qu'une adresse IP, et non un nom DNS."useforrequest": true/false
Par défaut, le paramètre useforrequest est false. Dans ce cas, les adresses URL du texte qui arrivent à ONLYOFFICE Docs en tant que paramètres sont vérifiées:
- Liens de téléchargement du fichier: ouvrir, convertir, docbuilder, etc.
- Un abonnement aux événements de l'éditeur callbackUrl.
- WOPI actionUrl.
Lorsque le paramètre useforrequest est true (n'est pas recommandé), l'adresse IP du client dans les requêtes http suivantes est vérifiée également:
coauthoring/CommandService.ashxConvertService.ashxconverterFileUploader.ashxhealthcheckdocbuilderinfo/info.jsoninternal/cluster/inactivehosting/discoveryhosting/capabilitieslool/convert-to/:format?dummyCallback
Pour ces requêtes, une erreur est renvoyée avec le code qui est indiqué dans le champ errorcode.
Par exemple, lorsque ONLYOFFICE Docs et l'exemple de test sont installés sur la même machine, l'adresse IP du client sera l'adresse du réseau interne. ONLYOFFICE Docs ne peut pas trouver l'hôte du client, il n'est donc pas possible d'utiliser un nom DNS dans le champ address en tant que paramètre. Il est recommandé de laisser la valeur par défaut pour ce paramètre et d'effectuer les vérifications au niveau du proxy.