> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticación de API

> GOWA sólo autentifica llamadas API con HTTP Basic Auth.

GOWA soporta **HTTP Basic Auth** y nada más: no hay claves API, fichas portadoras o JWTs para la API REST. (MCP puede aceptar adicionalmente fichas de OAuth; vea [Servidor MCP](https://gowa-docs.mintlify.site/es/integrations/mcp.md#clientes-remotos-con-oauth).)

## Configurar

```bash theme={null}
APP_BASIC_AUTH=admin:changeme,ops:another-password   # or --basic-auth=admin:changeme
```

Cada par `user:pass` separado por comas es un inicio de sesión válido. Cada entrada debe contener un nombre de usuario y una contraseña. Un servidor que escucha en una dirección que no sea de bucle local se niega a iniciar sin credenciales completas. Configura `APP_HOST=127.0.0.1` para el desarrollo local sin autenticación. Usa `APP_ALLOW_UNAUTHENTICATED=true` solo cuando un proxy inverso autentique a los clientes y el acceso directo a GOWA esté restringido.

## Enviar credenciales

```bash curl theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```bash Header theme={null}
curl -H "Authorization: Basic $(echo -n 'admin:changeme' | base64)" \
  -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```javascript JavaScript theme={null}
const res = await fetch("http://localhost:3000/user/my/groups", {
  headers: {
    Authorization: "Basic " + Buffer.from("admin:changeme").toString("base64"),
    "X-Device-Id": "my-device",
  },
});
```

```python Python theme={null}
import requests
r = requests.get("http://localhost:3000/user/my/groups",
                 auth=("admin", "changeme"),
                 headers={"X-Device-Id": "my-device"})
```

Credenciales incorrectas o faltantes devuelven `401 Unauthorized`.

## Rutas públicas

| Ruta | Por qué |
| - | - |
| `/health` | Comprobaciones de liquidez. |
| `/statics/*` | Imágenes QR y archivos multimedia. Las URL conocidas siguen siendo públicas. Las URLs que no son imágenes cargan como archivos adjuntos. Proteja el acceso a su proxy si es necesario. |
| `/chatwoot/webhook`, `/chatwoot/webhook/{device_id}` | Llamado por Chatwoot; asegurado por `CHATWOOT_WEBHOOK_SECRET`. |
| extremos MCP OAuth y metadatos `/.well-known/*` | Flujo OAuth, cuando está activado. |

## WebSocket

Los navegadores no pueden establecer encabezados en conexiones WebSocket, así que `/ws` también acepta `/ws?device_id=my-device&authorization=<base64 user:pass>`. Usa `wss://` y redacta credenciales de registros proxy.

Las rutas HTTP de WebSocket y cambiantes de estado rechazan los orígenes no confiables del navegador. Establece el origen exacto del tablero en `APP_TRUSTED_ORIGINS` o `APP_CORS_ALLOWED_ORIGINS`. Un comodín de origen CORS no concede este acceso, y los orígenes `null` de páginas `file://` son rechazados. mutaciones HTTP de origen no confiable retorno `403 CROSS_SITE_REQUEST_BLOCKED`. Vea [configuración de acceso al navegador](https://gowa-docs.mintlify.site/es/authentication.md#cors).

## Encabezado del dispositivo

Auth Básica identifica a la llamada API, no a la cuenta de WhatsApp. Cada llamada con ámbito de dispositivo también necesita `X-Device-Id` cuando existe más de un dispositivo. Vea [Multi-device](https://gowa-docs.mintlify.site/es/concepts/multidevice.md).

> [!WARNING]
>
> Basic Auth envía credenciales en cada solicitud. Utilice siempre HTTPS frente a GOWA fuera de una red de confianza.


## Related topics

- [Autenticación](https://gowa-docs.mintlify.site/es/authentication.md)
- [Referencia API](https://gowa-docs.mintlify.site/es/api-reference/introduction.md)
- [Métricas del servidor](https://gowa-docs.mintlify.site/es/api-reference/metrics.md)
- [Grupos de Lista de Usuarios](https://gowa-docs.mintlify.site/es/api-reference/user/grupos-de-lista-de-usuarios.md)
- [Final de webhook de Chatwoot](https://gowa-docs.mintlify.site/es/api-reference/chatwoot/final-de-webhook-de-chatwoot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.