Intune Company Portal 数据 API
Intune Company Portal(公司门户)是 Microsoft Corporation 推出的面向员工的 Android 应用,服务于用 Microsoft Intune 管理手机和平板的组织;Intune 是随 Microsoft 365 提供的终端管理服务,员工以 Microsoft Entra 工作账号登录。注册从输入工作邮箱开始,应用据此识别组织采用联合认证还是本地部署登录,再引导员工接受公司使用条款、领取设备管理证书,并为 Android Enterprise 绑定 Managed Google Play 工作账号。注册完成后,「设备」标签页列出每台已注册手机的昵称、型号和最近签到时间;「设备合规详情」页面逐条说明未通过的规则(例如未设置锁屏密码)、由谁负责修复以及宽限期截止时间;「停用」操作让手机退出管理并清除公司数据,同时保留个人应用和文件。「应用」页面展示 IT 部门分配的公司应用,附带推荐标记、发布者和版本,经 Managed Google Play 安装;应用还会上报 Google Play 保护机制的扫描状态供合规评估,承载 Intune 在 Android 上施加于工作应用的应用保护策略(PIN 与截屏管控),并在首页显示员工工作账号的头像。它的用户是由 IT 部门运行 Intune 的企业、学校和公共部门组织的员工,此处对应美国 Google Play 上架版本;它是微软为 iOS/iPadOS、Windows 和 macOS 发布的 Company Portal 应用的 Android 版本,在其他统一终端管理(UEM)方案中,同样的角色由 Workspace ONE Intelligent Hub 或 Ivanti 的客户端承担。
受管设备记录是核心:登录工作账号名下的每台已注册手机都会返回 Nickname、Manufacturer、Model、OperatingSystem 与 OperatingSystemId,OwnerType 与 ManagementType(如 AndroidEnterprise),ComplianceState,目录设备 ID AadId,以及最近签到时间 LastContact。按需合规评估会追加未通过的规则 NoncompliantRules,每条含 SettingId、Title、ExpectedValue 与 RemediationOwner,并给出宽限期截止时间 InGracePeriodUntilDateTimeUtc;Play Protect 上报则提供 playProtectEnabled、lastScanTimeUtc 与 threatLevel。
设备之外是租户与策略层:分配的工作应用由 applicationGuid、publisher、appVersion、availableDate 与 isFeaturedApp 描述;公司条款按 CompanyTermVersion 版本化并附 AcceptanceStatement;Android 应用保护策略集以 policiesHash 为键,每条带 policiesPayload、policyType 与 priority;Managed Google Play 绑定含 accountName 与 maintenanceState;设备证书给出 LeafThumbprint 与 IntermediateThumbprint;注册发现则把 aadTenantId 映射到对应的 AuthPolicies 与租户专属服务位置。
IT 资产团队据设备列表保持 CMDB 记录同步;零信任接入代理在 AndroidDeviceOwnerPasscodeRequired 等规则超过宽限期仍未通过时拒绝 VPN 会话;软件资产管理工具将分配的应用目录与已购席位对账以回收许可;安全运维保存策略哈希与负载,把 Android 上的 PIN 与截屏管控同 Intune 基线做差异比对。openData Studio 把这些 Intune 设备、合规、目录与策略记录变成可调用的开放数据,供这些集成直接使用。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
注册服务器发现(SOAP)
POST
/v1/enrollment/discoveropendata在设备注册握手之前,将工作邮箱解析到租户的注册端点与认证策略(联合认证或本地部署)。
认证方式: 无需认证的发现调用;工作邮箱放在请求体中。后续注册步骤使用带设备注册作用域的 Microsoft Entra Bearer 令牌。
- EmailAddress
- RequestVersion
- DeviceType
- ApplicationVersion
- OSEdition
- AuthPolicies
- EnrollmentServiceUrl
- AuthenticationServiceUrl
POST /v1/enrollment/discover HTTP/1.1 Content-Type: application/soap+xml; charset=utf-8 <Discover><request><EmailAddress>[email protected]</EmailAddress><RequestVersion>4.0</RequestVersion><DeviceType>AndroidForWork</DeviceType><ApplicationVersion>5.0.7080.0</ApplicationVersion><OSEdition>4</OSEdition><AuthPolicies><AuthPolicy>OnPremise</AuthPolicy><AuthPolicy>Federated</AuthPolicy></AuthPolicies></request></Discover>{ "DiscoveryResponse": { "AuthPolicy": "Federated", "EnrollmentPolicyServiceUrl": "https://enroll.contoso.example/policy", "EnrollmentServiceUrl": "https://enroll.contoso.example/enroll", "AuthenticationServiceUrl": "https://login.contoso.example/contoso.com" } }Intune 服务位置发现
POST
/v1/enrollment/service-locationsopendata返回租户专属的 Android 设备网关、AOSP 预配、注册与诊断 URL,应用登录后会缓存这些地址。
认证方式: 在组织身份提供方签发的 Microsoft Entra Bearer 令牌(设备注册作用域)。
- aadTenantId
- deviceType
- applicationPackageName
- applicationVersionName
- androidDeviceGatewayCertificateServiceUrl
- androidDeviceGatewayServiceUrl
- androidDeviceGatewayServiceFefUrl
- aospProvisioningServiceUrl
- ariaServiceUrl
- enrollmentServiceUrl
- powerliftServiceUrl
POST /v1/enrollment/service-locations HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Content-Type: application/json { "aadTenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47", "deviceType": "Android", "applicationPackageName": "com.example.workapp", "applicationVersionName": "5.0.7080.0" }{ "androidDeviceGatewayCertificateServiceUrl": "https://gw.contoso.example/android/certificates", "androidDeviceGatewayServiceUrl": "https://gw.contoso.example/android/gateway", "androidDeviceGatewayServiceFefUrl": "https://gw.contoso.example", "aospProvisioningServiceUrl": "https://gw.contoso.example/aosp-provisioning", "ariaServiceUrl": "https://telemetry.contoso.example/collector", "enrollmentServiceUrl": "https://enroll.contoso.example/enroll", "powerliftServiceUrl": "https://logs.contoso.example" }列出已注册设备
GET
/v1/fleetopendata分页返回登录用户的受管设备,用于「设备」标签页——昵称、硬件、操作系统、合规状态、最近签到与目录设备 ID。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域),并附带 Accept: application/json 请求头。
- Key
- Nickname
- Manufacturer
- Model
- OfficialName
- OperatingSystem
- OperatingSystemId
- OwnerType
- ComplianceState
- AadId
- DeviceHWId
- LastContact
- ManagementType
- CategoryId
- NoncompliantRules
- odata.id
GET /v1/fleet HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json{ "value": [ { "Key": "d1a2b3c4-1111-2222-3333-444455556666", "Nickname": "Alex Pixel 8", "Manufacturer": "Google", "Model": "Pixel 8", "OfficialName": "Pixel 8", "OperatingSystem": "Android", "OperatingSystemId": "14", "OwnerType": 1, "ComplianceState": "Compliant", "AadId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "DeviceHWId": "android-hw-9f2c", "LastContact": "2026-09-28T18:12:03Z", "ManagementType": "AndroidEnterprise", "CategoryId": "cat-sales", "CategorySetByEndUser": true, "IsReadOnly": false, "InGracePeriodUntilDateTimeUtc": null, "NoncompliantRules": [], "odata.id": "fleet/d1a2b3c4-1111-2222-3333-444455556666" } ] }检查设备合规性
POST
/v1/fleet/{deviceId}/compliance-checkopendata为单台设备触发一次按需合规评估,并返回「设备合规详情」页面上展示的未通过规则。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域)。
- Key
- ComplianceState
- InGracePeriodUntilDateTimeUtc
- NoncompliantRules
- SettingId
- Title
- ExpectedValue
- Description
- MoreInfoUri
- RemediationOwner
- LastContact
POST /v1/fleet/d1a2b3c4-1111-2222-3333-444455556666/compliance-check HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json Content-Length: 0{ "Key": "d1a2b3c4-1111-2222-3333-444455556666", "ComplianceState": "Noncompliant", "InGracePeriodUntilDateTimeUtc": "2026-10-05T00:00:00Z", "NoncompliantRules": [ { "SettingId": "AndroidDeviceOwnerPasscodeRequired", "Title": "Device passcode required", "ExpectedValue": "true", "Description": "A screen lock must be set on this device.", "MoreInfoUri": "https://docs.contoso.example/compliance/passcode", "RemediationOwner": 1 } ], "LastContact": "2026-09-29T17:40:11Z" }停用设备(移除公司数据)
POST
/v1/fleet/{deviceId}/retireopendata启动由用户发起的停用操作:注销设备注册并擦除公司数据,同时保留个人应用与文件。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域)。
- odata.id
- Key
- ManagementType
- retired
POST /v1/fleet/d1a2b3c4-1111-2222-3333-444455556666/retire HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json Content-Length: 0{ "Key": "d1a2b3c4-1111-2222-3333-444455556666", "ManagementType": "AndroidEnterprise", "retired": true }工作应用目录条目
GET
/v1/catalog/apps/{appId}opendata为「应用」页面加载一个分配的公司应用——标题、发布者、图标、推荐标记与安装状态链接。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域)。
- applicationGuid
- name
- publisher
- category
- description
- smallIconUri
- largeIconUri
- isFeaturedApp
- relevance
- availableDate
- appVersion
- privacyStatementUri
- moreInfoUri
GET /v1/catalog/apps/8e2c1a90-77ab-4d21-9c0e-0b6d1f2a3c4d HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json{ "applicationGuid": "8e2c1a90-77ab-4d21-9c0e-0b6d1f2a3c4d", "name": "Microsoft Outlook", "publisher": "Microsoft Corporation", "category": "Productivity", "description": "Email and calendar for work.", "smallIconUri": "https://cdn.contoso.example/catalog/icons/outlook-small.png", "largeIconUri": "https://cdn.contoso.example/catalog/icons/outlook-large.png", "isFeaturedApp": true, "relevance": 10, "availableDate": "2026-01-15T00:00:00Z", "appVersion": "4.2426.0", "privacyStatementUri": "https://privacy.contoso.example", "moreInfoUri": "https://docs.contoso.example/apps/outlook", "installStateLink": "catalog/apps/8e2c1a90-77ab-4d21-9c0e-0b6d1f2a3c4d/install-state" }接受公司条款
POST
/v1/terms/{termsId}/acceptopendata在注册设置过程中记录对租户公司使用条款的接受(条款正文与接受声明均带版本号)。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域)。
- termVersion
- Key
- Title
- BodyText
- AcceptanceStatement
- CompanyTermVersion
POST /v1/terms/contoso-mdm-tos/accept HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Content-Type: application/json Accept: application/json { "termVersion": 3 }{ "Key": "contoso-mdm-tos", "Title": "Contoso mobile use policy", "BodyText": "You must protect company data on this device...", "AcceptanceStatement": "I have read and accept these terms.", "CompanyTermVersion": 3, "accepted": true }用户功能开关
GET
/v1/users/{userId}/featuresopendata读取按用户的功能开关,用于隐藏或显示 Managed Play、工作资料锁定等 Company Portal 界面。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域)。
- featureId
- isEnabled
GET /v1/users/11111111-2222-3333-4444-555555555555/features HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json{ "value": [ {"featureId": "ManagedPlay", "isEnabled": true}, {"featureId": "WebCompanyPortal", "isEnabled": false}, {"featureId": "WorkProfileLockdown", "isEnabled": true} ] }Managed Google Play 账户
GET
/v1/users/{userId}/work-play-accountosint返回 Managed Google Play / 工作账户绑定,用于在 Android Enterprise 设备上从 Play 商店安装公司应用。
认证方式: Microsoft Entra Bearer 令牌(设备管理作用域)。
- accountName
- isAccountDisabled
- isAccountWorkplaceJoinEnabled
- maintenanceState
GET /v1/users/11111111-2222-3333-4444-555555555555/work-play-account HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json{ "accountName": "[email protected]", "isAccountDisabled": false, "isAccountWorkplaceJoinEnabled": true, "maintenanceState": 0 }MAM Android 应用保护策略
GET
/v1/app-protection/android/policiesopendata下载应用于 Company Portal 及其他受保护应用的 Android MAM / 应用保护策略集(PIN、截屏、反馈开关)。
认证方式: Microsoft Entra Bearer 令牌(应用保护策略作用域);客户端在 Authorization 前加上 'Bearer ' 前缀。
- policiesHash
- value
- id
- policyType
- priority
- policiesPayload
GET /v1/app-protection/android/policies HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json{ "policiesHash": "sha256:9c1e0a…", "value": [ { "id": "office16;L_SendFeedback", "policyType": 1, "priority": 10, "policiesPayload": [{"key": "PINRequired", "value": "true"}] } ] }Android 设备网关证书申请
POST
/v1/fleet/{deviceId}/certificatesopendata向 Android 设备网关提交 CSR,并取回用于后续签到的设备管理证书(叶证书与中间证书指纹)。
认证方式: 注册完成后获取的 Microsoft Entra Bearer 令牌(Android 设备网关作用域)。
- CertificateSigningRequest
- Signature
- SigningCertSha256Thumbprint
- Base64EncodedCertificate
- LeafThumbprint
- IntermediateThumbprint
POST /v1/fleet/android-hw-9f2c/certificates HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Content-Type: application/json { "CertificateSigningRequest": "MIICUzCCATsCAQAwgYMxCzAJBgNVBAYTAlVT...", "Signature": "MEUCIQDx…", "SigningCertSha256Thumbprint": "A1B2C3D4E5F60718293A4B5C6D7E8F9012345678ABCDEF01" }{ "Base64EncodedCertificate": "MIIDPjCCAiagAwIBAgIQe0…", "LeafThumbprint": "9F2C8A71B0D4E6…", "IntermediateThumbprint": "7C11AA90FF22…" }上报 Google Play Protect 状态
POST
/v1/fleet/{deviceId}/play-protect-statusopendata上报设备的 Google Play Protect 扫描状态,使要求 Play Protect 的合规策略可以评估该手机。
认证方式: Microsoft Entra Bearer 令牌(Android 设备网关作用域)。
- playProtectEnabled
- lastScanTimeUtc
- threatLevel
- deviceId
POST /v1/fleet/android-hw-9f2c/play-protect-status HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Content-Type: application/json { "playProtectEnabled": true, "lastScanTimeUtc": "2026-09-29T16:01:00Z", "threatLevel": "NoThreatsFound" }{ "deviceId": "android-hw-9f2c", "playProtectEnabled": true, "threatLevel": "NoThreatsFound", "accepted": true }目录设备启用状态
GET
/v1/directory/device-objects/{deviceId}/enabledosint读取目录中的设备对象是否启用——Company Portal 据此判断手机上的工作账户是否仍允许登录。
认证方式: 通过组织身份平台获取的 Microsoft 目录 Bearer 令牌。
- value
GET /v1/directory/device-objects/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/enabled HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: application/json{ "value": true }登录用户头像
GET
/v1/directory/me/photoosint获取 Company Portal 首页与用户资料页展示的工作账户头像。
认证方式: Microsoft 目录 Bearer 令牌。
- $value
GET /v1/directory/me/photo HTTP/1.1 Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs... Accept: image/jpeg(binary JPEG) Content-Type: image/jpeg Content-Length: 18432
数据类别
- 设备
- 合规状态
- 应用程序
- 注册
- 身份标识
- MAM 策略
- 证书
数据使用场景与案例
基于 Company Portal 的 ITAM 设备盘点
CMDB 定时任务以员工身份登录并读取 GET /v1/fleet,获取 Nickname、Manufacturer、Model、OperatingSystem、AadId、LastContact 与 ComplianceState,让资产记录与员工在 Company Portal 中看到的内容保持同步。
授予 VPN 前的零信任状态判定
接入代理调用 POST /v1/fleet/{deviceId}/compliance-check,当 NoncompliantRules 在 InGracePeriodUntilDateTimeUtc 宽限期过后仍列出 AndroidDeviceOwnerPasscodeRequired 等 SettingId 时,拒绝本次会话。
用于许可回收的软件目录
软件资产管理(SAM)工具遍历 GET /v1/catalog/apps/{appId},读取 applicationGuid、publisher、appVersion 与 isFeaturedApp,将分配的工作应用与已购席位逐一比对。
MAM 策略漂移核查
运维团队拉取 GET /v1/app-protection/android/policies,保存 policiesHash 与每条 policiesPayload,用于将 Android 上的 PIN 与截屏管控同 Intune 基线做差异比对。
常见问题
Intune Company Portal 为每台受管设备暴露哪些数据?
设备清单为登录用户注册的每台手机或平板返回 Key、Nickname、Manufacturer、Model、OperatingSystem、OwnerType、ComplianceState、AadId、DeviceHWId、LastContact、ManagementType、CategoryId 以及 NoncompliantRules 列表。
该应用的数据调用如何认证?
通过微软身份平台完成工作或学校账户登录后,应用持有分别面向注册、设备管理、组织目录与应用保护策略作用域的 Bearer 令牌,每次调用都在 Authorization 请求头中携带对应令牌。
按需设备合规检查如何工作?
员工可以为单台设备触发一次新的评估。响应会列出每条未通过的规则:SettingId、可读的 Title、ExpectedValue 与整改链接,以及宽限期截止时间 InGracePeriodUntilDateTimeUtc。
可以看到组织分配了哪些工作应用吗?
可以。工作应用目录为分配给登录用户的每个应用返回 applicationGuid、name、publisher、category、appVersion、推荐标记与图标链接,软件资产管理工具可据此与已购许可对账。
与 Intune Company Portal 相似的应用
- Workspace ONE Intelligent Hub — Omnissa(原 VMware)推出的 Workspace ONE UEM 员工端应用,可将 Android 设备注册进企业管理、查看合规状态并获取公司分配的应用目录,是与 Intune Company Portal 最直接对应的同类产品。
- Android Device Policy — Google 官方的设备注册应用,供使用 Google Workspace 的组织将 Android 手机和平板纳入 Google 端点管理,应用工作资料和管理员设定的设备规则。
- IBM MaaS360 — IBM 的统一端点管理平台,其 Android 代理应用负责设备注册、执行合规策略并分发工作应用,并基于 Watson 提供设备队列分析能力。
- ManageEngine Endpoint Central — ManageEngine 的统一端点管理产品,可在单一控制台管理 Windows、macOS、Linux、iOS 和 Android 设备,并提供最多 25 台桌面加 25 台移动设备的免费版。
- Scalefusion UEM — 一套覆盖 Android、iOS、Windows、macOS、Linux 和 ChromeOS 设备队列的统一端点管理平台,按设备计费,常被列入 MDM 选型对比清单。
- Hexnode UEM — 覆盖 Windows、macOS、Linux、iOS、Android 和 ChromeOS 的 UEM 平台,常因价格亲民而被中小企业列为 Intune 的备选方案。
- Jamf — 以 Apple 设备管理见长的平台,提供零接触部署和员工自助门户,适合管理 iPhone、iPad 和 Mac 设备队列而非 Android 的组织。
相关主题
- Intune Company Portal API
- Microsoft Intune 设备接口
- Company Portal 合规 API
- Intune MAM Android 策略
- Managed Google Play 账户 API
- Intune 注册发现
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业