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

# Configurar el Library Item Custom Declarations

> Configura el Library Item Custom Declarations en Iru Endpoint. Implementa configuraciones de gestión declarativa de dispositivos de Apple que no tienen un Library Item integrado.

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.

> [!NOTE]
>
> Para obtener información general sobre las declaraciones, consulta la [documentación de gestión declarativa de dispositivos](https://developer.apple.com/documentation/devicemanagement/declarative-management) 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](https://docs.iru.com/es/endpoint/library/library-items-profiles/custom-profiles-overview.md).

**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](https://docs.iru.com/es/endpoint/getting-started/blueprints-and-library/configuring-blueprints.md).

**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](#declaration-json).

![Ajustes de Custom Declarations con Subir archivo seleccionado. Arrastra un JSON de declaración a la página o elige un archivo.](https://mintcdn.com/iru/EIZIDeW6fQDKik27/assets/media/images/iru-custom-declarations-upload-file.jpg?fit=max\&auto=format\&n=EIZIDeW6fQDKik27\&q=85\&s=98ee1608c139da55421624e8865d62bf)

**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](#declaration-json).

![Ajustes de Custom Declarations con Entrada manual seleccionada. Introduce el JSON a la izquierda y revisa Validación a la derecha.](https://mintcdn.com/iru/EIZIDeW6fQDKik27/assets/media/images/iru-custom-declarations-manual-entry.jpg?fit=max\&auto=format\&n=EIZIDeW6fQDKik27\&q=85\&s=b19cb9b90b5c784f5b92797e14b06fc4)

**8. Revisar la validación**

Revisa los hallazgos en **Validación** y corrige todo lo marcado como **Error**. Consulta [Hallazgos de validación](#validation-findings).

**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:

```json theme={null}
[
  {
    "Type": "com.apple.configuration.safari.bookmarks",
    "Payload": {
      "ManagedBookmarks": [
        {
          "Title": "Iru Resources",
          "Bookmarks": [
            {
              "URL": "https://www.iru.com",
              "Title": "Iru"
            },
            {
              "URL": "https://www.iru.com/updates/all",
              "Title": "Product Updates"
            },
            {
              "URL": "https://www.iru.com/legal",
              "Title": "Legal and Privacy"
            }
          ],
          "GroupIdentifier": "Group1"
        }
      ]
    },
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5019"
  }
]
```

* 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](https://docs.iru.com/es/endpoint/library/library-items-profiles/global-variables.md), 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

> [accordion] Los recursos no se entregan
>
> 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.

> [accordion] No se aceptan perfiles
>
> Custom Declarations solo implementa declaraciones. Para implementar un archivo `.mobileconfig`, usa un [Custom Profile](https://docs.iru.com/es/endpoint/library/library-items-profiles/custom-profiles-overview.md).

> [accordion] Algunas declaraciones aparecen como Incompatible
>
> 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.

> [accordion] El estado aparece para cada declaración
>
> 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.

> [accordion] Una declaración válida puede quedarse en Pendiente
>
> 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**.

> [accordion] Al editar solo se reenvía lo que cambió
>
> Cuando editas una declaración, Iru reenvía solo esa declaración. Reordenar o editar otras entradas no cambia el resto.

> [accordion] Asistente de configuración
>
> 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.

> [accordion] Al eliminar una declaración, se elimina de los dispositivos
>
> 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.

> [accordion] Colisiones de Identifier entre Library Items
>
> 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

> [accordion] Una declaración aparece como Incompatible
>
> 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.

> [accordion] El Library Item sigue en Pendiente
>
> **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.

> [accordion] El Library Item muestra Error
>
> **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ó.

> [accordion] No puedes guardar el Library Item
>
> **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.

> [accordion] La validación no pudo comprobar las declaraciones
>
> **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.

> [accordion] No se acepta un archivo .mobileconfig
>
> **Posibles causas:**
>
> * El archivo es un perfil `.mobileconfig`, no un JSON de declaración.
>
> **Soluciones:**
>
> * Implementa el perfil con un [Custom Profile](https://docs.iru.com/es/endpoint/library/library-items-profiles/custom-profiles-overview.md).

## Artículos relacionados

> [card] [Descripción general de la Library](https://docs.iru.com/es/endpoint/library/library-items-profiles/library-overview.md)
>
> Selecciona, crea y administra Library Items y añádelos a Blueprints

> [card] [Descripción general de Custom Profiles](https://docs.iru.com/es/endpoint/library/library-items-profiles/custom-profiles-overview.md)
>
> Implementa un perfil .mobileconfig cuando una declaración no sea la carga útil adecuada

> [card] [Configurar Blueprints](https://docs.iru.com/es/endpoint/getting-started/blueprints-and-library/configuring-blueprints.md)
>
> Asigna Library Items a dispositivos con un Blueprint

> [card] [Variables globales](https://docs.iru.com/es/endpoint/library/library-items-profiles/global-variables.md)
>
> Inserta valores del dispositivo y del usuario asignado en una declaración


## Related topics

- [Descripción general de Custom Profiles](https://docs.iru.com/es/endpoint/library/library-items-profiles/custom-profiles-overview.md)
- [Gestionar la Library](https://docs.iru.com/es/endpoint/getting-started/blueprints-and-library/managing-library.md)
- [Variables globales](https://docs.iru.com/es/endpoint/library/library-items-profiles/global-variables.md)
