-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathAccess_Reviews_API_plugin.yaml
148 lines (138 loc) · 6.27 KB
/
Access_Reviews_API_plugin.yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
# Author Amit Singh
# Jan-29-2025
openapi: 3.0.0
info:
title: EntraID Access Review Plugin
description: The skills in this plugin will help create access reviews in EntraID, including User details like groups, licenses via Graph API Call
version: "v1.0.11"
servers:
- url: https://graph.microsoft.com/v1.0
paths:
#############################################################################################################
# List a user's memberships (direct and transitive)
# https://learn.microsoft.com/en-us/graph/api/user-list-transitivememberof
#############################################################################################################
/users/{userIdentifier}/transitiveMemberOf:
get:
operationId: RetrieveTransitiveMemberOf
description: Fetch all transitive memberships details for a user.
descriptionForModel: Fetch all transitive memberships of a user, including groups and directory roles in Entra ID. Transitive memberships include both direct and indirect memberships, such as those assigned via group nesting.
examplePrompts:
- Get all memberships for user
- Get all transitive memberships for user
- Get the transitive group memberships for user
- Get the group memberships for user
- Get the transitive group memberships for user objectID
- Get the group memberships for user objectID
- What are the group memberships for user
- What are the transitive group memberships for user
- What Entra group memberships does user have
- What Entra transitive group memberships does user have
parameters:
- in: path
name: userIdentifier
schema:
type: string
required: true
description: The unique identifier (ID) or userPrincipalName of the user to retrieve.
responses:
"200":
description: OK
content:
application/json:
schema:
type: object
properties:
"@odata.context":
type: string
example: "https://graph.microsoft.com/v1.0/$metadata#directoryObjects"
value:
type: array
items:
type: object
properties:
"@odata.type":
type: string
example: "#microsoft.graph.group"
displayName:
type: string
example: "All_Contoso_Licensing"
mailEnabled:
type: boolean
example: true
mailNickname:
type: string
example: "ContosoMailNickName"
securityEnabled:
type: boolean
example: true
"400":
description: Bad request, invalid parameters
#############################################################################################################
# List licenseDetails
# https://learn.microsoft.com/en-us/graph/api/user-list-licensedetails
#############################################################################################################
/users/{userIdentifier}/licenseDetails:
get:
operationId: RetrieveTheLicenseDetailsOfUser
description: Fetch the license details assigned to a user in Entra ID.
descriptionForModel: Fetch the license details assigned to a user in Entra ID.
examplePrompts:
- Get license details assigned to a user
- Get license details assigned to a UPN
- Get license details assigned to user object ID
- Get Entra license details assigned to the user
- Get Entra license details assigned to the UPN
- Get Entra license details assigned to the user object ID
parameters:
- in: path
name: userIdentifier
schema:
type: string
required: true
description: The unique identifier (ID) or userPrincipalName of the user to retrieve.
responses:
"200":
description: OK
content:
application/json:
schema:
type: object
properties:
"@odata.context":
type: string
example: "https://graph.microsoft.com/v1.0/$metadata#users('48d31887-5fad-4d73-a9f5-3c356e68a038')/licenseDetails"
value:
type: array
items:
type: object
properties:
id:
type: string
example: "3RnS3Gi8m0u_C0ozp5a-NWAn38eBLPdOtXhbU5K1cd8"
skuId:
type: string
example: "c7df2760-2c81-4ef7-b578-5b5392b571df"
skuPartNumber:
type: string
example: "ENTERPRISEPREMIUM"
servicePlans:
type: array
items:
type: object
properties:
servicePlanId:
type: string
example: "cd31b152-6326-4d1b-ae1b-997b625182e6"
servicePlanName:
type: string
example: "MIP_S_Exchange"
provisioningStatus:
type: string
example: "PendingProvisioning"
appliesTo:
type: string
example: "User"
required: ["@odata.context", "value"]
"400":
description: Bad request, invalid parameters