onPremisesPublishing 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

通过 Microsoft Entra 应用程序代理发布的本地应用程序由应用程序对象及其关联的 onPremisesPublishing 属性表示。 应用程序代理提供对本地应用程序的安全远程访问。

onPremisesPublishing 对象表示用于为本地应用程序配置应用程序代理的属性集。

实例化自定义应用程序或创建应用程序后，可以通过更新应用程序的 onPremisesPublishing 属性来配置应用程序的应用程序代理设置。

有关配置应用程序代理的教程，请参阅使用 Microsoft 图形 API自动配置应用程序代理。

属性

属性	类型	说明
alternateUrl	String	如果要在多个应用代理应用程序前面配置流量管理器，alternateUrl 是指向流量管理器的用户友好 URL。
applicationServerTimeout	String	连接器在关闭连接之前等待后端应用程序响应的持续时间。 可能的值为 default、 long。 设置为默认值时，后端应用程序超时的长度为 85 秒。 设置为 long 时，后端超时将增加到 180 秒。 如果服务器响应请求的时间超过 85 秒，或者无法访问应用程序并且错误状态为“后端超时”，请使用 long 。 默认值为 default。
applicationType	String	指示此应用程序是否为应用程序代理配置的应用程序。 这是由系统预先设置的。 此为只读属性。
externalAuthenticationType	externalAuthenticationType	详细说明应用程序的预身份验证设置。 预身份验证强制用户在访问应用之前必须进行身份验证。 直通不需要身份验证。 可取值为：passthru、aadPreAuthentication。
externalUrl	String	应用程序的已发布外部 URL。 例如，https://intranet-contoso.msappproxy.net/。
internalUrl	String	应用程序的内部 URL。 例如，https://intranet/.
isBackendCertificateValidationEnabled	布尔值	指示是否为应用程序启用后端 SSL 证书验证。 对于所有新的应用程序代理应用，属性默认设置为 true 。 对于所有现有应用， 属性设置为 false。
isHttpOnlyCookieEnabled	布尔值	指示是否应在 HTTP 响应标头中设置 HTTPOnly Cookie 标志。 将此值设置为 true 应用程序代理 cookie 在 HTTP 响应标头中包含 HTTPOnly 标志。 如果使用远程桌面服务，请将此值设置为 False。 默认值为 false。
isOnPremPublishingEnabled	布尔值	指示应用程序当前是否通过应用程序代理发布。 这是系统预设的。 此为只读属性。
isPersistentCookieEnabled	布尔值	指示是否应在 HTTP 响应标头中设置持久 Cookie 标志。 将此值设置为 false。 仅对无法在进程之间共享 Cookie 的应用程序使用此设置。 有关 Cookie 设置的详细信息，请参阅用于访问 Microsoft Entra ID 中的本地应用程序的 Cookie 设置。 默认值为 false。
isSecureCookieEnabled	布尔值	指示是否应在 HTTP 响应标头中设置安全 Cookie 标志。 将此值设置为 以 true 通过安全通道（例如加密的 HTTPS 请求）传输 Cookie。 默认值为 true。
isStateSessionEnabled	布尔值	指示客户端使用 OAuth 2.0 授权代码授予流时是否启用状态参数验证。 此设置允许管理员指定是否要为其应用启用 CSRF 保护。
isTranslateHostHeaderEnabled	布尔值	指示应用程序是否应转换响应标头中的 URL。 除非应用程序要求身份验证请求中的原始主机标头，否则请将此值保留为 true 。 默认值为 true。
isTranslateLinksInBodyEnabled	布尔值	指示应用程序是否应转换应用程序正文中的 URL。 除非具有指向其他本地应用程序的硬编码 HTML 链接且不使用自定义域，否则请将此值保留为 false 。 有关详细信息，请参阅链接翻译与 应用程序代理。 默认值为 false。
onPremisesApplicationSegments (已弃用)	onPremisesApplicationSegment 集合	表示本地通配符应用程序的应用程序段集合。 此属性已弃用，将于 2023 年 6 月 1 日停止返回数据。 请改用 segmentsConfiguration 。
segmentsConfiguration	segmentConfiguration	表示通过Microsoft Entra应用程序代理发布的本地通配符应用程序的应用程序段的集合。
singleSignOnSettings	onPremisesPublishingSingleSignOn	表示本地应用程序的单一登录配置。
verifiedCustomDomainCertificatesMetadata	verifiedCustomDomainCertificatesMetadata	在使用自定义域时与应用程序关联的证书的详细信息。 null 使用默认域时。 此为只读属性。
verifiedCustomDomainKeyCredential	keyCredential	使用的自定义域的关联密钥凭据。
verifiedCustomDomainPasswordCredential	passwordCredential	使用的自定义域的关联密码凭据。

JSON 表示形式

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

{
  "alternateUrl": "String",
  "applicationServerTimeout": "String",
  "applicationType": "String",
  "externalAuthenticationType": "String",
  "externalUrl": "String",
  "internalUrl": "String",
  "isBackendCertificationValidationEnabled": true,
  "isHttpOnlyCookieEnabled": true,
  "isOnPremPublishingEnabled": true,
  "isPersistentCookieEnabled": true,
  "isSecureCookieEnabled": true,
  "isStateSessionEnabled": true,
  "isTranslateHostHeaderEnabled": true,
  "isTranslateLinksInBodyEnabled": true,
  "onPremisesApplicationSegments":[{"@odata.type":"microsoft.graph.onPremisesApplicationSegment"}],
  "segmentsConfiguration":{"@odata.type":"microsoft.graph.segmentConfiguration"},
  "singleSignOnSettings": {"@odata.type": "microsoft.graph.onPremisesPublishingSingleSignOn"},
  "verifiedCustomDomainCertificatesMetadata": {"@odata.type": "microsoft.graph.verifiedCustomDomainCertificatesMetadata"},
  "verifiedCustomDomainKeyCredential": {"@odata.type": "microsoft.graph.keyCredential"},
  "verifiedCustomDomainPasswordCredential": {"@odata.type": "microsoft.graph.passwordCredential"}
}