Android 10(API レベル 29)以降を搭載したデバイスでは、アプリでネットワーク認証情報を追加して、デバイスを Wi-Fi アクセス ポイントに自動接続できます。WifiNetworkSuggestion を使用して、接続するネットワークの候補を提供できます。プラットフォームは、アプリや他のアプリからの入力に基づいて、最終的に受け入れるアクセス ポイントを選択します。
Android 11(API レベル 30)以降の場合:
PasspointConfigurationのプロビジョニングは、提案 API でサポートされています。Android 11 より前では、PasspointConfigurationをプロビジョニングするにはaddOrUpdatePasspointConfiguration()API を使用する必要がありました。- このフレームワークは、TLS ベースのエンタープライズ提案(EAP-TLS、EAP-TTLS、EAP-PEAP)にセキュリティ要件を適用します。このようなネットワークへの提案では、
Root CA certificateとserver domain nameを設定する必要があります。
- フレームワークは、EAP-SIM ベースのエンタープライズ候補(EAP-SIM、EAP-AKA、EAP-AKA-PRIME)の所有権要件を適用します。このような候補は、携帯通信会社が署名したアプリでのみ許可されます。
- 携帯通信会社が署名したアプリから提供される候補の場合、フレームワークは、アプリの携帯通信会社の署名に対応する携帯通信会社 ID を自動的に割り当てます。対応する SIM がデバイスから取り外されると、そのような候補は自動的に無効になります。
Android 12(API レベル 31)以降の場合:
非永続的な MAC ランダム化を使用すると、ランダム化された MAC アドレスが定期的に再ランダム化されるため、プライバシーをさらに強化できます。
setMacRandomizationSettingを使用して、ネットワークのランダム化のレベルを指定します。isPasspointTermsAndConditionsSupported(): 利用規約は、ネットワーク デプロイにおいて、オープン ネットワークを使用する安全でないキャプティブ ポータルを安全な Passpoint ネットワークに置き換えることができる Passpoint の機能です。利用規約への同意が必要な場合は、通知が表示されます。利用規約によって制限されている Passpoint ネットワークを提案するアプリは、まずこの API を呼び出して、デバイスがこの機能をサポートしていることを確認する必要があります。デバイスがこの機能をサポートしていない場合、このネットワークに接続できないため、代替ネットワークまたはレガシー ネットワークを提案する必要があります。isDecoratedIdentitySupported(): プレフィックス装飾でネットワークの認証を行う場合、装飾された ID プレフィックスにより、ネットワーク事業者はネットワーク アクセス識別子(NAI)を更新して、AAA ネットワーク内の複数のプロキシを経由して明示的なルーティングを行えます(詳しくは、RFC 7542 をご覧ください)。Android 12 では、この機能を PPS-MO 拡張機能の WBA 仕様に準拠するように実装しています。装飾された ID を必要とする Passpoint ネットワークを提案するアプリは、まずこの API を呼び出して、デバイスがこの機能をサポートしていることを確認する必要があります。デバイスがこの機能をサポートしていない場合、ID は装飾されず、ネットワークへの認証が失敗する可能性があります。
Passpoint 候補を作成するには、アプリで PasspointConfiguration、Credential、HomeSp クラスを使用する必要があります。これらのクラスは、Wi-Fi Alliance Passpoint 仕様で定義されている Passpoint プロファイルを表します。
次のコードサンプルは、1 つのオープン ネットワーク、1 つの WPA2 ネットワーク、1 つの WPA3 ネットワーク、1 つの Passpoint ネットワークの認証情報を提供する方法を示しています。
Kotlin
val suggestion1 = WifiNetworkSuggestion.Builder()
.setSsid("test111111")
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
val suggestion2 = WifiNetworkSuggestion.Builder()
.setSsid("test222222")
.setWpa2Passphrase("test123456")
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
val suggestion3 = WifiNetworkSuggestion.Builder()
.setSsid("test333333")
.setWpa3Passphrase("test6789")
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
val passpointConfig = PasspointConfiguration(); // configure passpointConfig to include a valid Passpoint configuration
val suggestion4 = WifiNetworkSuggestion.Builder()
.setPasspointConfig(passpointConfig)
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
val suggestionsList = listOf(suggestion1, suggestion2, suggestion3, suggestion4);
val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager;
val status = wifiManager.addNetworkSuggestions(suggestionsList);
if (status != WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) {
// do error handling here
}
// Optional (Wait for post connection broadcast to one of your suggestions)
val intentFilter = IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION);
val broadcastReceiver = object : BroadcastReceiver() {
override fun onReceive(context: Context, intent: Intent) {
if (!intent.action.equals(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) {
return;
}
// do post connect processing here
}
};
context.registerReceiver(broadcastReceiver, intentFilter);
Java
final WifiNetworkSuggestion suggestion1 =
new WifiNetworkSuggestion.Builder()
.setSsid("test111111")
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
final WifiNetworkSuggestion suggestion2 =
new WifiNetworkSuggestion.Builder()
.setSsid("test222222")
.setWpa2Passphrase("test123456")
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
final WifiNetworkSuggestion suggestion3 =
new WifiNetworkSuggestion.Builder()
.setSsid("test333333")
.setWpa3Passphrase("test6789")
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
final PasspointConfiguration passpointConfig = new PasspointConfiguration();
// configure passpointConfig to include a valid Passpoint configuration
final WifiNetworkSuggestion suggestion4 =
new WifiNetworkSuggestion.Builder()
.setPasspointConfig(passpointConfig)
.setIsAppInteractionRequired(true) // Optional (Needs location permission)
.build();
final List<WifiNetworkSuggestion> suggestionsList =
new ArrayList<WifiNetworkSuggestion>() {{
add(suggestion1);
add(suggestion2);
add(suggestion3);
add(suggestion4);
}};
final WifiManager wifiManager =
(WifiManager) context.getSystemService(Context.WIFI_SERVICE);
final int status = wifiManager.addNetworkSuggestions(suggestionsList);
if (status != WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) {
// do error handling here…
}
// Optional (Wait for post connection broadcast to one of your suggestions)
final IntentFilter intentFilter =
new IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION);
final BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
if (!intent.getAction().equals(
WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) {
return;
}
// do post connect processing here...
}
};
context.registerReceiver(broadcastReceiver, intentFilter);
アプリが初めて候補を配置した直後に、ユーザーに通知されます。通知の種類は、デバイスで実行されている Android のバージョンによって異なります。
- Android 11(API レベル 30)以降では、アプリがフォアグラウンドで実行されている場合はダイアログが表示され、アプリがバックグラウンドで実行されている場合は通知が表示されます。
- Android 10(API レベル 29)では、アプリがフォアグラウンドで実行されているかバックグラウンドで実行されているかにかかわらず、ユーザーに通知が表示されます。
プラットフォームがネットワーク候補のいずれかに接続すると、設定には、ネットワーク接続を対応する候補アプリに関連付けるテキストが表示されます。
ユーザーが接続を解除した場合の処理
ユーザーが Wi-Fi 選択ツールを使用して、接続されているネットワーク候補の 1 つから明示的に切断した場合、そのネットワークは範囲内にある間は無視されます。この期間中は、アプリがネットワークに対応するネットワーク候補を削除して再度追加しても、そのネットワークは自動接続の対象になりません。ユーザーが Wi-Fi ピッカーを使用して、以前に切断されたネットワークに明示的に接続した場合、そのネットワークはすぐに自動接続の対象とみなされます。
アプリの承認ステータスの変更
ユーザーがネットワーク候補の通知を拒否すると、アプリから CHANGE_WIFI_STATE 権限が削除されます。ユーザーは、後で Wi-Fi 管理メニュー([設定] > [アプリと通知] > [特別なアプリアクセス] > [Wi-Fi の管理] > App name)に移動して、この承認を付与できます。