# Keypairs

## Generate new keypair

This operation creates a new keypair under a provided name; the public key value is automatically generated for you.

    $keypair = $service->keypair();

    $keypair->create(array(
       'name' => 'jamie_keypair_1'
    ));

    echo $keypair->getPublicKey();

    // Save private key to a file so you can use it to SSH into
    // your server later.
    $sshPrivateKeyFilename = 'jamie_keypair_1_rsa';
    $privateKey = $keypair->getPrivateKey();
    file_put_contents($sshPrivateKeyFilename, $privateKey);
    chmod($sshPrivateKeyFilename, 0600);

## Upload existing keypair

This operation creates a new keypair under a provided name using a provided public key value. This public key will probably exist on your local filesystem, and so provide easy access to your server when uploaded.

    $keypair = $service->keypair();

    $key = <<<EOT
    ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDx8nkQv/zgGgB4rMYmIf+6A4l6Rr+o/6lHBQdW5aYd44bd8JttDCE/F/pNRr0lRE+PiqSPO8nDPHw0010JeMH9gYgnnFlyY3/OcJ02RhIPyyxYpv9FhY+2YiUkpwFOcLImyrxEsYXpD/0d3ac30bNH6Sw9JD9UZHYcpSxsIbECHw== Example public key
    EOT;

    $keypair->create(array(
       'name'      => 'jamie_macbook',
       'publicKey' => $key
    ));

## List keypairs

To list all existing keypairs:

    $keys = $service->listKeypairs();

    foreach ($keys as $key) {
       // ...
    }

For more information about iterators, please see the docs.

## Delete keypairs

To delete a specific keypair:

    $keypair->delete();

## Creating a server with a keypair

In order to spawn an instance with a saved keypair (allowing you to SSH in without passwords), you create your server using the same operation as usual, with one extra parameter:

    use Guzzle\Http\Exception\BadResponseException;
    use OpenCloud\Compute\Constants\Network;

    $server = $compute->server();

    try {
        $response = $server->create(array(
            'name'     => 'New server',
            'image'    => $ubuntuImage,
            'flavor'   => $twoGbFlavor,
            'networks' => array(
                $compute->network(Network::RAX_PUBLIC),
                $compute->network(Network::RAX_PRIVATE)
            ),
            'keypair' => 'jamie_macbook'
        ));
    } catch (BadResponseException $e) {
       // error...
    }

So, as you can see, you specify the name of an existing keypair that you previously created on the API.