> 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 de un flujo de trabajo. Una vez autenticado, puedes optar por **exponer** esas credenciales para poder hacer referencia a ellas directamente desde plantillas Liquid y pasos de código. Esto resulta útil si quieres llamar a una API que el paso nativo no admite o interpolar un token en una solicitud.

## Asignar un nombre a una autenticación

Al añadir una autenticación en **Configuración → Integraciones**, puedes introducir 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

Usa **Probar conexión** en **Configuración → Integraciones** para comprobar las integraciones compatibles antes de usarlas en los flujos de trabajo. Puedes probar las credenciales nuevas durante la configuración o usar el menú de la autenticación guardada para probar una conexión existente. Si ya hay resultados, selecciona **Ver resultados de la prueba** y usa **Volver a probar** para realizar otra comprobación.

La columna **Última comprobación de conexión** describe la prueba más reciente. **Pruebas no disponibles** significa que AirOps no ofrece pruebas para esa integración; **No probada** significa que no se ha realizado ninguna prueba. Ninguna de estas etiquetas significa que la autenticación esté desconectada.

Revisa los resultados guardados y cada una de las comprobaciones:

| Estado                      | Significado                                                                                   |
| --------------------------- | --------------------------------------------------------------------------------------------- |
| **Conectada**               | Las comprobaciones de conexión se completaron correctamente.                                  |
| **Verificada parcialmente** | Algunas comprobaciones se completaron correctamente, pero no se pudieron verificar las demás. |
| **No verificada**           | Las comprobaciones no pudieron determinar si la conexión funciona.                            |
| **Acceso limitado**         | Revisa las comprobaciones de acceso fallidas y los permisos necesarios para la integración.   |
| **Error de conexión**       | 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 resultado **No verificada** no significa necesariamente que las credenciales sean incorrectas. Algunas acciones no se pueden probar sin crear, editar o eliminar contenido. Revisa esas acciones antes de confiar en ellas en un flujo de trabajo.

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

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

Para OAuth de Semrush, **Probar conexión** comprueba la autenticación del token y el acceso al servidor sin consumir unidades de la API de informes. Que la comprobación de autenticación se complete correctamente no verifica los permisos de informes ni los créditos disponibles para informes. Revisa la nota independiente sobre el acceso a informes antes de ejecutar un flujo de trabajo.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-781014a050068c906c2e9666c769859440c30986%2Fauthentications-01-integrations-list.png?alt=media" alt="Settings Integrations list with named authentications, a connection test result, an expiration badge, and Expose credentials"><figcaption><p>Prueba conexiones, consulta su vencimiento y expón credenciales desde Integraciones.</p></figcaption></figure>

## Registrar la fecha de vencimiento de las credenciales

En las conexiones compatibles con tokens o autenticación básica, puedes definir una **Fecha de vencimiento** opcional al crear o editar credenciales. Los administradores pueden definir, actualizar o borrar la fecha, y la lista de autenticaciones muestra el valor configurado. Las conexiones de OAuth y las administradas por Pipedream no muestran este campo.

Usa la fecha para registrar cuándo debe renovarse la credencial emitida por el proveedor. Definirla no renueva ni amplía la vigencia de la credencial. AirOps envía avisos en la **Bandeja de entrada** 30 días antes del vencimiento, 14 días antes del vencimiento y cuando las credenciales vencen. Estas notificaciones enlazan a **Integraciones**, donde puedes actualizar las credenciales y la fecha.

## Habilitar la exposición

1. Ve a **Configuración > Integraciones**.
2. Busca la autenticación que quieres exponer.
3. Activa **Exponer credenciales** en esa fila.

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

## Referenciar en flujos de trabajo

Una vez expuestas, las credenciales están disponibles mediante la variable `authentications` , organizada primero por 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 del generador de flujos de trabajo muestra las autenticaciones expuestas en la categoría «Autenticaciones de integraciones». Al hacer clic en una entrada, se inserta la ruta correcta para el modo de edición que estés usando.

## Qué está disponible

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

## Deshabilitar la exposición

Desactiva el interruptor. Las referencias a las credenciales que ahora ya no están 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 habilitar la opción para restaurar el acceso.

## Seguridad

Las credenciales se ocultan 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 hará que su valor se filtre al historial de ejecución.

Las salidas de los pasos no se ocultan. Si un paso de código devuelve directamente el valor de una credencial (por ejemplo, `return token`), el valor aparecerá en el seguimiento de ejecución. Procura no incluir 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.
