Microsoft Graph · Schema

userSecurityState

Azure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Tasks

Properties

Name Type Description
aadUserId string AAD User object identifier (GUID) - represents the physical/multi-account user entity.
accountName string Account name of user account (without Active Directory domain or DNS domain) - (also called mailNickName).
domainName string NetBIOS/Active Directory domain of user account (that is, domain/account format).
emailRole object For email-related alerts - user account's email 'role'. The possible values are: unknown, sender, recipient.
isVpn boolean Indicates whether the user logged on through a VPN.
logonDateTime string Time at which the sign-in occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:0
logonId string User sign-in ID.
logonIp string IP Address the sign-in request originated from.
logonLocation string Location (by IP address mapping) associated with a user sign-in event by this user.
logonType object Method of user sign in. The possible values are: unknown, interactive, remoteInteractive, network, batch, service.
onPremisesSecurityIdentifier string Active Directory (on-premises) Security Identifier (SID) of the user.
riskScore string Provider-generated/calculated risk score of the user account. Recommended value range of 0-1, which equates to a percentage.
userAccountType object User account type (group membership), per Windows definition. The possible values are: unknown, standard, power, administrator.
userPrincipalName string User sign-in name - internet format: (user account name)@(user account DNS domain name).
@odata.type string
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphusersecuritystate-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.userSecurityState",
  "title": "userSecurityState",
  "required": [
    "@odata.type"
  ],
  "type": "object",
  "properties": {
    "aadUserId": {
      "type": "string",
      "description": "AAD User object identifier (GUID) - represents the physical/multi-account user entity.",
      "nullable": true
    },
    "accountName": {
      "type": "string",
      "description": "Account name of user account (without Active Directory domain or DNS domain) - (also called mailNickName).",
      "nullable": true
    },
    "domainName": {
      "type": "string",
      "description": "NetBIOS/Active Directory domain of user account (that is, domain/account format).",
      "nullable": true
    },
    "emailRole": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/microsoft.graph.emailRole"
        },
        {
          "type": "object",
          "nullable": true
        }
      ],
      "description": "For email-related alerts - user account's email 'role'. The possible values are: unknown, sender, recipient."
    },
    "isVpn": {
      "type": "boolean",
      "description": "Indicates whether the user logged on through a VPN.",
      "nullable": true
    },
    "logonDateTime": {
      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      "type": "string",
      "description": "Time at which the sign-in occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
      "format": "date-time",
      "nullable": true
    },
    "logonId": {
      "type": "string",
      "description": "User sign-in ID.",
      "nullable": true
    },
    "logonIp": {
      "type": "string",
      "description": "IP Address the sign-in request originated from.",
      "nullable": true
    },
    "logonLocation": {
      "type": "string",
      "description": "Location (by IP address mapping) associated with a user sign-in event by this user.",
      "nullable": true
    },
    "logonType": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/microsoft.graph.logonType"
        },
        {
          "type": "object",
          "nullable": true
        }
      ],
      "description": "Method of user sign in. The possible values are: unknown, interactive, remoteInteractive, network, batch, service."
    },
    "onPremisesSecurityIdentifier": {
      "type": "string",
      "description": "Active Directory (on-premises) Security Identifier (SID) of the user.",
      "nullable": true
    },
    "riskScore": {
      "type": "string",
      "description": "Provider-generated/calculated risk score of the user account. Recommended value range of 0-1, which equates to a percentage.",
      "nullable": true
    },
    "userAccountType": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/microsoft.graph.userAccountSecurityType"
        },
        {
          "type": "object",
          "nullable": true
        }
      ],
      "description": "User account type (group membership), per Windows definition. The possible values are: unknown, standard, power, administrator."
    },
    "userPrincipalName": {
      "type": "string",
      "description": "User sign-in name - internet format: (user account name)@(user account DNS domain name).",
      "nullable": true
    },
    "@odata.type": {
      "type": "string"
    }
  }
}