> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/help-center/help-center-fr/security/shade-network-configuration-guide.md).

# Guide de configuration réseau

### Aperçu

Ce document fournit les exigences de configuration réseau pour déployer Shade dans des environnements d'entreprise. Pour garantir un fonctionnement correct, vos administrateurs réseau devront ajouter les domaines et ports suivants à la liste d'autorisation.

### Liste d'autorisation des domaines requis

Les domaines suivants doivent être placés sur liste d'autorisation pour permettre à Shade de fonctionner correctement :

#### Services principaux de Shade

* `*.shade.inc` - Tous les sous-domaines Shade (caractère générique)\*\*, y compris :
  * `app.shade.inc` - Interface principale de l'application
  * `api.shade.inc` - Points de terminaison de l’API Shade
  * `api-auth.shade.inc` - Connexion et authentification
  * `fs.shade.inc` - Service de système de fichiers (HTTPS et WebSocket sécurisé)
  * `events.shade.inc` - Mises à jour en temps réel (WebSocket sécurisé)
  * `s3.shade.inc` - Point de terminaison compatible S3 (utilisé avec des clés d’accès S3)
  * `status.shade.inc` - Page d’état de Shade
* `*.wasabisys.com` - Stockage pour les lecteurs Vault (via Wasabi), par exemple `s3.us-east-1.wasabisys.com`. Si vous ne pouvez pas utiliser un caractère générique, autorisez `s3.<region>.wasabisys.com` pour chaque région utilisée par vos lecteurs Vault.
* `*.r2.cloudflarestorage.com` - Stockage pour les lecteurs Active (via Cloudflare R2)

\*\*Bien que nous recommandions d'ajouter la route générique, ce n'est pas strictement nécessaire

#### Examen et approbation

* `app.shade.inc` - Interface principale de l'application
* `api.shade.inc` - Points de terminaison de l’API Shade
* `2f0871f542c14e6bb9ff5efbf27effa0.r2.cloudflarestorage.com` - Stockage

#### Système de fichiers Shade

* `*.upload.shadefs.com` - Serveurs de téléversement utilisés lors de l’envoi de fichiers depuis le web et l’application de bureau

#### Services tiers

* `storage.googleapis.com` - API Google Cloud Storage, y compris les téléchargements et les mises à jour de l’application de bureau (`storage.googleapis.com/v2-public.shade.inc`)
* `*.googleapis.com` - Services Google Cloud (recommandés pour une compatibilité complète)
* `shade-prod.firebaseapp.com` et `*.firebaseio.com` - Firebase (Google)
* `*.ingest.sentry.io` - Rapports d’erreurs de l’application de bureau (Sentry)
* `do.featurebase.app` et `shade.featurebase.app` - Mises à jour produit et journal des modifications (Featurebase)
* `*.intercom.io` et `*.intercomcdn.com` - Chat d’assistance intégré à l’application (Intercom)

#### Services de notification

* `https://api.knock.app` - Service Knock pour les notifications Slack

### Configuration des ports requise

#### Trafic HTTPS et WebSocket

* **Port 443 (TCP)** - Tout le trafic HTTPS et WebSocket sécurisé (WSS) pour les domaines listés ci-dessus

Tous les services cloud de Shade communiquent via des connexions chiffrées sur le port 443. `fs.shade.inc` et `events.shade.inc` utilisent des WebSockets sécurisés (`wss://`), donc les pare-feu et proxys doivent autoriser les requêtes de mise à niveau WebSocket vers ces hôtes.

#### Cache partagé (réseau local uniquement)

Si vous utilisez un Cache partagé sur votre réseau local, autorisez également les éléments suivants entre l'application de bureau et le serveur de Cache partagé :

* **Port 8003 (TCP)** par défaut, ou le port configuré pour votre serveur de Cache partagé - L'application de bureau se connecte au Cache partagé via HTTP en clair (et non HTTPS) sur votre réseau local
* **Port 5353 (UDP)** - mDNS/Bonjour, utilisé pour découvrir automatiquement les serveurs de Cache partagé sur votre réseau

### Liste de contrôle d’implémentation

Pour configurer votre réseau pour Shade, effectuez les étapes suivantes :

1. **Configuration du pare-feu**
   * Ajoutez tous les domaines répertoriés à la liste d’autorisation de votre pare-feu
   * Assurez-vous que le port TCP sortant 443 est ouvert pour ces domaines
   * Si vous utilisez un Cache partagé, autorisez son port TCP et le port UDP 5353 (mDNS) sur votre réseau local
2. **Configuration du proxy** (si applicable)
   * Configurez vos serveurs proxy pour autoriser le trafic vers les domaines listés
   * Autorisez les requêtes de mise à niveau WebSocket (nécessaire pour `fs.shade.inc` et `events.shade.inc`)
   * Assurez-vous que l’inspection SSL/TLS (si activée) n’interfère pas avec les connexions
3. **Résolution DNS**
   * Vérifiez que vos serveurs DNS peuvent résoudre tous les domaines listés
   * Envisagez d’ajouter les domaines aux règles de transfert DNS internes si nécessaire
4. **Tests**
   * Après la configuration, testez la connectivité vers chaque domaine
   * Vérifiez que les utilisateurs peuvent accéder à `app.shade.inc` et effectuer des opérations sur les fichiers

### Considérations de sécurité

* Toutes les communications avec les services cloud de Shade sont chiffrées à l'aide de TLS conforme aux normes du secteur
* Le trafic du Cache partagé reste sur votre réseau local et utilise HTTP plutôt que HTTPS
* Le domaine générique `*.shade.inc` est utilisé pour prendre en charge de nouveaux services et fonctionnalités
* Si votre politique de sécurité n’autorise pas les domaines génériques, veuillez contacter le support Shade pour obtenir une liste complète des sous-domaines actuels

### Assistance

Si vous rencontrez des problèmes lors de la configuration ou si vous avez besoin d'informations supplémentaires sur certains domaines, veuillez contacter :

**Support entreprise de Shade**\
E-mail : <support@shade.inc>\
Documentation : <https://docs.shade.inc>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/help-center/help-center-fr/security/shade-network-configuration-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
