mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
267 lines
8.4 KiB
Python
267 lines
8.4 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
#
|
|
# (c) 2015, René Moser <mail@renemoser.net>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['stableinterface'],
|
|
'supported_by': 'community'}
|
|
|
|
|
|
DOCUMENTATION = '''
|
|
---
|
|
module: cs_sshkeypair
|
|
short_description: Manages SSH keys on Apache CloudStack based clouds.
|
|
description:
|
|
- Create, register and remove SSH keys.
|
|
- If no key was found and no public key was provided and a new SSH
|
|
private/public key pair will be created and the private key will be returned.
|
|
author: René Moser (@resmo)
|
|
options:
|
|
name:
|
|
description:
|
|
- Name of public key.
|
|
type: str
|
|
required: true
|
|
domain:
|
|
description:
|
|
- Domain the public key is related to.
|
|
type: str
|
|
account:
|
|
description:
|
|
- Account the public key is related to.
|
|
type: str
|
|
project:
|
|
description:
|
|
- Name of the project the public key to be registered in.
|
|
type: str
|
|
state:
|
|
description:
|
|
- State of the public key.
|
|
type: str
|
|
default: present
|
|
choices: [ present, absent ]
|
|
public_key:
|
|
description:
|
|
- String of the public key.
|
|
type: str
|
|
extends_documentation_fragment:
|
|
- community.general.cloudstack
|
|
|
|
'''
|
|
|
|
EXAMPLES = '''
|
|
- name: create a new private / public key pair
|
|
cs_sshkeypair:
|
|
name: linus@example.com
|
|
delegate_to: localhost
|
|
register: key
|
|
- debug:
|
|
msg: 'Private key is {{ key.private_key }}'
|
|
|
|
- name: remove a public key by its name
|
|
cs_sshkeypair:
|
|
name: linus@example.com
|
|
state: absent
|
|
delegate_to: localhost
|
|
|
|
- name: register your existing local public key
|
|
cs_sshkeypair:
|
|
name: linus@example.com
|
|
public_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
|
|
delegate_to: localhost
|
|
'''
|
|
|
|
RETURN = '''
|
|
---
|
|
id:
|
|
description: UUID of the SSH public key.
|
|
returned: success
|
|
type: str
|
|
sample: a6f7a5fc-43f8-11e5-a151-feff819cdc9f
|
|
name:
|
|
description: Name of the SSH public key.
|
|
returned: success
|
|
type: str
|
|
sample: linus@example.com
|
|
fingerprint:
|
|
description: Fingerprint of the SSH public key.
|
|
returned: success
|
|
type: str
|
|
sample: "86:5e:a3:e8:bd:95:7b:07:7c:c2:5c:f7:ad:8b:09:28"
|
|
private_key:
|
|
description: Private key of generated SSH keypair.
|
|
returned: changed
|
|
type: str
|
|
sample: "-----BEGIN RSA PRIVATE KEY-----\nMII...8tO\n-----END RSA PRIVATE KEY-----\n"
|
|
'''
|
|
|
|
import traceback
|
|
|
|
SSHPUBKEYS_IMP_ERR = None
|
|
try:
|
|
import sshpubkeys
|
|
HAS_LIB_SSHPUBKEYS = True
|
|
except ImportError:
|
|
SSHPUBKEYS_IMP_ERR = traceback.format_exc()
|
|
HAS_LIB_SSHPUBKEYS = False
|
|
|
|
from ansible.module_utils.basic import AnsibleModule, missing_required_lib
|
|
from ansible.module_utils._text import to_native
|
|
from ansible_collections.community.general.plugins.module_utils.cloudstack import (
|
|
AnsibleCloudStack,
|
|
cs_required_together,
|
|
cs_argument_spec
|
|
)
|
|
|
|
|
|
class AnsibleCloudStackSshKey(AnsibleCloudStack):
|
|
|
|
def __init__(self, module):
|
|
super(AnsibleCloudStackSshKey, self).__init__(module)
|
|
self.returns = {
|
|
'privatekey': 'private_key',
|
|
'fingerprint': 'fingerprint',
|
|
}
|
|
self.ssh_key = None
|
|
|
|
def register_ssh_key(self, public_key):
|
|
ssh_key = self.get_ssh_key()
|
|
args = self._get_common_args()
|
|
name = self.module.params.get('name')
|
|
|
|
res = None
|
|
if not ssh_key:
|
|
self.result['changed'] = True
|
|
args['publickey'] = public_key
|
|
if not self.module.check_mode:
|
|
args['name'] = name
|
|
res = self.query_api('registerSSHKeyPair', **args)
|
|
else:
|
|
fingerprint = self._get_ssh_fingerprint(public_key)
|
|
if ssh_key['fingerprint'] != fingerprint:
|
|
self.result['changed'] = True
|
|
if not self.module.check_mode:
|
|
# delete the ssh key with matching name but wrong fingerprint
|
|
args['name'] = name
|
|
self.query_api('deleteSSHKeyPair', **args)
|
|
|
|
elif ssh_key['name'].lower() != name.lower():
|
|
self.result['changed'] = True
|
|
if not self.module.check_mode:
|
|
# delete the ssh key with matching fingerprint but wrong name
|
|
args['name'] = ssh_key['name']
|
|
self.query_api('deleteSSHKeyPair', **args)
|
|
# First match for key retrievement will be the fingerprint.
|
|
# We need to make another lookup if there is a key with identical name.
|
|
self.ssh_key = None
|
|
ssh_key = self.get_ssh_key()
|
|
if ssh_key and ssh_key['fingerprint'] != fingerprint:
|
|
args['name'] = name
|
|
self.query_api('deleteSSHKeyPair', **args)
|
|
|
|
if not self.module.check_mode and self.result['changed']:
|
|
args['publickey'] = public_key
|
|
args['name'] = name
|
|
res = self.query_api('registerSSHKeyPair', **args)
|
|
|
|
if res and 'keypair' in res:
|
|
ssh_key = res['keypair']
|
|
|
|
return ssh_key
|
|
|
|
def create_ssh_key(self):
|
|
ssh_key = self.get_ssh_key()
|
|
if not ssh_key:
|
|
self.result['changed'] = True
|
|
args = self._get_common_args()
|
|
args['name'] = self.module.params.get('name')
|
|
if not self.module.check_mode:
|
|
res = self.query_api('createSSHKeyPair', **args)
|
|
ssh_key = res['keypair']
|
|
return ssh_key
|
|
|
|
def remove_ssh_key(self, name=None):
|
|
ssh_key = self.get_ssh_key()
|
|
if ssh_key:
|
|
self.result['changed'] = True
|
|
args = self._get_common_args()
|
|
args['name'] = name or self.module.params.get('name')
|
|
if not self.module.check_mode:
|
|
self.query_api('deleteSSHKeyPair', **args)
|
|
return ssh_key
|
|
|
|
def _get_common_args(self):
|
|
return {
|
|
'domainid': self.get_domain('id'),
|
|
'account': self.get_account('name'),
|
|
'projectid': self.get_project('id')
|
|
}
|
|
|
|
def get_ssh_key(self):
|
|
if not self.ssh_key:
|
|
public_key = self.module.params.get('public_key')
|
|
if public_key:
|
|
# Query by fingerprint of the public key
|
|
args_fingerprint = self._get_common_args()
|
|
args_fingerprint['fingerprint'] = self._get_ssh_fingerprint(public_key)
|
|
ssh_keys = self.query_api('listSSHKeyPairs', **args_fingerprint)
|
|
if ssh_keys and 'sshkeypair' in ssh_keys:
|
|
self.ssh_key = ssh_keys['sshkeypair'][0]
|
|
# When key has not been found by fingerprint, use the name
|
|
if not self.ssh_key:
|
|
args_name = self._get_common_args()
|
|
args_name['name'] = self.module.params.get('name')
|
|
ssh_keys = self.query_api('listSSHKeyPairs', **args_name)
|
|
if ssh_keys and 'sshkeypair' in ssh_keys:
|
|
self.ssh_key = ssh_keys['sshkeypair'][0]
|
|
return self.ssh_key
|
|
|
|
def _get_ssh_fingerprint(self, public_key):
|
|
key = sshpubkeys.SSHKey(public_key)
|
|
if hasattr(key, 'hash_md5'):
|
|
return key.hash_md5().replace(to_native('MD5:'), to_native(''))
|
|
return key.hash()
|
|
|
|
|
|
def main():
|
|
argument_spec = cs_argument_spec()
|
|
argument_spec.update(dict(
|
|
name=dict(required=True),
|
|
public_key=dict(),
|
|
domain=dict(),
|
|
account=dict(),
|
|
project=dict(),
|
|
state=dict(choices=['present', 'absent'], default='present'),
|
|
))
|
|
|
|
module = AnsibleModule(
|
|
argument_spec=argument_spec,
|
|
required_together=cs_required_together(),
|
|
supports_check_mode=True
|
|
)
|
|
|
|
if not HAS_LIB_SSHPUBKEYS:
|
|
module.fail_json(msg=missing_required_lib("sshpubkeys"), exception=SSHPUBKEYS_IMP_ERR)
|
|
|
|
acs_sshkey = AnsibleCloudStackSshKey(module)
|
|
state = module.params.get('state')
|
|
if state in ['absent']:
|
|
ssh_key = acs_sshkey.remove_ssh_key()
|
|
else:
|
|
public_key = module.params.get('public_key')
|
|
if public_key:
|
|
ssh_key = acs_sshkey.register_ssh_key(public_key)
|
|
else:
|
|
ssh_key = acs_sshkey.create_ssh_key()
|
|
|
|
result = acs_sshkey.get_result(ssh_key)
|
|
module.exit_json(**result)
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|