Ansible role to manage ATOS Hardware Security Module (HSM) client software
Go to file
jiangzhilin c9f757de68 setup.cfg: Replace dashes with underscores
Setuptools v54.1.0 introduces a warning that the use of dash-separated
options in 'setup.cfg' will not be supported in a future version [1].
Get ahead of the issue by replacing the dashes with underscores. Without
this, we see 'UserWarning' messages like the following on new enough
versions of setuptools:

  UserWarning: Usage of dash-separated 'description-file' will not be
  supported in future versions. Please use the underscore name
  'description_file' instead

[1] https://github.com/pypa/setuptools/commit/a2e9ae4cb

Change-Id: I1a0ce7526a0f6c84ace786a80f5344fc5d626f0d
2021-05-04 07:39:29 +00:00
defaults Document role variables and defaults 2019-01-11 12:12:26 -06:00
handlers Add HA (load balancing) support 2020-02-04 09:48:42 -06:00
releasenotes/notes Add HA (load balancing) support 2020-02-04 09:48:42 -06:00
tasks Fix linter 2021-01-12 09:07:20 -07:00
templates Add HA (load balancing) support 2020-02-04 09:48:42 -06:00
zuul.d Add gate config 2019-03-05 23:37:52 -06:00
.ansible-lint Fix linter 2021-01-12 09:07:20 -07:00
.gitreview OpenDev Migration Patch 2019-04-19 19:33:14 +00:00
AUTHORS Add AUTHORS file. 2019-01-04 11:13:55 -06:00
LICENSE Initial commit 2019-01-04 10:51:40 -06:00
README.rst Add HA (load balancing) support 2020-02-04 09:48:42 -06:00
requirements.txt Add files for Python build 2019-01-04 15:22:03 -05:00
setup.cfg setup.cfg: Replace dashes with underscores 2021-05-04 07:39:29 +00:00
setup.py Add files for Python build 2019-01-04 15:22:03 -05:00
test-requirements.txt Add HA (load balancing) support 2020-02-04 09:48:42 -06:00
tox.ini Add gate config 2019-03-05 23:37:52 -06:00
vars.yaml.sample Add HA (load balancing) support 2020-02-04 09:48:42 -06:00

README.rst

atos-hsm

A role to manage ATOS Hardware Security Module (HSM) client software.

Role Variables

Name Default Value Description
atos_client_working_dir /tmp/atos_client_install Working directory in the target host.
atos_client_iso_name None Filename for the ATOS Client Software ISO.
atos_client_iso_location None Full URL where a copy of ATOS Client ISO can be downloaded.
atos_client_cert_location None Full URL where the client certificate can be downloaded.
atos_client_key_location None Full URL where the client key can be downloaded.
atos_hsms None List of one or more HSM devices.

Requirements

  • ansible >= 2.4

Usage

You'll need to set up a temporary HTTP server somewhere that is accessible to the node where this role will be applied. The HTTP server should serve the following:

  • ATOS Client Software ISO file.
  • HSM Server Certificate file(s).
  • HSM Client Certificate file.
  • HSM Client Key file associated with the Client Certificate.

Due to the sensitive nature of the Certificate and Key files, you should use TLS encryption and username and passwords to access the HTTP server.

Use the hostname and user/password for your HTTP server for the full URL values that need to be set for this role. See vars.yaml.example.