Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 mediante el proxy de aplicación de Microsoft Entra se representa mediante un objeto de aplicación y su propiedad onPremisesPublishing asociada. Application Proxy proporciona acceso remoto seguro a aplicaciones locales.
Un objeto onPremisesPublishing representa el conjunto de propiedades para configurar Application 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 de Application Proxy para la aplicación se puede configurar actualizando las propiedades onPremises Publishing de la aplicación.
Para obtener un tutorial sobre cómo configurar Application Proxy, consulte Automatizar la configuración de Application Proxy mediante la API de Microsoft Graph API.
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| dirección URL alternativa | Cadena | Si está configurando un administrador de tráfico delante de varias aplicaciones de proxy de aplicaciones, esta dirección URL descriptiva apunta al administrador de tráfico. |
| applicationServerTimeout | Cadena | La duración 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 el valor predeterminado, el tiempo de espera de la aplicación back-end tiene una duración de 85 segundos. Cuando se establece en largo, el tiempo de espera del back-end aumenta a 180 segundos. Úselo 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 de error es "Tiempo de espera de backend". El valor predeterminado es default. |
| applicationType | Cadena | Valor definido por el sistema que indica si esta aplicación es una aplicación configurada por proxy de aplicación. Los valores posibles son quickaccessapp y .nonwebapp Solo lectura. |
| externalAuthenticationType | externalAuthenticationType | Detalla la configuración de autenticación previa de la aplicación. La autenticación previa exige que los usuarios se autentiquen antes de acceder a la aplicación. El paso a través no requiere autenticación. Los valores posibles son: passthru, aadPreAuthentication. |
| url externa | Cadena | La dirección URL externa publicada para la aplicación. Por ejemplo, https://intranet-contoso.msappproxy.net/. |
| internalUrl | Cadena | La URL interna de la aplicación. Por ejemplo, https://intranet/. |
| isAccessibleViaZTNAClient | Booleano | Indica si se puede acceder a la aplicación a través de un cliente de acceso seguro global en un dispositivo administrado. |
| isBackendCertificateValidationEnabled | Booleano | Indica si la validación de certificados SSL de back-end está habilitada para la aplicación. Para todas las nuevas aplicaciones de Application Proxy, la propiedad se establece de true forma predeterminada. Para todas las aplicaciones existentes, la propiedad se establece en false. |
| isContinuousAccessEvaluationEnabled | Booleano | Indica si está habilitada la evaluación continua de acceso para la aplicación Application Proxy. Para todas las aplicaciones de Application Proxy, la propiedad se establece de true forma predeterminada. |
| isDnsResolutionEnabled | Booleano | Indica que el Acceso privado de Microsoft Entra debe controlar la resolución DNS.
false de forma predeterminada. |
| isHttpOnlyCookieEnabled | Booleano | Indica si se debe establecer el marcador de cookie HTTPOnly en los encabezados de respuesta HTTP. Establezca este valor para true 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 Falso. El valor predeterminado es false. |
| isOnPremPublishingEnabled | Booleano | Indica si la aplicación se está publicando actualmente a través de Application Proxy o no. Esto está preestablecido por el sistema. Solo lectura. |
| isPersistentCookieEnabled | Booleano | Indica si se debe establecer el marcador de cookie persistente 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 acerca de 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 se debe establecer la marca de cookie segura en los encabezados de respuesta HTTP. Establezca este valor en true 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 desean habilitar la protección CSRF para sus aplicaciones. |
| isTranslateHostHeaderEnabled | Booleano | Indica si la aplicación debe traducir las direcciones URL en los encabezados de respuesta. Mantenga este valor como true si su aplicación requiriera 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 a false 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) | Recopilación onPremisesApplicationSegment | Representa la colección de segmentos de aplicación para una aplicación comodín local. Esta propiedad está en desuso y dejará de devolver datos el 1 de junio de 2023. En su lugar , use segmentsConfiguration . |
| segmentsConfiguration | segmentConfiguration | Representa la colección de segmentos de aplicación para una aplicación comodín local que se publica a través del proxy de aplicación de Microsoft Entra. |
| singleSignOnSettings | onPremisesPublishingSingleSignOn | Representa la configuración de inicio de sesión único para la aplicación local. |
| trafficRoutingMethod | trafficRoutingMethod | Indica cómo se distribuye el tráfico entre varios conectores de un grupo de conectores. Los valores posibles son: none, random, sessionPersistence, performance (No implementado), unknownFutureValue. |
| useAlternateUrlForTranslationAndRedirect | Booleano | Indica si la aplicación debe usar alterteUrl en lugar de externalUrl. |
| verifiedCustomDomainCertificatesMetadata | verifiedCustomDomainCertificatesMetadata | Detalles del certificado asociado a la aplicación cuando un dominio personalizado está en uso.
null al utilizar el dominio predeterminado. Solo lectura. |
| verifiedCustomDomainKeyCredential | keyCredential | Credencial de clave asociada al dominio personalizado usado. |
| verifiedCustomDomainPasswordCredential | passwordCredential | Credencial de contraseña asociada al 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",
"isAccessibleViaZTNAClient": "Boolean",
"isBackendCertificateValidationEnabled": true,
"isContinuousAccessEvaluationEnabled": "Boolean",
"isDnsResolutionEnabled": "Boolean",
"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"},
"trafficRoutingMethod": "String",
"useAlternateUrlForTranslationAndRedirect": "Boolean",
"verifiedCustomDomainCertificatesMetadata": {"@odata.type": "microsoft.graph.verifiedCustomDomainCertificatesMetadata"},
"verifiedCustomDomainKeyCredential": {"@odata.type": "microsoft.graph.keyCredential"},
"verifiedCustomDomainPasswordCredential": {"@odata.type": "microsoft.graph.passwordCredential"}
}