Iwd

2021-08-09T12:44:08Z

Cocoa maemae: /* 使用方法 */

{{Lowercase title}}
[[Category:無線ネットワーク]]
[[Category:ネットワーク設定]]
[[en:Iwd]]
{{Related articles start}}
{{Related|ネットワーク設定}}
{{Related|ワイヤレス設定}}
{{Related|WPA supplicant}}
{{Related articles end}}
[https://iwd.wiki.kernel.org/ IWD] (iNet wireless daemon) は Intel によって書かれた Linux 用の無線デーモンです。プロジェクトの中心的な目標は、外部ライブラリに依存せず、Linux カーネルが提供する機能を最大限に活用することにより、リソース使用率を最適化することです。

iwd はスタンドアロンでも動作しますが [[ConnMan]]、[[systemd-networkd]] や [[NetworkManager]] のような包括的なネットワークマネージャーとの組み合わせて使うこともできます。

== インストール ==

{{Pkg|iwd}} パッケージを[[インストール]]してください。

== 使用方法 ==

{{Pkg|iwd}} パッケージにはクライアントプログラムの {{ic|iwctl}} とデーモンの {{ic|iwd}}、そして Wi-Fi 監視ツールの {{ic|iwmon}} が含まれています。

{{ic|iwd}} デーモンを実行したら ({{ic|iwd.service}} を[[起動]]・[[有効化]])、{{ic|iwctl}} コマンドを使って制御することができます。
=== iwctl ===

対話型プロンプトを表示するには、次のようにします:

$ iwctl

対話型プロンプトは、プレフィックスが、{{ic|[iwd]#}} と表示されます。

{{Tip|
* {{ic|iwctl}} プロンプトで、{{ic|Tab}} キーを押すとコマンドとデバイス名を補完できます。
* 対話型プロンプトを終了するには、{{ic|Ctrl+d}} を押して、 [[Wikipedia:EOF character|EOF]] を送信します。
* 対話型プロンプトを使用せずに、すべてのコマンドをコマンドライン引数として使用できます。例：{{ic|iwctl device wlan0 show}}}}

使用可能なすべてのコマンドの一覧を表示するには:

[iwd]# help

==== ネットワークに接続する ====

先ず、ワイヤレスデバイス名がわからない場合は、すべての Wi-Fiデバイスを一覧表示します:

[iwd]# device list

次に、ネットワークをスキャンします:

[iwd]# station ''device'' scan

利用可能なすべてのネットワークを一覧表示できます:

[iwd]# station ''device'' get-networks

最後に、ネットワークに接続するには:

[iwd]# station ''device'' connect ''SSID''

{{Tip|ユーザーインターフェイスはオートコンプリートをサポートしています。{{ic|station }} と入力し、{{ic|Tab}} {{ic|Tab}} を押すと、使用可能なデバイスが表示され、デバイスの最初の文字を入力し、{{ic|Tab}} を押して補完します。同じように、{{ic|connect }} を入力し {{ic|Tab}} {{ic|Tab}} と押すと、利用可能なネットワークのリストを表示します。次に、使用するネットワークの最初の文字を入力して、{{ic|Tab}} キーを押して補完を完了します。}}

パスフレーズが必要な場合は、入力を求められます。コマンドライン引数として指定することもできます:

$ iwctl --passphrase ''passphrase'' station ''device'' connect ''SSID''

{{Note|
* {{ic|iwd}} はネットワークパスフレーズを {{ic|/var/lib/iwd}} ディレクトリに自動的に保存し、将来的にそれらを使用して自動接続します。 [[#Network configuration]] を参照してください。
* SSID にスペースが含まれるネットワークに接続するには、接続時にネットワーク名をダブルクオートで囲む必要があります。
* iwd は、8〜63 文字の ASCII エンコード文字の PSK パスフレーズのみをサポートします。要件が満たされていない場合は次のエラーメッセージが表示されます: {{ic|PMK generation failed. Ensure Crypto Engine is properly configured}}
}}

==== WPS/WSC を使用してネットワークに接続する ====

ボタンを押してネットワークに接続できるように設定されている場合 ([[Wikipedia:ja:Wi-Fi Protected Setup]]) は、まず、ネットワークデバイスがこのセットアップ手順を使用できることを確認してください。

[iwd]# wsc list

次に、デバイスが上記のリストに表示されている場合、

[iwd]# wsc ''device'' push-button

それから、ルーターのボタンを押します。この手順は、2分以内にボタンを事前に押した場合にも機能します。

ネットワークがその方法で接続するために、PIN 番号を検証する必要がある場合は、help コマンド出力をチェックして、{{ic|wsc}} コマンドに適切なオプションを提供する方法を確認してください。

==== ネットワークから切断する ====

ネットワークから切断するには:

[iwd]# station ''device'' disconnect

==== デバイスと接続情報を表示する ====

MAC アドレスなどの WiFi デバイスの詳細を表示するには:

[iwd]# device ''device'' show

WiFi デバイスの接続ネットワークを含む接続状態を表示するには:

[iwd]# station ''device'' show

==== 既知のネットワークの管理 ====

以前に接続したネットワークを一覧表示するには:

[iwd]# known-networks list

既知のネットワークを忘れるには:

[iwd]# known-networks ''SSID'' forget

== ネットワーク設定 ==

デフォルトでは、''iwd'' はネットワーク設定を {{ic|/var/lib/iwd}} ディレクトリに保存します。設定ファイルの名前は、{{ic|''network''.''type''}} となります。''network'' はネットワーク SSID で ''.type'' はネットワークタイプ(''.open''、''.wep''、''.psk'' または ''.8021x'')です。このファイルは暗号化された{{ic|事前共有鍵}}と、オプションでクリアテキストの{{ic|パスフレーズ}}を保存するために使用され、ユーザー iwctl を呼び出さずに作成することもできます。このファイルは、そのネットワーク SSID に関連する他の設定にも使用できます。詳細な設定については、{{man|5|iwd.network}} を参照してください。

=== WPA-PSK ===

SSID "spaceship" とパスフレーズ "test1234" を使用して WPA-PSK または WPA2-PSK で保護されたネットワークに接続するための最小限のサンプルファイル:

{{hc|/var/lib/iwd/spaceship.psk|2=
[Security]
PreSharedKey=aafb192ce2da24d8c7805c956136f45dd612103f086034c402ed266355297295}}

{{Note|ネットワークの SSID は英数字のみまたは {{ic|- _}} のいずれかを含む場合のみファイル名として使用されます。他の文字が含まれている場合、名前は {{ic|1==}} 文字の後に16進数でエンコードされた SSID が代わりに使用されます。
}}

パスフレーズから事前共有鍵を計算するには、次の二つの方法のいずれかを使用できます:

* 設定ファイルにクリアテキストでパスフレーズを入力します:
{{hc|/var/lib/iwd/spaceship.psk|2=
[Security]
Passphrase=test1234}}
事前共有鍵は、最初の接続時にファイルに追加されます。
{{hc|/var/lib/iwd/spaceship.psk|2=
[Security]
Passphrase=test1234
PreSharedKey=aafb192ce2da24d8c7805c956136f45dd612103f086034c402ed266355297295}}

* もしくは、事前共有鍵は、''wpa_passphrase'' ({{Pkg|wpa_supplicant}} から) または {{AUR|wpa-psk}} を使用して、SSID とパスフレーズから計算できます。詳細については [[wpa_supplicant#wpa_passphrase で接続する]] を参照してください。

=== WPA Enterprise ===

==== EAP-PWD ====

EAP-PWD で保護されたエンタープライズアクセスポイントに接続するには {{ic|/var/lib/iwd}} フォルダに以下の内容で {{ic|''essid''.8021x}} という名前のファイルを作成する必要があります:

{{hc|/var/lib/iwd/''essid''.8021x|2=
[Security]
EAP-Method=PWD
EAP-Identity=''your_enterprise_email''
EAP-Password=''your_password''

[Settings]
AutoConnect=True
}}

アクセスポイントに自動接続したくない場合、Autoconnect オプションを False に設定して {{ic|iwctl}} で手動でアクセスポイントに接続してください。パスワードを平文で保存したくない場合は、ファイルからパスワードの設定を外してください。

==== EAP-PEAP ====

EAP-PWD と同様に、フォルダー内に {{ic|''essid''.8021x}} を作成する必要があります。設定ファイルの作成に奨む前に、組織が使用している CA 証明証を確認する良い機会でもあります。MSCHAPv2 を機能させるには、{{Pkg|ppp}} もインストールする必要があります。詳細については、[[Network_configuration/Wireless#MS-CHAPv2|MS-CHAPv2]] を参照してください。これは MSCHAPv2 パスワード認証を使用する設定ファイルの例です:

{{hc|/var/lib/iwd/''essid''.8021x|2=
[Security]
EAP-Method=PEAP
EAP-Identity=anonymous@realm.edu
EAP-PEAP-CACert=/path/to/root.crt
EAP-PEAP-ServerDomainMask=radius.realm.edu
EAP-PEAP-Phase2-Method=MSCHAPV2
EAP-PEAP-Phase2-Identity=johndoe@realm.edu
EAP-PEAP-Phase2-Password=hunter2

[Settings]
AutoConnect=true
}}

{{Tip|''eduroam'' の使用を計画している場合は、[[#Eduroam]] も参照してください。}}

==== TTLS-PAP ====

Like EAP-PWD, you also need to create a {{ic|''essid''.8021x}} in the folder. Before you proceed to write the configuration file, this is also a good time to find out which CA certificate your organization uses. This is an example configuration file that uses PAP password authentication:

{{hc|/var/lib/iwd/''essid''.8021x|2=
[Security]
EAP-Method=TTLS
EAP-Identity=anonymous@uni-test.de
EAP-TTLS-CACert=cert.pem
EAP-TTLS-ServerDomainMask=*.uni-test.de
EAP-TTLS-Phase2-Method=Tunneled-PAP
EAP-TTLS-Phase2-Identity=user
EAP-TTLS-Phase2-Password=password

[Settings]
AutoConnect=true
}}

==== Eduroam ====

Eduroam offers a [https://cat.eduroam.org/ configuration assistant tool (CAT)], which unfortunately does not support iwd. However, the installer, which you can download by clicking on the download button then selecting your university, is just a Python script. It is easy to extract the necessary configuration options, including the certificate and server domain mask.

The following table contains a mapping of iwd configuration options to eduroam CAT install script variables.

{| class="wikitable
! Iwd Configuration Option !! CAT Script Variable
|-
| file name || one of {{ic|Config.ssids}}
|-
| {{ic|EAP-Method}} || {{ic|Config.eap_outer}}
|-
| {{ic|EAP-Identity}} || {{ic|Config.anonymous_identity}}
|-
| {{ic|EAP-PEAP-CACert}} || {{ic|Config.CA}}
|-
| {{ic|EAP-PEAP-ServerDomainMask}} || one of {{ic|Config.servers}}
|-
| {{ic|EAP-PEAP-Phase2-Method}} || {{ic|Config.eap_inner}}
|-
| {{ic|EAP-PEAP-Phase2-Identity}} || username@{{ic|Config.user_realm}}
|}

{{Note|
* {{ic|EAP-Identity}} may not be required by your Eduroam provider, in which case you can use {{ic|anonymous}} in this field.
* If your {{ic|EAP-PEAP-ServerDomainMask}} starts with {{ic|DNS:}}, use only the part after {{ic|DNS:}}.
}}

==== Other cases ====

More example tests can be [https://git.kernel.org/pub/scm/network/wireless/iwd.git/tree/autotests found in the test cases] of the upstream repository.

== 任意設定 ==

メインの設定は {{ic|/etc/iwd/main.conf}} ファイルで行います。

ネットワーク (SSID) の設定は {{ic|/var/lib/iwd}} ディレクトリを使用します。

=== 特定のネットワークで自動接続を無効化 ===

{{ic|/var/lib/iwd/''network''.''type''}} ファイルを作成・編集してください (''network'' はネットワークの SSID に、''type'' は "open", "wep", "psk", "8021x" のどれかのネットワークタイプに置き換えてください)。そしてファイルに以下のセクションを追加してください:

{{hc|/var/lib/iwd/spaceship.psk|2=<nowiki>
[Settings]
Autoconnect=false
</nowiki>}}

=== 利用可能なネットワークの定期スキャンを無効にする ===

デフォルトでは、 {{ic|iwd}} は切断状態の場合、利用可能なネットワークを定期的にスキャンします。定期スキャンを無効にする(常に手動でスキャンする)には、{{ic|/etc/iwd/main.conf}} ファイルを作成/編集し、以下のセクションを追加します:

{{hc|/etc/iwd/main.conf|2=
[Scan]
DisablePeriodicScan=true
}}

=== 内蔵ネットワーク設定の有効化 ===

バージョン 0.19 以降、iwd は内蔵の DHCP クライアントまたは静的な設定を使用して、IPアドレスの割り当てとルートの設定を行うことができます。これは、[[ネットワーク設定#DHCP|スタンドアロン DHCP クライアント]]の良い代替手段です。

iwd のネットワーク設定機能を有効にするには、/{{ic|/etc/iwd/main.conf}} を作成・編集し、以下のセクションを追加します:

{{hc|/etc/iwd/main.conf|2=
[General]
EnableNetworkConfiguration=true
}}

また、{{ic|RoutePriorityOffset}} でルートメトリックを設定する機能もあります:
{{hc|/etc/iwd/main.conf|2=
[Network]
RoutePriorityOffset=300
}}

==== IPv6 support ====

バージョン 1.10 以降、iwd は IPv6 をサポートしていますが、デフォルトでは無効になっています。IPv6 を有効にするには、設定ファイルに以下を追加します:

{{hc|/etc/iwd/main.conf|2=
[Network]
EnableIPv6=true
}}

この設定は、DHCPv6 または静的 IPv6 設定のどちらを使用する場合でも必要です。ネットワーク毎に設定することもできます。

==== ネットワーク構成での静的 IP アドレスの設定 ====

次のセクションを {{ic|/var/lib/iwd/''network''.''type''}} ファイルに追加します。例えば:

{{hc|/var/lib/iwd/spaceship.psk|2=
[IPv4]
Address=192.168.1.10
Netmask=255.255.255.0
Gateway=192.168.1.1
Broadcast=192.168.1.255
DNS=192.168.1.1
}}

==== DNS マネージャーの選択 ====

現在、iwd は [[systemd-resolved]] と [[Openresolv|resolvconf]] の二つの DNS マネージャーをサポートしています。

{{ic|systemd-resolved}} の場合、次のセクションを {{ic|/etc/iwd/main.conf}} に追加します:

{{hc|/etc/iwd/main.conf|2=
[Network]
NameResolvingService=systemd
}}

{{ic|resolvconf}} の場合:

{{hc|/etc/iwd/main.conf|2=
[Network]
NameResolvingService=resolvconf
}}

=== コンソール (ローカル) ユーザーが設定を変えられないようにする ===

デフォルトでは {{ic|iwd}} の D-Bus インターフェイスは (たとえユーザーが "root" でなくても) 誰でも {{ic|iwd}} デーモンに接続して設定を変更できるようになっています。

コンソールユーザーが設定を編集できないようにしたい場合、以下のように D-Bus 設定ファイルを作成してください:

{{hc|/etc/dbus-1/system.d/iwd-strict.conf|2=<nowiki>




<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
"http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>

<policy at_console="true">
<deny send_destination="net.connman.iwd"/>
<allow send_destination="net.connman.iwd" send_interface="org.freedesktop.DBus.Properties" send_member="GetAll" />
<allow send_destination="net.connman.iwd" send_interface="org.freedesktop.DBus.Properties" send_member="Get" />
<allow send_destination="net.connman.iwd" send_interface="org.freedesktop.DBus.ObjectManager" send_member="GetManagedObjects" />
<allow send_destination="net.connman.iwd" send_interface="net.connman.iwd.Device" send_member="RegisterSignalLevelAgent" />
<allow send_destination="net.connman.iwd" send_interface="net.connman.iwd.Device" send_member="UnregisterSignalLevelAgent" />
</policy>

</busconfig>
</nowiki>}}

{{Tip|''<allow>'' 行を削除するとネットワークの状態を読み出すこともできなくなります。}}

== Troubleshooting ==

=== Verbose TLS debugging ===

This can be useful, if you have trouble setting up MSCHAPv2 or TTLS. You can set the following [[environment variable]] via a [[drop-in snippet]]:

{{hc|/etc/systemd/system/iwd.service.d/tls-debug.conf|2=
[Service]
Environment=IWD_TLS_DEBUG=TRUE
}}

Check the iwd logs afterwards via {{ic|journalctl -u iwd.service}}

=== 再起動後の接続の問題 ===

エントロピープールが低いと、特に再起動後に顕著な接続の問題が発生する可能性があります。エントロピープールを増やすための提案については、[[乱数生成]] を参照してください。

=== Wireless device is not renamed by udev ===

Since version 1.0, iwd disables predictable renaming of wireless device. It installs the following systemd network link configuration file which prevents udev from renaming the interface to {{ic|wlp#s#}}:

{{hc|1=/usr/lib/systemd/network/80-iwd.link|2=
[Match]
Type=wlan

[Link]
NamePolicy=keep kernel
}}

As a result the wireless link name {{ic|wlan#}} is kept after boot. This resolved a race condition between ''iwd'' and [[udev]] on interface renaming as explained in [https://iwd.wiki.kernel.org/interface_lifecycle#udev_interface_renaming iwd udev interface renaming].

If this results in issues try masking it with:

# ln -s /dev/null /etc/systemd/network/80-iwd.link

== 参照 ==

* [https://iwd.wiki.kernel.org/gettingstarted Getting Started with iwd]
* [https://iwd.wiki.kernel.org/networkconfigurationsettings Network Configuration Settings]
* [https://git.kernel.org/pub/scm/network/wireless/iwd.git/tree/autotests More Examples for WPA Enterprise]
* [https://bbs.archlinux.org/viewtopic.php?id=237074 The IWD thread on the Arch Linux Forums]
* [https://www.youtube.com/watch?v=F2Q86cphKDo 2017 Update on new WiFi daemon for Linux by Marcel Holtmann - YouTube]
* [https://www.youtube.com/watch?v=QIqT2obSPDk The New Wi-Fi Experience for Linux - Marcel Holtmann, Intel - YouTube]

ArchWiki - 利用者の投稿記録 [ja]

Iwd