summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/md5.yml
blob: c97870d08619118262adba6c389adf4b232969bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
DOCUMENTATION:
  name: md5
  version_added: "historical"
  short_description: MD5 hash of input data
  description:
    - Returns an L(MD5 hash, https://en.wikipedia.org/wiki/MD5) of the input data
  positional: _input
  notes:
    - This requires the MD5 algorithm to be available on the system, security contexts like FIPS might prevent this.
    - MD5 has long been deemed insecure and is not recommended for security related uses.
  options:
    _input:
      description: data to hash
      type: raw
      required: true

EXAMPLES: |
    # md5hash => "ae2b1fca515949e5d54fb22b8ed95575"
    md5hash: "{{ 'testing' | md5 }}"

RETURN:
  _value:
    description: The MD5 hash of the input.
    type: string