const { PUTTY_VALUE_FLAGS, isElectronNoiseArg, parseHostSpec, parsePort, toDeepLinkUrl, } = require("./puttyCommandLine.cjs"); const SSH_PROTOCOL = "ssh"; const TELNET_PROTOCOL = "telnet"; // SecureCRT-style protocol switches, e.g. `/SSH2 /L user /P 22 /PASSWORD pass // host` (case-insensitive). 4A / PAM bastion launchers that let the operator // pick a "SecureCRT" client emit exactly this shape, so Netcatty accepts it // and funnels the result through the same ssh:// deep-link queue as PuTTY-style // argv (#3390). const PROTOCOL_FLAGS = new Map([ ["/ssh", SSH_PROTOCOL], ["/ssh1", SSH_PROTOCOL], ["/ssh2", SSH_PROTOCOL], ["/telnet", TELNET_PROTOCOL], ]); // Protocol switches Netcatty cannot map to a connection; bail out instead of // silently connecting over a different transport. const UNSUPPORTED_PROTOCOL_FLAGS = new Set([ "/serial", "/rlogin", "/tapi", ]); // Switches whose next argv token is a value. Most are accepted but ignored: // Netcatty has no SecureCRT session database, identity file, auth-method or // logging concept, so a 4A line that carries them still connects via the host. const VALUE_FLAGS = new Set([ "/l", // login username "/p", // port "/password", // Consumed and ignored: "/auth", // keyboard-interactive | password | publickey | gssapi | tacacs "/i", // identity (private key) file path "/passphrase", "/s", // saved SecureCRT session name "/n", // tab name "/titlebar", // window title "/log", "/logappend", "/firewall", "/fwfirewall", "/proxy", ]); const PORT_FLAGS = new Set(["/p"]); const USERNAME_FLAGS = new Set(["/l"]); const PASSWORD_FLAGS = new Set(["/password"]); const IGNORED_VALUE_FLAGS = new Set([ "/auth", "/i", "/passphrase", "/s", "/n", "/titlebar", "/log", "/logappend", "/firewall", "/fwfirewall", "/proxy", ]); // Standalone switches (no separate value token). const SKIP_FLAGS = new Set([ "/t", // open in a tab; /N supplies the tab name "/new", "/x", "/c", "/v", "/a", "/z", ]); const PASSWORD_REDACT_FLAGS = new Set(["/password", "/passphrase"]); function normalizeFlag(arg) { return typeof arg === "string" ? arg.toLowerCase() : ""; } function hasSecureCrtLaunchSignal(argv) { if (!Array.isArray(argv)) return false; for (let index = 1; index < argv.length; index += 1) { const flag = normalizeFlag(argv[index]); if (PROTOCOL_FLAGS.has(flag) || PASSWORD_REDACT_FLAGS.has(flag)) return true; if (VALUE_FLAGS.has(flag) || PUTTY_VALUE_FLAGS.has(argv[index])) index += 1; } return false; } // Identify every known option operand before validating values, so an early // parse failure cannot turn a later option value into a standalone scheme URL. // Skip operands: a password equal to "/L" is data, not another switch. function findOperandIndices(argv) { const operandIndices = new Set(); const credentialIndices = new Set(); for (let index = 0; index < argv.length; index += 1) { const flag = normalizeFlag(argv[index]); if (!VALUE_FLAGS.has(flag) || typeof argv[index + 1] !== "string") continue; operandIndices.add(index + 1); if (PASSWORD_REDACT_FLAGS.has(flag) || USERNAME_FLAGS.has(flag)) { credentialIndices.add(index + 1); } index += 1; } return { operandIndices, credentialIndices }; } // Consumed indices include positionals only on success. Operand indices remain // valid on failure and must always be excluded from standalone URL scanning. function parseSecureCrtCommandLineTokens(argv) { if (!Array.isArray(argv) || !hasSecureCrtLaunchSignal(argv)) return null; let protocol = SSH_PROTOCOL; let username; let password; let port; let tabName; const positionals = []; const consumedIndices = new Set(); const { operandIndices, credentialIndices } = findOperandIndices(argv); const fail = () => ({ result: null, consumedIndices, operandIndices, credentialIndices }); for (let index = 0; index < argv.length; index += 1) { const arg = argv[index]; if (typeof arg !== "string" || !arg) continue; const flag = normalizeFlag(arg); if (UNSUPPORTED_PROTOCOL_FLAGS.has(flag)) return fail(); const protocolFromFlag = PROTOCOL_FLAGS.get(flag); if (protocolFromFlag) { protocol = protocolFromFlag; consumedIndices.add(index); continue; } if (SKIP_FLAGS.has(flag)) { consumedIndices.add(index); continue; } if (VALUE_FLAGS.has(flag)) { const value = argv[index + 1]; if (typeof value !== "string") return fail(); consumedIndices.add(index); consumedIndices.add(index + 1); index += 1; if (PORT_FLAGS.has(flag)) { const parsedPort = parsePort(value); if (parsedPort === null) return fail(); port = parsedPort; continue; } if (USERNAME_FLAGS.has(flag)) { // `index` now points at the operand value (it was advanced above). credentialIndices.add(index); const nextUser = value.trim(); if (!nextUser) return fail(); username = nextUser; continue; } if (PASSWORD_FLAGS.has(flag)) { credentialIndices.add(index); if (value === "") return fail(); password = value; continue; } if (flag === "/n") { tabName = value.trim(); } if (!IGNORED_VALUE_FLAGS.has(flag) || !value.trim()) return fail(); continue; } // Only the executable and Electron development entry point are paths; // other slash-prefixed tokens are switches, including punctuated names. const isEntryPoint = index === 1 && /(?:^|[/\\])electron(?:\.exe)?$/i.test(argv[0]) && /\.(?:js|cjs|mjs|asar)$/i.test(arg); if (index > 0 && !isEntryPoint && arg.startsWith("/")) return fail(); if (/^[a-z][a-z0-9+.-]*:\/\//i.test(arg.trim())) continue; if (isElectronNoiseArg(arg, index, argv)) { consumedIndices.add(index); continue; } // Single-dash client switches are not part of SecureCRT syntax. // Do not silently reinterpret a mixed-protocol launch as SSH. if (arg.startsWith("-")) return fail(); const spec = parseHostSpec(arg); if (spec) { positionals.push(spec); consumedIndices.add(index); } } // A launch describes one destination. Do not guess between multiple hosts // and risk sending credentials to metadata or an unsupported option value. if (positionals.length !== 1) return fail(); const hostSpec = positionals[0]; const resolvedUsername = (username || hostSpec.username || "").trim() || undefined; const resolvedPort = port ?? hostSpec.port; const hostname = hostSpec.hostname; if (!hostname) return fail(); const url = toDeepLinkUrl({ protocol, username: resolvedUsername, password, hostname, port: resolvedPort, }); return { result: { protocol, url, hostname, ...(resolvedUsername ? { username: resolvedUsername } : {}), ...(password !== undefined ? { password } : {}), ...(resolvedPort ? { port: resolvedPort } : {}), ...(tabName ? { tabName } : {}), }, consumedIndices, operandIndices, credentialIndices, }; } function parseSecureCrtCommandLine(argv) { return parseSecureCrtCommandLineTokens(argv)?.result ?? null; } function redactSecureCrtCommandLinePasswords(argv) { if (!Array.isArray(argv)) return argv; for (let index = 0; index < argv.length; index += 1) { const flag = normalizeFlag(argv[index]); if (!VALUE_FLAGS.has(flag) && !PUTTY_VALUE_FLAGS.has(argv[index])) continue; const next = argv[index + 1]; if (typeof next !== "string") continue; if (PASSWORD_REDACT_FLAGS.has(flag)) { argv[index + 1] = "*".repeat(Math.min(next.length, 8)) || "********"; } index += 1; } return argv; } module.exports = { parseSecureCrtCommandLine, parseSecureCrtCommandLineTokens, redactSecureCrtCommandLinePasswords, };