> 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-es/security/shade-network-configuration-guide.md).

# Guía de configuración de red

### Resumen

Este documento proporciona los requisitos de configuración de red para desplegar Shade en entornos empresariales. Para garantizar un funcionamiento correcto, los administradores de red deberán añadir los siguientes dominios y puertos a la lista de permitidos.

### Lista de permitidos de dominios requerida

Los siguientes dominios deben incluirse en la lista de permitidos para que Shade funcione correctamente:

#### Servicios principales de Shade

* `*.shade.inc` - Todos los subdominios de Shade (comodín)\*\*, incluidos:
  * `app.shade.inc` - Interfaz principal de la aplicación
  * `api.shade.inc` - Endpoints de la API de Shade
  * `api-auth.shade.inc` - Inicio de sesión y autenticación
  * `fs.shade.inc` - Servicio del sistema de archivos (HTTPS y WebSocket seguro)
  * `events.shade.inc` - Actualizaciones en tiempo real (WebSocket seguro)
  * `s3.shade.inc` - Endpoint compatible con S3 (utilizado con claves de acceso S3)
  * `status.shade.inc` - Página de estado de Shade
* `*.wasabisys.com` - Almacenamiento para unidades Vault (a través de Wasabi), por ejemplo `s3.us-east-1.wasabisys.com`. Si no puedes usar un comodín, अनुमति `s3.<region>.wasabisys.com` para cada región que utilicen tus unidades Vault.
* `*.r2.cloudflarestorage.com` - Almacenamiento para unidades Active (a través de Cloudflare R2)

\*\*Aunque recomendamos añadir la ruta comodín, no es estrictamente necesario

#### Revisión y aprobación

* `app.shade.inc` - Interfaz principal de la aplicación
* `api.shade.inc` - Endpoints de la API de Shade
* `2f0871f542c14e6bb9ff5efbf27effa0.r2.cloudflarestorage.com` - Almacenamiento

#### Sistema de archivos de Shade

* `*.upload.shadefs.com` - Servidores de carga usados al subir archivos desde la web y la aplicación de escritorio

#### Servicios de terceros

* `storage.googleapis.com` - API de Google Cloud Storage, incluidas las descargas y actualizaciones de la aplicación de escritorio (`storage.googleapis.com/v2-public.shade.inc`)
* `*.googleapis.com` - Servicios de Google Cloud (recomendado para una compatibilidad completa)
* `shade-prod.firebaseapp.com` y `*.firebaseio.com` - Firebase (Google)
* `*.ingest.sentry.io` - Informes de errores desde la aplicación de escritorio (Sentry)
* `do.featurebase.app` y `shade.featurebase.app` - Actualizaciones del producto y registro de cambios (Featurebase)
* `*.intercom.io` y `*.intercomcdn.com` - Chat de soporte en la aplicación (Intercom)

#### Servicios de notificación

* `https://api.knock.app` - Servicio Knock para notificaciones de Slack

### Configuración de puertos requerida

#### Tráfico HTTPS y WebSocket

* **Puerto 443 (TCP)** - Todo el tráfico HTTPS y WebSocket seguro (WSS) para los dominios enumerados arriba

Todos los servicios en la nube de Shade se comunican mediante conexiones cifradas en el puerto 443. `fs.shade.inc` y `events.shade.inc` usan WebSockets seguros (`wss://`), por lo que los firewalls y proxies deben permitir solicitudes de actualización de WebSocket a estos hosts.

#### Caché compartida (solo red local)

Si usas una Caché compartida en tu red local, permite también lo siguiente entre la aplicación de escritorio y el servidor de Caché compartida:

* **Puerto 8003 (TCP)** por defecto, o el puerto que tenga configurado tu servidor de Caché compartida - La aplicación de escritorio se conecta a la Caché compartida mediante HTTP sin cifrar (no HTTPS) en tu red local
* **Puerto 5353 (UDP)** - mDNS/Bonjour, utilizado para descubrir automáticamente servidores de Caché compartida en tu red

### Lista de comprobación de implementación

Para configurar tu red para Shade, completa los siguientes pasos:

1. **Configuración del firewall**
   * Añade todos los dominios enumerados a la lista de permitidos de tu firewall
   * Asegúrate de que el puerto TCP 443 saliente esté abierto para estos dominios
   * Si usas una Caché compartida, permite su puerto TCP y el UDP 5353 (mDNS) en tu red local
2. **Configuración del proxy** (si corresponde)
   * Configura tus servidores proxy para permitir tráfico hacia los dominios enumerados
   * Permite las solicitudes de actualización de WebSocket (requerido para `fs.shade.inc` y `events.shade.inc`)
   * Asegúrate de que la inspección SSL/TLS (si está habilitada) no interfiera con las conexiones
3. **Resolución DNS**
   * Verifica que tus servidores DNS puedan resolver todos los dominios enumerados
   * Considera añadir los dominios a las reglas internas de reenvío DNS si es necesario
4. **Pruebas**
   * Después de la configuración, prueba la conectividad con cada dominio
   * Verifica que los usuarios puedan acceder a `app.shade.inc` y realizar operaciones de archivos

### Consideraciones de seguridad

* Toda la comunicación con los servicios en la nube de Shade está cifrada mediante TLS estándar de la industria
* El tráfico de la Caché compartida permanece en tu red local y usa HTTP en lugar de HTTPS
* El dominio comodín `*.shade.inc` se utiliza para dar cabida a nuevos servicios y funciones
* Si tu política de seguridad no permite dominios comodín, ponte en contacto con el soporte de Shade para obtener una lista completa de los subdominios actuales

### Soporte

Si encuentras algún problema durante la configuración o necesitas información adicional sobre dominios específicos, ponte en contacto con:

**Soporte empresarial de Shade**\
Correo electrónico: <support@shade.inc>\
Documentación: <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-es/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.
