> ## 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 を構成する

> Iru Endpoint で Custom Declarations Library Item を構成します。組み込みの Library Item がない Apple の宣言型デバイス管理の構成を展開します。

この Library Item は Mac コンピュータ、iPhone、iPad、Apple TV、Apple Vision Pro で利用できます

Apple が新しい宣言型デバイス管理（DDM）の構成をリリースした場合、専用の Library Item の代わりに **Custom Declarations** Library Item を使用して展開できます。宣言の JSON を追加し、インストール先を選択して、Blueprint で Library Item を割り当てます。Iru は JSON を Apple のスキーマと照合して確認し、デバイスに配信して、各宣言のステータスを表示します。後で Iru が同じ構成用の専用 Library Item を追加した場合は、検証パネルの **推奨** の検出結果にそのリンクが表示されます。

Iru は宣言の構造を検証します。デバイスが宣言を適用したときに Apple のソフトウェアがどのように動作するかはテストしません。広く割り当てる前に、すべての宣言をパイロットデバイスでテストしてください。

> [!NOTE]
>
> 宣言の背景情報については、Apple の[宣言型デバイス管理のドキュメント](https://developer.apple.com/documentation/devicemanagement/declarative-management)を参照してください。

## Custom Declarations Library Item を作成する

開始する前に、宣言の JSON を用意してください。代わりに `.mobileconfig` プロファイルを展開する場合は、[Custom Profile](https://docs.iru.com/ja/endpoint/library/library-items-profiles/custom-profiles-overview.md) を使用します。

**ファイルをアップロード** と **手動入力** は、どちらか一方を選択するオプションです。宣言の JSON を追加するには、いずれか 1 つのオプションを使用し、両方は使用しないでください。

**1. Library を開く**

**Library** に移動します。

**2. Library Item を追加する**

**Library Item を追加** を選択し、**Custom Declarations** を選択します。

**3. Library Item のタイトルを設定する**

Library Item のタイトルを入力します。

**4. インストール先を選択する**

**インストール先** で、この Library Item を適用するプラットフォームを選択します。Iru は、選択したプラットフォームのうち、各宣言のタイプをサポートするプラットフォームにのみその宣言を送信します。

**5. Assignment Maps を割り当てる**

この Library Item を受け取る Assignment Maps を割り当てます。[Blueprints を設定する](https://docs.iru.com/ja/endpoint/getting-started/blueprints-and-library/configuring-blueprints.md)を参照してください。

**6. オプション 1：ファイルをアップロード**

宣言が `.json` ファイルとして保存されている場合は、このオプションを使用します。**設定** で **ファイルをアップロード** を選択します。ファイルをページにドラッグするか、**ファイルを選択** を選択します。Iru はファイルをエディタに読み込み、同じ方法で確認します。ファイル自体は保存されません。[宣言の JSON](#declaration-json) を参照してください。

![ファイルをアップロードが選択された Custom Declarations の設定。宣言の JSON をページにドラッグするか、ファイルを選択します。](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. オプション 2：手動入力**

JSON を自分で貼り付ける場合は、このオプションを使用します。**設定** で **手動入力** を選択し、**JSON を入力** に JSON を貼り付けます。入力に合わせて **検証** が更新されます。[宣言の JSON](#declaration-json) を参照してください。

![手動入力が選択された Custom Declarations の設定。左側で JSON を入力し、右側で検証を確認します。](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. 検証を確認する**

**検証** の検出結果を確認し、**エラー** とマークされた項目を修正します。[検証の検出結果](#validation-findings)を参照してください。

**9. 保存する**

**保存** を選択します。

## 設定

### 宣言の JSON

1 つ以上の Apple 構成宣言を貼り付けるかアップロードします。各宣言には `Type` と `Payload` が必要です。単一の宣言またはリストを追加できます。次の例は、Safari のブックマーク宣言を 1 つ含むリストです。

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

* 1 つの Library Item には 1～100 個の宣言を、合計 128 KB まで含めることができます。
* 各宣言には個別のアクティベーションが割り当てられるため、1 つが失敗しても他の宣言はブロックされません。
* Iru は構成宣言（`com.apple.configuration.*`）を受け付けます。アクティベーションや管理宣言は受け付けません。
* `Identifier` は省略可能です。省略した場合は Iru が割り当てます。各 `Identifier` は Library Item 内で一意である必要があります。
* `ServerToken` を含めた場合、Iru は保存時にそれを削除し、独自の値を計算します。
* `$EMAIL` や `$ASSET_TAG` などの[グローバル変数](https://docs.iru.com/ja/endpoint/library/library-items-profiles/global-variables.md)を使用できます。Iru はデバイスごとに変数を解決します。値のない変数は空のテキストになります。

### チャネル

Iru は、Apple のスキーマに基づいて各宣言のデバイスチャネルまたはユーザチャネルを選択します。ユーザチャネルがあるのは Mac コンピュータと Shared iPad のみです。

### 検証の検出結果

Iru は、編集中、入力を止めた直後、および保存時に宣言を確認します。検出結果は **検証** に、影響する行と関連付けて表示されます。Apple のベータサイクル中は、パネルにベータタブも表示されます。

各検出結果には重大度があります。

* **エラー**：Apple が宣言を拒否します。たとえば、値の型が間違っている、必須キーがないなどです。
* **警告**：宣言は機能する可能性がありますが、Iru では確認できません。たとえば、キーやタイプが不明である、選択したすべてのプラットフォームでサポートされていないなどです。
* **情報**：Iru が何かを変更または保留します。たとえば、Iru が `ServerToken` を削除する、アセットを配信しないなどです。
* **推奨**：Iru にこの宣言タイプ用の組み込み Library Item があります。検出結果にはそのリンクが表示されます。

Iru が保持する Apple のスキーマは新しいリリースに追いついていない場合があるため、検出結果によって保存がブロックされることはありません。次の問題がある場合は保存がブロックされます。

* 無効な JSON
* `Type` または `Payload` がない宣言
* Iru がサポートしていない種類の宣言
* 重複する `Identifier`
* **インストール先** でプラットフォームが選択されていない
* 宣言が 100 個を超える、または 128 KB を超える

## 考慮事項

> [accordion] アセットは配信されない
>
> アセット宣言（`com.apple.asset.*`）は保存できますが、Iru はそれらを配信しません。これらのアセットのいずれかを参照する構成も配信されません。どちらもデバイス上では **互換性なし** と表示されます。DDM アセットのサポートは今後のリリースで追加される予定です。

> [accordion] プロファイルは受け付けられない
>
> Custom Declarations は宣言のみを展開します。`.mobileconfig` ファイルを展開するには、[Custom Profile](https://docs.iru.com/ja/endpoint/library/library-items-profiles/custom-profiles-overview.md) を使用します。

> [accordion] 一部の宣言が互換性なしと表示される
>
> デバイスが宣言を受け取れない場合、Iru はその宣言を送信せず、理由とともに **互換性なし** とマークします。理由には、サポートされていない OS やプラットフォーム、アセット、Apple が Shared iPad で許可していないタイプなどがあります。デバイスが宣言を受け取れるようになると、Iru はその宣言を配信します。

> [accordion] ステータスは宣言ごとに表示される
>
> デバイスのステータスを開くと、各宣言が `Identifier` ごとに一覧表示されます。Library Item の全体的なステータスは次のルールに従います。いずれかの宣言が **エラー** の場合、項目は **エラー** と表示されます。それ以外で、いずれかが **保留中** の場合、項目は **保留中** と表示されます。それ以外の場合は **パス** と表示されます。宣言が失敗した場合、Iru は Apple のエラーテキストを表示します。

> [accordion] 有効な宣言が保留中のままになる場合がある
>
> Apple が受け付けたものの非アクティブとマークした宣言は、Apple の理由とともに **保留中** と表示されます。理由が `Error.*` コードの場合、その宣言は **エラー** と表示されます。

> [accordion] 編集時は変更された部分のみ再送信される
>
> 1 つの宣言を編集すると、Iru はその宣言のみを再送信します。他のエントリの並べ替えや編集によって、残りの宣言が変更されることはありません。

> [accordion] Setup Assistant
>
> Automated Device Enrollment 中、Setup Assistant はすべての宣言がアクティブになるか、いずれか 1 つが失敗するまで待機します。**互換性なし** の宣言は待機しません。OS が宣言型デバイス管理を実行できないデバイスは、代わりに MDM 経由で Library Item を受け取ります。

> [accordion] 宣言を削除するとデバイスからも削除される
>
> 宣言を削除するか、Library Item の割り当てを解除すると、デバイスからも削除されます。Iru は確認を求めます。非常に大規模なテナントでは削除がバッチで実行されるため、デバイスから削除されるまで数分かかる場合があります。

> [accordion] Library Item 間での Identifier の競合
>
> Iru は、各 `Identifier` が Library Item 内で一意であることを確認します。別の Library Item にある同じ `Identifier` は検出しません。Library Item 間で Identifier が重複しないようにしてください。

## ベストプラクティス

**1. パイロットデバイスでテストする**

Iru が確認するのは構造であり、Apple のソフトウェアの動作ではありません。広く割り当てる前に、すべての宣言をパイロットデバイスでテストしてください。

**2. 組み込みの Library Item を使用する**

**推奨** の検出結果に同じ構成用の組み込み Library Item へのリンクが表示された場合は、その Library Item を使用してください。

**3. わかりやすい Identifier を使用する**

Iru はステータスを `Identifier` でラベル付けします。わかりやすい名前にすると、トラブルシューティングが速くなります。

**4. 関連する宣言をグループ化する**

まとめて使用する宣言は、100 個まで 1 つの Library Item にまとめてください。

**5. 割り当てる前にエラーの検出結果を修正する**

検出結果によって保存はブロックされませんが、**エラー** は通常、デバイスが宣言を拒否することを意味します。

**6. 割り当て後にステータスを確認する**

デバイスのステータスを開き、各宣言が **パス** と表示されていることを確認します。

## トラブルシューティング

> [accordion] 宣言が互換性なしと表示される
>
> Iru はその宣言を送信しませんでした。デバイスのステータスを開いて理由を確認してください。
>
> **考えられる原因:**
>
> * デバイスの OS またはプラットフォームが宣言のタイプをサポートしていない。
> * 宣言がアセットである、または構成がアセットを参照している。
> * そのタイプが Shared iPad で許可されていない。
>
> **解決策:**
>
> * デバイスをサポートされている OS にアップデートするか、Library Item から宣言を削除します。
> * アセットへの参照を削除します。

> [accordion] Library Item が保留中のままになる
>
> **考えられる原因:**
>
> * デバイスがまだチェックインしていない、またはステータスを報告していない。
> * Apple が宣言を受け付けたが、非アクティブとマークした。
>
> **解決策:**
>
> * デバイスがオンラインでチェックイン済みであることを確認します。
> * デバイスのステータスを開き、その宣言に対する Apple の理由を確認します。

> [accordion] Library Item がエラーと表示される
>
> **考えられる原因:**
>
> * 宣言に誤った値、欠落したキー、または Apple の許容範囲外の値がある。
> * Apple が `Error.*` の理由を報告した。
>
> **解決策:**
>
> * デバイスのステータスを開き、`Identifier` で宣言を見つけて、Apple のエラーテキストを確認します。
> * 宣言を修正して保存します。Iru は変更された部分のみを再送信します。

> [accordion] Library Item を保存できない
>
> **考えられる原因:**
>
> * JSON が無効である。
> * 宣言に `Type` または `Payload` がない。
> * 2 つの宣言が同じ `Identifier` を共有している。
> * **インストール先** でプラットフォームが選択されていない。
> * Library Item に 100 個を超える宣言がある、または 128 KB を超えている。
> * テキストが 2 MB を超えている。
>
> **解決策:**
>
> * **検証** のメッセージを読み、示されている行を修正します。
> * テキストが 2 MB を超えている場合は、上限未満に減らします。Iru はすぐに拒否し、そのサイズを表示します。

> [accordion] 検証で宣言を確認できなかった
>
> **考えられる原因:**
>
> * 検証チェックが完了しなかった。
>
> **解決策:**
>
> * しばらく待ってから JSON を再度編集し、チェックを実行します。
> * 宣言が有効であれば、そのまま保存できます。

> [accordion] .mobileconfig ファイルが受け付けられない
>
> **考えられる原因:**
>
> * ファイルが宣言の JSON ではなく、`.mobileconfig` プロファイルである。
>
> **解決策:**
>
> * [Custom Profile](https://docs.iru.com/ja/endpoint/library/library-items-profiles/custom-profiles-overview.md) を使用してプロファイルを展開します。

## 関連記事

> [card] [Library の概要](https://docs.iru.com/ja/endpoint/library/library-items-profiles/library-overview.md)
>
> Library Items をキュレーション、作成、管理し、Blueprints に追加します

> [card] [Custom Profiles の概要](https://docs.iru.com/ja/endpoint/library/library-items-profiles/custom-profiles-overview.md)
>
> 宣言が適切なペイロードでない場合に .mobileconfig プロファイルを展開します

> [card] [Blueprints を設定する](https://docs.iru.com/ja/endpoint/getting-started/blueprints-and-library/configuring-blueprints.md)
>
> Blueprint を使用して Library Items をデバイスに割り当てます

> [card] [グローバル変数](https://docs.iru.com/ja/endpoint/library/library-items-profiles/global-variables.md)
>
> デバイスと割り当てられたユーザの値を宣言に挿入します


## Related topics

- [Custom Profiles の概要](https://docs.iru.com/ja/endpoint/library/library-items-profiles/custom-profiles-overview.md)
- [Mac Custom App Library Item を構成する](https://docs.iru.com/ja/endpoint/library/library-items-profiles/configure-the-custom-apps-library-item.md)
- [AirPrint Library Item を構成する](https://docs.iru.com/ja/endpoint/library/library-items-profiles/configure-an-airprint-library-item.md)
