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

[DOCS] Include server.cors configuration settings #47701

Merged
merged 4 commits into from
Oct 11, 2019
Merged

Conversation

rwaight
Copy link
Contributor

@rwaight rwaight commented Oct 9, 2019

Summary

Include server.cors configuration settings in the Kibana documentation. Closes #40095

@KOTungseth FYI, this should be reviewed to ensure the defaults and descriptions are accurate.

Checklist

Use strikethroughs to remove checklist items you don't feel are applicable to this PR.

### For maintainers

[skip ci]

Include `server.cors` configuration settings
@rwaight rwaight added Team:Docs Team:Core Core services & architecture: plugins, logging, config, saved objects, http, ES client, i18n, etc Team:Operations Team label for Operations Team labels Oct 9, 2019
@rwaight rwaight requested a review from KOTungseth October 9, 2019 14:06
@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-operations (Team:Operations)

@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-platform (Team:Platform)

@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-docs (Team:Docs)

@elasticmachine
Copy link
Contributor

💔 Build Failed

@gchaps gchaps added release_note:skip Skip the PR/issue when compiling release notes v7.4.0 v7.5.0 v8.0.0 labels Oct 9, 2019
@@ -253,6 +253,10 @@ running behind a proxy. Use the `server.rewriteBasePath` setting to tell Kibana
if it should remove the basePath from requests it receives, and to prevent a
deprecation warning at startup. This setting cannot end in a slash (`/`).

[[server-cors]]`server.cors:`:: *Default: `false`* Set to `true` to enable CORS support, this setting is required in order to configure `server.cors.origin`.

`server.cors.origin:`:: *Default: none* Used to specify origins, "origin" must be an array. This setting requires `server.cors: true` set. Use `server.cors.origin: ["*"]` to accept all origins.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm actually not sure the server.cors.origins feature is implemented in production mode. We still have an open issue about this: #16714

Someone will need to verify, I may have some time later today.

Copy link
Contributor

@KOTungseth KOTungseth left a comment

Choose a reason for hiding this comment

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

Thank you so much for pushing this PR! I have a few comments and suggestions, but other than these, this looks great.

@@ -253,6 +253,10 @@ running behind a proxy. Use the `server.rewriteBasePath` setting to tell Kibana
if it should remove the basePath from requests it receives, and to prevent a
deprecation warning at startup. This setting cannot end in a slash (`/`).

[[server-cors]]`server.cors:`:: *Default: `false`* Set to `true` to enable CORS support, this setting is required in order to configure `server.cors.origin`.
Copy link
Contributor

Choose a reason for hiding this comment

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

Not critical, but could we split this into two sentences? For example:

Set to true to enable CORS support. This setting is required to configure server.cors.origin.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated in ebe8a07

@@ -253,6 +253,10 @@ running behind a proxy. Use the `server.rewriteBasePath` setting to tell Kibana
if it should remove the basePath from requests it receives, and to prevent a
deprecation warning at startup. This setting cannot end in a slash (`/`).

[[server-cors]]`server.cors:`:: *Default: `false`* Set to `true` to enable CORS support, this setting is required in order to configure `server.cors.origin`.

`server.cors.origin:`:: *Default: none* Used to specify origins, "origin" must be an array. This setting requires `server.cors: true` set. Use `server.cors.origin: ["*"]` to accept all origins.
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this could benefit from some reformatting. What do you think about:

Specifies origins. "origin" must be an array. To use this setting, you must set server.cors to true. To accept all origins, use server.cors.origin: ["*"].

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated in ebe8a07

Update formatting in the `server.cors` configuration settings
@rwaight rwaight requested a review from KOTungseth October 10, 2019 16:02
Copy link
Contributor

@spalger spalger left a comment

Choose a reason for hiding this comment

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

LGTM

@elasticmachine
Copy link
Contributor

💔 Build Failed

@rwaight
Copy link
Contributor Author

rwaight commented Oct 10, 2019

@elasticmachine update branch

@elasticmachine
Copy link
Contributor

💔 Build Failed

@spalger
Copy link
Contributor

spalger commented Oct 11, 2019

@elasticmachine merge upstream

@rwaight
Copy link
Contributor Author

rwaight commented Oct 11, 2019

Thank you @spalger and @KOTungseth. I'll Squash and merge this PR as requested by @gchaps.

@rwaight rwaight merged commit e9e8b1d into master Oct 11, 2019
rwaight added a commit that referenced this pull request Oct 11, 2019
Include `server.cors` configuration settings -- back port to 7.x from #47701
rwaight added a commit that referenced this pull request Oct 11, 2019
Include `server.cors` configuration settings -- back port to 7.4 from #47701
[skip ci]
rwaight added a commit that referenced this pull request Oct 11, 2019
Include `server.cors` configuration settings -- back port to 7.x from #47701
rwaight added a commit that referenced this pull request Oct 11, 2019
Include `server.cors` configuration settings -- back port to 7.4 from #47701
[skip ci]
@rwaight rwaight self-assigned this Oct 11, 2019
@rwaight rwaight deleted the rwaight-patch-1 branch October 23, 2019 19:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release_note:skip Skip the PR/issue when compiling release notes Team:Core Core services & architecture: plugins, logging, config, saved objects, http, ES client, i18n, etc Team:Docs Team:Operations Team label for Operations Team v7.4.0 v7.5.0 v8.0.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOCS] server.cors settings are missing from the Kibana documentation
6 participants