Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

windows: updated docs to include info regarding https validation #34128

Merged
merged 2 commits into from
Jan 3, 2018

Conversation

jborean93
Copy link
Contributor

SUMMARY

Updated Windows docs to contain more information regarding the latest pywinrm release.

ISSUE TYPE
  • Docs Pull Request
COMPONENT NAME

windows docs

ANSIBLE VERSION
2.5

@ansibot ansibot added affects_2.5 This issue/PR affects Ansible v2.5 docs_pull_request needs_triage Needs a first human triage before being processed. support:core This issue/PR relates to code supported by the Ansible Engineering Team. labels Dec 21, 2017
Copy link
Contributor

@dharmabumstead dharmabumstead left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few edit requests. Thanks @jborean93!

One of the more common ways of setting up a HTTPS listener in a domain
environment is to use Active Directory Certificate Service (AD CS). AD CS is
used by Active Directory to sign certificate requests that are sent to it and
then issue a certificate from the csr. The issuer certificate of the AD CS
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Explain what a “CSR” is. In general, define abbreviations on first use and then you can just use the abbreviation (capitalized, please) for subsequent mentions.


This file can either contain the single issuer certificate or multiple
certificates. To then use this file as part of the valiation process, set
``ansible_winrm_ca_trust_path`` to the path of the. If this value is not set
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please either remove the word “which” or add parenthesis around that part of the sentence so it makes it easier to understand.

the `certifi <https://github.com/certifi/python-certifi>`_ package is used.

.. Note:: Each HTTP call is done by the Python requests library which does not
use the systems built in certificate store as a trust authority.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

“system’s built-in”

@ansibot ansibot added the needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. label Dec 21, 2017
@jborean93
Copy link
Contributor Author

Thanks @dharmabumstead, I've made a few edits around some of the sentences so it is ready for review again.

@jborean93 jborean93 removed the needs_triage Needs a first human triage before being processed. label Dec 21, 2017
@ansibot ansibot added stale_ci This PR has been tested by CI more than one week ago. Close and re-open this PR to get it retested. stale_review Updates were made after the last review and the last review is more than 7 days old. labels Dec 31, 2017
@ansibot ansibot removed stale_ci This PR has been tested by CI more than one week ago. Close and re-open this PR to get it retested. stale_review Updates were made after the last review and the last review is more than 7 days old. labels Jan 3, 2018
@jborean93 jborean93 merged commit 278663a into ansible:devel Jan 3, 2018
@jborean93 jborean93 deleted the win-https-docs branch January 3, 2018 22:47
@ansibot ansibot added docs This issue/PR relates to or includes documentation. and removed docs_pull_request labels Mar 4, 2018
@dagwieers dagwieers added the windows Windows community label Feb 11, 2019
@ansible ansible locked and limited conversation to collaborators Apr 26, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
affects_2.5 This issue/PR affects Ansible v2.5 docs This issue/PR relates to or includes documentation. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. support:core This issue/PR relates to code supported by the Ansible Engineering Team. windows Windows community
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants