python-csr/README.md

# python-csr
## Purpose
Generate a key, self-signed certificate, and certificate request.

## Information
You'll notice there is a csrgen and csrgen35. This corresponds to their respective Python versions.
- csrgen uses Python 2.7
- csrgen34 uses Python 3.5

## Installation / Dependencies
The following modules are required:
- OpenSSL (pyopenssl)
- Argparse (argparse)
- YAML (pyyaml)

I've included a setup.py that will install these dependencies if you run:
```
python setup.py install
```

## Usage
csrgen [fqdn]

```
python csrgen -n test.test.com
```

When more than one hostname is provided, a SAN (Subject Alternate Name)
certificate and request are generated.  This can be acheived by adding a -s.

csrgen <hostname> -s <san0> <san1>

```
python csrgen -n test.test.com -s mushu.test.com pushu.test.com
```

# TODO
- Consolidate Python 2.7 & 3.5
- For CLI (not -f), ensure a -n is provided or "fail" gracefully.
- Have the C, ST, L, O, OU stored in a .conf file and ask if
   these are the settings the user wants to use before running.
- Turn this into a Class.
Initial commit 2015-01-20 18:25:58 +00:00			`# python-csr`
Update README.md Just updating some information and clearing up formatting 2017-03-22 00:56:58 +00:00			`## Purpose`
Update README.md 2015-06-15 00:59:10 +00:00			`Generate a key, self-signed certificate, and certificate request.`
Update README.md 2015-06-15 00:59:24 +00:00
Update README.md Just updating some information and clearing up formatting 2017-03-22 00:56:58 +00:00			`## Information`
			`You'll notice there is a csrgen and csrgen35. This corresponds to their respective Python versions.`
			`- csrgen uses Python 2.7`
			`- csrgen34 uses Python 3.5`

Adding setup.py and updated to accept -f flag. x Adding a setup.py for installing dependencies. I had an issue with none of the modules being installed. The message thrown is clear, but I'd like to just run a setup.py install. x Adding -f flag. It allows users to create a .yaml file for multiple nodes/sans and will create a csr/key for each. 2017-08-09 23:15:27 +00:00			`## Installation / Dependencies`
			`The following modules are required:`
			`- OpenSSL (pyopenssl)`
			`- Argparse (argparse)`
			`- YAML (pyyaml)`

			`I've included a setup.py that will install these dependencies if you run:`
			```
Updating README.md 2017-08-10 05:28:02 +00:00			`python setup.py install`
Adding setup.py and updated to accept -f flag. x Adding a setup.py for installing dependencies. I had an issue with none of the modules being installed. The message thrown is clear, but I'd like to just run a setup.py install. x Adding -f flag. It allows users to create a .yaml file for multiple nodes/sans and will create a csr/key for each. 2017-08-09 23:15:27 +00:00			```

Update README.md Just updating some information and clearing up formatting 2017-03-22 00:56:58 +00:00			`## Usage`
			`csrgen [fqdn]`
Update README.md 2015-06-15 01:00:14 +00:00
Updating README 2015-07-13 17:10:04 +00:00			```
Updating README.md 2017-08-10 05:28:02 +00:00			`python csrgen -n test.test.com`
Updating README 2015-07-13 17:10:04 +00:00			```
Update README.md Just updating some information and clearing up formatting 2017-03-22 00:56:58 +00:00
Update README.md 2015-06-15 00:59:10 +00:00			`When more than one hostname is provided, a SAN (Subject Alternate Name)`
Update README.md Just updating some information and clearing up formatting 2017-03-22 00:56:58 +00:00			`certificate and request are generated. This can be acheived by adding a -s.`
Update README.md 2015-06-15 00:59:24 +00:00
Update README.md Just updating some information and clearing up formatting 2017-03-22 00:56:58 +00:00			`csrgen <hostname> -s <san0> <san1>`
Update README.md 2015-06-15 01:00:14 +00:00
Updating README 2015-07-13 17:10:04 +00:00			```
Updating README.md 2017-08-10 05:28:02 +00:00			`python csrgen -n test.test.com -s mushu.test.com pushu.test.com`
Updating README 2015-07-13 17:10:04 +00:00			```
Updating README.md 2017-08-10 05:28:02 +00:00
			`# TODO`
			`- Consolidate Python 2.7 & 3.5`
			`- For CLI (not -f), ensure a -n is provided or "fail" gracefully.`
			`- Have the C, ST, L, O, OU stored in a .conf file and ask if`
			`these are the settings the user wants to use before running.`
			`- Turn this into a Class.`