时间戳

首页 > 解决方案 > Where is the RingCentral ReadPresenceSettings set in the portal?

user-permissions - Where is the RingCentral ReadPresenceSettings set in the portal?

问题描述

I see the ReadPresenceSettings permission in the API for my role, but I do not see it in the Online Account Portal (https://service.ringcentral.com). What does this correspond to in the portal so I can set/unset it?

Permission in Role

Request

GET /restapi/v1.0/dictionary/user-role/:roleId
GET /restapi/v1.0/dictionary/user-role/3

Response

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/user-role/3",
    "id": "3",
    "displayName": "Standard (International)",
    "description": "User level access with international dialing access.",
    "custom": false,
    "scope": "Self",
    "hidden": false,
    "siteCompatible": false,
    "permissions": [
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceSettings",
            "id": "ReadPresenceSettings",
            "assignable": false,
            "readOnly": false,
            "siteCompatible": "Independent"
        },
        ...
    ]
}

Permission Info Exists

When I check the presence info endpoint, I see that it is called "Read Presence Settings" but there is no such permission in the portal.

Request

GET /restapi/v1.0/dictionary/permission/:permissionId
GET /restapi/v1.0/dictionary/permission/ReadPresenceSettings

Response

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceSettings",
    "id": "ReadPresenceSettings",
    "displayName": "Read Presence Settings",
    "assignable": false,
    "readOnly": false,
    "siteCompatible": "Independent",
    "category": {
        "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission-category/Features",
        "id": "Features"
    },
    "includedPermissions": []
}

I'm using the Postman with the collection here:

https://github.com/grokify/swaggman

标签： user-permissionsringcentral

解决方案

RingCentral 权限可以相当精细，并不是每个 API 权限都显示在在线帐户门户中。

可分配给用户的权限由权限的布尔assignable属性指示。这设置为falsefor ReadPresenceSettings。

某些权限是另一个可分配权限的子权限。在这种情况下，它们将列在权限includedPermissions属性中。

在这种情况下，可分配的父权限是：ConfigurePresence在 API 中或 UI 中的“配置状态”。

查找可分配的父权限

要使用 API 查找此内容，请调用权限列表端点，然后ReadPresenceSettings在属性也是的includedPermissions属性中检查每个权限。assignabletrue

要求

GET /restapi/v1.0/dictionary/permission

回复

响应将包括一系列权限，如下所示。过滤可分配的ReadPresenceSettings权限和作为包含权限的权限仅对ConfigurePresence我返回。

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission?page=1&perPage=100",
    "records": [
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ConfigurePresence",
            "id": "ConfigurePresence",
            "displayName": "Configure Presence",
            "description": "Allows to manage Presence settings",
            "assignable": true,
            "readOnly": false,
            "siteCompatible": "Independent",
            "category": {
                "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission-category/Features",
                "id": "Features"
            },
            "includedPermissions": [
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/EditPresenceStatus",
                    "id": "EditPresenceStatus",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                },
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceSettings",
                    "id": "ReadPresenceSettings",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                },
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceStatus",
                    "id": "ReadPresenceStatus",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                },
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/EditPresenceSettings",
                    "id": "EditPresenceSettings",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                }
            ]
        },
        ....
    ]
}

更新权限

拥有可分配的父权限后，您可以照常为用户更新它。这样做也会启用/禁用子权限。例如，ReadPresenceSettings您将照常使用在线帐户门户更新用户角色“配置状态”权限。如果用户正在使用内置权限，您可能需要为用户创建一个新的、已修改的角色（如果还没有的话）。

您可以在此知识库文章中了解有关如何执行此操作的更多信息：

https://success.ringcentral.com/articles/RC_Knowledge_Article/5-10-Editing-the-Extension-Permissions-via-Web

推荐阅读