-
Notifications
You must be signed in to change notification settings - Fork 513
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
Enhancing Security configuration steps #8058
Enhancing Security configuration steps #8058
Conversation
Thank you for submitting your PR. The PR states are In progress (or Draft) -> Tech review -> Doc review -> Editorial review -> Merged. Before you submit your PR for doc review, make sure the content is technically accurate. If you need help finding a tech reviewer, tag a maintainer. When you're ready for doc review, tag the assignee of this PR. The doc reviewer may push edits to the PR directly or leave comments and editorial suggestions for you to address (let us know in a comment if you have a preference). The doc reviewer will arrange for an editorial review. |
Hi @cwperks @shikharj05 @stephen-crawford, The documentation team needs a technical review of this security PR, with approval from you. Do one of you have capacity to take on this task? Turnaround time is by end of day Friday, 8/23. Thank you. |
@leanneeliatra Please see tech reviewer's feedback. Once these comments are addressed, please tag me to request tech reviewer approval. Thank you. |
Signed-off-by: [email protected] <[email protected]>
Addressing comments. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@leanneeliatra @vagimeli @Naarcha-AWS Please see my comments and changes and tag me for approval once addressed (I'd like to verify lines 16 and 26). Thanks!
Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: leanneeliatra <[email protected]>
Signed-off-by: [email protected] <[email protected]>
… the text, as is the standard (not to have hyperlinked headings). Signed-off-by: [email protected] <[email protected]>
@natebower I have completed all suggested updates and throughly reviewed the page in light of so many changes. I also added a toc to the bottom of the page with all relevant links, as there is a lot of information on the page this is helpful. If you do not agree with that one, I can remove it. Thank you for the thorough review. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@Naarcha-AWS @leanneeliatra Please see my comments and changes and tag me for approval once addressed. Thanks!
_security/configuration/index.md
Outdated
redirect_from: | ||
- /security-plugin/configuration/ | ||
- /security-plugin/configuration/index/ | ||
--- | ||
|
||
# Security configuration | ||
|
||
The plugin includes demo certificates so that you can get up and running quickly. To use OpenSearch in a production environment, you must configure it manually: | ||
The plugin includes demo certificates so that you can get up and running quickly. To use OpenSearch in a production environment, you must configure it manually. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"The plugin" => "The Security plugin"? In the second sentence, does "it" refer to OpenSearch or to "the plugin"?
_security/configuration/index.md
Outdated
plugins.security.ssl.http.pemkey_filepath: /path/to/your/key.pem | ||
plugins.security.ssl.http.pemtrustedcas_filepath: /path/to/your/ca.pem | ||
``` | ||
For more information, see [Configuring TLS certificates. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For more information, see [Configuring TLS certificates. | |
For more information, see [Configuring TLS certificates |
_security/configuration/index.md
Outdated
plugins.security.ssl.http.pemtrustedcas_filepath: /path/to/your/ca.pem | ||
``` | ||
For more information, see [Configuring TLS certificates. | ||
]({{site.url}}{{site.baseurl}}/security/configuration/tls/) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
]({{site.url}}{{site.baseurl}}/security/configuration/tls/) | |
]({{site.url}}{{site.baseurl}}/security/configuration/tls/). |
Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@Naarcha-AWS LGTM with edited suggestions. Thanks!
Signed-off-by: Naarcha-AWS <[email protected]>
* wip building out the security configuration steps Signed-off-by: [email protected] <[email protected]> * adding relevant links to docs. Signed-off-by: [email protected] <[email protected]> * adding further info to security settings Signed-off-by: [email protected] <[email protected]> * reviewdog issues fixed Signed-off-by: [email protected] <[email protected]> * paths given for 1.0 securityadmin Signed-off-by: [email protected] <[email protected]> * Reconfiguring layout Signed-off-by: [email protected] <[email protected]> * updating security configuraton Signed-off-by: [email protected] <[email protected]> * Update _security/configuration/index.md Co-authored-by: Craig Perkins <[email protected]> Signed-off-by: leanneeliatra <[email protected]> * Updates for examples given in config doc. Signed-off-by: [email protected] <[email protected]> Signed-off-by: [email protected] <[email protected]> * Add doc review Signed-off-by: Naarcha-AWS <[email protected]> * Update index.md Signed-off-by: Naarcha-AWS <[email protected]> * Delete _security/configuration/test Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Made the securityadmin.sh backup tool instructions clearer Signed-off-by: [email protected] <[email protected]> Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Update _security/configuration/index.md Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * updating the command for the securityadmin tool Signed-off-by: [email protected] <[email protected]> * reviewdog updates Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: leanneeliatra <[email protected]> * removing headings as links Signed-off-by: [email protected] <[email protected]> * Updating headings to be headings and adding extra links at the end of the text, as is the standard (not to have hyperlinked headings). Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> * Update index.md Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> --------- Signed-off-by: [email protected] <[email protected]> Signed-off-by: leanneeliatra <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> Co-authored-by: Craig Perkins <[email protected]> Co-authored-by: Melissa Vagi <[email protected]> Co-authored-by: Naarcha-AWS <[email protected]> Co-authored-by: Nathan Bower <[email protected]> (cherry picked from commit 9230b00) Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
* wip building out the security configuration steps Signed-off-by: [email protected] <[email protected]> * adding relevant links to docs. Signed-off-by: [email protected] <[email protected]> * adding further info to security settings Signed-off-by: [email protected] <[email protected]> * reviewdog issues fixed Signed-off-by: [email protected] <[email protected]> * paths given for 1.0 securityadmin Signed-off-by: [email protected] <[email protected]> * Reconfiguring layout Signed-off-by: [email protected] <[email protected]> * updating security configuraton Signed-off-by: [email protected] <[email protected]> * Update _security/configuration/index.md Co-authored-by: Craig Perkins <[email protected]> Signed-off-by: leanneeliatra <[email protected]> * Updates for examples given in config doc. Signed-off-by: [email protected] <[email protected]> Signed-off-by: [email protected] <[email protected]> * Add doc review Signed-off-by: Naarcha-AWS <[email protected]> * Update index.md Signed-off-by: Naarcha-AWS <[email protected]> * Delete _security/configuration/test Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Made the securityadmin.sh backup tool instructions clearer Signed-off-by: [email protected] <[email protected]> Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Update _security/configuration/index.md Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * updating the command for the securityadmin tool Signed-off-by: [email protected] <[email protected]> * reviewdog updates Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: leanneeliatra <[email protected]> * removing headings as links Signed-off-by: [email protected] <[email protected]> * Updating headings to be headings and adding extra links at the end of the text, as is the standard (not to have hyperlinked headings). Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> * Update index.md Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> --------- Signed-off-by: [email protected] <[email protected]> Signed-off-by: leanneeliatra <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> Co-authored-by: Craig Perkins <[email protected]> Co-authored-by: Melissa Vagi <[email protected]> Co-authored-by: Naarcha-AWS <[email protected]> Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Noah Staveley <[email protected]>
* wip building out the security configuration steps Signed-off-by: [email protected] <[email protected]> * adding relevant links to docs. Signed-off-by: [email protected] <[email protected]> * adding further info to security settings Signed-off-by: [email protected] <[email protected]> * reviewdog issues fixed Signed-off-by: [email protected] <[email protected]> * paths given for 1.0 securityadmin Signed-off-by: [email protected] <[email protected]> * Reconfiguring layout Signed-off-by: [email protected] <[email protected]> * updating security configuraton Signed-off-by: [email protected] <[email protected]> * Update _security/configuration/index.md Co-authored-by: Craig Perkins <[email protected]> Signed-off-by: leanneeliatra <[email protected]> * Updates for examples given in config doc. Signed-off-by: [email protected] <[email protected]> Signed-off-by: [email protected] <[email protected]> * Add doc review Signed-off-by: Naarcha-AWS <[email protected]> * Update index.md Signed-off-by: Naarcha-AWS <[email protected]> * Delete _security/configuration/test Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Made the securityadmin.sh backup tool instructions clearer Signed-off-by: [email protected] <[email protected]> Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Update _security/configuration/index.md Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> * updating the command for the securityadmin tool Signed-off-by: [email protected] <[email protected]> * reviewdog updates Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: leanneeliatra <[email protected]> * removing headings as links Signed-off-by: [email protected] <[email protected]> * Updating headings to be headings and adding extra links at the end of the text, as is the standard (not to have hyperlinked headings). Signed-off-by: [email protected] <[email protected]> * Apply suggestions from code review Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> * Update index.md Signed-off-by: Naarcha-AWS <[email protected]> * Apply suggestions from code review Signed-off-by: Naarcha-AWS <[email protected]> --------- Signed-off-by: [email protected] <[email protected]> Signed-off-by: leanneeliatra <[email protected]> Signed-off-by: Naarcha-AWS <[email protected]> Co-authored-by: Craig Perkins <[email protected]> Co-authored-by: Melissa Vagi <[email protected]> Co-authored-by: Naarcha-AWS <[email protected]> Co-authored-by: Nathan Bower <[email protected]> Signed-off-by: Noah Staveley <[email protected]>
Description
Expanding on the Security Configuration steps listed
https://opensearch.org/docs/latest/security/configuration/index/
Issues Resolved
#7881
Version
all
Frontend features
Checklist
For more information on following Developer Certificate of Origin and signing off your commits, please check here.