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

# Autorizar tu tenant de Iru para Okta Workflows

> Autoriza tu tenant de Iru Endpoint para la integración con Okta Workflows. Genera tokens de API, configura el conector y habilita flujos de trabajo automatizados para dispositivos.

<Callout icon="list-check" color="#B84A7A" iconType="regular">Esta guía se aplica a computadoras Mac y computadoras Windows</Callout>

<Note>
  En Okta Workflows, el conector sigue apareciendo como **Kandji**. Los pasos de esta guía para crear un token de API y copiar tu dominio se realizan en **Iru Endpoint**. Cuando configures la conexión en Okta Workflows, selecciona **Kandji** e introduce tu token de API y tu dominio de Iru Endpoint.
</Note>

### Acerca de autorizar tu tenant de Iru para Okta Workflows

Autorizar tu tenant de Iru Endpoint para Okta Workflows permite que Okta Workflows se conecte a tu tenant mediante el conector **Kandji**, para que puedas automatizar tareas de gestión de dispositivos en tus flujos de trabajo.

### Cómo funciona

El conector **Kandji** de Okta Workflows se conecta a tu tenant de Iru Endpoint mediante un token de API y un dominio. Después de configurar la conexión, puedes crear flujos de trabajo que respondan a eventos del ciclo de vida de los usuarios y a tareas de gestión de dispositivos sin pasos manuales en Iru Endpoint.

### Requisitos previos

Antes de empezar, asegúrate de tener:

* Credenciales de administrador de Okta Workflows
* Acceso de administrador a Iru Endpoint
* Acceso a la API habilitado en tu tenant de Iru Endpoint

Después de autorizar correctamente tu tenant de Iru Endpoint para Okta Workflows, puedes [usar las tarjetas de acción del conector Kandji en Okta Workflows](/es/endpoint/integrations/okta-workflows/use-kandji-connector-action-cards-with-okta-workflows).

### Autorizar tu tenant de Iru

La autorización tiene dos partes: crear un token de API y copiar tu dominio en **Iru Endpoint** y, después, configurar el conector **Kandji** en **Okta Workflows** con esos valores.

Cuando añades una tarjeta **Kandji** a un flujo de trabajo por primera vez, Okta Workflows te pide que configures la conexión. Puedes guardar la conexión y reutilizarla en futuros flujos de trabajo.

<Note>
  Puedes crear y gestionar varias conexiones desde tu página **Connections**.
</Note>

#### Crear un token de API en Iru Endpoint

Completa estos pasos en la app web de **Iru Endpoint**.

Para crear un token de API para el conector Kandji en Okta Workflows:

<Steps>
  <Step title="Acceder a Iru Endpoint">
    Inicia sesión en la app web de Iru Endpoint con credenciales de administrador.
  </Step>

  <Step title="Abrir Access">
    En la barra lateral, selecciona el [**Botón del menú de la cuenta**](/es/iru/platform-overview/account-menu) y, a continuación, selecciona **Acceso**.

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-access.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=466fdf5fb47efd6bab8b450a5a1e8302" alt="Captura de pantalla del menú de la cuenta con la opción Access resaltada" width="562" height="1040" data-path="assets/media/images/iru-nav-access.png" />
    </Frame>
  </Step>

  <Step title="Añadir token">
    En la pestaña **Tokens de API**, selecciona **Add Token**.
  </Step>

  <Step title="Configurar el nombre del token">
    En el campo **Nombre**, introduce un nombre como Okta Workflows.
  </Step>

  <Step title="Añadir la descripción del token">
    En el campo Description, introduce una descripción como *Allow Okta Workflows to use the Iru Endpoint API*.
  </Step>

  <Step title="Crear el token">
    Selecciona **Crear**.
  </Step>

  <Step title="Copiar el token de API">
    En el cuadro de diálogo **Copy your API token**, selecciona **Copy Token**.
  </Step>

  <Step title="Guardar el token de forma segura">
    Guarda el token copiado en un lugar seguro. Si pierdes el texto del token, puedes eliminarlo antes de usarlo y crear uno nuevo con los pasos anteriores. Usarás este token en el paso 4 de la siguiente sección.
  </Step>

  <Step title="Confirmar la copia del token">
    Selecciona la casilla **He copiado el token y entiendo que no podré volver a ver estos detalles**.
  </Step>

  <Step title="Continuar con la configuración">
    Selecciona Next.
  </Step>

  <Step title="Configurar los permisos">
    En el cuadro de diálogo **Manage API Permissions**, selecciona **Configurar**.
  </Step>

  <Step title="Seleccionar los permisos">
    En la sección Permissions, selecciona la casilla de cada área a la que quieras que Okta Workflows tenga acceso. Por ejemplo, selecciona la casilla **Blueprints Management** para habilitar todos los permisos para inspeccionar y modificar Blueprints. Nota: puedes seleccionar el triángulo desplegable situado a la derecha del tipo de permiso para mostrar permisos más específicos.
  </Step>

  <Step title="Revisar los permisos">
    Revisa los permisos que has configurado para el token de API.
  </Step>

  <Step title="Guardar la configuración">
    Selecciona **Guardar** y, a continuación, **Cerrar**.
  </Step>

  <Step title="Verificar la creación del token">
    En la pestaña **Tokens de API**, confirma que se muestra tu nuevo token.
  </Step>

  <Step title="Copiar la URL de la API">
    En el campo **Your organization's API URL is**, copia o anota tu dominio de Iru Endpoint.

    <Frame>
      <img src="https://mintcdn.com/iru/97IKZnNVEzytYzut/assets/media/images/iru-okta-workflows-api-url.png?fit=max&auto=format&n=97IKZnNVEzytYzut&q=85&s=05f21971cae8156ca02cc0ab32a3e559" alt="Campo de URL de la API de Iru Endpoint que muestra la URL de la API de la organización que debe copiarse para la conexión de Okta Workflows" width="1898" height="866" data-path="assets/media/images/iru-okta-workflows-api-url.png" />
    </Frame>
  </Step>
</Steps>

#### Configurar el conector Kandji en Okta Workflows

Completa estos pasos en **Okta Workflows**. Necesitas el token de API y el dominio de la sección anterior.

Puedes crear más de una conexión. Por ejemplo, puedes tener varios tenants de Iru Endpoint o estar probando varios tokens de API. El token de API debe incluir al menos el permiso **Devices: Device Information: Device list**. Concede permisos adicionales en función de las acciones de flujo de trabajo que pienses usar. Por ejemplo, para enumerar todos los dispositivos, el token necesita:

| Permiso | Descripción |
| - | - |
| **Devices: Device Information: Device list** | Obtener una lista de todos los dispositivos del tenant de Iru Endpoint |
| **Devices: Device Information: Device details** | Obtener todos los detalles de un dispositivo específico |

<Steps>
  <Step title="Crear una nueva conexión">
    En Okta Workflows, desde la página Connections o desde cualquier tarjeta, selecciona **New Connection**.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-new-connection.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8660bcbc03e426c96c8324fe11b45111" alt="Página Connections de Okta Workflows con el botón New Connection que debe seleccionarse para crear una nueva conexión" width="686" height="234" data-path="assets/media/images/iru-okta-workflows-new-connection.png" />
    </Frame>
  </Step>

  <Step title="Seleccionar el conector Kandji">
    En la ventana New Connection, desplázate si es necesario y selecciona **Kandji**. Este es el nombre del conector en Okta Workflows; se conecta a tu tenant de Iru Endpoint.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-kandji-connector.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=efffbbe77501dc2b238574cb3a248e58" alt="Ventana New Connection de Okta Workflows con la lista de conectores disponibles y Kandji resaltado para su selección" width="651" height="725" data-path="assets/media/images/iru-okta-workflows-select-kandji-connector.png" />
    </Frame>
  </Step>

  <Step title="Configurar el alias de la conexión">
    En el campo **Connection Nickname**, introduce un nombre único que te ayude a distinguir varios tenants de Iru Endpoint o varias claves de API de Iru Endpoint.
  </Step>

  <Step title="Introducir la clave de API">
    En el campo **API key**, introduce o pega el texto del token de API que generaste en el paso 7 de la sección anterior.
  </Step>

  <Step title="Introducir el dominio">
    En el campo **Kandji domain**, introduce tu dominio completo de Iru Endpoint del paso 16 de la sección anterior. Okta Workflows etiqueta este campo como **Kandji domain**, pero el valor es la URL de la API de Iru Endpoint (por ejemplo, *accuhive.api.kandji.io* o *accuhive.api.eu.kandji.io*).
  </Step>

  <Step title="Crear la conexión">
    Selecciona **Crear**.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-connection-credentials.jpg?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=a854c9253adb5fc41e84bf3e642dfff9" alt="Formulario de configuración de la conexión de Okta Workflows con los campos Connection Nickname, API key y dominio de Iru Endpoint rellenados y el botón Create listo para seleccionarse" width="1084" height="1194" data-path="assets/media/images/iru-okta-workflows-connection-credentials.jpg" />
    </Frame>
  </Step>
</Steps>

El conector **Kandji** ya está configurado y conectado a tu tenant de Iru Endpoint. Puedes usarlo con las tarjetas de conector disponibles.

#### Usar la conexión en los flujos de trabajo

<Steps>
  <Step title="Crear un nuevo flujo">
    En Workflows, ve a la sección Flows y selecciona **+New Flow**.
  </Step>

  <Step title="Añadir una acción de app">
    Selecciona **Add app action**.
  </Step>

  <Step title="Seleccionar Kandji">
    En la sección **My Connected Apps**, selecciona **Kandji**. Okta Workflows sigue mostrando este nombre de app; proporciona acceso a tu tenant de Iru Endpoint.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-connected-app.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8273f6867296d243a8f4c86dc45aaafb" alt="Sección My Connected Apps de Okta Workflows que muestra Iru Endpoint como app conectada disponible que se puede seleccionar para acciones de flujo de trabajo" width="684" height="470" data-path="assets/media/images/iru-okta-workflows-select-connected-app.png" />
    </Frame>
  </Step>

  <Step title="Elegir una tarjeta de conector">
    Selecciona una tarjeta de conector.
  </Step>

  <Step title="Configurar y continuar">
    Configura la tarjeta y sigue creando tu flujo de trabajo.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-action-card.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=b4b164f71f667efc1bebdc6654649c4a" alt="Interfaz de selección de tarjetas de conector de Okta Workflows que muestra las tarjetas de acción de Iru Endpoint disponibles que se pueden seleccionar para el flujo de trabajo" width="1230" height="1248" data-path="assets/media/images/iru-okta-workflows-select-action-card.png" />
    </Frame>
  </Step>
</Steps>
