Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions _dashboards/management/resource-sharing.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,47 @@ Follow these steps to share resources in OpenSearch Dashboards:

1. Select **Save** to update the backend configuration. Changes are applied immediately.

## Sharing resources from a plugin page using the Share button
**Introduced 3.9**
{: .label .label-purple }

Many plugins that support resource sharing provide a centralized **Share** button directly in their resource list tables. This lets you manage access to a resource without leaving the plugin's page. The **Share** button uses the same resource-sharing APIs as the **Resource Access Management** page, so changes made in either location are equivalent.

The **Share** button appears in an **Access** column that is displayed only when resource sharing is enabled for that resource type. If the Security plugin is not installed or resource sharing is disabled, the column is hidden and no other plugin functionality is affected.
{: .note}

The following plugins surface the **Share** button in their resource lists:

* **Anomaly Detection** – Detectors and forecasters
* **Alerting** – Monitors
* **Machine Learning** – Model groups
* **Reporting** – Report definitions and reports
* **Notifications** – Channels
* **Flow Framework** – Workflows
* **Security Analytics** – Detectors and correlation rules

Follow these steps to share a resource using the **Share** button:

1. Open the resource list for a supported plugin. For example, in the left navigation menu, under **Anomaly Detection**, select **Detectors**.

1. In the **Access** column, review the sharing status for each resource. Each resource displays a status of **Private** or **Shared**, along with a share icon.

![Access column with the Share button]({{site.url}}{{site.baseurl}}/images/resource-sharing/share-button-access-column.png)

1. Select the share icon for the resource that you want to manage. The **Manage access** dialog opens.

![Manage access dialog]({{site.url}}{{site.baseurl}}/images/resource-sharing/share-button-share-access-modal.png)

1. For each access level, add or remove **Users**, **Roles**, or **Backend roles**. Access levels are plugin-specific and are retrieved dynamically from OpenSearch, for example, `ad_read_only` or `ml_read_write`.

Wildcards (`*`) are supported for the `users` field to make a resource accessible to everyone at the chosen access level.
{: .note}

1. Select **Save changes** to apply your changes. Changes take effect immediately, and the **Access** column updates to reflect the new sharing status.

You can share a resource only if you are its owner, a superadmin, or a user who was granted share permission by the owner.
{: .note}

## Viewing and managing access

Follow these steps to view and manage access for a resource in OpenSearch Dashboards:
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading