Update csp configuration instructions for OSD (#7026)

* Update docs about configuring frame-ancestors

Signed-off-by: Tianle Huang <[email protected]>

* update fgac info

Signed-off-by: Tianle Huang <[email protected]>

* add fgac info

Signed-off-by: Tianle Huang <[email protected]>

* fix vale

Signed-off-by: Tianle Huang <[email protected]>

* fix readme

Signed-off-by: Tianle Huang <[email protected]>

* Update _dashboards/csp/csp-dynamic-configuration.md

Co-authored-by: Melissa Vagi <[email protected]>
Signed-off-by: Tianle Huang <[email protected]>

* Update _dashboards/csp/csp-dynamic-configuration.md

Co-authored-by: Melissa Vagi <[email protected]>
Signed-off-by: Tianle Huang <[email protected]>

* Update _dashboards/csp/csp-dynamic-configuration.md

Co-authored-by: Melissa Vagi <[email protected]>
Signed-off-by: Tianle Huang <[email protected]>

* Update _dashboards/csp/csp-dynamic-configuration.md

Co-authored-by: Melissa Vagi <[email protected]>
Signed-off-by: Tianle Huang <[email protected]>

* Update _dashboards/csp/csp-dynamic-configuration.md

Co-authored-by: Melissa Vagi <[email protected]>
Signed-off-by: Tianle Huang <[email protected]>

* Update csp-dynamic-configuration.md

Signed-off-by: Melissa Vagi <[email protected]>

Signed-off-by: Melissa Vagi <[email protected]>

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

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

* Update _dashboards/csp/csp-dynamic-configuration.md

Signed-off-by: Melissa Vagi <[email protected]>

---------

Signed-off-by: Tianle Huang <[email protected]>
Signed-off-by: Tianle Huang <[email protected]>
Signed-off-by: Melissa Vagi <[email protected]>
Co-authored-by: Melissa Vagi <[email protected]>
Co-authored-by: Nathan Bower <[email protected]>

_dashboards/csp/csp-dynamic-configuration.md

@@ -1,19 +1,19 @@
 ---
 layout: default
-title: Configuring Content Security Policy rules dynamically
+title: Configuring the Content Security Policy `frame-ancestors` directive dynamically
 nav_order: 110
 has_children: false
 ---
 
-# Configuring Content Security Policy rules dynamically
+# Configuring the CSP `frame-ancestors` directive dynamically
 Introduced 2.13
 {: .label .label-purple }
 
-Content Security Policy (CSP) is a security standard intended to prevent cross-site scripting (XSS), `clickjacking`, and other code injection attacks resulting from the execution of malicious content in the trusted webpage context. OpenSearch Dashboards supports configuring CSP rules in the `opensearch_dashboards.yml` file by using the `csp.rules` key. A change in the YAML file requires a server restart, which may interrupt service availability. You can, however, configure the CSP rules dynamically through the `applicationConfig` plugin without restarting the server.
+Content Security Policy (CSP) is a security standard intended to prevent cross-site scripting (XSS), `clickjacking`, and other code injection attacks resulting from the launch of malicious content in the trusted webpage context. OpenSearch Dashboards supports configuring CSP rules in the `opensearch_dashboards.yml` file by using the `csp.rules` key. A change in the YAML file requires a server restart, which may interrupt service availability. You can, however, dynamically configure the `frame-ancestors` directive in the CSP rules through the `applicationConfig` plugin without restarting the server. Support for other directives is evaluated based on security ramifications.
 
 ## Configuration
 
-The `applicationConfig` plugin provides read and write APIs that allow OpenSearch Dashboards users to manage dynamic configurations as key-value pairs in an index. The `cspHandler` plugin registers a pre-response handler to `HttpServiceSetup`, which gets CSP rules from the dependent `applicationConfig` plugin and then rewrites to the CSP header. Enable both plugins within your `opensearch_dashboards.yml` file to use this feature. The configuration is shown in the following example. Refer to the `cspHandler` plugin [README](https://github.com/opensearch-project/OpenSearch-Dashboards/blob/main/src/plugins/csp_handler/README.md) for configuration details.
+The `applicationConfig` plugin provides read and write APIs that allow OpenSearch Dashboards users to manage dynamic configurations as key-value pairs in an index. The `cspHandler` plugin registers a pre-response handler to `HttpServiceSetup`, which gets the `frame-ancestors` value from the dependent `applicationConfig` plugin and then rewrites it to the CSP header. Enable both plugins in your `opensearch_dashboards.yml` file to use this feature. The configuration is shown in the following example. Refer to [`cspHandler` plugin](https://github.com/opensearch-project/OpenSearch-Dashboards/blob/main/src/plugins/csp_handler/README.md) for more information.
 
 ```
 application_config.enabled: true
@@ -22,29 +22,36 @@ csp_handler.enabled: true
 
 ## Enable site embedding for OpenSearch Dashboards
 
-To enable site embedding for OpenSearch Dashboards, update the CSP rules using CURL. When using CURL commands with single quotation marks inside the `data-raw` parameter, escape them with a backslash (`\`). For example, use `'\''` to represent `'`. The configuration is shown in the following example. Refer to the `applicationConfig` plugin [README](https://github.com/opensearch-project/OpenSearch-Dashboards/blob/main/src/plugins/application_config/README.md) for configuration details.
+To enable site embedding for OpenSearch Dashboards, update the `frame-ancestors` directive in the CSP rules using cURL. When using cURL commands with single quotation marks in the `data-raw` parameter, escape them with a backslash (`\`). For example, use `'\''` to represent `'`. The configuration is shown in the following example. Refer to [`applicationConfig` plugin](https://github.com/opensearch-project/OpenSearch-Dashboards/blob/main/src/plugins/application_config/README.md) for more information.
 
 ```
-curl '{osd endpoint}/api/appconfig/csp.rules' -X POST -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'osd-xsrf: osd-fetch' -H 'Sec-Fetch-Dest: empty' --data-raw '{"newValue":"script-src '\''unsafe-eval'\'' '\''self'\''; worker-src blob: '\''self'\''; style-src '\''unsafe-inline'\'' '\''self'\''; frame-ancestors '\''self'\'' {new site}"}'
+curl '{osd endpoint}/api/appconfig/csp.rules.frame-ancestors' -X POST -H 'Accept: application/json' -H 'Content-Type: application/json' -H 'osd-xsrf: osd-fetch' -H 'Sec-Fetch-Dest: empty' --data-raw '{"newValue":"{new site}"}'
 ```
 
-## Delete CSP rules
+## Delete `frame-ancestors` in the CSP rules
 
-Use the following CURL command to delete CSP rules:
+Use the following cURL command to delete `frame-ancestors` in the CSP rules:
 
 ```
-curl '{osd endpoint}/api/appconfig/csp.rules' -X DELETE -H 'osd-xsrf: osd-fetch' -H 'Sec-Fetch-Dest: empty'
+curl '{osd endpoint}/api/appconfig/csp.rules.frame-ancestors' -X DELETE -H 'osd-xsrf: osd-fetch' -H 'Sec-Fetch-Dest: empty'
 ```
 
-## Get CSP rules
+## Get `frame-ancestors` in the CSP rules
 
-Use the following CURL command to get CSP rules:
+Use the following cURL command to get `frame-ancestors` in the CSP rules:
 
 ```
-curl '{osd endpoint}/api/appconfig/csp.rules'
-
+curl '{osd endpoint}/api/appconfig/csp.rules.frame-ancestors'
 ```
 
 ## Precedence
 
 Dynamic configurations override YAML configurations, except for empty CSP rules. To prevent `clickjacking`, a `frame-ancestors: self` directive is automatically added to YAML-defined rules when necessary.
+
+## Fine-grained access control
+
+When the Security plugin is enabled, only users with write permissions to the configuration index `.opensearch_dashboards_config` are able to call the mutating APIs. The API calls must have a valid cookie containing the security information. To construct the cURL command, you can use a `Copy as cURL` option from the network tab of a browser development tool. For GET APIs, you can find an existing GET XHR request with type `json` from the network tab, copy it as cURL, and then replace it with the `appconfig` API names. Similarly, for POST and DELETE APIs, you can find an existing POST XHR request and update the API name and the value of `--data-raw` accordingly. DELETE APIs must have their request method updated to `-X DELETE`.
+
+An example of the `Copy as cURL` option in Firefox is shown in the following image.
+
+![Copying as curl in Firefox]({{site.url}}{{site.baseurl}}/images/dashboards/copy-as-curl.png)