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

# Renovar, actualizar o eliminar tokens de ADE con la API de Iru

> Renueva, actualiza o elimina tokens de Automated Device Enrollment con la API de Iru Endpoint para evitar su caducidad y mantener las conexiones con Apple Business.

<Note title="Cambio de nombre de Apple Business">
  **Apple Business Manager** ahora es **Apple Business**. **Apple School Manager** no cambia. Para obtener más información, consulta [Introducing Apple Business](https://www.apple.com/newsroom/2026/03/introducing-apple-business-a-new-all-in-one-platform-for-businesses-of-all-sizes/) y [Apple Business Manager is now Apple Business](https://support.apple.com/guide/apple-business-manager/apple-business-manager-is-now-apple-business-axmd79d79dea/web).
</Note>

### Acerca de la gestión de tokens de ADE

Los tokens de Automated Device Enrollment (ADE) requieren una renovación y gestión periódicas para mantener la capacidad de inscripción de dispositivos. Este proceso te permite gestionar de forma eficiente varios tokens de ADE mediante automatización con la API, lo que reduce el esfuerzo manual y garantiza una gestión coherente del ciclo de vida de los tokens.

### Cómo funciona

La gestión de tokens de ADE implica usar la API de Iru Endpoint mediante Postman para realizar operaciones masivas en varios tokens. El proceso incluye configurar el acceso a la API, establecer variables de entorno, descargar tokens desde Apple Business o Apple School Manager y usar flujos de trabajo automatizados para renovar, actualizar o eliminar tokens de forma eficiente.

<Warning>
  Si no te sientes seguro para completar este proceso por tu cuenta, ponte en contacto con el [soporte de Iru Endpoint](/es/iru/iru-support/access-to-iru-support) para obtener orientación adicional.
</Warning>

### Requisitos previos

* Acceso a Iru Endpoint con permisos para crear tokens de API
* Aplicación Postman instalada y configurada
* Acceso a Apple Business o Apple School Manager
* Varios tokens de ADE que necesiten renovación o gestión
* Conocimientos básicos de operaciones de API y flujos de trabajo de Postman

### Configurar un token de la API de Iru Endpoint

Prepara un token de API y guárdalo en un lugar seguro. Puedes obtener más información al respecto en nuestro artículo [API de Iru Endpoint](/en/endpoint/api/iru-api-overview). Puedes omitir esta sección si ya tienes un token de API preparado.

<Steps>
  <Step title="Crea o modifica un token de API">
    Crea un nuevo token de API o modifica uno existente con los permisos necesarios.
  </Step>

  <Step title="Abre Tokens de API">
    En tu tenant de Iru Endpoint, en la barra lateral, selecciona el [**botón del menú de la cuenta**](/es/iru/platform-overview/account-menu) y luego selecciona **Acceso** → **Tokens de API**.
  </Step>

  <Step title="Configura los permisos">
    Crea o modifica el token de API existente para incluir todos los permisos relacionados con Automated Device Enrollment.
  </Step>
</Steps>

### Preparar Postman

La mayoría de los pasos siguientes se realizarán en la aplicación Postman de tu dispositivo. Puedes omitir esta sección si ya tienes Postman configurado.

<Steps>
  <Step title="Verifica la estructura de la colección">
    Comprueba que tu colección contenga la carpeta Automated Device Enrollment integrations.
  </Step>

  <Step title="Define la URL de la API">
    Define la URL de tu API si no está definida en la carpeta Iru Endpoint API, en la parte superior de la colección.
  </Step>

  <Step title="Configura las variables de entorno">
    Define el token de API en tus variables de entorno siguiendo nuestro artículo Cómo configurar la API de Iru Endpoint en Postman.
  </Step>
</Steps>

### Configurar las variables de entorno de Postman

Ahora que los aspectos básicos de Postman están configurados, tendrás que definir algunas variables de entorno en Postman para llevar un control de los servidores de Automated Device Enrollment.

<Steps>
  <Step title="Crea variables de entorno">
    En Postman, selecciona la pestaña **Environments** en la barra lateral izquierda y luego selecciona **Create Environment** para crear un nuevo entorno. Asigna un nombre a tu entorno (por ejemplo, "Iru Endpoint API") y añade las siguientes variables:

    * **Variable**: `base_url`
      * **Initial Value**: `https://<subdomain>.api.iru.com/api/v1`
      * **Current Value**: `https://<subdomain>.api.iru.com/api/v1`

    <Note>Sustituye `<subdomain>` por el subdominio real de tu tenant o copia la URL base directamente desde tu tenant. La URL que se muestra en tu tenant puede usar el dominio `api.kandji.io`. Tanto `<subdomain>.api.iru.com` como `<subdomain>.api.kandji.io` funcionarán sin modificaciones.</Note>

    * **Variable**: `token`
      * **Initial Value**: `your_api_token_here`
      * **Current Value**: `your_api_token_here`

    Selecciona **Guardar** para guardar tu entorno y luego selecciona el entorno recién creado en el menú desplegable de entornos de la esquina superior derecha.
  </Step>

  <Step title="Añádelas a las variables existentes">
    Si ya tienes variables de entorno configuradas, puedes añadir los nuevos elementos a las variables existentes.
  </Step>

  <Step title="Lista las integraciones de ADE">
    Ve a **Iru Endpoint API** > **Automated Device Enrollment Integrations** > **GET List ADE Integrations** en la colección.
  </Step>

  <Step title="Ejecuta la solicitud">
    Selecciona el botón **Enviar** para ejecutar la solicitud.
  </Step>

  <Step title="Copia los ID de los tokens">
    En la sección **Body** de los resultados, copia los ID de nivel superior de cada token de Automated Device Enrollment.
  </Step>

  <Step title="Crea variables para los tokens">
    Para cada ID de token, crea una variable de entorno con un esquema de nomenclatura como `ade_token_1`, `ade_token_2`, etc., incrementando el número para cada token.
  </Step>

  <Step title="Anota los nombres de los servidores">
    Anota el `server_name` asociado a cada token. Necesitarás esta información al descargar los tokens desde Apple Business o Apple School Manager.
  </Step>

  <Step title="Establece los valores de las variables">
    Pega el valor del ID de cada token en la variable `ade_token_#` correspondiente (por ejemplo, `ade_token_1`, `ade_token_2`).
  </Step>

  <Step title="Protege las variables">
    Puedes establecer el tipo de variable como secreto para que su valor no sea visible.
  </Step>
</Steps>

### Descargar tokens de ADE

<Steps>
  <Step title="Accede a Apple Business o Apple School Manager">
    Inicia sesión en tu cuenta de [Apple Business](https://business.apple.com) o [Apple School Manager](https://school.apple.com).
  </Step>

  <Step title="Abre la pestaña Devices">
    Selecciona la pestaña **Dispositivos** en la parte superior de la página.
  </Step>

  <Step title="Abre Management">
    En la barra lateral izquierda, selecciona **Management**.
  </Step>

  <Step title="Selecciona el servicio de gestión de dispositivos correspondiente">
    En la lista **Management Services**, selecciona el servicio cuyo nombre coincida con el `server_name` de la primera integración de ADE de la lista que creaste antes en Postman.
  </Step>

  <Step title="Abre el menú de acciones del servicio">
    Selecciona los puntos suspensivos (**…**) de ese servicio.
  </Step>

  <Step title="Descarga el token">
    Selecciona **Download Token**.
  </Step>

  <Step title="Repite para todos los tokens">
    Repite este proceso para cada token que vayas a renovar.
  </Step>
</Steps>

### Crear una plantilla de carpeta en Postman

Crear carpetas en Postman te facilitará llevar un control de tus tokens de Automated Device Enrollment.

<Steps>
  <Step title="Accede a las opciones de la carpeta">
    Selecciona los puntos suspensivos junto a la carpeta Automated Device Enrollment Integrations.
  </Step>

  <Step title="Añade una carpeta nueva">
    Selecciona Add folder.
  </Step>

  <Step title="Asigna un nombre a la carpeta">
    Asigna a la carpeta el nombre ADE\_Token1.
  </Step>

  <Step title="Selecciona los elementos de integración">
    Ve a la carpeta **Automated Device Enrollment Integrations** y selecciona los elementos **Renew ADE Integration** y **Update ADE Integration**.
  </Step>

  <Step title="Copia los elementos">
    Haz clic con el botón derecho (o Control-clic) en los elementos seleccionados y elige **Copiar**.
  </Step>

  <Step title="Accede a la carpeta nueva">
    Selecciona los puntos suspensivos junto a la carpeta ADE\_Token1.
  </Step>

  <Step title="Pega los elementos">
    Selecciona **Paste** para añadir los elementos copiados a la carpeta nueva.
  </Step>
</Steps>

### Modificar el elemento Renew

<Steps>
  <Step title="Selecciona el elemento Renew">
    Selecciona el elemento **Renew ADE Integration** de la carpeta de tu token.
  </Step>

  <Step title="Cambia el nombre del elemento">
    Cámbiale el nombre a **Renew ADE1 Integration** (o **Renew ADE2 Integration**, etc., según el número de tu token).
  </Step>

  <Step title="Actualiza la barra de direcciones">
    En la sección de la derecha, selecciona la barra de direcciones situada a la izquierda del botón **Enviar**.
  </Step>

  <Step title="Actualiza la variable del token">
    Selecciona el texto dentro de `{{ade_token_ade}}` y cámbialo a `{{ade_token_1}}` (o `{{ade_token_2}}`, etc., según el número de tu token).
  </Step>

  <Step title="Configura el cuerpo">
    Selecciona la pestaña Body situada debajo.
  </Step>

  <Step title="Introduce los detalles del token">
    Introduce el `blueprint_id`, el teléfono y el correo electrónico que deben asociarse al token.
  </Step>

  <Step title="Selecciona el archivo del token">
    Para el archivo, selecciona la x junto a los archivos actuales y luego selecciona el botón Select Files.
  </Step>

  <Step title="Elige el archivo P7M">
    Elige el archivo .p7m que corresponde a este token de ADE.
  </Step>

  <Step title="Guarda los cambios">
    Guarda los cambios.
  </Step>
</Steps>

### Modificar el elemento Update

<Steps>
  <Step title="Selecciona el elemento Update">
    Selecciona el elemento **Update ADE Integration** de la carpeta de tu token.
  </Step>

  <Step title="Cambia el nombre del elemento">
    Cámbiale el nombre a **Update ADE1 Integration** (o **Update ADE2 Integration**, etc., según el número de tu token).
  </Step>

  <Step title="Actualiza la barra de direcciones">
    En la sección de la derecha, selecciona la barra de direcciones situada a la izquierda del botón **Enviar**.
  </Step>

  <Step title="Actualiza la variable del token">
    Selecciona el texto dentro de `{{ade_token_ade}}` y cámbialo a `{{ade_token_1}}` (o `{{ade_token_2}}`, etc., según el número de tu token).
  </Step>

  <Step title="Configura el cuerpo">
    Selecciona la pestaña Body situada debajo.
  </Step>

  <Step title="Introduce la información actualizada">
    Aquí puedes introducir la nueva información de `blueprint_id`, teléfono y correo electrónico.
  </Step>

  <Step title="Guarda los cambios">
    Guarda los cambios.
  </Step>
</Steps>

### Duplicar la carpeta ADE\_Token

<Steps>
  <Step title="Accede a las opciones de la carpeta">
    Selecciona los puntos suspensivos junto a la carpeta ADE\_Token1.
  </Step>

  <Step title="Duplica la carpeta">
    Elige Duplicate.
  </Step>

  <Step title="Actualiza el contenido de la carpeta">
    Actualiza el contenido de la carpeta siguiendo el proceso anterior.
  </Step>

  <Step title="Crea carpetas adicionales">
    Crea duplicados de la carpeta para cada uno de tus tokens de ADE.
  </Step>
</Steps>

### Renovar la integración de ADE

Ahora que todo está configurado, puedes enviar el comando Renew.

<Steps>
  <Step title="Selecciona el comando Renew">
    Ve a la carpeta del token específico que creaste (por ejemplo, **ADE\_Token1**, **ADE\_Token2**, etc.) y selecciona el elemento **Renew ADE1 Integration** (o **Renew ADE2 Integration**, etc.) que corresponda al número de tu token.
  </Step>

  <Step title="Ejecuta el comando">
    Selecciona el botón Send.
  </Step>
</Steps>

### Actualizar la integración de ADE

Actualizar la integración de ADE te permite cambiar el ID del Blueprint, el número de teléfono y la dirección de correo electrónico asociados.

<Steps>
  <Step title="Selecciona el comando Update">
    Ve a la carpeta del token específico que creaste (por ejemplo, **ADE\_Token1**, **ADE\_Token2**, etc.) y selecciona el elemento **Update ADE1 Integration** (o **Update ADE2 Integration**, etc.) que corresponda al número de tu token.
  </Step>

  <Step title="Actualiza los detalles">
    Actualiza los detalles de la sección Body que necesiten actualizarse.
  </Step>

  <Step title="Ejecuta el comando">
    Selecciona el botón Send.
  </Step>
</Steps>

### Comprobar las integraciones actuales

El comando Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations devuelve todas las integraciones de ADE actuales para que podamos verificar que la integración se renovó o actualizó correctamente.

<Steps>
  <Step title="Selecciona el comando List">
    Selecciona Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations en la colección.
  </Step>

  <Step title="Ejecuta el comando">
    Selecciona el botón Send.
  </Step>

  <Step title="Verifica la renovación">
    La variable `days_left` debería ser 364 si el comando Renew se ejecutó correctamente.
  </Step>

  <Step title="Verifica las actualizaciones">
    Para verificar una actualización, comprueba la información asociada al token de ADE para confirmar que se actualizó.
  </Step>
</Steps>

### Eliminar la integración

El comando Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration elimina la integración de ADE asociada al ID de token de ADE proporcionado.

<Steps>
  <Step title="Selecciona el comando Delete">
    Selecciona Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration en la colección.
  </Step>

  <Step title="Establece el ID del token">
    Rellena la variable `ade_token_id` con el ID del token de ADE.
  </Step>

  <Step title="Ejecuta el comando">
    Selecciona el botón Send.
  </Step>
</Steps>

### Consideraciones

<AccordionGroup>
  <Accordion title="Seguridad de la API, Postman y configuración del entorno">
    * **Seguridad del token de API**: asegúrate de que los tokens de API se almacenen de forma segura y tengan los permisos adecuados para las operaciones de ADE
    * **Configuración de Postman**: una configuración correcta de Postman es esencial para que las operaciones de API se realicen correctamente
    * **Variables de entorno**: usa variables de entorno para gestionar varios ID de token de forma eficiente
    * **Gestión de errores**: prepárate para solucionar errores de la API y problemas de validación de tokens
  </Accordion>

  <Accordion title="Tokens, archivos y acceso al portal de Apple">
    * **Ciclo de vida de los tokens**: los tokens de ADE tienen fechas de caducidad y requieren una renovación periódica para mantener la capacidad de inscripción
    * **Gestión de archivos de token**: lleva un control de los archivos .p7m descargados y asócialos con los ID de token correctos
    * **Acceso a Apple Business o Apple School Manager**: asegúrate de poder iniciar sesión en el portal y descargar los tokens
    * **Proceso de verificación**: verifica siempre que las operaciones se hayan realizado correctamente comprobando el estado de la integración y la caducidad del token
  </Accordion>

  <Accordion title="Operaciones masivas y control de acceso">
    * **Operaciones masivas**: usa plantillas de carpeta para gestionar varios tokens de forma eficiente
    * **Control de acceso**: asegúrate de que solo el personal autorizado tenga acceso a las operaciones de gestión de tokens
  </Accordion>

  <Accordion title="Pruebas, supervisión y continuidad">
    * **Pruebas**: prueba las operaciones a pequeña escala antes de realizar operaciones masivas
    * **Supervisión**: supervisa periódicamente las fechas de caducidad de los tokens y los calendarios de renovación
    * **Documentación**: mantén registros de las configuraciones de los tokens y los nombres de servidor asociados
    * **Estrategia de respaldo**: mantén copias de seguridad de las configuraciones de los tokens y de los ajustes de la API
  </Accordion>
</AccordionGroup>