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

# Envoy

> Conecta Envoy a Iru Compliance mediante OAuth para recopilar registros de visitantes, invitaciones, ubicaciones y metadatos del directorio de empleados como evidencia de seguridad física.

### Acerca de Envoy

Iru lee los **registros de entrada de visitantes**, las **invitaciones**, las **ubicaciones** y los metadatos del directorio de **empleados** mediante la API de Envoy usando **OAuth 2.0** (**código de autorización**). Los ámbitos típicos incluyen **`entry_logs.read`**, **`invites.read`**, **`locations.read`**, **`employees.read`**, además de **`refresh_tokens`** para que Iru pueda rotar los tokens de acceso sin inicios de sesión repetidos.

### Cómo funciona

Iru usa el flujo de **código de autorización de OAuth 2.0** de Envoy. Cuando habilitas la fuente, una **ventana emergente del navegador** redirige al servidor de autorización de Envoy. Inicias sesión, revisas los ámbitos y concedes el acceso; Envoy devuelve un código que Iru intercambia por un **token de acceso** y un **token de actualización**.

| Detalle | Valor |
| - | - |
| **Categoría** | Productividad |
| **Autenticación** | OAuth 2.0 |
| **Planes típicos** | Premium o Enterprise para el acceso a la API |

Referencias oficiales: [Developer hub](https://developers.envoy.com/hub/docs), [Autorización](https://developers.envoy.com/hub/docs/authorization), [Ámbitos](https://developers.envoy.com/hub/docs/scopes).

### Requisitos previos

* **Administrador** o **Global Admin** en Envoy.
* **Ventanas emergentes** habilitadas en el navegador.

### Conectar Envoy a Iru

<Tabs>
  <Tab title="Envoy">
    <Note>
      Completa esta pestaña antes de habilitar **Envoy** en **Iru Compliance**, para que el administrador adecuado complete OAuth.
    </Note>

    <Steps>
      <Step title="Inicia sesión en Envoy">
        Abre tu panel de Envoy (por ejemplo, [dashboard.envoy.com](https://dashboard.envoy.com) o la URL que use tu organización) e inicia sesión con derechos de **Administrador** o **Global Admin**.
      </Step>

      <Step title="Confirma el acceso a la API de Premium o Enterprise">
        Las API para desarrolladores de Envoy requieren un plan que exponga los ámbitos que solicita Iru. Confirma que tu suscripción cumple los **requisitos previos** de este artículo.
      </Step>

      <Step title="Revisa los ámbitos de OAuth">
        Revisa rápidamente la [autorización de Envoy](https://developers.envoy.com/hub/docs/authorization) y los [ámbitos](https://developers.envoy.com/hub/docs/scopes) para que la pantalla de consentimiento coincida con tu revisión de seguridad.
      </Step>

      <Step title="Permite ventanas emergentes para Iru">
        En el perfil del navegador que usarás para Compliance, permite las **ventanas emergentes** para el nombre de host de **Iru** para que la ventana de OAuth de Envoy no se bloquee.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**Envoy**](#envoy).
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa Envoy">
        Busca **Envoy** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Inicia sesión en Envoy">
        En la ventana emergente de OAuth, completa el inicio de sesión en Envoy si se te solicita.
      </Step>

      <Step title="Autoriza Envoy">
        En la ventana emergente de OAuth de Envoy, selecciona **Authorize** (o el control de aprobación equivalente).
      </Step>

      <Step title="Finaliza la conexión">
        Cuando la ventana emergente se cierra e Iru completa el intercambio de tokens, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Envoy** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="Ventana emergente bloqueada">
    Permite las ventanas emergentes para el origen de Iru y vuelve a intentarlo.
  </Accordion>

  <Accordion title="Acceso denegado">
    El rol de Envoy no es suficiente: usa Admin/Global Admin.
  </Accordion>

  <Accordion title="No hay datos de la API">
    Es posible que el plan **Estándar** no incluya la API: actualízalo según las licencias de Envoy.
  </Accordion>

  <Accordion title="Conexión obsoleta">
    Administrador desactivado: **vuelve a autorizar** con una cuenta activa.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>