客户端属性

Last published : Oct 21, 2026
客户端属性包含直接提供给用户设备上的 Citrix Secure Hub 的信息。您可以使用这些属性来配置高级设置,例如 Citrix PIN。您可以从 Citrix 支持获取客户端属性。
客户端属性可能会随 Citrix Secure Hub 的每个版本更改,有时也会随客户端应用程序更改。有关更常用客户端属性的详细信息,请参阅本文后面的客户端属性参考。
  1. 在 Citrix Endpoint Management 控制台中,单击右上角的齿轮图标。此时将显示“设置”页面。
  2. 在“客户端”下,单击“客户端属性”。此时将显示“客户端属性”页面。您可以从此页面添加、编辑和删除客户端属性。
    客户端属性屏幕

添加客户端属性

  1. 单击“添加”。此时将显示“添加新客户端属性”页面。
    客户端属性屏幕
  2. 配置以下设置:
    • 密钥: 从下拉列表中单击要添加的属性密钥。重要提示: 在更新设置之前,请联系 Citrix 支持。您可以请求一个特殊密钥。
    • 值: 所选属性的值。
    • 名称: 属性的名称。
    • 说明: 属性的说明。
  3. 单击“保存”。

编辑客户端属性

  1. 在客户端属性表中,选择要编辑的客户端属性。
    选中客户端属性旁边的复选框以打开客户端属性列表上方的选项菜单。单击列表中的其他任意位置以打开列表右侧的选项菜单。
  2. 单击编辑。此时将显示编辑客户端属性页面。
    客户端属性屏幕
  3. 根据需要更改以下信息:
    • **密钥:**您无法更改此字段。
    • **值:**属性值。
    • **名称:**属性名称。
    • **描述:**属性描述。
  4. 单击保存以保存更改,或单击取消以使属性保持不变。

删除客户端属性

  1. 在客户端属性表中,选择要删除的客户端属性。
    通过选中每个属性旁边的复选框,可以选择多个属性进行删除。
  2. 单击删除。此时将显示确认对话框。再次单击删除。

客户端属性参考

Citrix Endpoint Management 的预定义客户端属性及其默认设置如下:
  • ALLOW_CLIENTSIDE_PROXY
    • 显示名称:ALLOW_CLIENTSIDE_PROXY
    • 如果您的用户想要使用他们在 iOS 手机上配置的代理,请将此自定义策略设置为默认值 true。
      某些用户可能已在其设备上的 “设置”>“Wi-Fi”>“配置代理” 中配置了代理。如果 Citrix Secure Hub 未为这些用户打开,请执行以下操作之一:
      • 从设备中删除代理配置,然后重新启动 Citrix Secure Hub。
      • 将设备连接到另一个 Wi-Fi 网络。Citrix Secure Hub 重新进行身份验证后,它将获取 ALLOW_CLIENTSIDE_PROXY 属性并打开。
    • 如果 ALLOW_CLIENTSIDE_PROXY 为 false 且用户在其设备上配置了代理,则 Citrix Endpoint Management 会检测到该代理。但是,Citrix Secure Hub 不会使用该代理并显示错误消息。如果设备连接到启用了代理的接入点或路由器,则 Citrix Endpoint Management 不会检测到该代理。为了获得最高安全性,我们建议您使用证书锁定。有关为 Citrix Secure Hub 启用证书锁定的信息,请参阅证书锁定。
    • 要配置此自定义客户端策略,请转至 “设置”>“客户端属性”,添加自定义密钥 ALLOW_CLIENTSIDE_PROXY,然后设置 “值”。
  • CONTAINER_SELF_DESTRUCT_PERIOD
    • 显示名称:MDX 容器自毁期限
    • 自毁功能可在指定天数的不活动后阻止访问 Citrix Secure Hub 和托管应用程序。超过时间限制后,应用程序将无法使用。擦除数据包括清除每个已安装应用程序的应用程序数据,包括应用程序缓存和用户数据。
      不活动时间是指服务器在特定时间长度内未收到用于验证用户的身份验证请求。假设此属性为 30 天。如果用户超过 30 天未使用该应用程序,则该策略将生效。
      此全局安全策略适用于 iOS 和 Android 平台,是对现有应用程序锁定和擦除策略的增强。
    • 要配置此全局策略,请转到 设置 > 客户端属性 并添加自定义密钥 CONTAINER_SELF_DESTRUCT_PERIOD。
    • 值:天数
  • DEVICE_LOGS_TO_IT_HELP_DESK
    • 显示名称:将设备日志发送到 IT 帮助台
    • 此属性启用或禁用向 IT 帮助台发送日志的功能。
    • 可能的值:true 或 false
    • 默认值:false
  • DISABLE_LOGGING
    • 显示名称:禁用日志记录
    • 使用此属性可阻止用户从其设备收集和上传日志。此属性会禁用 Citrix Secure Hub 和所有已安装的 MDX 应用程序的日志记录。用户无法从“支持”页面发送任何应用程序的日志。即使显示邮件撰写对话框,日志也不会附加。一条消息指示日志记录已禁用。此设置还会阻止您在 Citrix Endpoint Management 控制台中更新 Citrix Secure Hub 和 MDX 应用程序的日志设置。
      当此属性设置为 true 时,Citrix Secure Hub 会将 阻止应用程序日志 设置为 true。因此,当应用新策略时,MDX 应用程序将停止日志记录。
    • 可能的值:true 或 false
    • 默认值:false(未禁用日志记录)
  • ENABLE_CRASH_REPORTING
    • 显示名称:启用崩溃报告
    • 如果为 true,Citrix 将收集崩溃报告和诊断信息,以帮助排查适用于 iOS 和 Android 的 Citrix Secure Hub 的问题。如果为 false,则不收集任何数据。
    • 可能的值:true 或 false
    • 默认值:true
  • ENABLE_CREDENTIAL_STORE
    • 显示名称:启用凭据存储
    • 启用凭据存储意味着 Android 或 iOS 用户在访问 Citrix 移动生产力应用程序时只需输入一次密码。无论是否启用 Citrix PIN,您都可以使用凭据存储。如果您未启用 Citrix PIN,用户将输入其 Active Directory 密码。Citrix Endpoint Management 仅支持将 Active Directory 密码与凭据存储结合用于 Citrix Secure Hub 和公共应用商店应用程序。如果您将 Active Directory 密码与凭据存储结合使用,Citrix Endpoint Management 不支持 PKI 身份验证。
    • 要在 Citrix Secure Mail 中自动注册,需要将此属性设置为 true。
    • 要配置此自定义客户端策略,请转至 Settings > Client Properties,添加自定义密钥 ENABLE_CREDENTIAL_STORE,并将 Value 设置为 true。
  • ENABLE_PASSCODE_AUTH
    • 显示名称:启用 Citrix PIN 身份验证
    • 此属性允许您启用 Citrix PIN 功能。通过 Citrix PIN 或密码,系统会提示用户定义一个 PIN,以代替其 Active Directory 密码使用。当 ENABLE_PASSWORD_CACHING 启用或 Citrix Endpoint Management 使用证书身份验证时,此设置会自动启用。
      对于离线身份验证,Citrix PIN 在本地进行验证,用户可以访问其请求的应用程序或内容。对于在线身份验证,Citrix PIN 或密码会解锁 Active Directory 密码或证书,然后将其发送给 Citrix Endpoint Management 进行身份验证。
      如果 ENABLE_PASSCODE_AUTH 为 true 且 ENABLE_PASSWORD_CACHING 为 false,则在线身份验证始终会提示输入密码,因为 Citrix Secure Hub 不会保存密码。
    • 可能的值:true 或 false
    • 默认值:false
  • ENABLE_PASSWORD_CACHING
    • 显示名称: 启用用户密码缓存
    • 此属性允许 Active Directory 密码在移动设备上本地缓存。当您将此属性设置为 true 时,还必须将 ENABLE_PASSCODE_AUTH 属性设置为 true。启用用户密码缓存后,Citrix Endpoint Management 会提示用户设置 Citrix PIN 或密码。
    • 可能的值: true 或 false
    • 默认值: false
  • ENABLE_TOUCH_ID_AUTH
    • 显示名称: 启用触控 ID 身份验证
    • 对于支持触控 ID 身份验证的设备,此属性可启用或禁用设备上的触控 ID 身份验证。要求:
      用户设备必须启用 Citrix PIN 或 LDAP。如果 LDAP 身份验证已关闭(例如,因为仅使用基于证书的身份验证),用户必须设置 Citrix PIN。在这种情况下,即使客户端属性 ENABLE_PASSCODE_AUTH 为 false,Citrix Endpoint Management 也需要 Citrix PIN。
      将 ENABLE_PASSCODE_AUTH 设置为 false,以便当用户启动应用程序时,他们必须响应提示才能使用触控 ID。
    • 可能的值: true 或 false
    • 默认值: false
  • ENABLE_WORXHOME_CEIP
    • 显示名称: 启用 Citrix Secure Hub CEIP
    • 此属性启用客户体验改善计划。该功能会定期向 Citrix 发送匿名配置和使用数据。这些数据有助于 Citrix 提高 Citrix Endpoint Management 的质量、可靠性和性能。
    • 值:true 或 false
    • 默认值:false
  • ENCRYPT_SECRETS_USING_PASSCODE
    • 显示名称:使用密码加密机密
    • 此属性将敏感数据存储在设备上的秘密保管库中,而不是存储在基于平台的本机存储(例如 iOS 钥匙串)中。此属性可对关键工件进行强加密并添加用户熵。用户熵是只有用户知道的用户生成的随机 PIN 码。
      Citrix 建议您启用此属性,以帮助提高用户设备上的安全性。因此,用户会收到更多 Citrix PIN 身份验证提示。
    • 可能的值:true 或 false
    • 默认值:false
  • INACTIVITY_TIMER
    • 显示名称:不活动计时器
    • 此属性定义了用户可以将设备置于不活动状态多长时间,然后无需提示 Citrix PIN 或密码即可访问应用程序。要为 MDX 应用程序启用此设置,请将“应用程序密码”设置设为“开”。如果“应用程序密码”设置设为“关”,则用户将被重定向到 Citrix Secure Hub 以进行完全身份验证。更改此设置后,该值将在用户下次收到身份验证提示时生效。
      在 iOS 上,“不活动计时器”还控制 MDX 和非 MDX 应用程序对 Citrix Secure Hub 的访问。
    • 可能的值:任何正整数
    • 默认值:15(分钟)
  • ON_FAILURE_USE_EMAIL
    • 显示名称:失败时使用电子邮件将设备日志发送到 IT 帮助台
    • 此属性启用或禁用使用电子邮件将设备日志发送给 IT 的功能。
    • 可能的值:true 或 false
    • 默认值:true
  • PASSCODE_EXPIRY
    • 显示名称:PIN 更改要求
    • 此属性定义 Citrix PIN 或密码的有效期,过期后用户将被强制更改其 Citrix PIN 或密码。更改此设置时,新值仅在当前 Citrix PIN 或密码过期时设置。
    • 可能的值:建议 1 到 99。要消除 PIN 重置,请将值设置为一个较大的数字(例如,100,000,000,000)。如果您最初将有效期设置为 1 到 99 天之间,然后在此期间更改为较大的数字:PIN 仍会在初始期限结束时过期,但之后不会再过期。
    • 默认值:90(天)
  • PASSCODE_HISTORY
    • 显示名称:PIN 历史记录
    • 此属性定义用户在更改 Citrix PIN 或密码时不能重复使用的先前 Citrix PIN 或密码的数量。更改此设置时,新值将在用户下次重置其 Citrix PIN 或密码时设置。
    • 可能的值:1 到 99
    • 默认值:5
  • PASSCODE_MAX_ATTEMPTS
    • 显示名称: PIN 尝试次数
    • 此属性定义用户在被提示进行完整身份验证之前可以进行多少次错误的 Citrix PIN 或密码尝试。用户成功完成完整身份验证后,系统会提示他们创建 Citrix PIN 或密码。
    • 可能的值: 任何正整数
    • 默认值: 15
  • PASSCODE_MIN_LENGTH
    • 显示名称: PIN 长度要求
    • 此属性定义 Citrix PIN 的最小长度。
    • 可能的值: 4 到 10
    • 默认值: 6
  • PASSCODE_STRENGTH
    • 显示名称: PIN 强度要求
    • 此属性定义 Citrix PIN 或密码的强度。更改此设置后,下次提示用户进行身份验证时,系统会提示他们创建 Citrix PIN 或密码。
    • 可能的值: 低、中、高或强
    • 默认值: 中
    • 基于 PASSCODE_TYPE 设置的每个强度设置的密码规则如下所示:
数字密码的规则:
密码强度 数字密码类型的规则 允许 不允许
低 所有数字,允许任何序列 444444, 123456, 654321
中(默认设置) 所有数字不能相同或连续。 444333, 124567, 136790, 555556, 788888 444444, 123456, 654321
高 相邻数字不能相同。 123512, 134134, 132312, 131313, 987456 080080, 112233, 135579, 987745, 919199
强 不要使用相同的数字超过两次。不要使用三个或更多连续的数字。不要使用三个或更多反向连续的数字。 102983, 085085, 824673, 132312 132132, 131313, 902030
字母数字密码规则:
密码强度 字母数字密码类型规则 允许 不允许
低 必须至少包含一个数字和一个字母 aa11b1, Abcd1#, Ab123~, aaaa11, aa11aa AAAaaa, aaaaaa, abcdef
中(默认设置) 除了低密码强度规则外,字母和所有数字不能相同。字母不能连续,数字也不能连续。 aa11b1, aaa11b, aaa1b2, abc145, xyz135, sdf123, ab12c3, a1b2c3, Abcd1#, Ab123~ aaaa11, aa11aa, 或 aaa111; abcd12, bcd123, 123abc, xy1234, xyz345, 或 cba123
高 至少包含一个大写字母和一个小写字母。 Abcd12, jkrtA2, 23Bc#, AbCd abcd12, DFGH2
强 至少包含一个数字、一个特殊符号、一个大写字母和一个小写字母。 Abcd1#, Ab123~, xY12#3, Car12#, AAbc1# abcd12, Abcd12, dfgh12, jkrtA2
  • 密码类型
    • 显示名称:PIN 类型
    • 此属性定义用户是可以使用数字 Citrix PIN 还是字母数字密码。当您选择数字时,用户只能使用数字 (Citrix PIN)。当您选择字母数字时,用户可以使用字母和数字的组合(密码)。
      如果您更改此设置,用户在下次系统提示其进行身份验证时必须设置新的 Citrix PIN 或密码。
    • 可能的值:数字或字母数字
    • 默认值:数字
  • REFRESHINTERVAL
    • 显示名称:REFRESHINTERVAL
    • 默认情况下,Citrix Endpoint Management 每 3 天 ping 一次自动发现服务器 (ADS) 以获取固定的证书。要更改刷新间隔,请转到设置 > 客户端属性,添加自定义密钥REFRESHINTERVAL,并将值设置为小时数。
    • 默认值:72 小时(3 天)
  • SEND_LDAP_ATTRIBUTES
    • 对于 Android、iOS 或 macOS 设备的仅 MAM 部署:您可以将 Citrix Endpoint Management 配置为,使用电子邮件凭据注册 Citrix Secure Hub 的用户将自动注册 Citrix Secure Mail。因此,用户无需提供额外信息或采取额外步骤即可注册 Citrix Secure Mail。
    • 要配置此全局客户端策略,请转到设置 > 客户端属性,添加自定义密钥SEND_LDAP_ATTRIBUTES,并按如下方式设置值。
    • 值:userPrincipalName=${user.userprincipalname},sAMAccountNAme=${user.samaccountname}, displayName=${user.displayName},mail=${user.mail}
    • 属性值被指定为宏,类似于 MDM 策略。
    • 以下是此属性的示例帐户服务响应:
      <property value="userPrincipalName=user@site.com,sAMAccountName=eng1,displayName=user\,test1,email=user@site.com\,user@site.com" name="SEND_LDAP_ATTRIBUTES"/>
    • 对于此属性,Citrix Endpoint Management 将逗号字符视为字符串终止符。因此,如果属性值包含逗号,请在其前面加上反斜杠。反斜杠可防止客户端将嵌入的逗号解释为属性值的结尾。使用 "\\" 表示反斜杠字符。
  • HIDE_THREE_FINGER_TAP_MENU
    • 当此属性未设置或设置为 false 时,用户可以通过在其设备上执行三指轻触来访问隐藏功能菜单。隐藏功能菜单允许用户重置应用程序数据。将此属性设置为 true 会禁用用户对隐藏功能菜单的访问。
    • 要配置此全局客户端策略,请转至 Settings > Client Properties,添加自定义密钥 HIDE_THREE_FINGER_TAP_MENU 并设置 Value。
  • TUNNEL_EXCLUDE_DOMAINS
    • 显示名称:隧道排除域
    • 默认情况下,MDX 会从微 VPN 隧道中排除移动应用程序 SDK 和应用程序用于各种功能的某些服务终结点。例如,这些终结点包括不需要通过企业网络路由的服务,例如 Google Analytics、Citrix Cloud™ 服务和 Active Directory 服务。使用此客户端属性可将其他域添加到排除域列表中。
    • 要配置此全局客户端策略,请转至 Settings > Client Properties,添加自定义密钥 TUNNEL_EXCLUDE_DOMAINS 并设置 Value。
    • 值:要从隧道中排除的其他域,请键入一个逗号分隔的域后缀列表。例如:
      app.launchdarkly.com,cis.citrix.com,cis-staging.citrix.com,cis-test.citrix.com,clientstream.launchdarkly.com,crashlytics.com,events.launchdarkly.com,fabric.io,firehose.launchdarkly.com, hockeyapp.net,mobile.launchdarkly.com,pushreg.xm.citrix.com,rttf.citrix.com,rttf-staging.citrix.com,rttf-test.citrix.com,ssl.google-analytics.com,stream.launchdarkly.com,features.netscalergatewaystaging.net,features.netscalergateway.net
Citrix Endpoint Management 的自定义客户端属性如下:
ENABLE_MAM_NFACTOR_SSO:
  • 此属性允许您在使用 NetScaler® Gateway 中的高级身份验证策略时,在 Secure Hub 的 MAM 注册或登录期间启用或禁用 MAM nFactor SSO。如果值设置为 true,则在 Secure Hub 的 MAM 注册或登录期间启用 MAM nFactor SSO。
  • 要配置此属性,请转至 Settings > Client Properties 并单击 Add。在 Key 下拉菜单中选择 Custom Key 并酌情更新以下信息:
    • 密钥 - ENABLE_MAM_NFACTOR_SSO
    • 值 - true 或 false
    • 名称 - ENABLE_MAM_NFACTOR_SSO
    • 描述 - 添加相关描述
MICROSOFT_CERTIFICATE_STRONG_MAPPING:
  • 此属性控制在使用 Secure Mail 和 Microsoft 公钥基础结构 (PKI) 时,是否通过将安全标识符 (SID) 附加到主题备用名称 (SAN) 来续订现有客户端证书,以支持证书强映射功能。如果值设置为 true,则现有客户端证书将续订以包含 SAN SID。
  • 此属性仅适用于 Microsoft PKI。
  • 要配置此属性,请转到“设置 > 客户端属性”,然后单击“添加”。在“密钥”下拉菜单中选择“自定义密钥”,并根据需要更新以下信息:
    • 密钥 - MICROSOFT_CERTIFICATE_STRONG_MAPPING
    • 值 - true 或 false
    • 名称 - MICROSOFT_CERTIFICATE_STRONG_MAPPING
    • 描述 - 续订客户端证书以包含 SAN SID
aeDeviceCertRenewSupport:
  • 此属性控制最终用户是否可以从 Citrix Secure Hub 应用程序查看设备证书运行状况并自动修复证书问题。如果值设置为 true,则启用此功能。
  • 要配置此属性,请转到“设置 > 客户端属性”,然后单击“添加”。在“密钥”下拉菜单中选择“自定义密钥”,并根据需要更新以下信息:
    • 密钥 - aeDeviceCertRenewSupport
    • 值 - true 或 false
    • 名称 - aeDeviceCertRenewSupport
    • 描述 - 启用设备证书健康状态和自动修复证书问题