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

Add hot reload TLS certificate section #433 #6875

Merged

Conversation

AntonEliatra
Copy link
Contributor

Description

Adding a section outlining TLS certificate Hot Reloading API

Issues Resolved

Part of #433

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
Contributor

@stephen-crawford stephen-crawford left a comment

Choose a reason for hiding this comment

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

Looks good to me

@Naarcha-AWS Naarcha-AWS added 4 - Doc review PR: Doc review in progress and removed 3 - Tech review PR: Tech review in progress labels Apr 10, 2024
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
Co-authored-by: Naarcha-AWS <[email protected]>
Signed-off-by: AntonEliatra <[email protected]>
@hdhalter hdhalter changed the title adding hot reload TLS certificate section #433 Add hot reload TLS certificate section #433 Apr 15, 2024
@Naarcha-AWS Naarcha-AWS added 5 - Editorial review PR: Editorial review in progress and removed 4 - Doc review PR: Doc review in progress labels Apr 17, 2024
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.

@AntonEliatra @Naarcha-AWS Please see my comments and changes and let me know if you have any questions. Thanks!

_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved
_security/configuration/tls.md Outdated Show resolved Hide resolved

After enabling hot reloading, use the Reload Certificates API to replace the expired certification. The API expects the old certificates to be replaced with valid certificates issued with the same `Issuer/Subject DN` and `SAN`. The new certificates also need be in the same location as the previous certificates, in order to prevent any changes to `opensearch.yml` file.

Only a [super admin]({{site.url}}{{site.baseurl}}/security/configuration/tls/#configuring-admin-certificates) can use the Reload Certificates API.
Copy link
Collaborator

Choose a reason for hiding this comment

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

We've been using this as one word. I'll add it to the style guide/Vale if I haven't already.

{: .note }

### Reload TLS certificates on the transport layer
The following example reloads TLS certificates on the transport layer:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Let's add the noun after "example".


### Reload TLS certificates on the http layer

The following example reloads TLS certificates on the `http` layer:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Let's add the noun after "example".

AntonEliatra and others added 2 commits April 17, 2024 17:02
Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: AntonEliatra <[email protected]>
Signed-off-by: AntonEliatra <[email protected]>
@Naarcha-AWS Naarcha-AWS added the backport 2.13 PR: Backport label for 2.13 label Apr 17, 2024
@Naarcha-AWS Naarcha-AWS merged commit fa38567 into opensearch-project:main Apr 18, 2024
5 checks passed
opensearch-trigger-bot bot pushed a commit that referenced this pull request Apr 18, 2024
* adding hot reload TLS certificate section #433

Signed-off-by: AntonEliatra <[email protected]>

* fixing issues on hot reload #433

Signed-off-by: AntonEliatra <[email protected]>

* Update tls.md

Signed-off-by: AntonEliatra <[email protected]>

* Apply suggestions from code review

Co-authored-by: Naarcha-AWS <[email protected]>
Signed-off-by: AntonEliatra <[email protected]>

* Apply suggestions from code review

Co-authored-by: Nathan Bower <[email protected]>
Signed-off-by: AntonEliatra <[email protected]>

* Update tls.md

Signed-off-by: AntonEliatra <[email protected]>

---------

Signed-off-by: AntonEliatra <[email protected]>
Co-authored-by: Naarcha-AWS <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>
(cherry picked from commit fa38567)
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
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.13 PR: Backport label for 2.13 security
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants