- Accueil
- Docs
- Installation et réglage
- Enterprise
- 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.X
pour ipv4. - Une adresse IP au format
xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx.xxxx
pour 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.ashx
ConvertService.ashx
converter
FileUploader.ashx
healthcheck
docbuilder
info/info.json
internal/cluster/inactive
hosting/discovery
hosting/capabilities
lool/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.