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 https://img.shields.io/badge/license-MIT-blue.svg https://img.shields.io/badge/python-2.7-blue.svg https://img.shields.io/badge/python-3.5-blue.svg https://img.shields.io/badge/python-3.6-blue.svg

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


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

ec2rdp-1.0.0-py2.py3-none-any.whl (6.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page