Microsoft Intune
40 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/ 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 path parameters detectedappid string required the id of the detected app input example {"path parameters" {"detectedappid" "string"}} 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 response value object value for the parameter response value \@odata type string response data response value id string unique identifier response value displayname string name of the resource response value version string value for the parameter response value sizeinbyte number value for the parameter response value devicecount number value for the parameter response value publisher string value for the parameter response value platform string value for the parameter output example {"status code" 200,"reason" "ok","headers"\ null,"response" {"value" {"@odata type" "#microsoft graph detectedapp","id" "caf60db6 0db6 caf6 b60d f6cab60df6ca","displayname" "display name value","version" "version value","sizeinbyte" 10,"devicecount" 11,"publisher" "publisher value","platform" "windows"}}} 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 response value array value for the parameter response value \@odata type string response data response value id string unique identifier response value displayname string name of the resource response value version string value for the parameter response value sizeinbyte number value for the parameter response value devicecount number value for the parameter response value publisher string value for the parameter response value platform string value for the parameter output 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 path parameters userid string required the id of the user input example {"path parameters" {"userid" "string"}} 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 response value array value for the parameter response value \@odata type string response data response value id string unique identifier response value displayname string name of the resource response value description string value for the parameter response value priority number value for the parameter response value createddatetime string value for the parameter response value lastmodifieddatetime string value for the parameter response value version number value for the parameter output 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 path parameters userid string required the id of the user input example {"path parameters" {"userid" "string"}} 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 response value array value for the parameter response value \@odata type string response data response value id string unique identifier response value userid string unique identifier response value devicename string name of the resource response value hardwareinformation object value for the parameter response value hardwareinformation \@odata type string response data response value hardwareinformation serialnumber string value for the parameter response value hardwareinformation totalstoragespace number value for the parameter response value hardwareinformation freestoragespace number value for the parameter response value hardwareinformation imei string value for the parameter response value hardwareinformation meid string unique identifier response value hardwareinformation manufacturer string value for the parameter response value hardwareinformation model string value for the parameter response value hardwareinformation phonenumber string value for the parameter response value hardwareinformation subscribercarrier string value for the parameter response value hardwareinformation cellulartechnology string value for the parameter response value hardwareinformation wifimac string value for the parameter response value hardwareinformation operatingsystemlanguage string value for the parameter response value hardwareinformation issupervised boolean value for the parameter response value hardwareinformation isencrypted boolean value for the parameter output 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 path parameters usersid string required the id of the user input example {"path parameters" {"usersid" "string"}} 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 response value array value for the parameter response value \@odata type string response data response value displayname string name of the resource response value description string value for the parameter response value createddatetime string value for the parameter response value lastmodifieddatetime string value for the parameter response value id string unique identifier response value version string value for the parameter output 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 path parameters usersid string required the id of the user input example {"path parameters" {"usersid" "string"}} 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 response id string unique identifier response userid string unique identifier response devicename string name of the resource response manageddeviceownertype string type of the resource response enrollmentdatetime string time value response lastsyncdatetime string time value response operatingsystem string output field response operatingsystem response compliancestate string output field response compliancestate response jailbroken string output field response jailbroken response managementagent string output field response managementagent response osversion string output field response osversion response easactivated string output field response easactivated response easdeviceid string unique identifier response easactivationdatetime string time value response azureadregistered string output field response azureadregistered response deviceenrollmenttype string type of the resource response activationlockbypasscode string output field response activationlockbypasscode response emailaddress string output field response emailaddress response azureaddeviceid string unique identifier response deviceregistrationstate string output field response deviceregistrationstate response devicecategorydisplayname string name of the resource output 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" "easactivationda remote lock lock action endpoint url /v1 0/devicemanagement/manageddevices/{{manageddeviceid}}/remotelock method post input argument name type required description path parameters manageddeviceid string required the id of the managed device input example {"path parameters" {"manageddeviceid" "string"}} 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 output 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 path parameters usersid string required the id of the user input example {"path parameters" {"usersid" "string"}} 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 output 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 path parameters manageddeviceid string required the id of the managed device input example {"path parameters" {"manageddeviceid" "string"}} 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 output example {"status code" 200,"reason" "ok","headers"\ null,"response" {}} response headers header description example content type the media type of the resource application/json date the date and time at which the message was originated thu, 01 jan 2024 00 00 00 gmt