From 897f86561f8341bf7db2dead4c71899c43afe9f2 Mon Sep 17 00:00:00 2001 From: Luke Short Date: Thu, 7 Sep 2017 22:52:25 -0400 Subject: [PATCH] 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 --- docs/docsite/rst/intro_windows.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/docsite/rst/intro_windows.rst b/docs/docsite/rst/intro_windows.rst index 1e639c1abc..5962d64bdc 100644 --- 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 ++++++++