misc/win_certauth.py at master · JayPearlman/misc · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
#!/usr/bin/python
# -*- coding: utf-8 -*-

# Copyright: (c) 2018, Jay Pearlman
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)

ANSIBLE_METADATA = {'metadata_version': '1.0',
                    'status': ['preview'],
                    'supported_by': 'community'}

DOCUMENTATION = r'''
---
module: win_certauth
version_added: '2.5'
short_description: Issues pending CA cert
description:
- Issues a requested pending cert from a Certificate Authority
options:
  caconfig:
    description:
    - A valid configuration string for the certification authority.
    - 'Example: COMPUTERNAME\CANAME'
    required: yes
  requestid:
    - Specifies the ID of the request to resubmit.
    - 'Example: 1234'
    required: yes
notes:
- The module requires the requestid to be in a pending state.
author:
- Jay Pearlman (@jaypearlman)
'''

EXAMPLES = r'''
- name: Approve / Issue pending certificate 1234
  win_certauth:
    caconfig: 'ca.contoso.com\MyCA'
    requestid: 1234
'''

RETURN = r'''
msg:
    description: changed
    returned: always
    type: boolean
    sample: True
disposition_of_request:
    description: The possible outcomes of the request
    returned: success
    type: string
    sample: The certificate was issued.
disposition_rc:
    description: The return code of the request
    returned: success
    type: int
    sample: 3
'''