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

# Okta

> Conecta Okta a Iru Compliance con un token de API para recopilar evidencia de usuarios y grupos del directorio, asignaciones de aplicaciones, políticas de MFA y auditoría de System Log.

### Acerca de Okta

El conector de **Okta** lee los datos del directorio, la pertenencia a grupos, las asignaciones de aplicaciones, las políticas, la postura de MFA y las señales relacionadas con auditoría de tu organización de Okta, y los muestra como artefactos en Iru Compliance. La autenticación usa un **token de API de Okta** sobre la **Okta Management API**. La integración está pensada para la recopilación de evidencia de **solo lectura**. Iru no aprovisiona usuarios ni cambia políticas en Okta más allá de lo que permiten los permisos de administrador de tu token durante las lecturas de la API.

### Cómo funciona

Okta acepta tokens de API mediante el esquema **SSWS**:

```http theme={null}
Authorization: SSWS YOUR_API_TOKEN
```

Los tokens heredan los permisos del administrador que los creó. **Los tokens que no se usan caducan después de 30 días**; las llamadas a la API correctas renuevan ese período.

El conector de Iru recorre las URL de servidor de tu tenant (producción, EMEA, Gov, vista previa o dominio personalizado) y, a continuación, solicita tu **token de API** en el último paso. Los pasos anteriores del asistente alinean las URL relacionadas con OAuth donde el producto las espera; la **autenticación con token SSWS** es lo que autoriza las llamadas a la Management API para esta fuente.

| Detalle | Valor |
| - | - |
| **Categoría** | Seguridad |
| **Autenticación** | Token de API de Okta (`Authorization: SSWS YOUR_TOKEN`) |
| **Plan de Okta** | Cualquier plan que incluya el acceso a la Management API del que dependes |

Documentación: [Crear un token de API](https://developer.okta.com/docs/guides/create-an-api-token/main/), [Administración de tokens de API](https://help.okta.com/en-us/content/topics/security/api.htm), [Límites de velocidad](https://developer.okta.com/docs/reference/rate-limits/).

### Requisitos previos

* Un rol de administrador de Okta que pueda **crear tokens de API** (**Super Admin**, **Administrador de la organización** o **Read-only Admin**, según lo que tu organización permita para las cuentas de automatización).
* El **subdominio** o el **dominio de Okta** completo de tu organización (por ejemplo, `acme` si los usuarios inician sesión en `https://acme.okta.com`).

### Conectar Okta a Iru

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

    <Steps>
      <Step title="Inicia sesión en la Okta Admin Console">
        Abre la URL de administración de tu organización (por ejemplo, `https://YOUR_SUBDOMAIN.okta.com/admin`) e inicia sesión con un rol que pueda crear **tokens de API** (**Super Admin**, **Administrador de la organización** o **Read-only Admin**, según lo que tu organización permita para las cuentas de automatización).
      </Step>

      <Step title="Abre Security">
        En la navegación izquierda, expande **Seguridad** (o busca **API** en la barra de búsqueda de administración).
      </Step>

      <Step title="Abre la administración de tokens de API">
        Elige **API** → **Tokens** para abrir la lista de tokens existentes y **Crear token**.
      </Step>

      <Step title="Crea un token nuevo">
        Selecciona **Crear token**, introduce un nombre que reconozcas (por ejemplo, **Iru Compliance**) y confirma la creación para que Okta pueda mostrar el secreto una vez.
      </Step>

      <Step title="Copia el token de inmediato">
        Copia el valor del token antes de cerrar el cuadro de diálogo. No podrás volver a verlo después de salir de la página. Guárdalo en un almacén de secretos hasta que lo pegues en Iru.

        Ten en cuenta la **caducidad por inactividad**: si ninguna llamada a la API correcta usa el token durante **30 días**, Okta lo invalida y debes crear un token nuevo.
      </Step>

      <Step title="Restricciones de red opcionales">
        Si tu entorno usa IP de salida fijas, puedes asociar opcionalmente una política de **network zone** al token según la documentación de Okta.
      </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 [**Okta**](#okta).
    </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 Okta">
        Busca **Okta** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Se abre una pestaña nueva con el asistente del conector.
      </Step>

      <Step title="Elige la URL de servidor que corresponda a tu tenant">
        Selecciona la fila que corresponda a la ubicación de tu organización:

        | Entorno | Patrón de URL base |
        | - | - |
        | Producción (EE. UU.) | `https://YOUR_SUBDOMAIN.okta.com` |
        | EMEA | `https://YOUR_SUBDOMAIN.okta-emea.com` |
        | Vista previa / sandbox | `https://YOUR_SUBDOMAIN.oktapreview.com` |
        | US Gov | `https://YOUR_SUBDOMAIN.okta-gov.com` |
        | Dominio personalizado | `https://YOUR_OKTA_DOMAIN` |

        Confirma tu elección para que el asistente pueda crear la URL base correcta de la Management API.
      </Step>

      <Step title="Introduce las variables de subdominio y dominio">
        Sigue cada pantalla del asistente: introduce los valores de tu **subdominio** o dominio donde se te solicite para que las URL relacionadas con OAuth sean coherentes con tu tenant.

        <Note>
          Los pasos intermedios del asistente que mencionan URL de OAuth existen porque la plantilla del conector configura los endpoints por completo. La **autenticación con token SSWS** del último paso es lo que Iru usa para las lecturas de la Management API en esta fuente.
        </Note>
      </Step>

      <Step title="Pega el token de API">
        En el paso de credenciales, pega tu **token de API** en el campo de autorización.
      </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 de **Okta** 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">
    Verifica la cadena del token, que la cuenta de administrador siga activa y que el token no se haya revocado.
  </Accordion>

  <Accordion title="Token caducado">
    Vuelve a crear el token en **Seguridad** → **API** → **Tokens** si ha estado inactivo durante 30 días.
  </Accordion>

  <Accordion title="403 Forbidden">
    Es posible que el perfil de administrador vinculado al token no tenga acceso de lectura a algunos endpoints. Confirma que tenga al menos **Read-only Admin** (o equivalente) para la evidencia que necesitas.
  </Accordion>

  <Accordion title="Host o dominio incorrecto">
    Desconecta y vuelve a conectar, comprobando bien el subdominio y la región (EE. UU., EMEA, Gov o vista previa).
  </Accordion>
</AccordionGroup>

### Consideraciones

<CardGroup cols={2}>
  <Card title="Trata los tokens de API como credenciales" icon="circle-info">
    Trata los tokens de API como credenciales. Es preferible una **cuenta de servicio** con el rol de administrador **mínimo** que siga cumpliendo los requisitos de evidencia.
  </Card>

  <Card title="Okta aplica límites de velocidad al tráfico de la Management API;…" icon="shield">
    Okta aplica **límites de velocidad** al tráfico de la Management API; en las organizaciones grandes, la sincronización puede tardar más durante la primera recopilación.
  </Card>

  <Card title="Iru lee los datos expuestos por las API a las que tu token puede…" icon="server">
    Iru lee los datos expuestos por las API a las que tu token puede acceder; no puede anular los permisos de Okta que no concedas.
  </Card>
</CardGroup>

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