ServerUserCreate/Readme.md

# AWS User Creation

Two files to create new user entries with an SSH key and zip all the data for download

## Setup

The application **pwgen** and **zip** must be installed.

Checkout the scripts from git into the `/root/` folder or any other folder.
The folder holding the script must be owned by *root* and have *600* permissions

```sh
cd /root/
git clone https://git.tequila.jp/ScriptsCollections/AwsUserCreate.git users
chown root. users
chgrp 600 users
```

Alternate download: `git clone http://gitlab-ap.factory.tools/scripts-collections/aws-user-create.git users`

## Folders

Inside the base folder there are
* ssh-keygen for temporary holding the PEM/PUB files
* zip file which holds the created user list, password and PEM/PUB files

## Options

### -t (test)

Run in test mode. This will *NOT* create any groups or users. Nor will it create any ssh key files.
`user_password` output file will be written with `.TEST` extension

### -i (info)

Do not created anything at all, just print out info strings

## User list creation

In the `/root/users/` folder there needs to be a file called '*user_list.txt*'

This is a CSV type file with the following layout

ID | Username | Group | Optional Password | Override host name | Override ssh key type
-|-|-|-|-|-

The ID, Username and Group column must be filled.
For sub groups add them with a *,* The first group is the master group
If the password column is filled, the string from here will be used as the PEM Key password.
If a override hostname is set it will be used instead of `hostname`
If the ssh key type is set, it will override the default *ed25519* type. This is not recommended. Only *rsa* is allowed. This is for setting up backwards compatible lists.

The ID can be any string in any form.
It can also be left empty. It is not used at the moment

The file can hold comments. The first character in the line must be a *#*

Example file
```
user1;some.name;group-a;;hostname
user2;othername;group-a;;
# I am a comment
;username;groupC;setpassword;
...
```

### User with existing PEM key

If we want to create a user that already has a PEM key or we want to have the user use the same PEM key for login we can copy the existing pub key into the ssh key folder `ssh-keygen-created-pub`

The public PEM key file format is as followed

**hostname**#**main group name**#**user name**#**ssh key type**.pem.pub

In the example above for *user1* the file name would be for **some.name** and **group-a**

`hostname#group-a#some.name#ssh-keytype.pem.pub`

Copy this file into the ssh-keygen folder and add the user to the '*user_list.txt*' file.
This must be with the same name and group as set in the PEM public key.

Example:

PEM public key file is `hostname#Bgroup#foobar#ed25519.pem.pub`
Then the line for the '*user_list.txt*' must be

`[some user id];foobar;Bgroup;;`

Note that *[some user id]* can be any string or left empty

## Script run

The current directory **MUST** be the directory where '*user_list.txt*' is stored.

`$> cd /root/users`

Then run the script without any options

`$> /root/bin/user_create.sh`

Sample output for above example file
```
++ Create 'some.name:group-a'
 > Create ssh key-pair '/root/users/ssh-keygen/hostname#group-a#some.name#ed25519.pem'
Generating public/private rsa key pair.
Your identification has been saved in /root/users/ssh-keygen/hostname#group-a#some.name#ed25519.pem.
Your public key has been saved in /root/users/ssh-keygen/hostname#group-a#some.name#ed25519.pem.pub.
The key fingerprint is:
SHA256:Ufalh41IRLJTHZlsaEJVK5N7cOYhxRdqf3fCDxhHdCA egrp10070.globalad.org: some.name@group-a
The key's randomart image is:
+---[RSA 3072]----+
|       .o+O*E=*o.|
|        .Bo=B@.. |
|        +oB.&.+  |
|         o @ O   |
|        S . + = +|
|           .   =o|
|                .|
|                 |
|                 |
+----[SHA256]-----+
 > Create .ssh folder
 > Add public into authorized_keys
 > Secure folder .ssh and authorized_keys file
```

If the public pem file is already provided the output will be a bit different
```
++ Create 'some.name:group-a'
 < Use existing public ssh key '/root/users/ssh-keygen/hostname#group-a#some.name#ed25519.pem.pub'
 > Create .ssh folder
 > Add public into authorized_keys
 > Secure folder .ssh and authorized_keys file
```

There is no SSH key generate output but *Use existing public ssh key* information line

If the user has been created, the creating will be skipped
```
-- Skip 'some.name:group-a'
```

## Script output

The generated users and the passwords are stored in the '*user_password.YYYYMMDD-hhmmss.txt*' file

For above the output will be
```
2020-11-27 13:51:01;sever.hostname.org;hostname;some.name;Aeh9uph8Oo
2020-11-27 13:51:02;sever.hostname.org;;othername;AePejoo9ch
2020-11-27 13:51:02;sever.hostname.org;;username;setpassword
```

Note that the *sever.hostname.org* is set from the hostname of the server where the script is run
The name *hostname* is set if the hostname field in hser `user_list.txt` file is set

If a existing pem public key is used, the entry for a new user will be
```
2020-11-27 13:53:18;sever.hostname.org;;some.name;[ALREADY SET]
```

Not that the password field has now *[ALREADY SET]*

## Get the user data

In the `zip/` folder there is a file named `users.YYYYMMDD-hhmmss.zip`;
This file should be copied localy and then removed from the server

**NOTE** Do not remove the public key data in `ssh-keygen-created-pub/` or the script will create new keys for users in the `user_list.txt` file

## SSH helper

change password or extract public key from pem file

### PEM key password reset

The SSH PEM key password can be reset or changed with

`$> ssh-keygen -p -f [PEM].pem -P old_passphrase -N new_passphrase`

To remove the password use this `-N ""`

**NOTE**

If the command is used like this it will be stored in the history file.
For scurity reason it is recommended to not give the -P and -N options when changing the password.

### Missing PUB key

The public key part can be extracted from the SSH PEM key with

`$> ssh-keygen -y -f [PEM].pem > [PEM].pem.pub`

*[PEM]* is the placeholder for the filename