Skip to content

Latest commit

 

History

History
76 lines (55 loc) · 3.53 KB

README.md

File metadata and controls

76 lines (55 loc) · 3.53 KB

complex_password - Creates a random and complex password with rules

Synopsis

  • Ansible module to randomly generate a complex and strong password that match sets of rules.

Parameters

Parameter Choices/Defaults Comments
length
integer
Default:
12
The number of characters in the generated password.
The length must be between 1 and 128 characters.
min_upper_case
integer
Default:
2
The minimum number of uppercase letters of European languages (A through Z) in the newly generated password.
To exclude upper case characters from the password, specify -1.
min_lower_case
integer
Default:
2
The minimum number of lowercase letters of European languages (a through z) in the newly generated password.
To exclude lower case characters from the password, specify -1.
min_digit
integer
Default:
2
The minimum number of characters from base 10 digits (0 through 9) in the newly generated password.
To exclude digits from the password, specify -1.
min_special
integer
Default:
2
The minimum number of non-alphanumeric characters (special characters) in the newly generated password.
To exclude special characters from the password, specify -1.
special_characters
string
Default:
/*!\"$%()=?{[]}+#-.,<'_:;>~|@
A string containing all special characters allowed to use.
forbidden_characters
string
The characters that cannot be used when generating a new password, e.g /~\.
prevent_repeating_characters
boolean
Choices:
  • no
  • yes ←
Whether or not characters can be used more than once in a password.

Examples

- hosts: localhost

  roles:
    - role: complex_password

  tasks:

    - name: generate a complex password
      complex_password:
        length: 14
        min_upper_case: 3
        min_lower_case: 2
        min_digit: 1
        min_special: 4
        special_characters: '+-'
        prevent_repeating_characters: no

    - name: debug message
      debug:
        var: complex_password

    - name: generate a complex password
      complex_password:
        length: 14
        min_upper_case: 5
        min_lower_case: -1
        min_digit: 3
        min_special: 1
        forbidden_chars: aA0
      register: my_complex_password

    - name: debug message
      debug:
        var: my_complex_password.ansible_facts.complex_password

Return Values

Facts returned by this module are added/updated in the hostvars host facts and can be referenced by name just like any other host fact. They do not need to be registered in order to use them.

Fact Returned Description
complex_password
string
success A string containing the password in plain text.

Authors

  • Stéphane Bilqué (@sbilque)

License

This project is licensed under the Apache 2.0 License.

See LICENSE to see the full text.