homeRealmDiscoveryPolicy 资源类型

命名空间:microsoft.graph

表示用于控制联合用户的Microsoft Entra 身份验证行为的策略,尤其是针对联合域中的自动注册和用户身份验证限制。 可以为组织中的所有服务主体或组织中的特定服务主体设置 homeRealmDiscoveryPolicy 。 有关更多方案和策略详细信息,请参阅 使用主领域发现策略为应用程序配置 Microsoft Entra 登录行为使用电子邮件作为备用登录 ID Microsoft Entra ID 登录。

继承自 stsPolicy

方法

方法 返回类型 Description
List homeRealmDiscoveryPolicy 读取 homeRealmDiscoveryPolicies 对象的属性和关系。
创建 homeRealmDiscoveryPolicy 创建 homeRealmDiscoveryPolicy 对象。
Get homeRealmDiscoveryPolicy 读取 homeRealmDiscoveryPolicy 对象的属性和关系。
更新 更新 homeRealmDiscoveryPolicy 对象。
删除 None 删除 homeRealmDiscoveryPolicy 对象。
列表适用于 directoryObject collection 获取已应用此策略的 directoryObject 列表。
分配到服务主体 None 将 homeRealmDiscoveryPolicy 对象分配给 servicePrincipal 对象。
分配给服务主体的列表 homeRealmDiscoveryPolicy 集合 列出分配给 servicePrincipal 对象的 homeRealmDiscoveryPolicy 对象。
取消从服务主体分配 None servicePrincipal 对象中删除 homeRealmDiscoveryPolicy 对象。

属性

属性 类型 说明
定义 字符串集合 一个字符串集合,其中包含定义此策略的规则和设置的 JSON 字符串。 有关此属性的 JSON 架构的详细信息,请参阅 主领域发现策略定义的属性。 必需。
description String 此策略的说明。
displayName String 此策略的显示名称。 必需。
id String 此策略的唯一标识符。 此为只读属性。
isOrganizationDefault 布尔值 如果设置为 true,则激活此策略。 同一策略类型可以有多个策略,但只有一种策略可以激活为组织默认策略。 可选,默认值为 false

主领域发现策略定义的属性

以下对象显示了构成令牌生存期策略定义的 JSON 对象的属性。 此 JSON 对象必须 转换为带转义引号的字符串 ,才能插入 到定义 属性中,如以下示例所示。

"definition": [
    "{
        \"HomeRealmDiscoveryPolicy\": {
          \"AccelerateToFederatedDomain\":true,
          \"AllowCloudPasswordValidation\": false,
          \"PreferredDomain\":\"federated.example.edu\",
          \"AlternateIdLogin\":{
            \"Enabled\":true
          }
        }
      }"
  ]
属性 类型 说明
AccelerateToFederatedDomain 布尔值 true对于自动 (绕过主领域发现) ,请将 设置为 。 如果 true 租户中只有一个经过验证的联合域,则用户将直接转到联合标识提供者 ((例如 ADFS) )进行登录。 如果 true 租户中有多个已验证域,则必须指定 PreferredDomain 。 可选。
AllowCloudPasswordValidation 布尔值 设置为 以 true 允许应用程序通过直接向 Microsoft Entra 令牌终结点提供用户名/密码凭据来对联合用户进行身份验证。 仅当启用了密码哈希同步时有效。 可选。
AlternateIdLogin Json {\"Enabled\": true}设置为 以允许Microsoft Entra 使用电子邮件作为备用登录 ID 登录。 仅当 IsOrganizationDefault 设置为 true时有效。 可选。
PreferredDomain String 指定要加速登录的域。 如果租户只有一个联合域,则可以省略它。 如果省略它,并且有多个已验证的联合域,则此策略无效。 如果 AccelerateToFederatedDomain 为 ,则 true为 必需。

关系

关系 类型 说明
appliesTo directoryObject collection 已应用此策略的 directoryObject 集合。 只读。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "definition": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": true
}