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 allowlist for more inclusive nomenclature #509

Merged
merged 6 commits into from
May 3, 2022

Conversation

Naarcha-AWS
Copy link
Collaborator

Signed-off-by: Naarcha-AWS [email protected]

Description

Replace whitelist with allowlist. Will add note about the reindex endpoint in the PR for #473 .

Issues Resolved

Fixes #449

Check List

  • Commits are signed per the DCO using --signoff

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

@Naarcha-AWS Naarcha-AWS requested a review from alicejw1 April 14, 2022 17:30
@Naarcha-AWS Naarcha-AWS requested a review from a team as a code owner April 14, 2022 17:30
@Naarcha-AWS Naarcha-AWS self-assigned this Apr 14, 2022
@@ -56,7 +56,7 @@ opensearch_security.multitenancy.enable_filter: false

Setting | Description
:--- | :---
`opensearch.requestHeadersWhitelist` | OpenSearch Dashboards requires that you whitelist all HTTP headers that it passes to OpenSearch. Multi-tenancy uses a specific header, `securitytenant`, that must be present with the standard `Authorization` header. If the `securitytenant` header is not whitelisted, OpenSearch Dashboards starts with a red status.
`opensearch.requestHeadersallowlist` | OpenSearch Dashboards requires that you allowlist all HTTP headers that it passes to OpenSearch. Multi-tenancy uses a specific header, `securitytenant`, that must be present with the standard `Authorization` header. If the `securitytenant` header is not allowlisted, OpenSearch Dashboards starts with a red status.
Copy link
Contributor

Choose a reason for hiding this comment

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

According to the style guide, I think we want to avoid using allow list as a verb, and that it should be two words.

Copy link
Contributor

@alicejw1 alicejw1 Apr 14, 2022

Choose a reason for hiding this comment

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

I noticed the style guide separates it for noun usage, but wiktionary still shows "allowlist" as a verb.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Switched to "If the securitytenant header is not on the allowlist, OpenSearch Dashboards starts with a red status."

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Switched to "If the securitytenant header is not on the allowlist, OpenSearch Dashboards starts with a red status."

@alicejw1
Copy link
Contributor

LGTM

Copy link
Contributor

@alicejw1 alicejw1 left a comment

Choose a reason for hiding this comment

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

LGTM

Signed-off-by: Naarcha-AWS <[email protected]>
_dashboards/branding.md Outdated Show resolved Hide resolved
@Naarcha-AWS Naarcha-AWS requested a review from keithhc2 April 25, 2022 21:21
Signed-off-by: Naarcha-AWS <[email protected]>
@Naarcha-AWS Naarcha-AWS requested a review from dblock April 25, 2022 21:23
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.

Having reviewed the AWS, Microsoft, and Google style guides, my thinking is that we should use "allow list" (two words) as a noun, per the AWS Style Guide (both Google and Microsoft use "allowlist," but we should probably align with the AWS Style Guide). With regard to using the term as a verb, Google explicitly prohibits this, and neither Microsoft nor AWS appear to provide specific guidance, so I think that we should avoid using the term as a verb and should instead rephrase relevant sentences.

Signed-off-by: Naarcha-AWS <[email protected]>
Signed-off-by: Naarcha-AWS <[email protected]>
Copy link
Contributor

@keithhc2 keithhc2 left a comment

Choose a reason for hiding this comment

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

Just some comments about using allow list as two words and a verb

_security-plugin/configuration/proxy.md Outdated Show resolved Hide resolved
_security-plugin/configuration/saml.md Outdated Show resolved Hide resolved
_security-plugin/configuration/saml.md Outdated Show resolved Hide resolved
_troubleshoot/saml.md Outdated Show resolved Hide resolved
_troubleshoot/saml.md Outdated Show resolved Hide resolved
Signed-off-by: Naarcha-AWS <[email protected]>
@Naarcha-AWS Naarcha-AWS merged commit aa9f88e into main May 3, 2022
@Naarcha-AWS Naarcha-AWS deleted the whitelist-replace2.0 branch May 3, 2022 19:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[FEATURE] Change the "blacklist / whitelist" nomenclature
5 participants