> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/tu-espacio-de-trabajo/settings/authentications.md).

# Autenticaciones de integraciones

Prueba conexiones de integración, rastrea la expiración de credenciales y usa credenciales en flujos de trabajo.

Muchas de las integraciones nativas de AirOps (Asana, HubSpot, Webflow, Shopify y otras) requieren que te autentiques antes de poder usarlas en los pasos del flujo de trabajo. Una vez autenticado, puedes optar por **exponer** esas credenciales para que puedan referenciarse directamente desde plantillas Liquid y pasos de código. Esto es útil cuando quieres llamar a una API que el paso nativo no cubre, o interpolar un token en una solicitud.

## Nombra una autenticación

Cuando agregas una autenticación en **Configuración → Integraciones**, puedes ingresar un nombre personalizado para distinguir cuentas o entornos. Deja el nombre en blanco para usar el nombre generado. Esta opción también se aplica a las conexiones OAuth.

## Probar una conexión

Usar **Probar conexión** en **Configuración → Integraciones** para comprobar las integraciones compatibles antes de usarlas en Workflows. Puedes probar credenciales nuevas durante la configuración o usar el menú de la autenticación guardada para probar una conexión existente. Si ya existe un resultado, selecciona **Ver resultados de la prueba** y usa **Volver a probar** para comprobar de nuevo.

Revisa el **Estado de la conexión** y las comprobaciones individuales:

| Estado                      | Significado                                                                                 |
| --------------------------- | ------------------------------------------------------------------------------------------- |
| **Conectado**               | Las comprobaciones de la conexión se aprobaron.                                             |
| **Verificado parcialmente** | Algunas comprobaciones se aprobaron, pero otras no pudieron verificarse.                    |
| **No verificado**           | Las comprobaciones no pudieron determinar si la conexión funciona.                          |
| **Acceso limitado**         | Revisa las comprobaciones de acceso fallidas y los permisos requeridos para la integración. |
| **La conexión falló**       | Revisa el error, corrige las credenciales o la configuración y vuelve a probar.             |
| **Estado no disponible**    | AirOps no puede mostrar un resultado de verificación fiable. Vuelve a probar la conexión.   |

Un **No verificado** resultado individual no significa necesariamente que las credenciales sean incorrectas. Algunas acciones no pueden probarse sin crear, editar o eliminar contenido. Revisa esas acciones antes de confiar en ellas en un Workflow.

Para una nueva conexión, elige **Guardar integración** después de revisar los resultados. **Guardar de todos modos** te permite guardar credenciales con un resultado bloqueante; no resuelve las comprobaciones fallidas.

Las pruebas de conexión de Contentful están disponibles para autenticaciones con acceso completo e incluyen el ID de espacio configurado.

## Seguimiento de la expiración de credenciales

Para conexiones compatibles con token o autenticación básica, establece un **Fecha de expiración** opcional al crear o editar credenciales. Los administradores pueden establecer, actualizar o borrar la fecha, y la lista de autenticaciones muestra el valor configurado. Las conexiones OAuth y administradas por Pipedream no exponen este campo.

Usa la fecha para registrar cuándo debe renovarse la credencial emitida por el proveedor. Establecerla no renueva ni extiende la credencial. AirOps envía **Bandeja de entrada** advertencias 30 días antes de la expiración, 14 días antes de la expiración y cuando las credenciales expiran. Estas notificaciones enlazan de vuelta a **Integraciones**, donde puedes actualizar las credenciales y la fecha.

## Habilitar la exposición

1. Navega a **Ajustes > Integraciones**.
2. Busca la autenticación que quieres exponer.
3. Activa **Exponer credenciales** para esa fila.

La opción está desactivada de forma predeterminada. Las credenciales solo están disponibles para los flujos de trabajo cuando las habilitas explícitamente.

## Referencia en flujos de trabajo

Una vez expuestas, las credenciales son accesibles mediante la variable `authentications` , indexada por el nombre del proveedor y luego por el nombre visible de la autenticación.

### Plantilla Liquid

```
{{ authentications['asana']['Prod'].token }}
```

### Paso de código JavaScript

```javascript
const auth = authentications.asana["Prod"];
const token = auth.token;
```

### Paso de código Python

```python
auth = authentications["asana"]["Prod"]
token = auth["token"]
```

El selector de variables en el generador de flujos de trabajo muestra las autenticaciones expuestas en la categoría "Integration Authentications". Hacer clic en una entrada inserta la ruta correcta para el modo de editor en el que estés.

## Qué está disponible

Los campos exactos dependen del tipo de autenticación. Para integraciones OAuth, normalmente tendrás `token`, `refresh_token`, y `expires_at`. Para integraciones con clave de API, tendrás el campo que use la integración (comúnmente `api_key`).

## Deshabilitar la exposición

Desactiva el interruptor. Los flujos de trabajo que hagan referencia a las credenciales ahora no expuestas se resolverán como valores vacíos; si un flujo de trabajo dependía de esas credenciales, las llamadas posteriores podrían fallar. Vuelve a habilitarlo para restaurarlo.

## Seguridad

Las credenciales se enmascaran automáticamente como `*****` en los registros de seguimiento y en los mensajes de error de los pasos, por lo que depurar errores que mencionen un token no filtrará el valor en el historial de ejecución.

Las salidas de los pasos no se enmascaran. Si un paso de código devuelve directamente un valor de credencial (por ejemplo, `return token`), el valor aparecerá en el seguimiento de ejecución. Ten cuidado de no emitir credenciales en las salidas de los pasos.


---

# 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://docs.airops.com/docs/es/tu-espacio-de-trabajo/settings/authentications.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.