> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows向けブラウザ拡張機能の導入

> Windows 端末に Admina Extension を配布するときに設定する内容と、手動・GPO・Intune のインストール方法の選び方を説明します。

このページでは、Windows 端末の Google Chrome や Microsoft Edge に Admina Extension を配布し、Admina の組織に紐づけて動作させるための全体像を説明します。

インストール方法は、環境に合わせて手動、GPO、Microsoft Intune の3種類から選べます。

> [!WARNING]
>
> 各インストール方式はお客様環境に合わせて調整してください。

## 前提条件

* Windows 10 以降の端末であること
* Google Chrome または Microsoft Edge がインストール済みであること

通信先を制限している環境では、[Admina Extensionとは](https://support.i.moneyforward.com/it-management/admina-extension/what-is-admina-extension.md#network-requirements) の通信要件を確認してください。配布方式ごとの条件（権限や管理ツール）は、各方式のページに記載しています。

## 設定のゴール

Windows 端末への導入では、次の3つを設定します。

1. HKLM にインストール指示を書く → 拡張機能が自動でインストールされる
2. HKCU に組織と利用者のパラメーターを書く → 拡張機能がお客様の組織に紐づいて動作する
3. ログオンスクリプトで利用者のメールアドレスを環境変数 `USEREMAIL` に設定する → 2 の `UserEmail` がログオンしたユーザーごとに自動で埋まる

書き込み方法は配布方式によって異なります。各方式のページで、その方式に合わせた手順を案内しています。

この3つがそろえば、利用者が操作しなくても拡張機能が有効になります。配布の手段（GPO、Intune、スクリプトなど）は問いません。

設定後に期待される状態は次のとおりです。

* ブラウザを起動すると拡張機能が自動でインストールされ、利用者は無効化や削除ができない
* 拡張機能が HKCU のパラメーターを読み取り、組織、利用者、端末に紐づいた状態で動作する

## 設定項目

このセクションでは、配布方法（手動、GPO、Intune など）を問わず、最終的にクライアント端末に設定するレジストリと環境変数をまとめています。配布の手順は、各方式のページを参照してください。

ここに記載した値は、Windows、Google Chrome、Microsoft Edge の一般的な仕様に基づいています。各方式のページで案内している方法に限らず、お客様独自のスクリプトや資産管理ツールで同じ値を設定できれば、問題なく動作します。

### インストール指示（HKLM）

ブラウザに拡張機能を強制インストールする指示を、マシンのレジストリ（HKLM）に設定します。

| ブラウザ | キー | 値の名前 | 種類 | データ |
| - | - | - | - | - |
| Chrome | `HKLM\Software\Policies\Google\Chrome\ExtensionSettings\bdeanmdeckegmfjpbnngomallcedjold` | `installation_mode` | REG\_SZ | `force_installed` |
| Chrome | `HKLM\Software\Policies\Google\Chrome\ExtensionSettings\bdeanmdeckegmfjpbnngomallcedjold` | `update_url` | REG\_SZ | `https://clients2.google.com/service/update2/crx` |
| Edge | `HKLM\Software\Policies\Microsoft\Edge\ExtensionSettings\flggmhlpipcopffjfkpgkoljghfkmfcg` | `installation_mode` | REG\_SZ | `force_installed` |
| Edge | `HKLM\Software\Policies\Microsoft\Edge\ExtensionSettings\flggmhlpipcopffjfkpgkoljghfkmfcg` | `update_url` | REG\_SZ | `https://edge.microsoft.com/extensionwebstorebase/v1/crx` |

> [accordion] ExtensionSettings に書き込めない場合（ExtensionInstallForcelist を使う）
>
> 資産管理ツール（SKYSEA Client View、LANSCOPE など）が `ExtensionSettings` を管理していて書き込めない場合は、代わりに `ExtensionInstallForcelist` を使います。どちらかを使えば十分です。他のソフトウェアがすでに同じ値を使っていて競合する場合に、もう一方を選んでください。
>
> | ブラウザ | キー | 種類 | データ |
> | - | - | - | - |
> | Chrome | `HKLM\Software\Policies\Google\Chrome\ExtensionInstallForcelist` | REG\_SZ | `bdeanmdeckegmfjpbnngomallcedjold;https://clients2.google.com/service/update2/crx` |
> | Edge | `HKLM\Software\Policies\Microsoft\Edge\ExtensionInstallForcelist` | REG\_SZ | `flggmhlpipcopffjfkpgkoljghfkmfcg;https://edge.microsoft.com/extensionwebstorebase/v1/crx` |
>
> 値の名前は連番です。空いている次の番号（すでに使われていなければ `1`）を使ってください。
>
> この方式でも、[拡張機能のパラメーター（HKCU）](#params-hkcu)と[利用者のメールアドレス（ログオンスクリプト）](#useremail)は同じく必要です。資産管理ツールに拡張機能を配布する機能があれば、そこから同じ値を登録してもかまいません。
>
> 競合の仕組みと確かめ方は、[ブラウザ拡張機能のポリシー競合と回避策](https://support.i.moneyforward.com/it-management/admina-extension/policy-conflicts.md#workarounds) を参照してください。

### 拡張機能のパラメーター（HKCU）

拡張機能が Admina の組織と利用者を識別するためのパラメーターを、ユーザーのレジストリ（HKCU）に設定します。

設定先のキーはブラウザごとに異なります。

* Chrome: `HKCU\Software\Policies\Google\Chrome\3rdparty\extensions\bdeanmdeckegmfjpbnngomallcedjold\policy`
* Edge: `HKCU\Software\Policies\Microsoft\Edge\3rdparty\extensions\flggmhlpipcopffjfkpgkoljghfkmfcg\policy`

両ブラウザ共通で、上記キーの配下に次の値を設定します。

| 値の名前 | 種類 | データ |
| - | - | - |
| `ApiKey` | REG\_SZ | Admina の管理画面の「設定 > ブラウザ拡張 > 拡張機能のポリシー」に表示される値 |
| `CreatedDate` | REG\_SZ | Admina の管理画面の「設定 > ブラウザ拡張 > 拡張機能のポリシー」に表示される値 |
| `OrganizationID` | REG\_SZ | Admina の管理画面の「設定 > ブラウザ拡張 > 拡張機能のポリシー」に表示される値 |
| `UserEmail` | REG\_EXPAND\_SZ | `%USEREMAIL%` |
| `UserPC` | REG\_EXPAND\_SZ | `%COMPUTERNAME%` |

`UserEmail`（`%USEREMAIL%`）と `UserPC`（`%COMPUTERNAME%`）は、環境変数を参照する形で設定するのが基本です。管理対象の端末や利用者が決まっている手動の設定などでは、変数の代わりに固定値（絶対値）を設定してもかまいません。一括配布の標準手順では、変数のまま設定してください。

### 利用者のメールアドレス（ログオンスクリプト）

ログオンした利用者のメールアドレスを、ユーザー環境変数 `USEREMAIL` に設定します。

| 変数名 | 種類 | 値 |
| - | - | - |
| `USEREMAIL` | ユーザー環境変数 | ログオンした利用者のメールアドレス |

ログオン時に `USEREMAIL` を設定する方法は、配布方式によって異なります。

スクリプトの配布方法は各方式のページを参照してください。

スクリプトはサンプルです。メールアドレスの取得元（Active Directory の属性、Microsoft Entra ID、固定のリストなど）は、お客様の環境に合わせて書き換えてください。

`UserEmail` に `%USEREMAIL%` を設定したのに `USEREMAIL` が未設定だと、利用者を特定できず、拡張機能が組織に紐づきません。**`%USEREMAIL%` を使う場合は、ログオンスクリプトを必ず併せて配布してください**。

## インストール方法を選ぶ

> [card] [拡張機能導入（Windows/手動）](https://support.i.moneyforward.com/it-management/admina-extension/windows-solo-setup.md)
>
> Active Directory や MDM の管理下にない PC で、管理者権限を持つ利用者自身がスクリプトを実行して設定する手順です。

> [card] [拡張機能導入（Windows/GPO）](https://support.i.moneyforward.com/it-management/admina-extension/qegqblx598-windows-gpo.md)
>
> Active Directory の GPO で管理されたドメイン参加端末に一括配布する手順です。

> [card] [拡張機能導入（Windows/Intune）](https://support.i.moneyforward.com/it-management/admina-extension/windows-intune.md)
>
> Microsoft Intune で管理された端末に一括配布する手順です（オンプレミス Active Directory は不要です）。

配布の設定が届いているのに拡張機能がインストールされない場合は、[ブラウザ拡張機能のポリシー競合と回避策](https://support.i.moneyforward.com/it-management/admina-extension/policy-conflicts.md) を参照してください。

## 技術解説と Q\&A

HKLM と HKCU を使い分ける理由、ポリシーの競合、権限などの技術的な背景と、配布方式によらないよくある質問は、[Windows向けブラウザ拡張機能の技術解説とQ\&A](https://support.i.moneyforward.com/it-management/admina-extension/windows-technical-notes.md) にまとめています。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.