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