Add safety around missing providerConfiguration

ios/NebulaNetworkExtension/PacketTunnelProvider.swift

@@ -3,6 +3,13 @@ import MobileNebula
 import os.log
 import SwiftyJSON
 
+enum VPNStartError: Error {
+    case noManagers
+    case couldNotFindManager
+    case noTunFileDescriptor
+    case noProviderConfig
+}
+
 class PacketTunnelProvider: NEPacketTunnelProvider {
     private var networkMonitor: NWPathMonitor?
     
@@ -13,61 +20,46 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
     private var didSleep = false
     private var cachedRouteDescription: String?
     
-    override func startTunnel(options: [String : NSObject]?, completionHandler: @escaping (Error?) -> Void) {
+    override func startTunnel(options: [String : NSObject]? = nil) async throws {
         // There is currently no way to get initialization errors back to the UI via completionHandler here
         // `expectStart` is sent only via the UI which means we should wait for the real start command which has another completion handler the UI can intercept
         if options?["expectStart"] != nil {
-            // The system completion handler must be called before IPC will work
+            // startTunnel must complete before IPC will work
-            completionHandler(nil)
             return
         }
         
         // VPN is being booted out of band of the UI. Use the system completion handler as there will be nothing to route initialization errors to but we still need to report
         // success/fail by the presence of an error or nil
-        start(completionHandler: completionHandler)
+        try await start()
     }
     
-    private func start(completionHandler: @escaping (Error?) -> Void) {
+    private func start() async throws {
-        // Load vpn configs from system, and find the manager matching the one being started
+        var manager: NETunnelProviderManager?
-        NETunnelProviderManager.loadAllFromPreferences() { managers, error in
-            let targetProtoConfig = self.protocolConfiguration as? NETunnelProviderProtocol;
-            let targetID = targetProtoConfig?.providerConfiguration!["id"] as? String;
-            
-            guard let managers = managers else {
-                self.log.error("No managers were loaded")
-                return
-            }
-            
-            for manager in managers {
         var config: Data
         var key: String
         
-                let mgr = manager.protocolConfiguration as? NETunnelProviderProtocol;
+        manager = try await self.findManager()
-                let id = mgr?.providerConfiguration!["id"] as? String;
+        
+        guard let foundManager = manager else {
+            throw VPNStartError.couldNotFindManager
+        }
         
-                if (id == targetID) {
         do {
-                        self.site = try Site(manager: manager)
+            self.site = try Site(manager: foundManager)
             config = try self.site!.getConfig()
         } catch {
             //TODO: need a way to notify the app
             self.log.error("Failed to render config from vpn object")
-                        return completionHandler(error)
+            throw error
         }
 
         let _site = self.site!
-
-                    do {
         key = try _site.getKey()
-                    } catch {
-                        return completionHandler(error)
-                    }
         
-                    let fileDescriptor = self.tunnelFileDescriptor
+        guard let fileDescriptor = self.tunnelFileDescriptor else {
-                    if fileDescriptor == nil {
+            throw VPNStartError.noTunFileDescriptor
-                        return completionHandler("Unable to locate the tun file descriptor")
         }
-                    let tunFD = Int(fileDescriptor!)
+        let tunFD = Int(fileDescriptor)
 
         // This is set to 127.0.0.1 because it has to be something..
         let tunnelNetworkSettings = NEPacketTunnelNetworkSettings(tunnelRemoteAddress: "127.0.0.1")
@@ -76,16 +68,16 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
         var err: NSError?
         let ipNet = MobileNebulaParseCIDR(_site.cert!.cert.details.ips[0], &err)
         if (err != nil) {
-                        return completionHandler(err!)
+            throw err!
         }
         tunnelNetworkSettings.ipv4Settings = NEIPv4Settings(addresses: [ipNet!.ip], subnetMasks: [ipNet!.maskCIDR])
         var routes: [NEIPv4Route] = [NEIPv4Route(destinationAddress: ipNet!.network, subnetMask: ipNet!.maskCIDR)]
 
         // Add our unsafe routes
-                    _site.unsafeRoutes.forEach { unsafeRoute in
+        try _site.unsafeRoutes.forEach { unsafeRoute in
             let ipNet = MobileNebulaParseCIDR(unsafeRoute.route, &err)
             if (err != nil) {
-                            return completionHandler(err!)
+                throw err!
             }
             routes.append(NEIPv4Route(destinationAddress: ipNet!.network, subnetMask: ipNet!.maskCIDR))
         }
@@ -93,31 +85,18 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
         tunnelNetworkSettings.ipv4Settings!.includedRoutes = routes
         tunnelNetworkSettings.mtu = _site.mtu as NSNumber
 
-                    self.setTunnelNetworkSettings(tunnelNetworkSettings, completionHandler: {(error:Error?) in
+        try await self.setTunnelNetworkSettings(tunnelNetworkSettings)
-                        if (error != nil) {
+        var nebulaErr: NSError?
-                            return completionHandler(error!)
+        self.nebula = MobileNebulaNewNebula(String(data: config, encoding: .utf8), key, self.site!.logFile, tunFD, &nebulaErr)
-                        }
-
-                        var err: NSError?
-                        self.nebula = MobileNebulaNewNebula(String(data: config, encoding: .utf8), key, self.site!.logFile, tunFD, &err)
         self.startNetworkMonitor()
 
-                        if err != nil {
+        if nebulaErr != nil {
-                            self.log.error("We had an error starting up: \(err, privacy: .public)")
+            self.log.error("We had an error starting up: \(nebulaErr, privacy: .public)")
-                            return completionHandler(err!)
+            throw nebulaErr!
         }
         
         self.nebula!.start()
         self.dnUpdater.updateSingleLoop(site: self.site!, onUpdate: self.handleDNUpdate)
-                        
-                        completionHandler(nil)
-                    })
-                    
-                    // We're done looking through managers
-                    continue
-                }
-            }
-        }
     }
     
     private func handleDNUpdate(newSite: Site) {
@@ -136,6 +115,30 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
 //        completionHandler()
 //    }
     
+    private func findManager() async throws -> NETunnelProviderManager {
+        let targetProtoConfig = self.protocolConfiguration as? NETunnelProviderProtocol
+        guard let targetProviderConfig = targetProtoConfig?.providerConfiguration else {
+            throw VPNStartError.noProviderConfig
+        }
+        let targetID = targetProviderConfig["id"] as? String
+        
+        // Load vpn configs from system, and find the manager matching the one being started
+        let managers = try await NETunnelProviderManager.loadAllFromPreferences()
+        for manager in managers {
+            let mgrProtoConfig = manager.protocolConfiguration as? NETunnelProviderProtocol
+            guard let mgrProviderConfig = mgrProtoConfig?.providerConfiguration else {
+                throw VPNStartError.noProviderConfig
+            }
+            let id = mgrProviderConfig["id"] as? String
+            if (id == targetID) {
+                return manager
+            }
+        }
+        
+        // If we didn't find anything, throw an error
+        throw VPNStartError.noManagers
+    }
+    
     private func startNetworkMonitor() {
         networkMonitor = NWPathMonitor()
         networkMonitor!.pathUpdateHandler = self.pathUpdate
@@ -180,10 +183,10 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
         return str.sorted().joined(separator: ", ")
     }
     
-    override func handleAppMessage(_ data: Data, completionHandler: ((Data?) -> Void)? = nil) {
+    override func handleAppMessage(_ data: Data) async -> Data? {
         guard let call = try? JSONDecoder().decode(IPCRequest.self, from: data) else {
             log.error("Failed to decode IPCRequest from network extension")
-            return
+            return nil
         }
         
         var error: Error?
@@ -191,27 +194,22 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
         
         // start command has special treatment due to needing to call two completers
         if call.command == "start" {
-            self.start() { error in
+            do {
-                // Notify the UI if we have a completionHandler
+                try await self.start()
-                if completionHandler != nil {
-                    if error == nil {
                 // No response data, this is expected on a clean start
-                        completionHandler!(try? JSONEncoder().encode(IPCResponse.init(type: .success, message: nil)))
+                return try? JSONEncoder().encode(IPCResponse.init(type: .success, message: nil))
-                        
+            } catch {
-                    } else {
+                defer {
-                        // We failed, notify and shutdown
-                        completionHandler!(try? JSONEncoder().encode(IPCResponse.init(type: .error, message: JSON(error!.localizedDescription))))
                     self.cancelTunnelWithError(error)
                 }
+                return try? JSONEncoder().encode(IPCResponse.init(type: .error, message: JSON(error.localizedDescription)))
             }
         }
-            return
-        }
         
         if nebula == nil {
             // Respond with an empty success message in the event a command comes in before we've truly started
             log.warning("Received command but do not have a nebula instance")
-            return completionHandler!(try? JSONEncoder().encode(IPCResponse.init(type: .success, message: nil)))
+            return try? JSONEncoder().encode(IPCResponse.init(type: .success, message: nil))
         }
         
         //TODO: try catch over all this
@@ -227,9 +225,9 @@ class PacketTunnelProvider: NEPacketTunnelProvider {
         }
         
         if (error != nil) {
-            completionHandler!(try? JSONEncoder().encode(IPCResponse.init(type: .error, message: JSON(error?.localizedDescription ?? "Unknown error"))))
+            return try? JSONEncoder().encode(IPCResponse.init(type: .error, message: JSON(error?.localizedDescription ?? "Unknown error")))
         } else {
-            completionHandler!(try? JSONEncoder().encode(IPCResponse.init(type: .success, message: data)))
+            return try? JSONEncoder().encode(IPCResponse.init(type: .success, message: data))
         }
     }
     

ios/NebulaNetworkExtension/Site.swift

@@ -489,6 +489,8 @@ struct IncomingSite: Codable {
         // Stuff our details in the protocol
         let proto = manager.protocolConfiguration as? NETunnelProviderProtocol ?? NETunnelProviderProtocol()
         proto.providerBundleIdentifier = "net.defined.mobileNebula.NebulaNetworkExtension";
+        // WARN: If we stop setting providerConfiguration["id"] here, we'll need to use something else to match
+        // managers in PacketTunnelProvider.findManager
         proto.providerConfiguration = ["id": self.id]
         proto.serverAddress = "Nebula"