Get secureScore
Namespace: microsoft.graph
Retrieve the properties and relationships of a secureScore object.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | SecurityEvents.Read.All, SecurityEvents.ReadWrite.All |
Delegated (personal Microsoft account) | Not supported. |
Application | SecurityEvents.Read.All, SecurityEvents.ReadWrite.All |
HTTP request
GET /security/secureScores/{id}
Request headers
Name | Description |
---|---|
Authorization | Bearer {code}. Required. |
Request body
Do not supply a request body for this method. The request body will be ignored.
Response
If successful, this method returns a 200 OK
response code and a secureScore object in the response body. If a status code other than 2xx or 404 is returned from a provider or if a provider times out, the response will be a 206 Partial Content
status code with the provider's response in a warning header. For more information, see Microsoft Graph Security API error responses.
Example
Request
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/security/secureScores/{id}
Response
The following is an example of the response.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "00000001-0001-0001-0001-000000000001c_2019-03-19",
"azureTenantId": "00000001-0001-0001-0001-000000000001c",
"activeUserCount": 0,
"createdDateTime": "2019-03-19T15:21:00Z",
"currentScore": 387.0,
"enabledServices": [
"HasExchange",
"HasSharePoint",
"HasInTune"
],
"licensedUserCount": 100,
"maxScore": 697.0,
"averageComparativeScores": [
{
"basis": "AllTenants",
"averageScore": 37.0
},
{
"basis": "TotalSeats",
"averageScore": 46.0
},
{
"basis": "IndustryTypes",
"averageScore": 109.0
}
],
"controlScores": [
{
"controlCategory": "Identity",
"controlName": "AdminMFA",
"description": "Requiring multi-factor authentication (MFA) for all Azure Active Directory accounts with privileged roles",
"score": 35.0
},
{
"controlCategory": "Data",
"controlName": "DLPEnabled",
"description": "Data Loss Prevention (DLP) policies can be used to comply with business standards and industry regulations.",
"score": 20.0
}
],
"vendorInformation": {
"provider": "SecureScore",
"providerVersion": null,
"subProvider": null,
"vendor": "Microsoft"
}
}
Feedback
Submit and view feedback for