Skip to main content
Este Library Item está disponible para computadoras Mac, iPhone, iPad, dispositivos Apple TV y Apple Vision Pro
Cuando Apple publica una nueva configuración de gestión declarativa de dispositivos (DDM), puedes implementarla con el Library Item Custom Declarations en lugar de un Library Item específico. Añade el JSON de la declaración, elige dónde se instala y asigna el Library Item con un Blueprint. Iru comprueba el JSON con los esquemas de Apple, lo entrega a los dispositivos y muestra el estado de cada declaración. Si Iru añade más adelante un Library Item específico para la misma configuración, un hallazgo de Recomendación en el panel de validación enlaza a él. Iru valida la estructura de tus declaraciones. No prueba cómo se comporta el software de Apple cuando un dispositivo las aplica. Prueba cada declaración en un dispositivo piloto antes de asignarla de forma amplia.
Para obtener información general sobre las declaraciones, consulta la documentación de gestión declarativa de dispositivos de Apple.

Crear un Library Item Custom Declarations

Ten listo el JSON de la declaración antes de empezar. Para implementar un perfil .mobileconfig, usa un Custom Profile. Subir archivo y Entrada manual son alternativas. Usa una sola opción para añadir el JSON de la declaración, no ambas.
1

Abrir la Library

Ve a Library.
2

Añadir el Library Item

Selecciona Añadir Library Item y, a continuación, selecciona Custom Declarations.
3

Establecer el título del Library Item

Introduce un título para el Library Item.
4

Seleccionar Instalar en

En Instalar en, selecciona las plataformas a las que se aplica este Library Item. Iru envía cada declaración solo a las plataformas seleccionadas que admiten su tipo.
5

Asignar Assignment Maps

Asigna los Assignment Maps que deben recibir este Library Item. Consulta Configurar Blueprints.
6

Opción 1: Subir archivo

Usa esta opción si tu declaración está guardada como archivo .json. En Ajustes, selecciona Subir archivo. Arrastra el archivo a la página o selecciona elegir archivo. Iru carga el archivo en el editor y lo comprueba de la misma manera. El archivo en sí no se almacena. Consulta JSON de la declaración.
Ajustes de Custom Declarations con Subir archivo seleccionado. Arrastra un JSON de declaración a la página o elige un archivo.
7

Opción 2: Entrada manual

Usa esta opción para pegar el JSON tú mismo. En Ajustes, selecciona Entrada manual y, a continuación, pega el JSON en Introducir JSON. Validación se actualiza mientras escribes. Consulta JSON de la declaración.
Ajustes de Custom Declarations con Entrada manual seleccionada. Introduce el JSON a la izquierda y revisa Validación a la derecha.
8

Revisar la validación

Revisa los hallazgos en Validación y corrige todo lo marcado como Error. Consulta Hallazgos de validación.
9

Guardar

Selecciona Guardar.

Ajustes

JSON de la declaración

Pega o sube una o más declaraciones de configuración de Apple. Cada declaración necesita un Type y un Payload. Puedes añadir una sola declaración o una lista. Este ejemplo es una lista con una declaración de marcadores de Safari:
  • Un Library Item contiene de 1 a 100 declaraciones, hasta 128 KB en total.
  • Cada declaración recibe su propia activación, por lo que un fallo no bloquea las demás.
  • Iru acepta declaraciones de configuración (com.apple.configuration.*). No acepta activaciones ni declaraciones de administración.
  • Identifier es opcional. Si lo omites, Iru asigna uno. Cada Identifier debe ser único dentro del Library Item.
  • Si incluyes un ServerToken, Iru lo elimina al guardar y calcula el suyo propio.
  • Puedes usar variables globales, como $EMAIL o $ASSET_TAG. Iru las resuelve para cada dispositivo. Una variable sin valor se convierte en texto vacío.

Canal

Iru elige el canal de dispositivo o de usuario para cada declaración a partir del esquema de Apple. Solo las computadoras Mac y Shared iPad tienen un canal de usuario.

Hallazgos de validación

Iru comprueba tus declaraciones mientras editas, poco después de que dejes de escribir, y de nuevo al guardar. Los hallazgos aparecen en Validación, vinculados a la línea a la que afectan. Durante un ciclo beta de Apple, el panel también muestra una pestaña beta. Cada hallazgo tiene una gravedad:
  • Error: Apple rechazaría la declaración. Por ejemplo, un valor tiene un tipo incorrecto o falta una clave obligatoria.
  • Advertencia: es posible que la declaración siga funcionando, pero Iru no puede confirmarlo. Por ejemplo, una clave o un tipo es desconocido, o no es compatible con todas las plataformas seleccionadas.
  • Información: Iru cambia o retiene algo. Por ejemplo, Iru elimina un ServerToken o no entrega un recurso.
  • Recomendación: Iru tiene un Library Item integrado para este tipo de declaración. El hallazgo enlaza a él.
Los hallazgos no impiden guardar, porque la copia de Iru de los esquemas de Apple puede ir por detrás de las nuevas versiones. Estos problemas sí impiden guardar:
  • JSON no válido
  • Una declaración sin Type o Payload
  • Un tipo de declaración que Iru no admite
  • Un Identifier duplicado
  • Ninguna plataforma seleccionada en Instalar en
  • Más de 100 declaraciones o más de 128 KB

Consideraciones

Puedes guardar declaraciones de recursos (com.apple.asset.*), pero Iru no las entrega. Tampoco se entrega una configuración que haga referencia a uno de esos recursos. Ambas aparecen como Incompatible en el dispositivo. La compatibilidad con los recursos de DDM se añadirá en una versión futura.
Custom Declarations solo implementa declaraciones. Para implementar un archivo .mobileconfig, usa un Custom Profile.
Si un dispositivo no puede recibir una declaración, Iru no la envía y la marca como Incompatible con un motivo. Los motivos incluyen un sistema operativo o una plataforma no compatibles, un recurso y un tipo que Apple no permite en Shared iPad. Iru entrega la declaración en cuanto el dispositivo puede recibirla.
Abre el estado de un dispositivo para ver cada declaración indicada por su Identifier. El estado general del Library Item sigue una regla: si alguna declaración tiene un Error, el elemento muestra Error. De lo contrario, si alguna está Pendiente, el elemento muestra Pendiente. En caso contrario, muestra Correcto. Cuando una declaración falla, Iru muestra el texto de error de Apple.
Una declaración que Apple acepta pero marca como inactiva muestra Pendiente, con los motivos de Apple. Si el motivo es un código Error.*, la declaración muestra Error.
Cuando editas una declaración, Iru reenvía solo esa declaración. Reordenar o editar otras entradas no cambia el resto.
Durante Automated Device Enrollment, el Asistente de configuración espera hasta que todas las declaraciones estén activas o hasta que alguna falle. No espera a las declaraciones Incompatible. Los dispositivos cuyo sistema operativo no puede ejecutar la gestión declarativa de dispositivos reciben el Library Item mediante MDM.
Eliminar una declaración, o anular la asignación del Library Item, la elimina de los dispositivos. Iru te pide que lo confirmes. En tenants muy grandes, la eliminación se ejecuta por lotes, por lo que los dispositivos pueden tardar varios minutos en quedar limpios.
Iru comprueba que cada Identifier sea único dentro de un Library Item. No detecta el mismo Identifier en otro Library Item. Mantén Identifiers distintos entre Library Items.

Prácticas recomendadas

1

Probar en un dispositivo piloto

Iru comprueba la estructura, no cómo se comporta el software de Apple. Prueba cada declaración en un dispositivo piloto antes de asignarla de forma amplia.
2

Usar un Library Item integrado

Cuando un hallazgo de Recomendación enlace a un Library Item integrado para la misma configuración, usa ese Library Item.
3

Usar Identifiers claros

Iru etiqueta el estado por Identifier. Los nombres descriptivos agilizan la solución de problemas.
4

Agrupar declaraciones relacionadas

Coloca las declaraciones que van juntas en un mismo Library Item, hasta 100.
5

Corregir los hallazgos de Error antes de asignar

Los hallazgos no impiden guardar, pero un Error suele significar que un dispositivo rechazará la declaración.
6

Comprobar el estado después de asignar

Abre el estado del dispositivo y confirma que cada declaración muestra Correcto.

Solución de problemas

Iru no envió la declaración. Abre el estado del dispositivo y lee el motivo.Posibles causas:
  • El sistema operativo o la plataforma del dispositivo no admite el tipo de declaración.
  • La declaración es un recurso, o una configuración hace referencia a un recurso.
  • El tipo no está permitido en Shared iPad.
Soluciones:
  • Actualiza el dispositivo a un sistema operativo compatible o elimina la declaración del Library Item.
  • Elimina las referencias a recursos.
Posibles causas:
  • El dispositivo aún no ha hecho check-in ni ha informado de su estado.
  • Apple aceptó la declaración y la marcó como inactiva.
Soluciones:
  • Confirma que el dispositivo está en línea y ha hecho check-in.
  • Abre el estado del dispositivo y lee los motivos de Apple para la declaración.
Posibles causas:
  • Una declaración tiene un valor incorrecto, le falta una clave o tiene un valor fuera del rango permitido por Apple.
  • Apple informó de un motivo Error.*.
Soluciones:
  • Abre el estado del dispositivo, busca la declaración por su Identifier y lee el texto de error de Apple.
  • Corrige la declaración y guarda. Iru reenvía solo lo que cambió.
Posibles causas:
  • El JSON no es válido.
  • Una declaración no tiene Type o Payload.
  • Dos declaraciones comparten un Identifier.
  • No hay ninguna plataforma seleccionada en Instalar en.
  • El Library Item tiene más de 100 declaraciones o supera los 128 KB.
  • El texto supera los 2 MB.
Soluciones:
  • Lee el mensaje en Validación y corrige la línea que indica.
  • Si el texto supera los 2 MB, redúcelo por debajo del límite. Iru lo rechaza de inmediato y muestra su tamaño.
Posibles causas:
  • La comprobación de validación no se completó.
Soluciones:
  • Espera un momento y vuelve a editar el JSON para ejecutar la comprobación.
  • Si las declaraciones son válidas, puedes guardar igualmente.
Posibles causas:
  • El archivo es un perfil .mobileconfig, no un JSON de declaración.
Soluciones:

Descripción general de la Library

Selecciona, crea y administra Library Items y añádelos a Blueprints

Descripción general de Custom Profiles

Implementa un perfil .mobileconfig cuando una declaración no sea la carga útil adecuada

Configurar Blueprints

Asigna Library Items a dispositivos con un Blueprint

Variables globales

Inserta valores del dispositivo y del usuario asignado en una declaración