Apple Business Manager ahora es Apple Business. Apple School Manager no cambia. Para obtener más información, consulta Introducing Apple Business y Apple Business Manager is now Apple Business.
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.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. Puedes omitir esta sección si ya tienes un token de API preparado.1
Crea o modifica un token de API
Crea un nuevo token de API o modifica uno existente con los permisos necesarios.
2
Abre Tokens de API
En tu tenant de Iru Endpoint, en la barra lateral, selecciona el botón del menú de la cuenta y luego selecciona Acceso → Tokens de API.
3
Configura los permisos
Crea o modifica el token de API existente para incluir todos los permisos relacionados con Automated Device Enrollment.
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.1
Verifica la estructura de la colección
Comprueba que tu colección contenga la carpeta Automated Device Enrollment integrations.
2
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.
3
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.
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.1
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
- Initial Value:
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.- Variable:
token- Initial Value:
your_api_token_here - Current Value:
your_api_token_here
- Initial Value:
2
Añádelas a las variables existentes
Si ya tienes variables de entorno configuradas, puedes añadir los nuevos elementos a las variables existentes.
3
Lista las integraciones de ADE
Ve a Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations en la colección.
4
Ejecuta la solicitud
Selecciona el botón Enviar para ejecutar la solicitud.
5
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.
6
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.7
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.8
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).9
Protege las variables
Puedes establecer el tipo de variable como secreto para que su valor no sea visible.
Descargar tokens de ADE
1
Accede a Apple Business o Apple School Manager
Inicia sesión en tu cuenta de Apple Business o Apple School Manager.
2
Abre la pestaña Devices
Selecciona la pestaña Dispositivos en la parte superior de la página.
3
Abre Management
En la barra lateral izquierda, selecciona Management.
4
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.5
Abre el menú de acciones del servicio
Selecciona los puntos suspensivos (…) de ese servicio.
6
Descarga el token
Selecciona Download Token.
7
Repite para todos los tokens
Repite este proceso para cada token que vayas a renovar.
Crear una plantilla de carpeta en Postman
Crear carpetas en Postman te facilitará llevar un control de tus tokens de Automated Device Enrollment.1
Accede a las opciones de la carpeta
Selecciona los puntos suspensivos junto a la carpeta Automated Device Enrollment Integrations.
2
Añade una carpeta nueva
Selecciona Add folder.
3
Asigna un nombre a la carpeta
Asigna a la carpeta el nombre ADE_Token1.
4
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.
5
Copia los elementos
Haz clic con el botón derecho (o Control-clic) en los elementos seleccionados y elige Copiar.
6
Accede a la carpeta nueva
Selecciona los puntos suspensivos junto a la carpeta ADE_Token1.
7
Pega los elementos
Selecciona Paste para añadir los elementos copiados a la carpeta nueva.
Modificar el elemento Renew
1
Selecciona el elemento Renew
Selecciona el elemento Renew ADE Integration de la carpeta de tu token.
2
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).
3
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.
4
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).5
Configura el cuerpo
Selecciona la pestaña Body situada debajo.
6
Introduce los detalles del token
Introduce el
blueprint_id, el teléfono y el correo electrónico que deben asociarse al token.7
Selecciona el archivo del token
Para el archivo, selecciona la x junto a los archivos actuales y luego selecciona el botón Select Files.
8
Elige el archivo P7M
Elige el archivo .p7m que corresponde a este token de ADE.
9
Guarda los cambios
Guarda los cambios.
Modificar el elemento Update
1
Selecciona el elemento Update
Selecciona el elemento Update ADE Integration de la carpeta de tu token.
2
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).
3
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.
4
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).5
Configura el cuerpo
Selecciona la pestaña Body situada debajo.
6
Introduce la información actualizada
Aquí puedes introducir la nueva información de
blueprint_id, teléfono y correo electrónico.7
Guarda los cambios
Guarda los cambios.
Duplicar la carpeta ADE_Token
1
Accede a las opciones de la carpeta
Selecciona los puntos suspensivos junto a la carpeta ADE_Token1.
2
Duplica la carpeta
Elige Duplicate.
3
Actualiza el contenido de la carpeta
Actualiza el contenido de la carpeta siguiendo el proceso anterior.
4
Crea carpetas adicionales
Crea duplicados de la carpeta para cada uno de tus tokens de ADE.
Renovar la integración de ADE
Ahora que todo está configurado, puedes enviar el comando Renew.1
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.
2
Ejecuta el comando
Selecciona el botón Send.
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.1
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.
2
Actualiza los detalles
Actualiza los detalles de la sección Body que necesiten actualizarse.
3
Ejecuta el comando
Selecciona el botón Send.
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.1
Selecciona el comando List
Selecciona Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations en la colección.
2
Ejecuta el comando
Selecciona el botón Send.
3
Verifica la renovación
La variable
days_left debería ser 364 si el comando Renew se ejecutó correctamente.4
Verifica las actualizaciones
Para verificar una actualización, comprueba la información asociada al token de ADE para confirmar que se actualizó.
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.1
Selecciona el comando Delete
Selecciona Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration en la colección.
2
Establece el ID del token
Rellena la variable
ade_token_id con el ID del token de ADE.3
Ejecuta el comando
Selecciona el botón Send.
Consideraciones
Seguridad de la API, Postman y configuración del entorno
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
Tokens, archivos y acceso al portal de Apple
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
Operaciones masivas y control de acceso
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
Pruebas, supervisión y continuidad
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