【Azure Developer】如何用Microsoft Graph API管理AAD Application里面的Permissions

问题描述

如何用Microsoft Graph API给应用添加Microsoft Graph Application Permission

解决方法

一：首先获取Microsoft Graph Application Permission对应的唯一标识GUID

接口：​​https://microsoftgraph.chinacloudapi.cn/v1.0/servicePrincipals?$search="appId:00000003-0000-0000-c000-000000000000​​"

• 00000003-0000-0000-c000-000000000000是Microsoft Graph API对应的AppId。
• 以Directory.Read.All权限为例，在appRoles中查找权限Directory.Read.All的这项，其中id则是Directory.Read.All的唯一标识。

二：调用Microsoft Graph Update Application接口更新requiredResourceAccess参数

• 接口：​​https://microsoftgraph.chinacloudapi.cn/v1.0/applications/youclientid​​
• Body:

{ 
    "requiredResourceAccess": [
        {
            "resourceAppId": "00000003-0000-0000-c000-000000000000",
            "resourceAccess": [
                {
                    "id": "e1fe6dd8-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
                    "type": "Scope"
                },{
7ab1d382-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
Role"
                }
            ]
        }
    ]
}

注：给应用添加Microsoft Graph Delegated Permission，需要在第一步中查找oauth2PermissionScopes中对应的权限Directory.Read.All并且找到对应的id，把第二步中的标黄的type的值修改为Scope，并且把id的值替换掉。

三：如果在第一步获取的权限需要管理员同意，则需要管理员在门户中授予同意，可以通过第一步中获取的权限中的type来区分，如果type是Admin则代表需要管理员同意。

参考内容

• 给应用添加APIs My organization uses的权限，在第一步执行查询唯一标识时需要根据该应用id来查询，参考如下，查找的结果中​​oauth2PermissionScopes​​里的权限对应Scope( Delegated Permission)，appRoles里的权限对应Role(Application Permission)

​​https://microsoftgraph.chinacloudapi.cn/v1.0/servicePrincipals?$search="appId:yourclientid​​"

Update Application：​​https://docs.microsoft.com/zh-cn/graph/api/application-update?view=graph-rest-1.0&tabs=http​​

List servicePrincipals：​​https://docs.microsoft.com/zh-cn/graph/api/serviceprincipal-list?view=graph-rest-1.0&tabs=http​​

requiredResourceAccess：​​https://docs.microsoft.com/zh-cn/graph/api/resources/requiredresourceaccess?view=graph-rest-1.0​​

• 对于Azure Service Management API和Microsoft Graph API的App Id都是可以从List servicePrincipals中查找到的，建议从接口中查找，以免发生变更时影响使用。比如：

​​https://microsoftgraph.chinacloudapi.cn/v1.0/servicePrincipals?$search="displayName:Microsoft​​ Graph"&$count=true

​​https://microsoftgraph.chinacloudapi.cn/v1.0/servicePrincipals?$search="displayName:Azure​​ Service Management"&$count=true

• user_impersonation的id首先通过上述接口获取到的结果中找到Azure Service Management，也可以在这里找到它对应的user_impersonation的id。

List servicePrincipals：​​https://docs.microsoft.com/zh-cn/graph/api/serviceprincipal-list?view=graph-rest-1.0&tabs=http​​

当在复杂的环境中面临问题，格物之道需：浊而静之徐清，安以动之徐生。 云中，恰是如此!