アドオン
AutoConfiguration Hook 3.5 要再起動
作者: ClearCode Inc.
メールアカウント作成ウィザードから任意のISP向けのメールアカウントを簡単に作成できるようにします。
![[警告]](https://addons.thunderbird.net/static/img/developers/test-warning.png?b=58a99cbb-667a0970)
許可設定
このアドオンについて
## 概要
Thunderbird 3.1 より導入されたアカウント情報の自動設定システムを使うと、あらかじめメールサーバなどの情報をプリセットしておき、ユーザ名などの限られた情報をユーザに入力させるだけでアカウントのセットアップを完了することができます。しかし、このシステムで自動設定できる項目は限られており、ケースによっては要求を達成できないこともありました。この問題に対し、本アドオンはThunderbirdでアカウントに対して設定可能なほぼ全ての項目を自動設定できるようにした独自のウィザードを提供します。
#### 専用アカウントの作成機能
管理者は専用アカウントのプリセット値を設定ファイル (XML 形式) として用意し、社内サーバなど特定の場所に配置します。すると、本アドオンをインストールしたユーザのアカウント作成メニューに、専用アカウントを作成するメニュー項目が出現します。このメニュー項目をクリックすれば、自動設定の済んだ専用アカウントを作成するための、独自ウィザードが開始されます。
以下で、実際の環境で専用アカウントの作成機能を利用するための手順を説明します。
### 設定ファイルの用意
はじめに、自動設定する項目を記述した設定ファイルを用意し、適当な場所へ配置します。ファイルはユーザのマシンから見てリモートにあっても、ローカルにあっても構いません。
設定ファイルのフォーマットがどのようなものになっているかについては、アドオンに同梱されている example.com.xml をご覧ください。Autoconfiguration のドキュメントも参考になることでしょう（下記）。
https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat
設定ファイル内では既定のプレースホルダに加えて、 "%USERNAME%" というプレースホルダを利用できます。
後述する "extensions.achook.staticConfig.separatedUsername" の値が "true" である場合は、 "%USERNAME%" はアカウントID専用の入力欄の値で置き換えられます。
アカウントID専用の入力欄が使われない場合や、入力欄が空の場合は、 "%EMAILLOCALPART%" の値が代わりに使われます。
作成されるアカウントの名前は、設定ファイル内の <achook:prettyNameFormat> でカスタマイズできます。
ここでは以下に示すいくつかの特殊なテンプレート変数を利用できます。
|_. 変数名 |_. 展開後の値 |
| %real_username% | ユーザの入力した名前 |
| %username% | メールアドレスのユーザ名部分 |
| %hostname% | メールアドレスのホスト名部分 |
| %port% | メール受信サーバのポート番号 (例 "12345") |
| %not_default_port_expression% | コロン付きのメール受信サーバのポート番号 (例 ":12345") |
<achook:prettyNameFormat> を省略した場合は、%username%@%hostname%%not_default_port_expression% に相当する内容になります。
### 設定ファイルの場所指定
つぎに、ユーザの Thunderbird へ achook をインストールした上で、Thunderbird の設定値 "extensions.achook.staticConfig.source" に設定ファイルの場所をURI形式（ファイルURLなど）で設定します。
### メールアドレスと異なるアカウントIDを使用するかどうかの設定
通常、メールサーバにログインする際のユーザアカウントIDは、メールアドレスのローカルパートが使われます。メールアドレスのローカルパートとは異なるアカウントIDを使ってログインする必要がある場合は、Thunderbird の設定値 "extensions.achook.staticConfig.separatedUsername" を "true" （真偽値）に設定します。
### ドメインの設定
最後に、ユーザの Thunderbird の設定値 "extensions.achook.staticConfig.domain" へ、専用アカウントで使うドメインを設定して下さい。これは、メニュー項目のラベルとして利用されます。
## 通常アカウント作成機能の無効化
企業内での導入などで社内で利用するメールアカウントを社内のものに統一したい場合、その他のアカウントの作成を禁止する必要があります。本アドオンの設定項目値 "extensions.achook.disableGenericWizard" を true に設定すると、そうしたその他のアカウント作成機能が無効化され、ユーザに社内メールアカウントの利用を強制することができます。
Thunderbird 3.1 より導入されたアカウント情報の自動設定システムを使うと、あらかじめメールサーバなどの情報をプリセットしておき、ユーザ名などの限られた情報をユーザに入力させるだけでアカウントのセットアップを完了することができます。しかし、このシステムで自動設定できる項目は限られており、ケースによっては要求を達成できないこともありました。この問題に対し、本アドオンはThunderbirdでアカウントに対して設定可能なほぼ全ての項目を自動設定できるようにした独自のウィザードを提供します。
#### 専用アカウントの作成機能
管理者は専用アカウントのプリセット値を設定ファイル (XML 形式) として用意し、社内サーバなど特定の場所に配置します。すると、本アドオンをインストールしたユーザのアカウント作成メニューに、専用アカウントを作成するメニュー項目が出現します。このメニュー項目をクリックすれば、自動設定の済んだ専用アカウントを作成するための、独自ウィザードが開始されます。
以下で、実際の環境で専用アカウントの作成機能を利用するための手順を説明します。
### 設定ファイルの用意
はじめに、自動設定する項目を記述した設定ファイルを用意し、適当な場所へ配置します。ファイルはユーザのマシンから見てリモートにあっても、ローカルにあっても構いません。
設定ファイルのフォーマットがどのようなものになっているかについては、アドオンに同梱されている example.com.xml をご覧ください。Autoconfiguration のドキュメントも参考になることでしょう（下記）。
https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat
設定ファイル内では既定のプレースホルダに加えて、 "%USERNAME%" というプレースホルダを利用できます。
後述する "extensions.achook.staticConfig.separatedUsername" の値が "true" である場合は、 "%USERNAME%" はアカウントID専用の入力欄の値で置き換えられます。
アカウントID専用の入力欄が使われない場合や、入力欄が空の場合は、 "%EMAILLOCALPART%" の値が代わりに使われます。
作成されるアカウントの名前は、設定ファイル内の <achook:prettyNameFormat> でカスタマイズできます。
ここでは以下に示すいくつかの特殊なテンプレート変数を利用できます。
|_. 変数名 |_. 展開後の値 |
| %real_username% | ユーザの入力した名前 |
| %username% | メールアドレスのユーザ名部分 |
| %hostname% | メールアドレスのホスト名部分 |
| %port% | メール受信サーバのポート番号 (例 "12345") |
| %not_default_port_expression% | コロン付きのメール受信サーバのポート番号 (例 ":12345") |
<achook:prettyNameFormat> を省略した場合は、%username%@%hostname%%not_default_port_expression% に相当する内容になります。
### 設定ファイルの場所指定
つぎに、ユーザの Thunderbird へ achook をインストールした上で、Thunderbird の設定値 "extensions.achook.staticConfig.source" に設定ファイルの場所をURI形式（ファイルURLなど）で設定します。
### メールアドレスと異なるアカウントIDを使用するかどうかの設定
通常、メールサーバにログインする際のユーザアカウントIDは、メールアドレスのローカルパートが使われます。メールアドレスのローカルパートとは異なるアカウントIDを使ってログインする必要がある場合は、Thunderbird の設定値 "extensions.achook.staticConfig.separatedUsername" を "true" （真偽値）に設定します。
### ドメインの設定
最後に、ユーザの Thunderbird の設定値 "extensions.achook.staticConfig.domain" へ、専用アカウントで使うドメインを設定して下さい。これは、メニュー項目のラベルとして利用されます。
## 通常アカウント作成機能の無効化
企業内での導入などで社内で利用するメールアカウントを社内のものに統一したい場合、その他のアカウントの作成を禁止する必要があります。本アドオンの設定項目値 "extensions.achook.disableGenericWizard" を true に設定すると、そうしたその他のアカウント作成機能が無効化され、ユーザに社内メールアカウントの利用を強制することができます。
