バーチャル SIM/Subscriber を管理する: バーチャル SIM/Subscriber のセッションを再確立する | SORACOM Arc

一部の機能 (利用する VPG の変更など) では、設定を反映するためにバーチャル SIM/Subscriber のセッションを再確立してください。

このページで説明する手順でセッションを再確立することを推奨します

セッションを再確立すると、WireGuard の接続情報が更新されることがあります。その場合は、soratun または WireGuard の設定を更新してください。

このページで説明する手順でセッションを再確立すると、WireGuard の接続情報が更新されたことが 判別できて便利です。
遠隔操作でセッションを再確立するで説明する操作でもセッションを再確立できますが、その手順では WireGuard の接続情報が更新されたことが 判別できません。

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

WireGuard の接続情報が表示されます。
セッションステータスが「OFFLINE」のときは
セッションステータスが OFFLINE で、WireGuard の接続情報がすべて削除されている場合は、バーチャル SIM/Subscriber を再初期化してください。
[バーチャル SIM セッションのリセット] → [バーチャル SIM セッションをリセット] の順にクリックします。

セッションが再確立されます。
なお、条件を満たすと WireGuard の接続情報が更新され、変更箇所が以下のようにハイライトされます。

ハイライトされた場合 (WireGuard の接続情報が更新された場合) は、以下のいずれかの操作を行って、デバイス側で WireGuard インターフェースを作成し直してください。作成し直すまでは、バーチャル SIM/Subscriber を利用した SORACOM との通信はできません。 詳しくは、デバイス側の WireGuard インターフェースを再作成するを参照してください。

セッションが再確立されたときに WireGuard の接続情報が更新される場合があります

バーチャル SIM/Subscriber のセッションが再確立されたときに、以下の条件を満たすと WireGuard の接続情報が更新されます。

Virtual Private Gateway (VPG) で、バーチャル SIM/Subscriber に対して IP アドレスマップが設定されている状態で、そのバーチャル SIM/Subscriber が VPG の利用を開始したり、終了したりすると、WireGuard の接続情報が自動的に更新されます。
サブスクリプションごとに定められたランデブーポイント (例: フランクフルト (ドイツ)) とは異なるランデブーポイントを利用する VPG (例: 東京 (日本) を利用する VPG) があり、バーチャル SIM/Subscriber がその VPG の利用を開始したり、終了したりすると、WireGuard の接続情報が自動的に更新されます。
SORACOM に問題が発生すると、WireGuard の接続情報が自動的に更新されることがあります。

SORACOM CLI / SORACOM API の場合

SORACOM CLI / SORACOM API を利用しても、バーチャル SIM/Subscriber のセッションを再確立することもできます。

詳しくは、Sim:deleteSimSession API を参照してください。

デバイス側の WireGuard インターフェースを再作成する

WireGuard の接続情報が更新された場合は、デバイス側で WireGuard インターフェースを作成し直してください。作成し直すまでは、バーチャル SIM/Subscriber を利用した SORACOM との通信はできません。

WireGuard インターフェースの作成方法によって操作が異なります。

WireGuard インターフェースの作成方法説明

WireGuard インターフェースの作成方法	説明
`soratun` を使用する	ステップ 2: WireGuard の設定ファイルから soratun 設定ファイルを作成する以降を参照して、soratun 設定ファイルを更新し、WireGuard インターフェースを作成し直してください。 `soratun` でブートストラップした場合は、前回と同じ手順でブートストラップすることもできます。詳しくは、以下のページを参照してください。 soratun で SORACOM API の認証キーを使用してバーチャル SIM/Subscriber をブートストラップする soratun でセルラー回線認証を使用してバーチャル SIM/Subscriber をブートストラップする soratun で SIM 認証を使用してバーチャル SIM/Subscriber をブートストラップする
WireGuard を使用する	ステップ 2: WireGuard の設定ファイルを作成する以降を参照して、WireGuard の設定を更新し、WireGuard インターフェースを作成し直してください。

soratun を使用する

ステップ 2: WireGuard の設定ファイルから soratun 設定ファイルを作成する以降を参照して、soratun 設定ファイルを更新し、WireGuard インターフェースを作成し直してください。

soratun でブートストラップした場合は、前回と同じ手順でブートストラップすることもできます。詳しくは、以下のページを参照してください。

WireGuard を使用するステップ 2: WireGuard の設定ファイルを作成する以降を参照して、WireGuard の設定を更新し、WireGuard インターフェースを作成し直してください。

Soracom

Users

バーチャル SIM/Subscriber のセッションを再確立する