命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示用于登录到用户帐户的标识。 标识可由 Microsoft、组织或社交标识提供者(如 Facebook、Google 或 Microsoft)提供。 这允许用户使用任何这些关联标识登录到用户帐户。
用户资源的 identityentities 属性是一个 objectIdentity 对象。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| signInType | String | 指定目录中的用户登录类型,例如 emailAddress、 userName、 federated或 userPrincipalName。
federated 表示来自颁发者的用户的唯一标识符,可以是颁发者选择的任何格式。 设置或更新 userPrincipalName 标识会更新用户对象上 userPrincipalName 属性的值。 对用户对象上的属性执行的验证(例如,验证的域和可接受的字符)是在 userPrincipalName 设置或更新 userPrincipalName 标识时执行的。 当登录类型设置为 emailAddress 或 userName时,会对 issuerAssignedId 强制实施额外的验证。 此属性也可以设置为任何自定义字符串。 有关筛选此属性的行为的详细信息,请参阅 筛选用户的标识属性。 |
| 颁发者 | String | 指定标识的颁发者,例如 facebook.com。 最多 512 个字符。 对于未) federatedsignInType (本地帐户,此属性是租户的本地默认域名,例如 contoso.com。 对于来自其他 Microsoft Entra 组织的来宾,这是联合组织的域,例如 contoso.com。 有关筛选此属性的行为的详细信息,请参阅 筛选用户的标识属性。 |
| issuerAssignedId | String | 指定颁发者分配给用户的唯一标识符。 64 个字符限制。
issuer 和 issuerAssignedId 的组合在组织中必须是唯一的。 当 signInType 设置为 emailAddress 或 userName (称为本地帐户) 时,表示用户的登录名称。当 signInType 设置为:
有关筛选此属性的行为的详细信息,请参阅 筛选用户的标识属性。 |
筛选
筛选 issuerAssignedId 的 identities 属性时:
- 以下值支持仅对颁发者进行筛选:
google.com、、facebook.commail、和phone。 - 筛选 signInType 为
federated的条目需要有效的 颁发者 和 issuerAssignedId。 - 筛选 signInType 为
userName或emailAddress要求有效的 颁发者 和 issuerAssignedId 的条目,但忽略颁发者值。 这是设计使然的。 - 不支持筛选 signInType 为 的
userPrincipalName条目。 可以改为对用户对象的 userPrincipalName 属性进行筛选。
关系
无。
JSON 表示形式
以下 JSON 表示形式显示资源类型。
{
"signInType": "string",
"issuer": "string",
"issuerAssignedId": "string"
}