yadro.tatlin_uni.tatlin_sp_ssl module – Set storage SSL certificate

Note

This module is part of the yadro.tatlin_uni collection (version 1.0.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install yadro.tatlin_uni.

To use it in a playbook, specify: yadro.tatlin_uni.tatlin_sp_ssl.

New in version 1.0.0: of yadro.tatlin_uni

Synopsis

  • This module is intended to set SSL certificate

  • This module supports check mode

Parameters

Parameter

Comments

connection

dictionary / required

connection describes Tatlin Storage Processor (SP) connection configuration.

Only session connection supported.

Authorization is executed automatically with corresponding endpoint. ‘auth/login’ by default.

Client receives x-auth-token and uses it for following requests.

base_url

string / required

Tatlin REST API entrypoint.

password

string

Tatlin user password.

timeout

integer

Tatlin REST API request timeout.

Default: 60

username

string

Tatlin username to login.

validate_certs

boolean

Responsible for SSL certificates validation.

If set to False certificates won’t validated.

Choices:

  • no

  • yes ← (default)

crt_content

string

Content of SSL certificate

crt_path

string

Path to file with SSL certificate

key_content

string

Content of private key

key_path

string

Path to file with private key

Notes

Note

  • One of following options are required - crt_path or crt_content, key_path or key_content

Examples

---
- name: Upload certificate from path
  yadro.tatlin_uni.tatlin_sp_ssl:
    connection: "{{ connection }}"
    crt_path: /etc/ssl/certs/testssl.pem
    key_path: /etc/ssl/private/testssl.key

- name: Test upload SSL certificate | Upload certificate from content
  yadro.tatlin_uni.tatlin_sp_ssl:
    connection: "{{ connection }}"
    crt_content: |
      -----BEGIN CERTIFICATE-----
      MIIFuzCCA6OgAwIBAgIU...
      -----END CERTIFICATE-----
    key_content: |
      -----BEGIN PRIVATE KEY-----
      MIIJQwIBADANBgkqhkiG9w...
      -----END PRIVATE KEY-----

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

error

string

Error details if raised

Returned: on error

msg

string

Operation status message

Returned: always

Authors

  • Sergey Kovalev (@kvlvs)