Skip to main content

Automatically populate rdp file from ec2 instance and put the password in the clipboard

Project description

https://travis-ci.org/jtvsoftwares/ec2rdp.svg?branch=master https://coveralls.io/repos/github/jtvsoftwares/ec2rdp/badge.svg?branch=master

Summary

Simple command line utility to decrypt the password of an AWS EC2 windows instance, put the decrypted password in the clipboard and write an rdp file to access the AWS EC2 windows instance.

Install

pip install ec2rdp

Usage

ec2rdp [-h] [-o OUTPUT] [-k KEY] [-q] [--aws-profile AWS_PROFILE]
       [--aws-access-key-id AWS_ACCESS_KEY_ID]
       [--aws-secret-access-key AWS_SECRET_ACCESS_KEY]
       [--aws-region AWS_REGION]
       instance-id

positional arguments:
  instance-id           The instance-id to decrypt the password.

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        The path for the rdp file to be created.
  -k KEY, --key KEY     The path to the private key file to decrypt the
                        password.
  -q, --quick           The script will not ask for the passphrase for the key
                        file.
  --aws-profile AWS_PROFILE
                        The profile name for aws credentials
  --aws-access-key-id AWS_ACCESS_KEY_ID
                        The access key id for aws
  --aws-secret-access-key AWS_SECRET_ACCESS_KEY
                        The secret access key for aws
  --aws-region AWS_REGION
                        The region for aws

AWS Credentials

The script will look for credentials to AWS in the following locations:

  • AWS_PROFILE environment variable with credentials set in either ~/.aws/credentials or ~/.aws/config. When using this, --aws-region must be set, ~/.aws/config must contain a region value for the profile or AWS_DEFAULT_REGION must be set.
  • AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY environment variables. When using this, --aws-region must be set or AWS_DEFAULT_REGION must be set.
  • --aws-profile command line option. When using this, --aws-region must be set, ~/.aws/config must contain a region value for the profile or AWS_DEFAULT_REGION must be set.
  • --aws-access-key-id, --aws-secret-access-key command line options. When using this, --aws-region must be set or AWS_DEFAULT_REGION must be set.

Key in AWS Config file

If you are using the same key for all the AWS EC2 Windows instances available from a profile, you can set the path to the key file in the ~/.aws/config file. To do so, add a ec2rdp_key entry with the path to the key file under the profile.

Example:

[profile profile1]
output = json
region = us-west-1
ec2rdp_key = ~/keys/profile1.pem

Project details


Release history Release notifications

This version
History Node

1.0.1

History Node

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
ec2rdp-1.0.1-py2.py3-none-any.whl (6.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Mar 13, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page