summaryrefslogtreecommitdiffstats
path: root/lib/ansible/plugins/filter/md5.yml
diff options
context:
space:
mode:
Diffstat (limited to 'lib/ansible/plugins/filter/md5.yml')
-rw-r--r--lib/ansible/plugins/filter/md5.yml24
1 files changed, 24 insertions, 0 deletions
diff --git a/lib/ansible/plugins/filter/md5.yml b/lib/ansible/plugins/filter/md5.yml
new file mode 100644
index 0000000..c97870d
--- /dev/null
+++ b/lib/ansible/plugins/filter/md5.yml
@@ -0,0 +1,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