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

# Privacy Library Itemの設定

> MacコンピュータでPPPCによるアプリのアクセスを適用し、Macコンピュータ、iPhoneデバイス、iPadデバイスでアプリとSafariのWebサイトの権限を推奨します。

<Callout icon="apple" color="#B84A7A" iconType="regular">このLibrary ItemはMacコンピュータ、iOSデバイス、iPadOSデバイスで利用できます</Callout>

### Privacy Library Itemについて

Privacy Library Itemには2種類のコントロールがあります。それぞれ動作が異なるため、Library Item内でそれぞれ独自のタイルに配置されています。

| コントロール | プラットフォーム | 動作 |
| - | - | - |
| **App access** | Macコンピュータ | デバイス上でプライバシーの決定を設定します。ユーザにはプロンプトが表示されず、変更することもできません。 |
| **Recommended privacy permissions - Apps** | Macコンピュータ、iPhoneデバイス、iPadデバイス | アプリの権限を推奨します。最終的な決定はユーザが行います。Macでは、バンドルIDと指定要件（designated requirement）でアプリを識別します。 |
| **Recommended privacy permissions - Websites** | Macコンピュータ、iPhoneデバイス、iPadデバイス | Safariで開いたWebサイトのカメラとマイクへのアクセスを推奨します。Mac、iPhone、iPadに同じ設定が適用されます。 |

App accessはPrivacy Preferences Policy Control（PPPC）に基づいており、**Mac only settings**タイルに表示されます。

推奨されるアプリの権限は、iPhoneとiPad、およびMacで個別に構成します。推奨されるWebサイトの権限は、Mac、iPhone、iPadで同じ設定を使用します。

推奨されるプライバシー権限には、iOS 27以降、iPadOS 27以降、またはmacOS 27以降を実行している監視対象デバイスが必要です。タイルは、**インストール先**で対応するプラットフォームを追加すると表示されます。

<Note>
  既存のPrivacy Library Itemsの対象範囲は変更されません。iPhoneとiPadのサポートが追加される前にLibrary Itemを作成した場合は、自分でそれらのプラットフォームを**インストール先**に追加する必要があります。
</Note>

### Privacy Library Itemを追加する

<Steps>
  <Step title="Library Itemを作成する">
    [Libraryの管理](/ja/endpoint/getting-started/blueprints-and-library/managing-library)の手順に従って、Privacy Library Itemを作成します。
  </Step>

  <Step title="Library Itemに名前を付ける">
    Library Itemにわかりやすい名前を付けます。
  </Step>

  <Step title="インストール先を設定する">
    **インストール先**で、このLibrary Itemを適用するプラットフォーム（**Mac**、**iPhone**、**iPad**）を選択します。
  </Step>

  <Step title="Blueprintsに割り当てる">
    Library Itemを目的の[Blueprints](/ja/endpoint/blueprints/assignment-maps/creating-a-blueprint)に割り当てます。
  </Step>
</Steps>

デバイスに一度に適用されるPrivacy Library Itemは1つだけです。以下のプラットフォーム設定を構成してから、**保存**を選択します。

### プライバシー設定を構成する

<Tabs>
  <Tab title="Mac" id="mac" icon="apple" iconType="brands">
    App accessは、PPPCを使用してプライバシーの決定をMacに直接書き込みます。決定はシステムによって設定されるため、システム設定には表示されず、ユーザは変更できず、回避する方法もありません。

    PPPCは、Transparency, Consent, and Control（TCC）の設定を構成します。各アプリをバンドルIDまたはパスで識別し、コード要件を指定して、アクセスできるサービスを選択します。詳細については、[AppleのPrivacy Preferences Policy Controlのドキュメント](https://support.apple.com/en-gb/guide/deployment/dep38df53c2a/web)を参照してください。

    #### プライバシープロファイルが必要なアプリを判断する

    アプリに追加のプライバシー権限が必要かどうかを判断するには、次の手順に従います。

    <Steps>
      <Step title="アプリをインストールして起動する">
        テストデバイスまたはmacOS仮想マシンにアプリをインストールします。アプリを起動し、アクセシビリティ機能やダウンロードフォルダへのアクセス要求など、表示されるダイアログを記録します。
      </Step>

      <Step title="システム設定を開く">
        システム設定に移動し、**Privacy & Security**を選択します。
      </Step>

      <Step title="アプリの権限を確認する">
        右側で**Accessibility**などのオプションを選択します。アプリがそこに表示されている場合、そのPPPC権限が必要です。
      </Step>

      <Step title="アプリのパスを取得する">
        アプリをControlキーを押しながらクリックし、**Show in Finder**を選択します。アプリが選択された状態でFinderが開きます。次の手順のために、アプリをターミナルにドラッグして完全なパスを取得します。
      </Step>
    </Steps>

    #### 識別子とコード要件を確認する

    アプリがインストールされているMacでターミナルを使用して、アプリのコード要件と識別子を収集します。

    <Steps>
      <Step title="ターミナルを起動する">
        アプリがインストールされているMacでターミナルを起動します。
      </Step>

      <Step title="codesignコマンドを実行する">
        次のコマンドを実行します。`/Applications/zoom.us.app`は、使用するアプリのパスに置き換えてください。

        ```bash theme={null}
        codesign -dr - "/Applications/zoom.us.app"
        ```
      </Step>

      <Step title="コード要件と識別子をコピーする">
        **=>**の後のすべてのテキストを、先頭と末尾にスペースを含めずにコピーします。これが**Code requirement**です。`us.zoom.xos`のように引用符で囲まれた部分が**Identifier**です。
      </Step>
    </Steps>

    #### アプリのアクセスを構成する

    <Note>
      MDMを通じて配信されたプライバシー設定は、システム設定には表示されません。
    </Note>

    **Mac only settings**タイルに入力します。

    <Steps>
      <Step title="識別子の種類を設定する">
        出力のコード要件の最初の部分に識別子が含まれている場合は、**App Identifier**を**バンドル ID**のままにします。それ以外の場合は、**パス**を選択します。
      </Step>

      <Step title="識別子またはパスを入力する">
        コード要件の最初の部分にある識別子を入力します。**パス**を選択した場合は、代わりにパスを入力します。
      </Step>

      <Step title="コード要件を貼り付ける">
        ターミナルからコピーしたコード要件全体を貼り付けます。先頭または末尾にスペースがあると、プロファイルが配信されない場合があります。
      </Step>

      <Step title="コード要件を検証する（任意）">
        プロセスが動的なコード署名を無効にする場合にのみ、**Statically validate the code requirement**を選択します。ほとんどのアプリでは必要ありません。
      </Step>

      <Step title="アプリまたはサービスを選択する">
        **App or Service**ドロップダウンからオプションを選択します。この選択はアプリケーションの要件によって異なります。詳細については、[プライバシープロファイルが必要なアプリを判断する](#determine-which-apps-need-a-privacy-profile)を参照してください。
      </Step>

      <Step title="アクセスを選択する">
        **Select access**ドロップダウンから、**許可**または**拒否**を選択します。

        <Warning>
          Appleのプライバシー要件により、Camera、Microphone、Screen Recordingでは**拒否**のみ選択できます。これらの設定を未定義のままにすると、ユーザが自分でアクセスを承認できます。
        </Warning>
      </Step>

      <Step title="追加のフィールドを入力する（表示される場合）">
        一部のアプリやサービスでは追加情報が求められます。**AppleEvents**の場合は、**Receiver identifier type**を**バンドル ID**または**パス**に設定してから、**Receiver identifier**と**Receiver code requirement**を入力します。
      </Step>

      <Step title="アクセスを追加する（任意）">
        同じアプリに別のサービスへのアクセスを付与するには**Add more**を選択するか、次の手順に進みます。
      </Step>

      <Step title="追加のアプリを追加する（任意）">
        別のMacアプリを追加する必要がある場合にのみ、**Add app access**を選択します。
      </Step>
    </Steps>

    App accessの設定が完了したら、[Macアプリの権限を推奨する](#recommend-permissions-for-a-mac-app)でMacアプリの推奨されるプライバシー権限を構成します。iPhoneおよびiPadアプリについては、[iPhoneとiPad](#iphone-and-ipad)タブに移動してください。Webサイトについては、[Webサイトの権限を推奨する](#recommend-permissions-for-a-website)を参照してください。**保存**を選択します。Library Itemを保存して配信した後、対象のMacで[プロファイルを確認](#verify-the-profile)します。

    #### プロファイルを確認する

    Library Itemを保存してMacに配信した後、プロファイルを確認します。以下の手順では、そのMacにインストールされたプロファイルを確認します。

    <Steps>
      <Step title="システム情報を開く">
        対象のMacコンピュータで**System Information**を開きます。
      </Step>

      <Step title="プロファイルを選択する">
        左側の列で**Profiles**を選択します。
      </Step>

      <Step title="プロファイルを探す">
        PPPCペイロードを含むプロファイルを探します。
      </Step>

      <Step title="プロファイルの詳細を展開する">
        プロファイル名の横にある開閉用の三角形を選択します。
      </Step>

      <Step title="TCCポリシーを確認する">
        `com.apple.TCC.configuration-profile-policy`の項目を探します。これにより、プロファイルがデバイス上のTCC権限を管理していることを確認できます。
      </Step>
    </Steps>

    #### Macアプリの権限を推奨する

    Macでの推奨されるプライバシー権限は、iPhoneおよびiPadと同じように機能します。決定を推奨し、最終的な選択はユーザが行います。ユーザが初めてアプリを開くと、Macには推奨する権限と正当な理由を一覧表示する同意プロンプトが1つ表示されます。ユーザは**許可**を選択してすべてを適用するか、**Not Now**を選択して標準のプロンプトを維持します。

    これはApp accessとは別のものです。App accessはMacアプリのプライバシーの決定を書き込みます。推奨されるプライバシー権限では、決定はユーザに委ねられます。

    Macアプリは**Recommended privacy permissions - Apps**で構成します。Macは監視対象であり、macOS 27以降を実行している必要があります。

    Macでは、アプリはバンドルIDと指定要件のみで識別します。これはApp accessで収集するのと同じ組み合わせです。指定要件とはコード要件のことです。

    <Steps>
      <Step title="アプリを識別する">
        **App Identifier**に、バンドルIDと指定要件を入力します。このフィールドには**Bundle ID + Designated Requirement**というラベルが付いており、**macOS App Kit apps only**に適用されます。両方の値は[識別子とコード要件を確認する](#determine-the-identifier-and-code-requirement)で収集します。フィールドには、`com.example.app (anchor apple generic)`のような値の形式が表示されます。

        識別子の下にある**Add app**を選択すると、このルールに別のバンドルIDと指定要件を追加できます。
      </Step>

      <Step title="正当な理由のメッセージを入力する">
        **Justification message**を入力します。ユーザはアプリを起動したときに、同意プロンプトでこのテキストを確認します。すべてのアプリに必須であり、これがないルールには**Missing required fields**と表示されます。
      </Step>

      <Step title="推奨する権限を設定する">
        推奨する各権限の値を設定します。**未構成**のままにした権限は送信されず、通常どおりユーザにプロンプトが表示されます。
      </Step>

      <Step title="追加のアプリを追加する（任意）">
        独自の正当な理由と権限を持つ別のMacアプリが必要な場合にのみ、**Add app**を選択します。
      </Step>
    </Steps>

    Macアプリに推奨できる権限は次のとおりです。

    | 権限 | 値 |
    | - | - |
    | Bluetooth | Allow |
    | Camera | Allow |
    | Dictation | Allow |
    | Microphone | Allow |
    | Local Network | Allow |
    | Location | Always |
    | Accessibility | Allow |

    Safariで開いたWebサイトのカメラまたはマイクへのアクセスを推奨するには、[Webサイトの権限を推奨する](#recommend-permissions-for-a-website)を参照してください。
  </Tab>

  <Tab title="iPhoneとiPad" id="iphone-and-ipad" icon="mobile-phone" iconType="solid">
    iPhoneとiPadでは、権限を推奨します。ユーザが初めてアプリを開くと、デバイスには推奨するすべての内容と正当な理由のメッセージを一覧表示する同意プロンプトが1つ表示されます。ユーザは**許可**を選択してすべてを適用するか、**Not Now**を選択して標準のプロンプトを維持します。決定はユーザに委ねられます。Macアプリは[Macアプリの権限を推奨する](#recommend-permissions-for-a-mac-app)で構成します。Mac、iPhone、iPadのWebサイトの設定は[Webサイトの権限を推奨する](#recommend-permissions-for-a-website)にあります。

    <Note>
      iPhoneまたはiPadで、単一のアプリの権限を拒否する方法はありません。アプリごとにプライバシーの決定を適用するのはMacの機能であり、App accessで構成します。[Apple Restrictions Library Item](/ja/endpoint/library/library-items-profiles/configure-the-restrictions-library-item)では、デバイス全体でカメラ、スクリーンショットと画面収録、または音声入力をオフにできますが、個々のアプリのMicrophone、Bluetooth、Local Network、Locationは制御できません。
    </Note>

    iPhoneおよびiPadで推奨されるアプリの権限には、次の要件があります。

    * iOS 27以降、またはiPadOS 27以降
    * 監視対象のデバイス
    * **インストール先**に**iPhone**または**iPad**が追加されていること

    #### アプリの権限を推奨する

    iPhoneおよびiPadアプリは**Recommended privacy permissions - Apps**で構成します。MacアプリはバンドルIDと指定要件を使用します。これらは[Macアプリの権限を推奨する](#recommend-permissions-for-a-mac-app)で構成します。

    <Steps>
      <Step title="アプリを識別する">
        **バンドル ID**に1つ以上のバンドルIDを入力するか、**Pick from Library**を選択して、Libraryにすでにあるアプリを選択します。1つのLibrary Itemに同じアプリを2回追加することはできません。
      </Step>

      <Step title="正当な理由のメッセージを入力する">
        組織がこれらの権限を推奨する理由を説明する**Justification message**を入力します。ユーザは同意プロンプトでこのテキストを確認します。すべてのアプリに必須であり、これがないルールには**Missing required fields**と表示されます。
      </Step>

      <Step title="推奨する権限を設定する">
        推奨する各権限の値を設定します。**未構成**のままにした権限は送信されず、通常どおりユーザにプロンプトが表示されます。
      </Step>

      <Step title="追加のアプリを追加する（任意）">
        別のアプリを追加する必要がある場合にのみ、**Add app**を選択します。
      </Step>
    </Steps>

    iPhoneまたはiPadアプリに推奨できる権限は次のとおりです。

    | 権限 | 値 |
    | - | - |
    | Bluetooth | Allow |
    | Camera | Allow |
    | Dictation | Allow |
    | Microphone | Allow |
    | Local Network | Allow |
    | Location | While Using, Always |
    | Location Accuracy | Approximate, Precise |
  </Tab>
</Tabs>

### Webサイトの権限を推奨する

Webサイトはアプリと同じようにカメラとマイクを要求できるため、組織が利用するサイトに対してこれらの権限を推奨できます。同じWebサイトの設定がMac、iPhone、iPadに適用されます。正当な理由のメッセージと推奨される権限は、追加するすべてのWebサイトに適用されます。Safariで初めてアクセスすると、デバイスには同意プロンプトが1つ表示され、ユーザは**許可**または**Not Now**を選択します。

推奨されるWebサイトの権限には、iOS 27以降、iPadOS 27以降、またはmacOS 27以降を実行している監視対象デバイスが必要です。**インストール先**で**Mac**、**iPhone**、または**iPad**を追加してください。

<Note>
  これらの推奨はSafariにのみ適用されます。ユーザがこれらのWebサイトのいずれかを別のブラウザで開いた場合、そのブラウザがデフォルトのブラウザに設定されていても、通常どおりカメラとマイクへのアクセスを求めるプロンプトが表示されます。
</Note>

<Steps>
  <Step title="Webサイトを追加する">
    **Recommended privacy permissions - Websites**で、**Add website**を選択します。
  </Step>

  <Step title="Webサイトの識別子を入力する">
    `www.iru.com`のような単一のドメインに一致させるには**Domain**を選択します。`*example.com`のようにドメインとそのサブドメインに一致させるには**Wildcard**を選択します。完全なURLではなく、ドメインを入力してください。
  </Step>

  <Step title="Webサイトを追加する（任意）">
    **Add website**を選択して、追加のドメインを含めます。これらは同じ正当な理由のメッセージと推奨される権限を使用します。
  </Step>

  <Step title="正当な理由のメッセージを入力する">
    **Justification message**を入力します。ユーザは追加したいずれかのWebサイトにアクセスしたときに、このテキストを確認します。
  </Step>

  <Step title="推奨する権限を設定する">
    **Camera**、**Microphone**、またはその両方を推奨します。これらの値は、Mac、iPhone、iPadで、リスト内のすべてのWebサイトに適用されます。**未構成**のままにした権限は送信されません。
  </Step>
</Steps>

| 権限 | 値 |
| - | - |
| Camera | Allow |
| Microphone | Allow |

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

<AccordionGroup>
  <Accordion title="Macでアプリケーションが引き続き権限を求める">
    <Steps>
      <Step title="コード要件を確認する">
        コード要件が先頭または末尾のスペースなしで正しくコピーされたことを確認します。`codesign -dr -`コマンドを再実行して、プロファイルの内容と一致することを確認します。
      </Step>

      <Step title="識別子の種類を確認する">
        正しい識別子の種類（Bundle IDまたはPath）を選択したこと、および識別子がcodesignコマンドの結果と一致することを確認します。
      </Step>

      <Step title="アプリが承認されていることを確認する">
        アプリがプロファイルの承認済みアプリケーションのリストに含まれていることを確認します。
      </Step>

      <Step title="サービスの権限を確認する">
        アプリに正しいサービスが構成されていることを確認します。たとえば、アプリに画面収録へのアクセスが必要な場合は、**Screen Recording**が選択されていることを確認します。
      </Step>

      <Step title="TCCのログストリームを使用する">
        アクセスを要求しているアプリまたはバイナリを特定するには、ターミナルで次のコマンドを実行します。

        ```bash theme={null}
        log stream --debug --predicate 'subsystem == "com.apple.TCC" AND eventMessage BEGINSWITH "AttributionChain"'
        ```

        これにより、TCC権限の要求がリアルタイムで表示され、プロファイルに追加する正確なアプリまたはバイナリを特定できます。
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="iPhone、iPad、またはMacで同意プロンプトが表示されない">
    <Steps>
      <Step title="OSのバージョンを確認する">
        推奨されるプライバシー権限には、iOS 27以降、iPadOS 27以降、またはmacOS 27以降が必要です。それより前のバージョンのデバイスでは、設定は無視されます。
      </Step>

      <Step title="デバイスが監視対象であることを確認する">
        推奨されるプライバシー権限には監視対象のデバイスが必要です。[Appleデバイスの監視](/ja/endpoint/enrollment/apple/apple-device-supervision)を参照してください。
      </Step>

      <Step title="プラットフォームが割り当てられていることを確認する">
        プロンプトが表示されないデバイスのプラットフォームが**インストール先**に表示されていることを確認します。そのプラットフォームは**Mac**、**iPhone**、または**iPad**です。
      </Step>

      <Step title="Macアプリの識別子を確認する">
        Macアプリの場合、**App Identifier**にはバンドルIDと指定要件の両方を含める必要があります。[Macアプリの権限を推奨する](#recommend-permissions-for-a-mac-app)を参照してください。
      </Step>

      <Step title="必須フィールドの不足を確認する">
        正当な理由のメッセージがないルールには**Missing required fields**と表示され、配信されません。
      </Step>

      <Step title="アプリがまだ開かれていないことを確認する">
        プロンプトは初回起動時または初回アクセス時に表示されます。ユーザがそのアプリまたはサイトの権限プロンプトにすでに応答している場合、推奨は再度表示されません。
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="システム設定で権限がグレー表示される">
    <Steps>
      <Step title="アプリの機能をテストする">
        システム設定 > Privacy & Securityでは、アプリに必要な権限がある場合でも、特定の権限のスライダーがグレー表示されることがあります。これは表示上の動作であり、問題ではありません。アプリをテストして動作することを確認してください。
      </Step>

      <Step title="プロファイルがアクティブであることを確認する">
        System Information > Profilesを確認して、プロファイルがデバイスにインストールされ、アクティブであることを確認します。
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="コード要件の問題">
    <Steps>
      <Step title="コード要件の形式を確認する">
        コード要件の先頭または末尾にスペースがないことを確認します。スペースが1つあるだけで、プロファイルが機能しなくなる場合があります。
      </Step>

      <Step title="アプリのアップデート後に再確認する">
        アプリがアップデートされた場合、コード要件が変更されている可能性があります。codesignコマンドを再実行して、プロファイルを更新してください。
      </Step>

      <Step title="静的検証を確認する">
        **Statically validate the code requirement**を使用している場合は、プロセスが動的なコード署名を無効にする場合にのみ有効になっていることを確認します。ほとんどのアプリでは必要ありません。
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>