SSH connections with Go

  • Go
  • Gabriele Romanato

Secure Shell (SSH) is a cryptographic protocol widely used to establish a secure connection between two systems, allowing remote commands to be executed securely. Go, the programming language developed by Google, offers a wide range of libraries for managing network operations, including creating SSH connections efficiently.

In this guide, we will explore how to create an SSH connection using Go, using the "golang.org/x/crypto/ssh" library.

First of all, let's make sure we have Go installed on our system. Next, we create a directory for our project and initialize a new Go module:


mkdir ssh-go-example
cd ssh-go-example
go mod init ssh-go-example

We use the go get command to download the Go SSH library:


go get golang.org/x/crypto/ssh

Now, let's create a file called main.go in our project directory. Let's enter the following code to create a basic SSH connection:


package main

import (
    "fmt"
    "golang.org/x/crypto/ssh"
)

func main() {
    // SSH server address
    sshAddress := "your-ssh-server-address:22"
    // Username
    username := "your-username"
    // Password or private key (replace with your data)
    password := "your-password-or-private-key"

    // Configuration for authentication
    config := &ssh.ClientConfig{
        User: username,
        Auth: []ssh.AuthMethod{
            ssh.Password(password),
            // You can also use the private key:
            // ssh.PublicKeys(privateKey),
        },
        HostKeyCallback: ssh.InsecureIgnoreHostKey(), 
       // Ignore host key verification (NOT recommended for production use)
    }

    // Connection to the SSH server
    client, err := ssh.Dial("tcp", sshAddress, config)
    if err != nil {
        fmt.Println("Error connecting SSH:", err)
        return
    }
    defer client.Close()

    fmt.Println("SSH connection established successfully!")
    // You can now perform operations on the connection, such as executing remote commands.
}

Modify the sshAddress, username, and password variables in the code with your connection data. Be sure to provide a valid SSH address, username, and appropriate password or private key.

After customizing the code, run the program using the command:


go run main.go

If the SSH connection is established successfully, you will see the message "SSH connection established successfully!" printed on the console.

Conclusion

Creating an SSH connection with Go is quite simple using the "golang.org/x/crypto/ssh" library. This guide provides a foundation to get you started, but remember to manage keys securely in a production environment and follow best security practices.

Back to top