% KEY-MANAGEMENT(1) Version 3.0.1 | Scripts Documentation
% Georg Voell - georg.voell@oracle.com
% (c)2020 Oracle

NAME
====

**key-management** - (BASH Script) Manage the ssh keys.

SYNOPSIS
========

| **key-management** \[_options_] _action_ \[_format_] 

DESCRIPTION
===========

Manage the ssh keys.

Options
-------

-h, \--help                       

:  Displays helptext.

-v, \--version                    

:  Displays the version of the script.

-u, \--username _string_          

:  Name of user e.g. "name@org.com".

-p, \--passphrase _string_        

:  Passphrase for key encryption.

Action
-------

create                    

:  Create private and public keypair for ssh and putty.

delete                    

:  Delete all the keys for user specified by username.

copy _destination_        

:  Copy keys to destination (could be "user@hostname" or IP e.g. "opc@130.61.219.239").

install                   

:  Install management software.

list                      

:  List all local user with keys.

show _format_             

:  Display keys or fingerprint. Allowed values: "pub", "ssh", "api", "pk8", "ppk" and 'fp'.

Format
-------

pub        

:  Display ssh public key.

ssh        

:  Display ssh private key.

api        

:  Display public key in PEM format (OCI API key).

pk8        

:  Display private key in PEM format (PKCS#8).

ppk        

:  Display putty private key (PPK).

fp         

:  Display fingerprint of private key.


EXAMPLES
========

**key-management** create \--username "opc"

: Create keys for user "opc"

**key-management** list

: Show all user (which have keys created with this tool)

**key-management** show api \--username "opc"

: Display OCI API public key in PEM format.

**key-management** show ssh \--username "opc"

: Display ssh private key.

**key-management** show fp \--username "opc"

: Display fingerprint for ssh private key (needed by OCI).


EXIT CODES
==========

01: Unknown or wrong parameter.

02: No username specified.

03: Error while creating keys.

04: Key (or user) does not exist.

05: Could not copy keys to destination.

99: User interrupt.


SEE ALSO
========

**install-scripts**(1)