Skip to content

Commit 46dd3fd

Browse files
authored
DOCS-676 - App permissions update (#5080)
* First draft * Add release note * Remove RSS logo * Change release note date * Minor updates * Updates from review by Kevin Keech * Add note * Fix screenshot * Change release note date to April 28 2025
1 parent 89123cb commit 46dd3fd

File tree

7 files changed

+43
-22
lines changed

7 files changed

+43
-22
lines changed

blog-service/2025-04-28-manage.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: Content Sharing for Apps (Manage)
3+
image: https://help.sumologic.com/img/sumo-square.png
4+
keywords:
5+
- manage
6+
- apps
7+
- content sharing
8+
hide_table_of_contents: true
9+
---
10+
11+
import useBaseUrl from '@docusaurus/useBaseUrl';
12+
13+
We are happy to announce that authorized users can now control the visibility of installed app content. This update allows content administrators and the installing user to configure the roles and users who should be allowed to view the dashboards and log searches that are installed with an app.
14+
15+
For more information about sharing apps, see [Content Sharing in Sumo Logic](/docs/manage/content-sharing/).
16+
17+
<img src={useBaseUrl('img/content-sharing/grant-app-access-to-org.png')} alt="<your image description>" style={{border: '1px solid gray'}} width="<insert-pixel-number>" />

docs/manage/content-sharing/index.md

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,11 @@ description: Content Sharing allows you to selectively share and collaborate on
66

77
import useBaseUrl from '@docusaurus/useBaseUrl';
88

9-
Content Sharing allows you to selectively share and collaborate on apps, dashboards, and searches with specific users or roles. As an Admin, you can use content sharing to share ownership of searches and dashboards, or to highlight key content to specific users and groups. As a user, you have the flexibility to control how broadly your content is shared within your organization.
9+
Content sharing allows you to selectively share and collaborate on apps, dashboards, and searches with specific users or roles. As an administrator, you can use content sharing to share ownership of apps, searches and dashboards, or to highlight key content to specific users and groups. As a user, you have the flexibility to control how broadly your content is shared within your organization.
1010

11-
You can share log searches, metric searches, dashboards, and folders with a user, a role, or combinations of the two. You can edit the sharing permissions at any time and share and revoke as needed from the **Share** dialog:
11+
You can share apps, log searches, metric searches, dashboards, and folders with a user, a role, or combinations of the two. You can edit the sharing permissions at any time and share and revoke as needed from the **Share** dialog:
1212

13-
<img src={useBaseUrl('img/content-sharing/ShareSearchPrime.png')} alt="Share dialog" width="800"/>
13+
<img src={useBaseUrl('img/content-sharing/ShareSearchPrime.png')} alt="Share dialog" style={{border: '1px solid gray'}} width="700"/>
1414

1515
## Share from any location
1616

@@ -23,61 +23,65 @@ In either location, you click the kabob icon to locate the **Share** option and
2323

2424
## Sharing notifications
2525

26-
When you share content, the users with whom you have shared it are notified by email. A user can also see shared content in the Library (listed in the left navigation bar). By default, any user or role with which you share content receives an email notification that names the person who is sharing the content, the Organization, and the type of content that is shared. You can also add text to the email notification to explain why you think the content is useful to them.
26+
When you share content, the users with whom you have shared it are notified by email. A user can also see shared content in the library (listed in the left navigation bar). By default, any user or role with which you share content receives an email notification that names the person who is sharing the content, the organization, and the type of content that is shared. You can also add text to the email notification to explain why you think the content is useful to them.
2727

2828
<img src={useBaseUrl('img/content-sharing/Emailnotification.png')} alt="Sharing notification" width="500"/>
2929

30-
To find content in the Library that has been shared with you, click the clock image in the left navigation bar: <img src={useBaseUrl('img/content-sharing/recent-icon.png')} alt="Recent icon" style={{border: '1px solid gray'}} width="30" />
30+
To find content in the library that has been shared with you, click the clock image in the left navigation bar: <img src={useBaseUrl('img/content-sharing/recent-icon.png')} alt="Recent icon" style={{border: '1px solid gray'}} width="30" />
3131

32-
## Sharing dashboards, log searches, metric queries, and folders
32+
## Sharing apps, dashboards, log searches, metric queries, and folders
3333

34-
To share content from the left navigation bar or the Library:
34+
To share content from the left navigation bar or the library:
3535

36-
1. Click the Details icon ![details](/img/content-sharing/details.png) for the content you want to share.
36+
1. Click the details icon ![details](/img/content-sharing/details.png) for the content you want to share.
3737
1. Select **Share** from the dropdown menu.
3838

3939
<img src={useBaseUrl('img/content-sharing/share-search.png')} alt="Share search" width="150"/>
4040

4141
:::note
42-
* The **Share** option appears on the dropdown menu only if you have edit or manage permissions on the selected item. You cannot share the item if you only have view permissions on the item. See [Available permission levels](#available-permission-levels).
43-
* The **View in Library** option is present when you click the Details icon from the left navigation bar. 
42+
* The **Share** option appears on the dropdown menu only if you have permissions to grant access. See [Available permission levels](#available-permission-levels).
43+
* The **View in Library** option is present when you click the details icon from the left navigation bar. 
4444
:::
4545

46-
1. In the Share dialog, enter the user name or role name to receive access. For example, if you want all users with the **Analyst** role to be able to edit the content, choose **Analyst**:  
46+
1. In the **Share** dialog, enter the user name or role name to receive access. For example, if you want all users with the **Analyst** role to be able to edit the content, choose **Analyst**:  
4747

48-
<img src={useBaseUrl('img/content-sharing/analyst.png')} alt="Analyst" width="600"/>
48+
<img src={useBaseUrl('img/content-sharing/analyst.png')} alt="Analyst role selected in Share dialog" style={{border: '1px solid gray'}} width="700"/>
4949

5050
If you have an unsaved search, these options will not be available to you. We need a name saved for your search before we can offer this dialog. If you want to share an unsaved search, you can share a link from the available dialog.
5151

52-
<img src={useBaseUrl('img/content-sharing/unsaved-search.png')} alt="Unsaved search" width="500"/>
53-
1. Optional. If you are sharing with a large Role, or a user who already expects access to this search, you can turn off **Notify recipients by email**. If you do want to send an email notification, we recommend that you include a note in the email for the recipients to indicate what to do with their new content and leave the option enabled.
54-
1. Choose the level of access from View, Edit, or Manage. For details on permission levels, see [Available Permission Levels](#available-permission-levels).
55-
1. Optional. Choose **Advanced Options** to further refine access to the content. For details on these options, see [Available Permission Levels](#available-permission-levels).
52+
<img src={useBaseUrl('img/content-sharing/unsaved-search.png')} alt="Unsaved search" style={{border: '1px solid gray'}} width="700"/>
53+
1. Optional. If you are sharing with a large role, or a user who already expects access to this search, you can turn off **Notify recipients by email**. If you do want to send an email notification, we recommend that you include a note in the email for the recipients to indicate what to do with their new content and leave the option enabled.
54+
1. Choose the level of access from view, edit, or manage. For details on permission levels, see [Available permission levels](#available-permission-levels).
55+
1. Optional. Choose **Advanced Access** to further refine access to the content. For details on these options, see [Available permission levels](#available-permission-levels).
5656

57-
<img src={useBaseUrl('img/content-sharing/PermissionsShare.png')} alt="Permissions share" width="600"/>
57+
<img src={useBaseUrl('img/content-sharing/PermissionsShare.png')} alt="Permissions share" style={{border: '1px solid gray'}} width="700"/>
5858

5959
## Navigate content sharing tabs
6060

61-
Sumo provides a few ways to navigate your content based on what you want to view.
61+
Sumo Logic provides a few ways to navigate your content based on what you want to view.
6262

6363
import UiElements from '../../reuse/ui-elements.md';
6464

6565
<UiElements/>
6666

6767
## Available permission levels
6868

69-
You can share your content with specific users or roles. As a best practice we recommend sharing at the search or dashboard level, or if you want to share a folder, share a subfolder. All contents of the folder are shared, you can’t exclude a particular content item in a folder as private content.
69+
You can share your content with specific users or roles. As a best practice we recommend sharing at the search or dashboard level, or if you want to share a folder, share a subfolder. If all contents of the folder are shared, you can’t exclude a particular content item in a folder as private content.
7070

71-
By default each permission level allows the user to grant that level of permission to another user. By default we assume that if a user has View access, for example, that they would be capable of deciding who should also have View access. If you have content where this is not the case, you can restrict their rights to allow others to have View, Edit, or Manage access.
71+
By default each permission level allows the user to grant that level of permission to another user. By default we assume that if a user has view access, for example, that they would be capable of deciding who should also have view access. If you have content where this is not the case, you can restrict their rights to allow others to have view, edit, or manage access.
72+
73+
:::note
74+
App content can only be shared with view access. Edit and manage access is not allowed for installed apps.
75+
:::
7276

7377
Consider carefully what level of permissions users and roles need with
7478
your content:
7579

7680
| Permission Level | Default Permissions | Available Advanced Options/Restrictions |
7781
| :-- | :-- | :-- |
7882
| View | Users can see the content and grant access to others to view. | **Cannot Grant Access.** Prevents the user from sharing any access.<br/><br/>**Grant View Access.** User can grant view access to others. |
79-
| Edit | Users can make changes to the content and grant View or Edit access to others. | **Cannot Grant Access.** Prevents the user from sharing any access.<br/><br/>**Grant View Access.** User can grant View access to others.<br/><br/>**Grant Edit and View Access.** User can grant Edit and View access to users. |
80-
| Manage<br/>(Recommended for individual users only) | Designated users are considered co-managers of the content and can modify the content as well grant the right to other users to View, Edit, Manage, or Move the content. | **Cannot Grant Access.** Prevents the user from sharing view access.<br/><br/>**Grant View Access.** User can grant view access to others.<br/><br/>**Grant Edit and View Access.** User can grant View and Edit access to users.<br/><br/>**Grant Manage, Edit, and View Access.** User can grant Manage, Edit, and View access to users. |
83+
| Edit | Users can make changes to the content and grant view or edit access to others. | **Cannot Grant Access.** Prevents the user from sharing any access.<br/><br/>**Grant View Access.** User can grant view access to others.<br/><br/>**Grant Edit and View Access.** User can grant edit and view access to users. |
84+
| Manage<br/>(Recommended for individual users only) | Designated users are considered co-managers of the content and can modify the content as well grant the right to other users to view, edit, manage, or Move the content. | **Cannot Grant Access.** Prevents the user from sharing view access.<br/><br/>**Grant View Access.** User can grant view access to others.<br/><br/>**Grant Edit and View Access.** User can grant view and edit access to users.<br/><br/>**Grant Manage, Edit, and View Access.** User can grant manage, edit, and view access to users. |
8185

8286

8387
In this section, we'll introduce the following concepts:
80.5 KB
Loading
103 KB
Loading
80.6 KB
Loading
179 KB
Loading
60.7 KB
Loading

0 commit comments

Comments
 (0)