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

# Custom Declarations Library Item konfigurieren

> Konfigurieren Sie das Custom Declarations Library Item in Iru Endpoint. Stellen Sie Konfigurationen für Apple Declarative Device Management bereit, für die es kein integriertes Library Item gibt.

Dieses Library Item ist für Mac-Computer, iPhone, iPad, Apple TV und Apple Vision Pro verfügbar

Wenn Apple eine neue Konfiguration für Declarative Device Management (DDM) veröffentlicht, können Sie sie mit dem **Custom Declarations** Library Item anstelle eines dedizierten Library Items bereitstellen. Fügen Sie das Deklarations-JSON hinzu, wählen Sie aus, wo es installiert wird, und weisen Sie das Library Item mit einem Blueprint zu. Iru prüft das JSON anhand der Schemas von Apple, liefert es an Geräte aus und zeigt den Status jeder Deklaration an. Wenn Iru später ein dediziertes Library Item für dieselbe Konfiguration hinzufügt, verweist ein Befund vom Typ **Empfehlung** im Validierungsbereich darauf.

Iru validiert die Struktur Ihrer Deklarationen. Es testet nicht, wie sich die Software von Apple verhält, wenn ein Gerät sie anwendet. Testen Sie jede Deklaration auf einem Pilotgerät, bevor Sie sie umfassend zuweisen.

> [!NOTE]
>
> Hintergrundinformationen zu Deklarationen finden Sie in der [Dokumentation zu Declarative Device Management](https://developer.apple.com/documentation/devicemanagement/declarative-management) von Apple.

## Custom Declarations Library Item erstellen

Halten Sie das Deklarations-JSON bereit, bevor Sie beginnen. Um stattdessen ein `.mobileconfig`-Profil bereitzustellen, verwenden Sie ein [Custom Profile](https://docs.iru.com/de/endpoint/library/library-items-profiles/custom-profiles-overview.md).

**Datei hochladen** und **Manuelle Eingabe** sind Alternativen. Verwenden Sie eine der beiden Optionen, um das Deklarations-JSON hinzuzufügen, nicht beide.

**1. Library öffnen**

Gehen Sie zu **Library**.

**2. Library Item hinzufügen**

Wählen Sie **Library Item hinzufügen** und dann **Custom Declarations**.

**3. Titel des Library Items festlegen**

Geben Sie einen Titel für das Library Item ein.

**4. Installieren auf auswählen**

Wählen Sie unter **Installieren auf** die Plattformen aus, für die dieses Library Item gilt. Iru sendet jede Deklaration nur an die ausgewählten Plattformen, die ihren Typ unterstützen.

**5. Assignment Maps zuweisen**

Weisen Sie die Assignment Maps zu, die dieses Library Item erhalten sollen. Siehe [Blueprints konfigurieren](https://docs.iru.com/de/endpoint/getting-started/blueprints-and-library/configuring-blueprints.md).

**6. Option 1: Datei hochladen**

Verwenden Sie diese Option, wenn Ihre Deklaration als `.json`-Datei gespeichert ist. Wählen Sie unter **Einstellungen** die Option **Datei hochladen**. Ziehen Sie die Datei auf die Seite oder wählen Sie **Datei auswählen**. Iru lädt die Datei in den Editor und prüft sie auf dieselbe Weise. Die Datei selbst wird nicht gespeichert. Siehe [Deklarations-JSON](#declaration-json).

![Custom Declarations-Einstellungen mit ausgewählter Option Datei hochladen. Ziehen Sie ein Deklarations-JSON auf die Seite oder wählen Sie eine Datei aus.](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. Option 2: Manuelle Eingabe**

Verwenden Sie diese Option, um das JSON selbst einzufügen. Wählen Sie unter **Einstellungen** die Option **Manuelle Eingabe** und fügen Sie das JSON dann in **JSON eingeben** ein. **Validierung** wird während der Eingabe aktualisiert. Siehe [Deklarations-JSON](#declaration-json).

![Custom Declarations-Einstellungen mit ausgewählter Option Manuelle Eingabe. Links JSON eingeben und rechts die Validierung überprüfen.](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. Validierung überprüfen**

Überprüfen Sie die Befunde unter **Validierung** und beheben Sie alles, was als **Fehler** markiert ist. Siehe [Validierungsbefunde](#validation-findings).

**9. Speichern**

Wählen Sie **Speichern**.

## Einstellungen

### Deklarations-JSON

Fügen Sie eine oder mehrere Apple-Konfigurationsdeklarationen ein oder laden Sie sie hoch. Jede Deklaration benötigt einen `Type` und einen `Payload`. Sie können eine einzelne Deklaration oder eine Liste hinzufügen. Dieses Beispiel ist eine Liste mit einer Deklaration für Safari-Lesezeichen:

```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"
  }
]
```

* Ein Library Item enthält 1 bis 100 Deklarationen mit insgesamt bis zu 128 KB.
* Jede Deklaration erhält eine eigene Aktivierung, sodass ein Fehler die anderen nicht blockiert.
* Iru akzeptiert Konfigurationsdeklarationen (`com.apple.configuration.*`). Aktivierungen oder Verwaltungsdeklarationen werden nicht akzeptiert.
* `Identifier` ist optional. Wenn Sie ihn weglassen, weist Iru einen zu. Jeder `Identifier` muss innerhalb des Library Items eindeutig sein.
* Wenn Sie ein `ServerToken` angeben, entfernt Iru es beim Speichern und berechnet ein eigenes.
* Sie können [globale Variablen](https://docs.iru.com/de/endpoint/library/library-items-profiles/global-variables.md) wie `$EMAIL` oder `$ASSET_TAG` verwenden. Iru löst sie für jedes Gerät auf. Eine Variable ohne Wert wird zu leerem Text.

### Kanal

Iru wählt den Geräte- oder Benutzerkanal für jede Deklaration anhand des Schemas von Apple aus. Nur Mac-Computer und Shared iPad verfügen über einen Benutzerkanal.

### Validierungsbefunde

Iru prüft Ihre Deklarationen während der Bearbeitung, kurz nachdem Sie die Eingabe beenden, und erneut beim Speichern. Befunde werden unter **Validierung** angezeigt und sind der Zeile zugeordnet, die sie betreffen. Während eines Apple-Betazyklus zeigt der Bereich außerdem einen Beta-Tab an.

Jeder Befund hat einen Schweregrad:

* **Fehler**: Apple würde die Deklaration ablehnen. Beispielsweise hat ein Wert den falschen Typ oder ein erforderlicher Schlüssel fehlt.
* **Warnung**: Die Deklaration funktioniert möglicherweise trotzdem, aber Iru kann dies nicht bestätigen. Beispielsweise ist ein Schlüssel oder Typ unbekannt oder wird nicht auf allen ausgewählten Plattformen unterstützt.
* **Info**: Iru ändert etwas oder hält etwas zurück. Beispielsweise entfernt Iru ein `ServerToken` oder liefert ein Asset nicht aus.
* **Empfehlung**: Iru verfügt über ein integriertes Library Item für diesen Deklarationstyp. Der Befund verweist darauf.

Befunde blockieren das Speichern nicht, da die Kopie der Apple-Schemas in Iru hinter neuen Versionen zurückliegen kann. Folgende Probleme blockieren das Speichern:

* Ungültiges JSON
* Eine Deklaration ohne `Type` oder `Payload`
* Eine Deklarationsart, die Iru nicht unterstützt
* Ein doppelter `Identifier`
* Keine Plattform unter **Installieren auf** ausgewählt
* Mehr als 100 Deklarationen oder mehr als 128 KB

## Überlegungen

> [accordion] Assets werden nicht ausgeliefert
>
> Sie können Asset-Deklarationen (`com.apple.asset.*`) speichern, aber Iru liefert sie nicht aus. Eine Konfiguration, die auf eines dieser Assets verweist, wird ebenfalls nicht ausgeliefert. Beide werden auf dem Gerät als **Inkompatibel** angezeigt. Unterstützung für DDM-Assets wird in einer zukünftigen Version hinzugefügt.

> [accordion] Profile werden nicht akzeptiert
>
> Custom Declarations stellt nur Deklarationen bereit. Um eine `.mobileconfig`-Datei bereitzustellen, verwenden Sie ein [Custom Profile](https://docs.iru.com/de/endpoint/library/library-items-profiles/custom-profiles-overview.md).

> [accordion] Einige Deklarationen werden als Inkompatibel angezeigt
>
> Wenn ein Gerät eine Deklaration nicht übernehmen kann, sendet Iru sie nicht und markiert sie mit einer Begründung als **Inkompatibel**. Zu den Gründen gehören ein nicht unterstütztes Betriebssystem oder eine nicht unterstützte Plattform, ein Asset sowie ein Typ, den Apple auf Shared iPad nicht zulässt. Iru liefert die Deklaration aus, sobald das Gerät sie übernehmen kann.

> [accordion] Der Status wird für jede Deklaration angezeigt
>
> Öffnen Sie den Status eines Geräts, um jede Deklaration nach ihrem `Identifier` aufgelistet zu sehen. Der Gesamtstatus des Library Items folgt einer Regel: Wenn eine Deklaration einen **Fehler** aufweist, zeigt das Item **Fehler** an. Andernfalls zeigt das Item **Ausstehend** an, wenn eine Deklaration **Ausstehend** ist. Andernfalls zeigt es **Bestanden** an. Wenn eine Deklaration fehlschlägt, zeigt Iru den Fehlertext von Apple an.

> [accordion] Eine gültige Deklaration kann Ausstehend bleiben
>
> Eine Deklaration, die Apple akzeptiert, aber als inaktiv markiert, wird mit den Gründen von Apple als **Ausstehend** angezeigt. Wenn der Grund ein `Error.*`-Code ist, wird die Deklaration als **Fehler** angezeigt.

> [accordion] Beim Bearbeiten wird nur Geändertes erneut gesendet
>
> Wenn Sie eine Deklaration bearbeiten, sendet Iru nur diese Deklaration erneut. Das Neuanordnen oder Bearbeiten anderer Einträge ändert die übrigen nicht.

> [accordion] Setup Assistant
>
> Während der Automated Device Enrollment wartet der Setup Assistant, bis alle Deklarationen aktiv sind oder eine davon fehlschlägt. Auf Deklarationen mit dem Status **Inkompatibel** wartet er nicht. Geräte, deren Betriebssystem Declarative Device Management nicht ausführen kann, erhalten das Library Item stattdessen über MDM.

> [accordion] Das Entfernen einer Deklaration entfernt sie von Geräten
>
> Das Entfernen einer Deklaration oder das Aufheben der Zuweisung des Library Items entfernt sie von den Geräten. Iru fordert Sie zur Bestätigung auf. Bei sehr großen Tenants erfolgt das Entfernen in Batches, sodass es auf den Geräten mehrere Minuten dauern kann.

> [accordion] Identifier-Konflikte zwischen Library Items
>
> Iru prüft, dass jeder `Identifier` innerhalb eines Library Items eindeutig ist. Denselben `Identifier` in einem anderen Library Item erkennt Iru nicht. Verwenden Sie unterschiedliche Identifier in verschiedenen Library Items.

## Best Practices

**1. Auf einem Pilotgerät testen**

Iru prüft die Struktur, nicht das Verhalten der Software von Apple. Testen Sie jede Deklaration auf einem Pilotgerät, bevor Sie sie umfassend zuweisen.

**2. Integriertes Library Item verwenden**

Wenn ein Befund vom Typ **Empfehlung** auf ein integriertes Library Item für dieselbe Konfiguration verweist, verwenden Sie dieses Library Item.

**3. Eindeutige Identifier verwenden**

Iru kennzeichnet den Status nach `Identifier`. Aussagekräftige Namen beschleunigen die Fehlerbehebung.

**4. Zusammengehörige Deklarationen gruppieren**

Fassen Sie zusammengehörige Deklarationen in einem Library Item zusammen, bis zu 100.

**5. Fehler-Befunde vor dem Zuweisen beheben**

Befunde blockieren das Speichern nicht, aber ein **Fehler** bedeutet in der Regel, dass ein Gerät die Deklaration ablehnt.

**6. Status nach dem Zuweisen prüfen**

Öffnen Sie den Gerätestatus und vergewissern Sie sich, dass jede Deklaration **Bestanden** anzeigt.

## Fehlerbehebung

> [accordion] Eine Deklaration wird als Inkompatibel angezeigt
>
> Iru hat die Deklaration nicht gesendet. Öffnen Sie den Gerätestatus und lesen Sie die Begründung.
>
> **Mögliche Ursachen:**
>
> * Das Betriebssystem oder die Plattform des Geräts unterstützt den Deklarationstyp nicht.
> * Die Deklaration ist ein Asset, oder eine Konfiguration verweist auf ein Asset.
> * Der Typ ist auf Shared iPad nicht zulässig.
>
> **Lösungen:**
>
> * Aktualisieren Sie das Gerät auf ein unterstütztes Betriebssystem oder entfernen Sie die Deklaration aus dem Library Item.
> * Entfernen Sie Verweise auf Assets.

> [accordion] Das Library Item bleibt Ausstehend
>
> **Mögliche Ursachen:**
>
> * Das Gerät hat sich noch nicht gemeldet oder noch keinen Status übermittelt.
> * Apple hat die Deklaration akzeptiert und als inaktiv markiert.
>
> **Lösungen:**
>
> * Vergewissern Sie sich, dass das Gerät online ist und sich gemeldet hat.
> * Öffnen Sie den Gerätestatus und lesen Sie die Gründe von Apple für die Deklaration.

> [accordion] Das Library Item zeigt Fehler an
>
> **Mögliche Ursachen:**
>
> * Eine Deklaration enthält einen falschen Wert, einen fehlenden Schlüssel oder einen Wert außerhalb des von Apple zulässigen Bereichs.
> * Apple hat einen `Error.*`-Grund gemeldet.
>
> **Lösungen:**
>
> * Öffnen Sie den Gerätestatus, suchen Sie die Deklaration anhand des `Identifier` und lesen Sie den Fehlertext von Apple.
> * Korrigieren Sie die Deklaration und speichern Sie. Iru sendet nur das Geänderte erneut.

> [accordion] Sie können das Library Item nicht speichern
>
> **Mögliche Ursachen:**
>
> * Das JSON ist ungültig.
> * Eine Deklaration hat keinen `Type` oder `Payload`.
> * Zwei Deklarationen verwenden denselben `Identifier`.
> * Unter **Installieren auf** ist keine Plattform ausgewählt.
> * Das Library Item enthält mehr als 100 Deklarationen oder ist größer als 128 KB.
> * Der Text ist größer als 2 MB.
>
> **Lösungen:**
>
> * Lesen Sie die Meldung unter **Validierung** und korrigieren Sie die Zeile, auf die sie verweist.
> * Wenn der Text größer als 2 MB ist, reduzieren Sie ihn unter das Limit. Iru lehnt ihn sofort ab und zeigt seine Größe an.

> [accordion] Die Validierung konnte die Deklarationen nicht prüfen
>
> **Mögliche Ursachen:**
>
> * Die Validierungsprüfung wurde nicht abgeschlossen.
>
> **Lösungen:**
>
> * Warten Sie einen Moment und bearbeiten Sie das JSON erneut, um die Prüfung auszuführen.
> * Wenn die Deklarationen gültig sind, können Sie trotzdem speichern.

> [accordion] Eine .mobileconfig-Datei wird nicht akzeptiert
>
> **Mögliche Ursachen:**
>
> * Die Datei ist ein `.mobileconfig`-Profil und kein Deklarations-JSON.
>
> **Lösungen:**
>
> * Stellen Sie das Profil mit einem [Custom Profile](https://docs.iru.com/de/endpoint/library/library-items-profiles/custom-profiles-overview.md) bereit.

## Verwandte Artikel

> [card] [Library-Übersicht](https://docs.iru.com/de/endpoint/library/library-items-profiles/library-overview.md)
>
> Library Items kuratieren, erstellen und verwalten und zu Blueprints hinzufügen

> [card] [Übersicht über Custom Profiles](https://docs.iru.com/de/endpoint/library/library-items-profiles/custom-profiles-overview.md)
>
> Ein .mobileconfig-Profil bereitstellen, wenn eine Deklaration nicht der richtige Payload ist

> [card] [Blueprints konfigurieren](https://docs.iru.com/de/endpoint/getting-started/blueprints-and-library/configuring-blueprints.md)
>
> Library Items mit einem Blueprint Geräten zuweisen

> [card] [Globale Variablen](https://docs.iru.com/de/endpoint/library/library-items-profiles/global-variables.md)
>
> Werte des Geräts und des zugewiesenen Benutzers in eine Deklaration einfügen


## Related topics

- [Übersicht über Custom Profiles](https://docs.iru.com/de/endpoint/library/library-items-profiles/custom-profiles-overview.md)
- [Library verwalten](https://docs.iru.com/de/endpoint/getting-started/blueprints-and-library/managing-library.md)
- [Globale Variablen](https://docs.iru.com/de/endpoint/library/library-items-profiles/global-variables.md)
