objectIdentity 资源类型

命名空间: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 设置为:
  • emailAddress (或以 emailAddress 类似) 开 emailAddress1 头的自定义字符串, issuerAssignedId 必须是有效的电子邮件地址
  • userName, issuerAssignedId 必须以字母字符或数字开头,并且只能包含字母数字字符和以下符号: - 或 _


  • 有关筛选此属性的行为的详细信息,请参阅 筛选用户的标识属性。

筛选

筛选 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"
}