358 lines
11 KiB
JavaScript
358 lines
11 KiB
JavaScript
// server
|
|
// app/socket.js
|
|
|
|
import validator from 'validator'
|
|
import { EventEmitter } from 'events'
|
|
import { createNamespacedDebug } from './logger.js'
|
|
import { SSHConnectionError, handleError } from './errors.js'
|
|
|
|
import { isValidCredentials, maskSensitiveData, validateSshTerm } from './utils.js'
|
|
import { MESSAGES } from './constants.js'
|
|
|
|
const debug = createNamespacedDebug('socket')
|
|
|
|
class WebSSH2Socket extends EventEmitter {
|
|
/**
|
|
* Creates a new WebSSH2Socket instance
|
|
* @param {Object} socket - The Socket.IO socket instance
|
|
* @param {Object} config - The application configuration
|
|
* @param {Function} SSHConnectionClass - The SSH connection class constructor
|
|
*/
|
|
constructor(socket, config, SSHConnectionClass) {
|
|
super()
|
|
this.socket = socket
|
|
this.config = config
|
|
this.SSHConnectionClass = SSHConnectionClass
|
|
this.ssh = null
|
|
this.sessionState = {
|
|
authenticated: false,
|
|
username: null,
|
|
password: null,
|
|
privateKey: null,
|
|
passphrase: null,
|
|
host: null,
|
|
port: null,
|
|
term: null,
|
|
cols: null,
|
|
rows: null,
|
|
}
|
|
|
|
this.initializeSocketEvents()
|
|
}
|
|
|
|
initializeSocketEvents() {
|
|
debug(`io.on connection: ${this.socket.id}`)
|
|
|
|
if (
|
|
this.socket.handshake.session.usedBasicAuth &&
|
|
this.socket.handshake.session.sshCredentials
|
|
) {
|
|
const creds = this.socket.handshake.session.sshCredentials
|
|
debug(
|
|
`handleConnection: ${this.socket.id}, Host: ${creds.host}: HTTP Basic Credentials Exist, creds: %O`,
|
|
maskSensitiveData(creds)
|
|
)
|
|
this.handleAuthenticate(creds)
|
|
} else if (!this.sessionState.authenticated) {
|
|
// Check if interactive auth is disabled
|
|
if (this.config.ssh.disableInteractiveAuth) {
|
|
debug(`handleConnection: ${this.socket.id}, interactive auth disabled`)
|
|
this.handleError('Interactive Auth Disabled')
|
|
return
|
|
}
|
|
|
|
debug(`handleConnection: ${this.socket.id}, emitting request_auth`)
|
|
this.socket.emit('authentication', { action: 'request_auth' })
|
|
}
|
|
|
|
this.socket.on('authenticate', (creds) => {
|
|
this.handleAuthenticate(creds)
|
|
})
|
|
this.socket.on('terminal', (data) => {
|
|
this.handleTerminal(data)
|
|
})
|
|
this.socket.on('disconnect', (reason) => {
|
|
this.handleConnectionClose(reason)
|
|
})
|
|
}
|
|
|
|
handleKeyboardInteractive(data) {
|
|
const self = this
|
|
debug(`handleKeyboardInteractive: ${this.socket.id}, %O`, data)
|
|
|
|
// Send the keyboard-interactive request to the client
|
|
this.socket.emit(
|
|
'authentication',
|
|
Object.assign(
|
|
{
|
|
action: 'keyboard-interactive',
|
|
},
|
|
data
|
|
)
|
|
)
|
|
|
|
// Set up a one-time listener for the client's response
|
|
this.socket.once('authentication', (clientResponse) => {
|
|
const maskedclientResponse = maskSensitiveData(clientResponse, {
|
|
properties: ['responses'],
|
|
})
|
|
debug('handleKeyboardInteractive: Client response masked %O', maskedclientResponse)
|
|
if (clientResponse.action === 'keyboard-interactive') {
|
|
// Forward the client's response to the SSH connection
|
|
self.ssh.emit('keyboard-interactive-response', clientResponse.responses)
|
|
}
|
|
})
|
|
}
|
|
|
|
handleAuthenticate(creds) {
|
|
debug(`handleAuthenticate: ${this.socket.id}, %O`, maskSensitiveData(creds))
|
|
|
|
if (isValidCredentials(creds)) {
|
|
// Set term if provided, otherwise use config default
|
|
this.sessionState.term = validateSshTerm(creds.term) ? creds.term : this.config.ssh.term
|
|
|
|
this.initializeConnection(creds)
|
|
} else {
|
|
debug(`handleAuthenticate: ${this.socket.id}, CREDENTIALS INVALID`)
|
|
this.socket.emit('authentication', {
|
|
success: false,
|
|
message: 'Invalid credentials format',
|
|
})
|
|
}
|
|
}
|
|
|
|
initializeConnection(creds) {
|
|
debug(
|
|
`initializeConnection: ${this.socket.id}, INITIALIZING SSH CONNECTION: Host: ${creds.host}, creds: %O`,
|
|
maskSensitiveData(creds)
|
|
)
|
|
|
|
// Add private key from config if available and not provided in creds
|
|
if (this.config.user.privateKey && !creds.privateKey) {
|
|
creds.privateKey = this.config.user.privateKey
|
|
}
|
|
|
|
// Create new SSH connection instance
|
|
this.ssh = new this.SSHConnectionClass(this.config)
|
|
|
|
// Set up SSH event handlers
|
|
this.ssh.on("keyboard-interactive", data => {
|
|
this.handleKeyboardInteractive(data)
|
|
})
|
|
|
|
this.ssh
|
|
.connect(creds)
|
|
.then(() => {
|
|
this.sessionState = Object.assign({}, this.sessionState, {
|
|
authenticated: true,
|
|
username: creds.username,
|
|
password: creds.password,
|
|
privateKey: creds.privateKey,
|
|
passphrase: creds.passphrase,
|
|
host: creds.host,
|
|
port: creds.port,
|
|
})
|
|
|
|
const authResult = { action: 'auth_result', success: true }
|
|
this.socket.emit('authentication', authResult)
|
|
|
|
const permissions = {
|
|
autoLog: this.config.options.autoLog || false,
|
|
allowReplay: this.config.options.allowReplay || false,
|
|
allowReconnect: this.config.options.allowReconnect || false,
|
|
allowReauth: this.config.options.allowReauth || false,
|
|
}
|
|
this.socket.emit('permissions', permissions)
|
|
|
|
this.updateElement('footer', `ssh://${creds.host}:${creds.port}`)
|
|
|
|
if (this.config.header && this.config.header.text !== null) {
|
|
this.updateElement('header', this.config.header.text)
|
|
}
|
|
|
|
this.socket.emit('getTerminal', true)
|
|
})
|
|
.catch((err) => {
|
|
debug(
|
|
`initializeConnection: SSH CONNECTION ERROR: ${this.socket.id}, Host: ${creds.host}, Error: ${err.message}`
|
|
)
|
|
const errorMessage =
|
|
err instanceof SSHConnectionError ? err.message : 'SSH connection failed'
|
|
this.socket.emit('authentication', {
|
|
action: 'auth_result',
|
|
success: false,
|
|
message: errorMessage,
|
|
})
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Handles terminal data.
|
|
* @param {Object} data - The terminal data.
|
|
*/
|
|
handleTerminal(data) {
|
|
const { term, rows, cols } = data
|
|
if (term && validateSshTerm(term)) {
|
|
this.sessionState.term = term
|
|
}
|
|
if (rows && validator.isInt(rows.toString())) {
|
|
this.sessionState.rows = parseInt(rows, 10)
|
|
}
|
|
if (cols && validator.isInt(cols.toString())) {
|
|
this.sessionState.cols = parseInt(cols, 10)
|
|
}
|
|
|
|
this.createShell()
|
|
}
|
|
|
|
/**
|
|
* Creates a new SSH shell session.
|
|
*/
|
|
createShell() {
|
|
// Get envVars from socket session if they exist
|
|
const envVars = this.socket.handshake.session.envVars || null
|
|
|
|
this.ssh
|
|
.shell(
|
|
{
|
|
term: this.sessionState.term,
|
|
cols: this.sessionState.cols,
|
|
rows: this.sessionState.rows,
|
|
},
|
|
envVars
|
|
)
|
|
.then((stream) => {
|
|
stream.on('data', (data) => {
|
|
this.socket.emit('data', data.toString('utf-8'))
|
|
})
|
|
// stream.stderr.on("data", data => debug(`STDERR: ${data}`)) // needed for shell.exec
|
|
stream.on('close', (code, signal) => {
|
|
debug('close: SSH Stream closed')
|
|
this.handleConnectionClose(code, signal)
|
|
})
|
|
|
|
stream.on('end', () => {
|
|
debug('end: SSH Stream ended')
|
|
})
|
|
|
|
stream.on('error', (err) => {
|
|
debug('error: SSH Stream error %O', err)
|
|
})
|
|
|
|
this.socket.on('data', (data) => {
|
|
stream.write(data)
|
|
})
|
|
this.socket.on('control', (controlData) => {
|
|
this.handleControl(controlData)
|
|
})
|
|
this.socket.on('resize', (data) => {
|
|
this.handleResize(data)
|
|
})
|
|
})
|
|
.catch((err) => this.handleError('createShell: ERROR', err))
|
|
}
|
|
|
|
handleResize(data) {
|
|
const { rows, cols } = data
|
|
if (rows && validator.isInt(rows.toString())) {
|
|
this.sessionState.rows = parseInt(rows, 10)
|
|
}
|
|
if (cols && validator.isInt(cols.toString())) {
|
|
this.sessionState.cols = parseInt(cols, 10)
|
|
}
|
|
this.ssh.resizeTerminal(this.sessionState.rows, this.sessionState.cols)
|
|
}
|
|
|
|
/**
|
|
* Handles control commands.
|
|
* @param {string} controlData - The control command received.
|
|
*/
|
|
handleControl(controlData) {
|
|
if (validator.isIn(controlData, ['replayCredentials', 'reauth']) && this.ssh.stream) {
|
|
if (controlData === 'replayCredentials') {
|
|
this.replayCredentials()
|
|
} else if (controlData === 'reauth') {
|
|
this.handleReauth()
|
|
}
|
|
} else {
|
|
console.warn(`handleControl: Invalid control command received: ${controlData}`)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Replays stored credentials.
|
|
*/
|
|
replayCredentials() {
|
|
if (this.config.options.allowReplay && this.ssh.stream) {
|
|
this.ssh.stream.write(`${this.sessionState.password}\n`)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles reauthentication.
|
|
*/
|
|
handleReauth() {
|
|
if (this.config.options.allowReauth) {
|
|
this.clearSessionCredentials()
|
|
this.socket.emit('authentication', { action: 'reauth' })
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles errors.
|
|
* @param {string} context - The error context.
|
|
* @param {Error} err - The error object.
|
|
*/
|
|
handleError(context, err) {
|
|
const errorMessage = err ? `: ${err.message}` : ''
|
|
handleError(new SSHConnectionError(`SSH ${context}${errorMessage}`))
|
|
this.socket.emit('ssherror', `SSH ${context}${errorMessage}`)
|
|
this.handleConnectionClose()
|
|
}
|
|
|
|
/**
|
|
* Updates a UI element on the client side.
|
|
* @param {string} element - The element to update.
|
|
* @param {any} value - The new value for the element.
|
|
*/
|
|
updateElement(element, value) {
|
|
this.socket.emit('updateUI', { element, value })
|
|
}
|
|
|
|
/**
|
|
* Handles the closure of the connection.
|
|
* @param {string} reason - The reason for the closure.
|
|
*/
|
|
handleConnectionClose(code, signal) {
|
|
this.ssh.end()
|
|
debug(`handleConnectionClose: ${this.socket.id}, Code: ${code}, Signal: ${signal}`)
|
|
this.socket.disconnect(true)
|
|
}
|
|
|
|
/**
|
|
* Clears session credentials.
|
|
*/
|
|
clearSessionCredentials() {
|
|
if (this.socket.handshake.session.sshCredentials) {
|
|
this.socket.handshake.session.sshCredentials.username = null
|
|
this.socket.handshake.session.sshCredentials.password = null
|
|
}
|
|
this.socket.handshake.session.usedBasicAuth = false
|
|
this.sessionState.authenticated = false
|
|
this.sessionState.username = null
|
|
this.sessionState.password = null
|
|
|
|
this.socket.handshake.session.save((err) => {
|
|
if (err) {
|
|
console.error(
|
|
`clearSessionCredentials: ${MESSAGES.FAILED_SESSION_SAVE} ${this.socket.id}:`,
|
|
err
|
|
)
|
|
}
|
|
})
|
|
}
|
|
}
|
|
|
|
export default function (io, config, SSHConnectionClass) {
|
|
io.on('connection', (socket) => new WebSSH2Socket(socket, config, SSHConnectionClass))
|
|
}
|