feat: support RDP-specific deep links

Author: ethanndickson

Coder-Desktop/Coder-Desktop/URLHandler.swift

@@ -20,20 +20,65 @@ class URLHandler {
         guard deployment.host() == url.host else {
             throw .invalidAuthority(url.host() ?? "<none>")
         }
+        let route: CoderRoute
         do {
-            switch try router.match(url: url) {
-            case let .open(workspace, agent, type):
-                switch type {
-                case let .rdp(creds):
-                    handleRDP(workspace: workspace, agent: agent, creds: creds)
-                }
-            }
+            route = try router.match(url: url)
         } catch {
             throw .matchError(url: url)
         }
 
-        func handleRDP(workspace _: String, agent _: String, creds _: RDPCredentials) {
-            // TODO: Handle RDP
+        switch route {
+        case let .open(workspace, agent, type):
+            switch type {
+            case let .rdp(creds):
+                try handleRDP(workspace: workspace, agent: agent, creds: creds)
+            }
+        }
+    }
+
+    private func handleRDP(workspace: String, agent: String, creds: RDPCredentials) throws(URLError) {
+        guard vpn.state == .connected else {
+            throw .openError(.coderConnectOffline)
+        }
+
+        guard let workspace = vpn.menuState.findWorkspace(name: workspace) else {
+            throw .openError(.invalidWorkspace(workspace: workspace))
+        }
+
+        guard let agent = vpn.menuState.findAgent(workspaceID: workspace.id, name: agent) else {
+            throw .openError(.invalidAgent(workspace: workspace.name, agent: agent))
+        }
+
+        var rdpString = "rdp:full address=s:\(agent.primaryHost):3389"
+        if let username = creds.username {
+            rdpString += "&username=s:\(username)"
+        }
+        guard let url = URL(string: rdpString) else {
+            throw .openError(.couldNotCreateRDPURL(rdpString))
+        }
+
+        let alert = NSAlert()
+        alert.messageText = "Opening RDP"
+        alert.informativeText = "Connecting to \(agent.primaryHost)."
+        if let username = creds.username {
+            alert.informativeText += "\nUsername: \(username)"
+        }
+        if creds.password != nil {
+            alert.informativeText += "\nThe password will be copied to your clipboard."
+        }
+
+        alert.alertStyle = .informational
+        alert.addButton(withTitle: "Open")
+        alert.addButton(withTitle: "Cancel")
+        let response = alert.runModal()
+        if response == .alertFirstButtonReturn {
+            if let password = creds.password {
+                NSPasteboard.general.clearContents()
+                NSPasteboard.general.setString(password, forType: .string)
+            }
+            NSWorkspace.shared.open(url)
+        } else {
+            // User cancelled
         }
     }
 }

Coder-Desktop/Coder-Desktop/VPN/MenuState.swift

@@ -58,6 +58,15 @@ struct VPNMenuState {
     // or have any invalid UUIDs.
     var invalidAgents: [Vpn_Agent] = []
 
+    public func findAgent(workspaceID: UUID, name: String) -> Agent? {
+        agents.first(where: { $0.value.wsID == workspaceID && $0.value.name == name })?.value
+    }
+
+    public func findWorkspace(name: String) -> Workspace? {
+        workspaces
+            .first(where: { $0.value.name == name })?.value
+    }
+
     mutating func upsertAgent(_ agent: Vpn_Agent) {
         guard
             let id = UUID(uuidData: agent.id),

Coder-Desktop/VPNLib/CoderRouter.swift

@@ -32,15 +32,40 @@ public enum RouterError: Error {
     case invalidAuthority(String)
     case matchError(url: URL)
     case noSession
+    case openError(OpenError)
 
-    public var description: String {
+    var description: String {
         switch self {
         case let .invalidAuthority(authority):
             "Authority '\(authority)' does not match the host of the current Coder deployment."
         case let .matchError(url):
             "Failed to handle \(url.absoluteString) because the format is unsupported."
         case .noSession:
             "Not logged in."
+        case let .openError(error):
+            error.description
+        }
+    }
+
+    var localizedDescription: String { description }
+}
+
+public enum OpenError: Error {
+    case invalidWorkspace(workspace: String)
+    case invalidAgent(workspace: String, agent: String)
+    case coderConnectOffline
+    case couldNotCreateRDPURL(String)
+
+    public var description: String {
+        switch self {
+        case let .invalidWorkspace(ws):
+            "Could not find workspace '\(ws)'. Does it exist?"
+        case .coderConnectOffline:
+            "Coder Connect must be running."
+        case let .invalidAgent(workspace: workspace, agent: agent):
+            "Could not find agent '\(agent)' in workspace '\(workspace)'. Is the workspace running?"
+        case let .couldNotCreateRDPURL(rdpString):
+            "Could not create construct RDP url from '\(rdpString)'."
         }
     }