Microsoft Intune
39 min
the microsoft intune connector is a software component that allows for seamless integration between intune and turbine, leveraging the oauth2 protocol for secure authentication and authorization this readme provides instructions for configuring and using the connector with graph's oauth2 configuration prerequisites before you can use the microsoft intune connector, you must meet the following prerequisites a microsoft intune subscription an azure ad tenant with at least one registered application an oauth2 client id and secret for your registered application note that if there is a microsoft graph api asset configured in turbine, there is no need to create a new as long as the asset has the correct permissions configurations oauth 2 0 client credentials authenticates using oauth 2 0 client credentials configuration parameters parameter description type required url a url to the target host string required token url must start with https //login microsoftonline com/ https //login microsoftonline com/ and then continue with the tenant id, and then be prepended with /oauth2/v2 0/token string required client id the client id string required client secret the client secret string required scope list of permission scopes for this action array required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions get detected app get details on a detected app endpoint url /v1 0/devicemanagement/detectedapps/{{detectedappid}} method get input argument name type required description detectedappid string required the id of the detected app output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response value object value for the parameter @odata type string response data id string unique identifier displayname string name of the resource version string output field version sizeinbyte number output field sizeinbyte devicecount number count value publisher string output field publisher platform string output field platform example \[ { "status code" 200, "reason" "ok", "headers" null, "response" { "value" {} } } ] get detected apps get properties and relationships of detected apps endpoint url /v1 0/devicemanagement/detectedapps method get output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response value array value for the parameter @odata type string response data id string unique identifier displayname string name of the resource version string output field version sizeinbyte number output field sizeinbyte devicecount number count value publisher string output field publisher platform string output field platform example \[ { "status code" 200, "reason" "ok", "headers" null, "response" { "value" \[] } } ] get user's device enrollment configs get a user's effective device enrollment configurations endpoint url /beta/users/{{usersid}}/geteffectivedeviceenrollmentconfigurations method get input argument name type required description userid string required the id of the user output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response value array value for the parameter @odata type string response data id string unique identifier displayname string name of the resource description string output field description priority number output field priority createddatetime string time value lastmodifieddatetime string time value version number output field version example \[ { "status code" 200, "reason" "ok", "headers" null, "response" { "value" \[] } } ] get user's logged on managed devices get managed devices a user is logged endpoint url /beta/users/{{userid}}/getloggedonmanageddevices method get input argument name type required description userid string required the id of the user output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response value array value for the parameter @odata type string response data id string unique identifier userid string unique identifier devicename string name of the resource hardwareinformation object output field hardwareinformation @odata type string response data serialnumber string output field serialnumber totalstoragespace number output field totalstoragespace freestoragespace number output field freestoragespace imei string output field imei meid string unique identifier manufacturer string output field manufacturer model string output field model phonenumber string output field phonenumber subscribercarrier string output field subscribercarrier cellulartechnology string output field cellulartechnology wifimac string output field wifimac operatingsystemlanguage string output field operatingsystemlanguage issupervised boolean output field issupervised isencrypted boolean output field isencrypted example \[ { "status code" 200, "reason" "ok", "headers" null, "response" { "value" \[] } } ] get user's managed app policies get a user's managed app policies endpoint url /beta/users/{{usersid}}/getmanagedapppolicies method get input argument name type required description usersid string required the id of the user output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response value array value for the parameter @odata type string response data displayname string name of the resource description string output field description createddatetime string time value lastmodifieddatetime string time value id string unique identifier version string output field version example \[ { "status code" 200, "reason" "ok", "headers" null, "response" { "value" \[] } } ] get user's managed devices get a user's managed devices endpoint url /v1 0/users/{{userid}}/manageddevices method get input argument name type required description usersid string required the id of the user output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response id string unique identifier userid string unique identifier devicename string name of the resource manageddeviceownertype string type of the resource enrollmentdatetime string time value lastsyncdatetime string time value operatingsystem string output field operatingsystem compliancestate string output field compliancestate jailbroken string output field jailbroken managementagent string output field managementagent osversion string output field osversion easactivated string output field easactivated easdeviceid string unique identifier easactivationdatetime string time value azureadregistered string output field azureadregistered deviceenrollmenttype string type of the resource activationlockbypasscode string output field activationlockbypasscode emailaddress string output field emailaddress azureaddeviceid string unique identifier deviceregistrationstate string output field deviceregistrationstate devicecategorydisplayname string name of the resource example \[ { "status code" 200, "reason" "ok", "headers" null, "response" { "id" "id", "userid" "userid", "devicename" "devicename", "manageddeviceownertype" "manageddeviceownertype", "enrollmentdatetime" "enrollmentdatetime", "lastsyncdatetime" "lastsyncdatetime", "operatingsystem" "operatingsystem", "compliancestate" "compliancestate", "jailbroken" "jailbroken", "managementagent" "managementagent", "osversion" "osversion", "easactivated" "easactivated", "easdeviceid" "easdeviceid", "easactivationdatetime" "easactivationdatetime", "azureadregistered" "azureadregistered" } } ] remote lock lock action endpoint url /v1 0/devicemanagement/manageddevices/{{manageddeviceid}}/remotelock method post input argument name type required description manageddeviceid string required the id of the managed device output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response example \[ { "status code" 200, "reason" "ok", "headers" null, "response" {} } ] remove all user's devices from management remove all devices from management for a user endpoint url /beta/users/{{usersid}}/removealldevicesfrommanagement method post input argument name type required description usersid string required the id of the user output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response example \[ { "status code" 200, "reason" "ok", "headers" null, "response" {} } ] reset passcode reset the passcode of a managed device endpoint url /v1 0/devicemanagement/manageddevices/{{manageddeviceid}}/resetpasscode method post input argument name type required description manageddeviceid string required the id of the managed device output parameter type description status code number http status code of the response reason string response reason phrase headers object http headers for the request response object output field response example \[ { "status code" 200, "reason" "ok", "headers" null, "response" {} } ]