> ## 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.

# Postman

> Conecta Postman a Iru Compliance con una API key para recopilar evidencia del inventario de espacios de trabajo, metadatos de colecciones, membresía de equipos y registros de auditoría.

### Acerca de Postman

Postman expone datos de equipos y espacios de trabajo mediante API autenticadas con **`X-API-Key`**. Iru lee **espacios de trabajo**, **colecciones**, **definiciones de API**, **membresía** y registros de **auditoría** cuando tu plan lo permite.

### Cómo funciona

```http theme={null}
X-API-Key: YOUR_API_KEY
```

| Detalle | Valor |
| - | - |
| **Categoría** | Herramientas de desarrollo |
| **Autenticación** | API key (`X-API-Key`) |

Las claves heredan el acceso a espacios de trabajo de su creador: usa un usuario **dedicado** cuando quieras limitar más el alcance de un posible incidente.

Referencias oficiales: [Managing Claves de API](https://learning.postman.com/docs/administration/managing-your-team/managing-api-keys), documentación del espacio de trabajo **público** de Postman para la superficie de la API.

### Requisitos previos

* Permiso para **generar Claves de API** (la política de la organización puede restringirlo).

### Conectar Postman a Iru

<Tabs>
  <Tab title="Postman">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Inicia sesión en Postman">
        Abre [postman.com](https://www.postman.com) e inicia sesión con un usuario que pueda administrar **Claves de API** para tu cuenta de **equipo** o **personal**, según dónde deba autenticarse Iru.
      </Step>

      <Step title="Abre el menú de tu avatar">
        Selecciona tu **Avatar** en la esquina superior derecha para abrir el menú de la cuenta.
      </Step>

      <Step title="Abre Account Settings">
        Elige **Account Settings** (o **Configuración** → **Cuenta** en algunos diseños).
      </Step>

      <Step title="Abre Claves de API">
        Selecciona **Claves de API** para ver las claves existentes y el control para generar una nueva.
      </Step>

      <Step title="Genera una nueva API key">
        Selecciona **Generate API Key**. Asígnale un nombre (por ejemplo, **Iru Compliance**) y establece la **caducidad** si tu organización lo requiere.
      </Step>

      <Step title="Copia la clave una sola vez">
        Copia el valor de la clave cuando Postman lo muestre. Postman puede **revocar automáticamente** las claves encontradas en repositorios públicos, así que guárdala en un gestor de secretos hasta que la pegues en **Iru Compliance**.
      </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 [**Postman**](#postman).
    </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 Postman">
        Busca **Postman** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **toggle**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Pega la API key">
        Pega la clave en el campo **`X-API-Key`**.
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar clave de API**. Cuando la conexión se realiza correctamente, 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 **Postman** 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="401 Unauthorized">
    Usa la clave completa; verifica que no haya caducado ni se haya revocado.
  </Accordion>

  <Accordion title="Creación bloqueada">
    Un administrador de la organización debe permitir las Claves de API para tu rol.
  </Accordion>

  <Accordion title="Revocada automáticamente">
    Emite una nueva clave; guárdala en un gestor de secretos.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

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

  <Card title="Primeros pasos con 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="Administración de Artifacts" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>