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

Enhancing Security configuration steps #8058

Conversation

leanneeliatra
Copy link
Contributor

@leanneeliatra leanneeliatra commented Aug 20, 2024

Description

Expanding on the Security Configuration steps listed
https://opensearch.org/docs/latest/security/configuration/index/

Issues Resolved

#7881

Version

all

Frontend features

Checklist

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license and subject to the Developers Certificate of Origin.
    For more information on following Developer Certificate of Origin and signing off your commits, please check here.

Copy link

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.

@vagimeli
Copy link
Contributor

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.

@vagimeli
Copy link
Contributor

@leanneeliatra Please see tech reviewer's feedback. Once these comments are addressed, please tag me to request tech reviewer approval. Thank you.

@vagimeli vagimeli added 3 - Tech review PR: Tech review in progress 2 - In progress Issue/PR: The issue or PR is in progress. labels Aug 20, 2024
@leanneeliatra leanneeliatra changed the title [DRAFT] Enhancing Security configuration steps Enhancing Security configuration steps Aug 21, 2024
@leanneeliatra
Copy link
Contributor Author

Addressing comments.

Copy link
Collaborator

@natebower natebower left a 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!

_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
@natebower natebower removed the 6 - Done but waiting to merge PR: The work is done and ready to merge label Sep 17, 2024
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]>
@leanneeliatra
Copy link
Contributor Author

@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.

Copy link
Collaborator

@natebower natebower left a 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!

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.
Copy link
Collaborator

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 Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
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.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
For more information, see [Configuring TLS certificates.
For more information, see [Configuring TLS certificates

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/)
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
]({{site.url}}{{site.baseurl}}/security/configuration/tls/)
]({{site.url}}{{site.baseurl}}/security/configuration/tls/).

_security/configuration/index.md Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
Naarcha-AWS and others added 2 commits September 19, 2024 07:24
Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Copy link
Collaborator

@natebower natebower left a 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!

_security/configuration/index.md Outdated Show resolved Hide resolved
_security/configuration/index.md Outdated Show resolved Hide resolved
@Naarcha-AWS Naarcha-AWS added the backport 2.17 Backport for version 2.17 label Sep 19, 2024
@Naarcha-AWS Naarcha-AWS merged commit 9230b00 into opensearch-project:main Sep 19, 2024
6 checks passed
opensearch-trigger-bot bot pushed a commit that referenced this pull request Sep 19, 2024
* 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>
noahstaveley pushed a commit to noahstaveley/documentation-website that referenced this pull request Sep 23, 2024
* 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]>
noahstaveley pushed a commit to noahstaveley/documentation-website that referenced this pull request Sep 23, 2024
* 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]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
5 - Editorial review PR: Editorial review in progress backport 2.17 Backport for version 2.17
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants