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

# Iru Access の展開

> MDM を通じて Iru Access アプリを展開し、Mac コンピュータ、iPhone デバイス、iPad デバイス、Windows コンピュータが管理対象として認識されるようにします。

**Iru Access** は、各ユーザーのデバイスに紐付けられたサインイン資格情報を保持し、
[デバイスヘルス](/ja/identity/authentication/device-trust)を報告します。*どのように*配信するかによって、
デバイスが**管理対象**として認識されるかどうかが決まります。

* **管理対象の展開：** MDM を通じてインストールおよび設定されます。Iru はデバイスを管理対象として
  認識するため、**managed** 属性を要求する[認証ポリシー](/ja/identity/authentication/authentication-policies)を
  満たします。
* **管理対象外の展開：** ユーザーが自分でセットアップする個人用または BYO デバイス。機能する認証システムを
  登録し、ヘルスシグナルを報告しますが、管理対象としては認識**されない**ため、managed 属性を要求する
  ポリシーには合格しません。

<Note>
  どちらのパスでも、ユーザーは機能する Iru Access 認証システムを取得し、デバイスヘルスが報告されます。
  唯一の違いは、デバイストラストの判定においてデバイスが**管理対象**として扱われるかどうかです。
</Note>

## 管理対象の展開

MDM を通じて Iru Access をインストールおよび設定し、登録済みのデバイスが
[デバイストラスト](/ja/identity/authentication/device-trust)において**管理対象**として扱われるようにします。

### MDM 接続を作成する

[MDM 接続](/ja/identity/authentication/mdm-connections)により、Iru は MDM に登録されたデバイスを
管理対象として認識できます。Iru Identity で使用する MDM インスタンスごとに 1 つ作成します。

1. Iru Identity で **Policies → MDM Connections** に移動し、**+ MDM Connection** を選択します。
2. **Select a connection type** で、次のいずれかを選択します。
   * **Iru Endpoint Instance：** Iru Endpoint インスタンスから接続フィールドを事前入力します。
   * **Custom MDM Connection：** 手動入力でカスタム MDM 接続を作成します。
3. 接続に**表示名**を付けます。MDM サーバーのドメインを推奨します。
4. **プラットフォーム**を選択します：Apple、Windows、またはその両方。
5. プラットフォームの詳細を入力します。
   * **Apple：** MDM サーバーの **APNs topic** と **Check-in URL**。
   * **Windows：** MDM サーバーの **Provider ID** と **Discovery service URL**。

<Tip>
  これらの値がわからない場合は、すでに登録済みのデバイスで実行して値を読み取れるヘルパースクリプトについて
  [リソース](#resources)を参照してください。
</Tip>

接続を作成したら、以下の各プラットフォームに Iru Access を展開します。

### macOS

<Steps>
  <Step title="Iru Access 構成プロファイルを展開する">
    Iru Identity の **Policies → MDM Connections** で、**+ MDM Connection** の左にあるダウンロードボタンを
    選択し、**macOS Profile** を選択します。プロファイルを Mac コンピュータに展開します。プロファイルには
    Associated Domains とシングルサインオン拡張機能の設定（組織のドメインが入力済み）がすでに含まれているため、
    手動で組み立てる必要はありません。

    <Expandable title="プロファイルを手動で作成する">
      MDM でアップロードしたプロファイルではなくネイティブペイロードとしてこれらを設定する場合は、
      以下を再現してください。`<your-iru-domain>` を接続で使用する各ドメインに置き換えます
      （接続には複数のドメインが含まれる場合があります）。

      * **Associated Domains：** アプリケーション識別子 `N5M3B34269.com.iru.Access`、
        各ドメインの関連ドメインは `authsrv:<your-iru-domain>`。
      * **シングルサインオン拡張機能**（Extensible SSO、**Redirect** タイプ）：
        拡張機能識別子 `com.iru.Access.SSOExtension`、チーム識別子 `N5M3B34269`、
        および各ドメインの次のリダイレクト URL の値：

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        https://<your-iru-domain>/api/v1/saml/login
        ```
      * **管理対象ログイン項目：** Iru Access のヘルパー、バックグラウンドサービス、アップデーターが
        実行できるよう、`com.iru.Access`、`com.iru.Access.IruDaemon`、`com.iru.Access.Menu` に対して
        チーム識別子 `N5M3B34269` を許可します。
    </Expandable>
  </Step>

  <Step title="Iru Access アプリを展開する">
    **Iru Endpoint の場合：** Library の **Auto Apps** から Mac 用の **Iru Access** Auto App を追加し、
    Blueprint を通じて割り当て、Mac コンピュータをスコープに設定します。
    [Auto Apps の概要](/ja/endpoint/library/auto-apps/auto-apps-overview)を参照してください。

    **他の MDM の場合：** [Iru Access for macOS](https://updater.iru.com/iru-access-macOS/download) を
    ダウンロードし、パッケージを MDM にアップロードして、Mac コンピュータをスコープに設定します。
  </Step>

  <Step title="登録スクリプトをダウンロードする">
    [Iru Support GitHub リポジトリ](https://github.com/kandji-inc/support/tree/main/Identity)から
    [Iru Access 管理対象登録スクリプト](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_macos.zsh)を
    コピーします。
  </Step>

  <Step title="スクリプトを設定する">
    ファイルの先頭付近にある **USER INPUT** セクションで、`regToken` に MDM 接続の**クライアントシークレット**を、
    `regTokenDomain` に**ベース**テナントドメインを設定します。

    ```zsh theme={null}
    # USER INPUT
    regToken="mdm-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    regTokenDomain="yourcompany.iru.com"
    ```
  </Step>

  <Step title="Iru Endpoint でスクリプトを展開する">
    Library から **Mac Custom Script** Library Item を追加し、変更したスクリプトを **監査スクリプト** に
    貼り付け、Iru Access アプリと同じ Blueprint を通じて割り当てます。Iru Access がインストールされて
    シークレットが保存されるまで各チェックイン時にスクリプトが再試行されるよう、**実行頻度** を
    **Run every 15 minutes** に設定します。スクリプトはべき等であるため、実行頻度を減らしたい場合は
    **Run daily** でも機能します。
    [Custom Scripts の概要](/ja/endpoint/library/library-items-profiles/custom-scripts-overview)
    （Mac タブ）を参照してください。
  </Step>

  <Step title="他の MDM でスクリプトを展開する">
    プラットフォームのカスタムスクリプトまたはポリシーツールを使用して、変更したスクリプトをアップロードします。
    アプリが存在する時点で新しいデバイスがシークレットを取得できるよう、Iru Access のインストール後に
    定期的なスケジュールで実行してください。
  </Step>
</Steps>

### iOS、iPadOS、visionOS

**要件**

* **iOS および iPadOS：** デバイスで **18.4 以降**が実行されている必要があります。
* **Apple Vision Pro：** Iru Access は iPad アプリとしてインストールされます。

<Steps>
  <Step title="Iru Access 構成プロファイルを展開する">
    Iru Identity の **Policies → MDM Connections** で、**+ MDM Connection** の左にあるダウンロードボタンを
    選択し、**iOS Profile** を選択します。プロファイルをデバイスに展開します。

    <Expandable title="プロファイルを手動で作成する">
      * **シングルサインオン拡張機能**（Extensible SSO、**Redirect** タイプ）：
        拡張機能識別子 `com.iru.AccessMobile.SSOExtension`、チーム識別子 `N5M3B34269`、
        および各ドメインの次のリダイレクト URL の値：

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        ```
    </Expandable>
  </Step>

  <Step title="Iru Access アプリを展開する">
    [App Store の Iru Access](https://apps.apple.com/us/app/iru-access/id6752437810) を MDM を通じて
    管理対象アプリとして配布し、デバイスをスコープに設定します。
  </Step>

  <Step title="管理対象登録を設定する">
    MDM で、Iru Access（バンドル ID `com.iru.AccessMobile`）に**管理対象アプリ構成**を設定します。
    2 つのキーを設定します。

    * **`mdmSecret`**（String、必須）：MDM 接続の**クライアントシークレット**。
    * **`mdmSecretDomain`**（String、必須）：**ベース**テナントドメイン（例：`yourcompany.iru.com`）。

    <Warning>
      `mdmSecretDomain` には、招待リンクで使用される `id.` サブドメイン（`yourcompany.id.iru.com`）ではなく、
      **ベース**ドメイン（`yourcompany.iru.com`）を設定してください。`id.` サブドメインが含まれていると、
      シークレットが適用されず、ユーザーは手動で入力することになります。
    </Warning>

    ```xml Managed app configuration (plist) theme={null}
    <dict>
        <key>mdmSecret</key>
        <string>mdm-REPLACE-WITH-MDM-CONNECTION-CLIENT-SECRET</string>
        <key>mdmSecretDomain</key>
        <string>yourcompany.iru.com</string>
    </dict>
    ```

    <Note>
      この構成により、登録は**資格情報不要**になります。ユーザーはシークレットを入力したり、QR コードを
      スキャンしたり、手動承認を待ったりする必要はありません。ただし、**招待**（メールで送信されたもの、
      または管理対象デバイスにプッシュしたリンク）またはアプリ内のオンボーディング画面を開き、**続ける** を
      タップして、Face ID または Touch ID で確認する必要はあります。
    </Note>

    Iru Endpoint の場合は、Iru Access App Store アプリの **Set app configuration** でこのディクショナリを
    適用します。展開手順については [AppConfig の使用](/ja/endpoint/library/library-items-profiles/using-appconfig)を
    参照してください。
  </Step>
</Steps>

### Windows

**要件**

* **Windows 11 24H2、25H2、または 26H2**

Windows の展開は 2 つの部分で構成されます。MDM を通じて **Iru Access** を展開し、次に登録スクリプトで
各 Windows コンピュータに MDM 接続の**クライアントシークレット**を保存します。登録には引き続き、
ユーザーが招待を開いて **Windows Hello** で確認する必要があります。

<Steps>
  <Step title="Iru Access アプリを展開する">
    **Iru Endpoint の場合：** Library の **Auto Apps** から Windows 用の **Iru Access** Auto App を追加し、
    Blueprint を通じて割り当て、Windows コンピュータをスコープに設定します。
    [Auto Apps の概要](/ja/endpoint/library/auto-apps/auto-apps-overview)を参照してください。

    **他の MDM の場合：** [Iru Access for Windows](https://updater.iru.com/iru-access-windows/download) を
    ダウンロードし、パッケージを MDM にアップロードして、Windows コンピュータをスコープに設定します。
  </Step>

  <Step title="登録スクリプトをダウンロードする">
    [Iru Support GitHub リポジトリ](https://github.com/kandji-inc/support/tree/main/Identity)から
    [Iru Access 管理対象登録スクリプト](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_windows.ps1)を
    コピーします。
  </Step>

  <Step title="Iru Endpoint でスクリプトを展開する">
    Library から **Windows Custom Script** Library Item を追加し、スクリプトをアップロードして、
    Iru Access アプリと同じ Blueprint を通じて割り当てます。
    [**Command line parameters**](/ja/endpoint/library/library-items-profiles/custom-scripts-overview#command-line-parameters-optional) で、
    クライアントシークレットとベーステナントドメインを渡します。

    ```
    manage --secret <client-secret> --domain yourcompany.iru.com
    ```

    <Warning>
      macOS や iOS と同じ値である、接続の**クライアントシークレット**と**ベース**テナントドメイン
      （`yourcompany.iru.com`）を使用してください。レジストリに直接書き込むのではなく、このスクリプトで
      クライアントシークレットを保存してください。シークレットはデバイスに対して暗号化されるため、
      生のレジストリや OMA-URI でプッシュした値は使用できません。
    </Warning>

    **Execute in** を **64 bit** に設定します。Windows Custom Scripts は、割り当て時にデバイスごとに
    1 回実行されます。[Custom Scripts の概要](/ja/endpoint/library/library-items-profiles/custom-scripts-overview)
    （Windows タブ）を参照してください。
  </Step>

  <Step title="他の MDM でスクリプトを展開する">
    プラットフォームがサポートするスクリプトまたは PowerShell ポリシーツールを使用してスクリプトを展開します。
    MDM で許可されている `manage --secret` と `--domain` の引数を渡し、スクリプトが `HKLM` に書き込めるよう
    管理者権限で実行します。

    ```powershell theme={null}
    .\iru_access_managed_registration_windows.ps1 manage --secret <client-secret> --domain yourcompany.iru.com
    ```
  </Step>

  <Step title="確認またはローテーション（任意）">
    シークレットが保存されていることを確認する、またはシークレットをクリアするには、管理者権限の
    PowerShell セッションから引数を指定してスクリプトを実行します。管理者として PowerShell を開く方法については、
    Microsoft の [Getting Started with PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/01-getting-started?view=powershell-7.5#starting-powershell-elevated-as-an-administrator) を
    参照してください。

    ```powershell theme={null}
    # Verify: prints "<domain>:<hash>", never the secret itself
    .\iru_access_managed_registration_windows.ps1 manage --list

    # Rotate or remove
    .\iru_access_managed_registration_windows.ps1 manage --clear "yourcompany.iru.com"
    ```
  </Step>

  <Step title="登録を完了する">
    アプリが展開され、クライアントシークレットが保存された状態で、ユーザーは**招待**を開いて Iru Access を
    起動し、**Windows Hello** で確認します。デバイスは MDM に登録されており、保存されたクライアントシークレットを
    保持しているため、Iru はデバイスを**管理対象**として認識します。
  </Step>
</Steps>

<Note>
  Iru Access は初回実行時に Windows に**パスキープラグイン**を自動的に登録し、その後
  **Settings ▸ Accounts ▸ Passkeys ▸ Advanced options** に表示されます。このトグルを**オン**にするのは
  Windows とユーザーであり、現在 MDM を通じて一元的に強制的にオンにすることはできません。
  [エンドユーザーガイド](/ja/identity/end-user/installing-iru-access)でその手順を説明しています。
</Note>

## 管理対象外の展開

個人用または持ち込みデバイスの場合、MDM で設定するものはありません。ユーザーが Iru Access を
インストールし、招待から登録します。

### macOS

[Iru Access for macOS](https://updater.iru.com/iru-access-macOS/download) をユーザーと共有します。
ユーザーはダウンロードしてインストールし、招待から登録します。手順については
[Iru Access のインストール](/ja/identity/end-user/installing-iru-access)を参照してください。

### iOS、iPadOS、visionOS

[App Store の Iru Access](https://apps.apple.com/us/app/iru-access/id6752437810) または招待リンクを
ユーザーと共有します。ユーザーはアプリをインストールし、登録します。

**要件**

* **iOS および iPadOS：** デバイスで **18.4 以降**が実行されている必要があります。
* **Apple Vision Pro：** App Store から iPad アプリとしてインストールします。

手順については [Iru Access のインストール](/ja/identity/end-user/installing-iru-access)を参照してください。

### Windows

[Iru Access for Windows](https://updater.iru.com/iru-access-windows/download) をユーザーと共有します。
ユーザーはダウンロードしてインストールし、招待から登録します。

**要件**

* **Windows 11 24H2、25H2、または 26H2**

手順については [Iru Access のインストール](/ja/identity/end-user/installing-iru-access)を参照してください。

<Note>
  管理対象外のデバイスでも、機能する認証システムを登録し、ヘルスシグナルを報告しますが、管理対象としては
  認識**されません**。managed 属性を要求するポリシーには合格しません。これらのポリシーを満たす必要がある
  デバイスには、**管理対象の展開**を使用してください。
</Note>

## リソース

MDM にすでに登録されているデバイスでこれらのヘルパースクリプトを実行し、接続の作成時に必要な
MDM サーバーの詳細を収集します。どちらも
[Iru Support GitHub リポジトリ](https://github.com/kandji-inc/support/tree/main/Identity)で管理されています。

<AccordionGroup>
  <Accordion title="macOS：APNs topic と Check-in URL を収集する" icon="apple">
    [macOS Collect MDM details スクリプト](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_macos.zsh)は、
    登録済みの Mac から **APNs topic** と **MDM Check-in URL** を読み取ります。
  </Accordion>

  <Accordion title="Windows：Provider ID と Discovery service URL を収集する" icon="windows">
    [Windows Collect MDM details スクリプト](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_windows.ps1)は、
    登録済みの Windows コンピュータから MDM サーバーの **Provider ID** と **Discovery service URL** を
    読み取ります。PowerShell で実行してください。
  </Accordion>
</AccordionGroup>

## 次のステップ

<CardGroup cols={2}>
  <Card title="macOS SSO 拡張機能のトラブルシューティング" icon="bug" href="/ja/identity/authentication/troubleshoot-macos-sso">
    Mac での関連ドメインの承認と拡張機能の読み込みを診断します。
  </Card>

  <Card title="MDM 接続" icon="tower-broadcast" href="/ja/identity/authentication/mdm-connections">
    デバイスを管理対象として扱うための接続をセットアップして管理します。
  </Card>

  <Card title="デバイストラスト" icon="laptop" href="/ja/identity/authentication/device-trust">
    アクセスの条件として、管理対象の正常なデバイスを要求します。
  </Card>

  <Card title="Iru Access のインストール" icon="download" href="/ja/identity/end-user/installing-iru-access">
    個人用デバイスで Iru Access をセットアップするためのエンドユーザー向けの手順。
  </Card>

  <Card title="認証システム" icon="key" href="/ja/identity/authentication/authenticators">
    認証システムとしてパスキーと並ぶ Iru Access の位置付け。
  </Card>
</CardGroup>