Prior to any compute provisioning, it is important to create access to keys that will be configured by default to any provisioned metal for easy, default authentication.
Equinix provides documentation for key generation here: https://metal.equinix.com/developers/docs/accounts/ssh-keys/ For ease of use with this guide some basic instructions will be provided below. For alternative methods or more information refer to the preceding link.
By default server deployment will add all available project and user SSH keys to the server. You can specify specific keys during deployment if desired. They do require at least one user key--so generate a user key in addition to any "project" level keys you create.
Generating an SSH Key
There are a variety of ways to create keys (for more examples refer to Equinix documentation), for this guide we will use Putty keygen.
If Putty is not installed do so, then launch puttygen:
Click Generate and follow the instructions.
First, save the private key as a ppk file. Save the public key as well. Now copy what is in the public key window.
ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAkqWkkmKMlVqcVbm/UK1fXp14NxS9aXr18+7f2yFQFt79CDJ3z8Y+vco+7wBJ+fZmyByIRQ0ZCtdwNJPq6XNNJaAksIPZdLpjWUKJCF81GEJQEd0dpXZ1zXRtjAZOw07P/BafdwnK6mrOFibOTAqnZx0fKdY3rMzWraoBn6aHJzexKZtWdxq8Y1gtx10DIYGxEvTYOv+2MVvGupqSCSuFIXdMHNQPwnWreJM27uv7nb/o78UXo76HdL8qkJOD+nhgc38KpRKzHm/AVWmFvsL7ZADhexhBba+XCZusKXBhge0xZWMplZfkOvfTT9SPblCbfvRKBOf//1h5XslbOMC1iw== pure-eqx-project
And login to the Equinix console.
Adding an SSH Key to Equinix
Click on Project Settings then SSH Keys then + Add Key:
Enter in a name for the key and then paste the public key into the panel.
You can choose to select pre-existing devices to associate the key with--note though that this WILL NOT provide immediate access to those systems with this key. You will need to manually add the key into the server's authenticated key file to provide access. This process is only automated for new server deployments.
Connecting to SOS Console with SSH Keys
Once a server has been provisioned, Equinix provides a mechanism to connect to the console of an offline (from the network) server via SSH keys.
Navigate to the Equinix Console and choose the desired server and then click Out of Band Console:
Copy the line.
To use this in Putty, open Putty and paste it into the host name line. REMOVE ssh from the beginning.
Now navigate to Connection > SSH > Auth and clock on Browse and choose your desired key.
Go back to Session and enter in a name for saved sessions and click Save.
You can now connect to the SOS console.