tipo de recurso onPremisesPublishing

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Una aplicación local publicada a través del proxy de aplicación Microsoft Entra se representa mediante un objeto de aplicación y su propiedad onPremisesPublishing asociada. Application Proxy proporciona acceso remoto seguro a las aplicaciones locales.

Un objeto onPremisesPublishing representa el conjunto de propiedades para configurar Application Proxy para una aplicación local.

Después de crear una instancia de una aplicación personalizada o crear una aplicación, la configuración del proxy de aplicación para la aplicación se puede configurar actualizando las propiedades onPremisesPublishing de la aplicación.

Para obtener un tutorial sobre la configuración de Application Proxy, consulte Automatización de la configuración de Application Proxy mediante Microsoft Graph API.

Propiedades

Propiedad Tipo Descripción
alternateUrl Cadena Si va a configurar un administrador de tráfico delante de varias aplicaciones de Proxy de aplicación, alternateUrl es la dirección URL fácil de usar que apunta al administrador de tráfico.
applicationServerTimeout Cadena La duración en la que el conector espera una respuesta de la aplicación back-end antes de cerrar la conexión. Los valores posibles son default, long. Cuando se establece en predeterminado, el tiempo de espera de la aplicación back-end tiene una longitud de 85 segundos. Cuando se establece en long, el tiempo de espera del back-end se aumenta a 180 segundos. Use long si el servidor tarda más de 85 segundos en responder a las solicitudes o si no puede acceder a la aplicación y el estado del error es "Tiempo de espera de back-end". El valor predeterminado es default.
applicationType Cadena Indica si esta aplicación es una aplicación configurada por Application Proxy. El sistema lo establece previamente. Solo lectura.
externalAuthenticationType externalAuthenticationType Detalla la configuración de autenticación previa para la aplicación. La autenticación previa exige que los usuarios deben autenticarse antes de acceder a la aplicación. El paso a través no requiere autenticación. Los valores posibles son passthru y aadPreAuthentication.
externalUrl Cadena Dirección URL externa publicada para la aplicación. Por ejemplo, https://intranet-contoso.msappproxy.net/.
internalUrl Cadena Dirección URL interna de la aplicación. Por ejemplo: https://intranet/.
isBackendCertificateValidationEnabled Booleano Indica si la validación del certificado SSL de back-end está habilitada para la aplicación. Para todas las nuevas aplicaciones de Application Proxy, la propiedad se establece en true de forma predeterminada. Para todas las aplicaciones existentes, la propiedad se establece en false.
isHttpOnlyCookieEnabled Booleano Indica si la marca de cookie HTTPOnly debe establecerse en los encabezados de respuesta HTTP. Establezca este valor true en para que las cookies de Application Proxy incluyan la marca HTTPOnly en los encabezados de respuesta HTTP. Si usa Servicios de Escritorio remoto, establezca este valor en False. El valor predeterminado es false.
isOnPremPublishingEnabled Booleano Indica si la aplicación se está publicando actualmente a través de Application Proxy o no. El sistema lo preajusta. Solo lectura.
isPersistentCookieEnabled Booleano Indica si la marca cookie persistente debe establecerse en los encabezados de respuesta HTTP. Mantenga este valor establecido en false. Use esta configuración solo para aplicaciones que no puedan compartir cookies entre procesos. Para obtener más información sobre la configuración de cookies, consulte Configuración de cookies para acceder a aplicaciones locales en Microsoft Entra ID. El valor predeterminado es false.
isSecureCookieEnabled Booleano Indica si la marca de cookie Secure debe establecerse en los encabezados de respuesta HTTP. Establezca este valor true en para transmitir cookies a través de un canal seguro, como una solicitud HTTPS cifrada. El valor predeterminado es true.
isStateSessionEnabled Booleano Indica si está habilitada la validación del parámetro de estado cuando el cliente usa el flujo de concesión de código de autorización de OAuth 2.0. Esta configuración permite a los administradores especificar si quieren habilitar la protección CSRF para sus aplicaciones.
isTranslateHostHeaderEnabled Booleano Indica si la aplicación debe traducir direcciones URL en los encabezados de respuesta. Mantenga este valor como true a menos que la aplicación requiera el encabezado de host original en la solicitud de autenticación. El valor predeterminado es true.
isTranslateLinksInBodyEnabled Booleano Indica si la aplicación debe traducir direcciones URL en el cuerpo de la aplicación. Mantenga este valor como false a menos que tenga vínculos HTML codificados de forma rígida a otras aplicaciones locales y no use dominios personalizados. Para obtener más información, consulte Traducción de vínculos con Application Proxy. El valor predeterminado es false.
onPremisesApplicationSegments (en desuso) colección onPremisesApplicationSegment Representa la colección de segmentos de aplicación para una aplicación con caracteres comodín locales. Esta propiedad está en desuso y dejará de devolver datos el 1 de junio de 2023. Use segmentsConfiguration en su lugar.
segmentsConfiguration segmentConfiguration Representa la colección de segmentos de aplicación para una aplicación con caracteres comodín locales que se publica a través del proxy de aplicación Microsoft Entra.
singleSignOnSettings onPremisesPublishingSingleSignOn Representa la configuración de inicio de sesión único para la aplicación local.
verifiedCustomDomainCertificatesMetadata verifiedCustomDomainCertificatesMetadata Detalles del certificado asociado a la aplicación cuando se usa un dominio personalizado. null cuando se usa el dominio predeterminado. Solo lectura.
verifiedCustomDomainKeyCredential keyCredential Credencial de clave asociada para el dominio personalizado usado.
verifiedCustomDomainPasswordCredential passwordCredential Credencial de contraseña asociada para el dominio personalizado usado.

Relaciones

Ninguna.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "alternateUrl": "String",
  "applicationServerTimeout": "String",
  "applicationType": "String",
  "externalAuthenticationType": "String",
  "externalUrl": "String",
  "internalUrl": "String",
  "isBackendCertificateValidationEnabled": 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"}
}