document the required variables for using Windows certificates (#29112)

* document the required variables for using certificates when authenticating to Windows * clarify that certificates are for local (non-domain) users
7 years ago · 897f86561f
parent 4e759a9cce
commit 897f86561f
1 changed files with 5 additions and 1 deletions
--- a/docs/docsite/rst/intro_windows.rst
+++ b/docs/docsite/rst/intro_windows.rst
@ -94,8 +94,12 @@ You can specify which authentication option you wish to use by setting it to the
 Certificate
 +++++++++++

-Certificate authentication is similar to SSH where a certificate is assigned to a local user and instead of using a password to authenticate a certificate is used instead.
+Certificate authentication is similar to SSH because it uses both a public and private key to access a local Windows user account. This removes the need for using a password.

+This requires two variables that specify the path to both the PEM file containing the certificate (cert_pem) and the related private key file (cert_key_pem).
+
+    ansible_winrm_cert_pem:
+    ansible_winrm_cert_key_pem:

 Kerberos
 ++++++++