WireGuard を利用する: WireGuard の設定ファイルを作成する | SORACOM Arc

WireGuard 実装を利用する場合は、バーチャル SIM/Subscriber を作成したあとで WireGuard の設定ファイルを作成します。

ユーザーコンソールから WireGuard の設定ファイルをコピーする

バーチャル SIM/Subscriber を作成したときにコピーする

SORACOM ユーザーコンソールでバーチャル SIM/Subscriber を作成するでコピーした WireGuard の接続情報を、WireGuard の設定ファイル (/etc/wireguard/wg0.conf) にペーストします。

バーチャル SIM/Subscriber を作成したときに、「バーチャル SIM の作成」画面に WireGuard の接続情報が表示されます。

この内容を、WireGuard の設定ファイルとして利用してください。たとえば、Linux の場合は、/etc/wireguard/wg0.conf に保存します。詳しくは、Linux / macOS / Windows の WireGuard 実装で WireGuard インターフェースを作成するを参照してください。

接続情報はユーザーコンソールで確認できます

作成済みのバーチャル SIM/Subscriber の WireGuard の接続情報は、ユーザーコンソールで確認できます。ただし、クライアントピア秘密鍵 (PrivateKey) を紛失した場合は再発行する必要があります。詳しくは、WireGuard の接続情報を確認するを参照してください。

SIM 詳細画面で WireGuard の接続情報をコピーする

WireGuard の接続情報のうち、PrivateKey (クライアントピア秘密鍵) を除く接続情報は、ユーザーコンソールで確認できます。PrivateKey (クライアントピア秘密鍵) が不明な場合は、認証情報を登録または生成してください。詳しくは、バーチャル SIM/Subscriber の認証情報を更新するを参照してください。

バーチャル SIM/Subscriber のセッションが確立していないときは情報を確認できません

セッションを確立するには、バーチャル SIM/Subscriber を再初期化してください。

ユーザーコンソールにログインし、接続情報を確認するバーチャル SIM/Subscriber にあわせてカバレッジタイプを変更します。
詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更するを参照してください。
接続情報を確認するバーチャル SIM/Subscriber にチェックを入れ、[詳細] をクリックします。
SIM 詳細画面が表示されます。

[バーチャル SIM] → [セッション] の順にクリックします。

WireGuard の接続情報が表示されます。

接続情報を更新する場合は、表示された情報をもとに soratun 設定ファイルまたは WireGuard の設定ファイルを更新してください。

項目	説明	soratun 設定ファイルの編集部分	WireGuard の設定ファイルの編集部分
[SIM ID]	SIM ID です。	`simId` に入力します。	入力しません。
[クライアントピア IP アドレス]	クライアントの IP アドレスです。	`arcSessionStatus.arcClientPeerIpAddress` に入力します。	`[Interface]` の `Address` に、アドレスレンジ (`/32`) を追加して `10.xxx.xxx.xxx/32` のフォーマットで入力します。
[クライアントピア公開鍵]	クライアントピア公開鍵です。	`publicKey` に入力します。	入力しません。
[サーバーピア公開鍵]	Arc サーバーのサーバーピア公開鍵です。	`arcSessionStatus.arcServerPeerPublicKey` に入力します。	`[Peer]` の `PublicKey` に入力します。
[サーバーエンドポイント]	Arc サーバーの Wireguard プロトコルのエンドポイント (`IP アドレスまたはホスト名:ポート番号`) です。	`arcSessionStatus.arcServerEndpoint` に入力します。	`[Peer]` の `Endpoint` に入力します。

表の下に表示される WireGuard の接続情報をコピーすることもできます。ただし、PrivateKey (クライアントピア秘密鍵) は、仮の文字列 (<YOUR_PRIVATE_KEY>) が表示されます。仮の文字列はそのままでは使用できません。 クライアントピア秘密鍵が分からない場合は、新しい鍵を生成します。詳しくは、バーチャル SIM/Subscriber の認証情報を更新するを参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI / SORACOM API を利用して、WireGuard の接続情報を確認することもできます。

SORACOM CLI を利用する場合は、soracom sims get を使用します。
SORACOM API を利用する場合は、Sim:getSim API を使用します。

soratun 設定ファイル (/path/to/arc.json) から、WireGuard の設定ファイルを作成します。
```
$ soratun wg-config --config /path/to/arc.json > wg0.conf
```
WireGuard の設定ファイルを WireGuard 実装で利用できるようにします。
Linux の場合は、/etc/wireguard/wg0.conf にコピーします。
```
$ sudo cp wg0.conf /etc/wireguard
```

Soracom

Users

WireGuard の設定ファイルを作成する