app/src/main/java/com/stoutner/privacycell/services/RealtimeMonitoringService.kt

   1 /*
   2  * Copyright © 2021-2022 Soren Stoutner <soren@stoutner.com>.
   3  *
   4  * This file is part of Privacy Cell <https://www.stoutner.com/privacy-cell>.
   5  *
   6  * Privacy Cell is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * Privacy Cell is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with Privacy Cell.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 // The suppression of deprecation lint can be removed once the minimum API >= 31.
  21 @file:Suppress("DEPRECATION")
  22
  23 package com.stoutner.privacycell.services
  24
  25 import android.Manifest
  26 import android.app.Notification
  27 import android.app.NotificationChannel
  28 import android.app.NotificationChannelGroup
  29 import android.app.NotificationManager
  30 import android.app.PendingIntent
  31 import android.app.Service
  32 import android.content.Context
  33 import android.content.Intent
  34 import android.content.pm.PackageManager
  35 import android.os.Binder
  36 import android.os.IBinder
  37 import android.telephony.PhoneStateListener  // This can be replaced by `TelephonyCallback` once the minimum API >= 31.
  38 import android.telephony.ServiceState
  39 import android.telephony.TelephonyDisplayInfo
  40 import android.telephony.TelephonyManager
  41
  42 import androidx.core.app.ActivityCompat
  43 import androidx.preference.PreferenceManager
  44 import androidx.work.ExistingPeriodicWorkPolicy
  45 import androidx.work.PeriodicWorkRequestBuilder
  46 import androidx.work.WorkManager
  47
  48 import com.stoutner.privacycell.R
  49 import com.stoutner.privacycell.activities.PrivacyCellActivity
  50 import com.stoutner.privacycell.helpers.ProtocolHelper
  51 import com.stoutner.privacycell.workers.RegisterRealtimeListenerWorker
  52
  53 import java.util.concurrent.TimeUnit
  54
  55 // Define the class constants.
  56 const val REALTIME_MONITORING = "realtime_monitoring"
  57 const val NOTIFICATION_ID = 1
  58 const val UNKNOWN_NETWORK = "unknown_network"
  59
  60 class RealtimeMonitoringService : Service() {
  61     companion object {
  62         // Define the public constants.  These are used in the settings fragment to launch intents to edit the sound that plays for each channel.
  63         const val SECURE_NETWORK = "secure_network"
  64         const val INSECURE_NETWORK = "insecure_network"
  65         const val ANTIQUATED_NETWORK = "antiquated_network"
  66     }
  67
  68     // Define the class variables.
  69     private var currentStatus = ""
  70     private var voiceNetworkSecurityStatus = ProtocolHelper.UNPOPULATED
  71     private var dataNetworkSecurityStatus = ProtocolHelper.UNPOPULATED
  72
  73     // Declare the class variables.
  74     private lateinit var notificationManager: NotificationManager
  75     private lateinit var phoneStateListener: PhoneStateListener  // The `PhoneStateListener` can be replaced by `TelephonyCallback` once the minimum API >= 31.
  76     private lateinit var privacyCellPendingIntent: PendingIntent
  77
  78     inner class ServiceBinder : Binder() {
  79         // Get a copy of this service as a binder.
  80         fun getService(): RealtimeMonitoringService = this@RealtimeMonitoringService
  81     }
  82
  83     override fun onBind(intent: Intent?): IBinder {
  84         // Return a copy of the service binder.
  85         return ServiceBinder()
  86     }
  87
  88     override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
  89         // Get a handle for the shared preferences.
  90         val sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this)
  91
  92         // Check to see if realtime monitoring is enabled.  Sometimes the shared preferences can't return a value in time, because Android sucks.
  93         // So, the default value is set to true, which is the safest value if the shared preferences can't be queried.
  94         if (sharedPreferences.getBoolean(applicationContext.getString(R.string.realtime_monitoring_key), true)) {  // Realtime monitoring is enabled.
  95             // Get a handle for the notification manager.
  96             notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
  97
  98             // Create a notification channel group.
  99             notificationManager.createNotificationChannelGroup(NotificationChannelGroup(REALTIME_MONITORING, getString(R.string.realtime_monitoring)))
 100
 101             // Prepare the notification channels.
 102             val secureNetworkChannel = NotificationChannel(SECURE_NETWORK, getString(R.string.secure_network_channel), NotificationManager.IMPORTANCE_HIGH)
 103             val insecureNetworkChannel = NotificationChannel(INSECURE_NETWORK, getString(R.string.insecure_network_channel), NotificationManager.IMPORTANCE_HIGH)
 104             val antiquatedNetworkChannel = NotificationChannel(ANTIQUATED_NETWORK, getString(R.string.antiquated_network_channel), NotificationManager.IMPORTANCE_HIGH)
 105             val unknownNetworkChannel = NotificationChannel(UNKNOWN_NETWORK, getString(R.string.unknown_network_channel), NotificationManager.IMPORTANCE_LOW)
 106
 107             // Set the notification channel group.
 108             secureNetworkChannel.group = REALTIME_MONITORING
 109             insecureNetworkChannel.group = REALTIME_MONITORING
 110             antiquatedNetworkChannel.group = REALTIME_MONITORING
 111             unknownNetworkChannel.group = REALTIME_MONITORING
 112
 113             // Disable the notification dots.
 114             secureNetworkChannel.setShowBadge(false)
 115             insecureNetworkChannel.setShowBadge(false)
 116             antiquatedNetworkChannel.setShowBadge(false)
 117             unknownNetworkChannel.setShowBadge(false)
 118
 119             // Set the primary channel notifications to be public.
 120             secureNetworkChannel.lockscreenVisibility = Notification.VISIBILITY_PUBLIC
 121             insecureNetworkChannel.lockscreenVisibility = Notification.VISIBILITY_PUBLIC
 122             antiquatedNetworkChannel.lockscreenVisibility = Notification.VISIBILITY_PUBLIC
 123
 124             // Create the notification channels.
 125             notificationManager.createNotificationChannel(secureNetworkChannel)
 126             notificationManager.createNotificationChannel(insecureNetworkChannel)
 127             notificationManager.createNotificationChannel(antiquatedNetworkChannel)
 128             notificationManager.createNotificationChannel(unknownNetworkChannel)
 129
 130             // Create a notification builder.
 131             val notificationBuilder = Notification.Builder(this, UNKNOWN_NETWORK)
 132
 133             // Create an intent to open Privacy Cell.
 134             val privacyCellIntent = Intent(this, PrivacyCellActivity::class.java)
 135
 136             // Create a pending intent from the Privacy Cell intent.
 137             privacyCellPendingIntent = PendingIntent.getActivity(this, 0, privacyCellIntent, PendingIntent.FLAG_IMMUTABLE)
 138
 139             // Set the notification to open Privacy Cell.
 140             notificationBuilder.setContentIntent(privacyCellPendingIntent)
 141
 142             // Set the notification text.
 143             notificationBuilder.setContentText(getString(R.string.unknown_network))
 144
 145             // Set the notification icon.
 146             notificationBuilder.setSmallIcon(R.drawable.antiquated_notification_enabled)
 147
 148             // Set the color.
 149             notificationBuilder.setColor(getColor(R.color.red_notification_icon))
 150
 151             // Start the foreground notification.
 152             startForeground(NOTIFICATION_ID, notificationBuilder.build())
 153
 154             // Instantiate the protocol helper.
 155             val protocolHelper = ProtocolHelper()
 156
 157             // Define the phone state listener.  The `PhoneStateListener` can be replaced by `TelephonyCallback` once the minimum API >= 31.
 158             phoneStateListener = object : PhoneStateListener() {
 159                 @Deprecated("Deprecated in Java")
 160                 override fun onServiceStateChanged(serviceState: ServiceState) {  // Update the voice network status.
 161                     // Get the network registration info for the voice network, which is the second of the three entries (the first appears to be Wi-Fi and the third appears to be the cell data network).
 162                     val networkRegistrationInfo = serviceState.networkRegistrationInfoList[1]
 163
 164                     // Get the consider 3G antiquated preference.
 165                     val consider3gAntiquated = sharedPreferences.getBoolean(getString(R.string.consider_3g_antiquated_key), false)
 166
 167                     // Update the voice network security status.
 168                     voiceNetworkSecurityStatus = protocolHelper.checkNetwork(networkRegistrationInfo.accessNetworkTechnology, consider3gAntiquated)
 169
 170                     // Populate the notification.
 171                     populateNotification()
 172                 }
 173
 174                 @Deprecated("Deprecated in Java")
 175                 override fun onDisplayInfoChanged(telephonyDisplayInfo: TelephonyDisplayInfo) {  // Update the data network status.
 176                     // Get the consider 3G antiquated preference.
 177                     val consider3gAntiquated = sharedPreferences.getBoolean(getString(R.string.consider_3g_antiquated_key), false)
 178
 179                     // Update the data network security status.
 180                     dataNetworkSecurityStatus = protocolHelper.checkNetwork(telephonyDisplayInfo.networkType, consider3gAntiquated)
 181
 182                     // Populate the notification.
 183                     populateNotification()
 184                 }
 185             }
 186
 187             // Check to see if the read phone state permission has been granted.
 188             if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_PHONE_STATE) == PackageManager.PERMISSION_GRANTED) {
 189                 // Create a register realtime listener work request that fires every hour.
 190                 // This periodic request will fire shortly after being created (it fires about every hour near the beginning of the hour) and will reregister the listener if it gets garbage collected.
 191                 val registerRealtimeListenerWorkRequest = PeriodicWorkRequestBuilder<RegisterRealtimeListenerWorker>(1, TimeUnit.HOURS).build()
 192
 193                 // Register the realtime listener work request.
 194                 WorkManager.getInstance(this).enqueueUniquePeriodicWork(getString(R.string.register_listener_work_request), ExistingPeriodicWorkPolicy.REPLACE, registerRealtimeListenerWorkRequest)
 195             }
 196         } else {  // Realtime monitoring is disabled.  This can happen if the restart listener work request fires after realtime monitoring has been disabled.
 197             // Cancel the realtime listener work request.
 198             WorkManager.getInstance(applicationContext).cancelUniqueWork(applicationContext.getString(R.string.register_listener_work_request))
 199         }
 200
 201         // Return a sticky service.
 202         return START_STICKY
 203     }
 204
 205     fun registerTelephonyManagerListener() {
 206         // Check to see if the read phone state permission has been granted.
 207         if (ActivityCompat.checkSelfPermission(this, Manifest.permission.READ_PHONE_STATE) == PackageManager.PERMISSION_GRANTED) {
 208             // Get a handle for the telephony manager.
 209             val telephonyManager = getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
 210
 211             // Cancel the current listener if it exists.  The `PhoneStateListener` can be replaced by `TelephonyCallback` once the minimum API >= 31.
 212             telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_NONE)
 213
 214             // Listen for changes to the phone state.  The `PhoneStateListener` can be replaced by `TelephonyCallback` once the minimum API >= 31.
 215             telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_SERVICE_STATE or PhoneStateListener.LISTEN_DISPLAY_INFO_CHANGED)
 216         }
 217     }
 218
 219     fun populateNotification() {
 220         // Populate the notification according to the security status.
 221         if ((voiceNetworkSecurityStatus == ProtocolHelper.ANTIQUATED) || (dataNetworkSecurityStatus == ProtocolHelper.ANTIQUATED)) {  // This is an antiquated network.
 222             // Only update the notification if the network status has changed.
 223             if (currentStatus != ANTIQUATED_NETWORK) {
 224                 // Create an antiquated network notification builder.
 225                 val antiquatedNetworkNotificationBuilder = Notification.Builder(applicationContext, ANTIQUATED_NETWORK)
 226
 227                 // Set the notification to open Privacy Cell.
 228                 antiquatedNetworkNotificationBuilder.setContentIntent(privacyCellPendingIntent)
 229
 230                 // Set the notification text.
 231                 antiquatedNetworkNotificationBuilder.setContentText(getString(R.string.antiquated_network))
 232
 233                 // Set the notification icon.
 234                 antiquatedNetworkNotificationBuilder.setSmallIcon(R.drawable.antiquated_notification_enabled)
 235
 236                 // Set the color.
 237                 antiquatedNetworkNotificationBuilder.setColor(getColor(R.color.red_notification_icon))
 238
 239                 // Update the notification.
 240                 notificationManager.notify(NOTIFICATION_ID, antiquatedNetworkNotificationBuilder.build())
 241
 242                 // Store the new network status.
 243                 currentStatus = ANTIQUATED_NETWORK
 244             }
 245         } else if ((voiceNetworkSecurityStatus == ProtocolHelper.INSECURE) || (dataNetworkSecurityStatus == ProtocolHelper.INSECURE)) {  // This is an insecure network.
 246             // Only update the notification if the network status has changed.
 247             if (currentStatus != INSECURE_NETWORK) {
 248                 // Create an insecure network notification builder.
 249                 val insecureNetworkNotificationBuilder = Notification.Builder(applicationContext, INSECURE_NETWORK)
 250
 251                 // Set the notification to open Privacy Cell.
 252                 insecureNetworkNotificationBuilder.setContentIntent(privacyCellPendingIntent)
 253
 254                 // Set the notification text.
 255                 insecureNetworkNotificationBuilder.setContentText(getString(R.string.insecure_network))
 256
 257                 // Set the notification icon.
 258                 insecureNetworkNotificationBuilder.setSmallIcon(R.drawable.insecure_notification_enabled)
 259
 260                 // Set the color.
 261                 insecureNetworkNotificationBuilder.setColor(getColor(R.color.yellow_notification_icon))
 262
 263                 // Update the notification.
 264                 notificationManager.notify(NOTIFICATION_ID, insecureNetworkNotificationBuilder.build())
 265
 266                 // Store the new network status.
 267                 currentStatus = INSECURE_NETWORK
 268             }
 269         } else {  // This is a secure network.
 270             // Only update the notification if the network status has changed.
 271             if (currentStatus != SECURE_NETWORK) {
 272                 // Create a secure network notification builder.
 273                 val secureNetworkNotificationBuilder = Notification.Builder(applicationContext, SECURE_NETWORK)
 274
 275                 // Set the notification to open Privacy Cell.
 276                 secureNetworkNotificationBuilder.setContentIntent(privacyCellPendingIntent)
 277
 278                 // Set the notification text.
 279                 secureNetworkNotificationBuilder.setContentText(getString(R.string.secure_network))
 280
 281                 // Set the notification icon.
 282                 secureNetworkNotificationBuilder.setSmallIcon(R.drawable.secure_notification_enabled)
 283
 284                 // Set the color.
 285                 secureNetworkNotificationBuilder.setColor(getColor(R.color.blue_icon))
 286
 287                 // Update the notification.
 288                 notificationManager.notify(NOTIFICATION_ID, secureNetworkNotificationBuilder.build())
 289
 290                 // Store the new network status.
 291                 currentStatus = SECURE_NETWORK
 292             }
 293         }
 294     }
 295 }