Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Um aplicativo local publicado por meio do proxy de aplicativo do Microsoft Entra é representado por um objeto de aplicativo e sua propriedade onPremisesPublishing associada. O Proxy de Aplicativo fornece acesso remoto seguro a aplicativos locais.
Um objeto onPremisesPublishing representa o conjunto de propriedades para configurar o Proxy de Aplicativo para um aplicativo local.
Depois de instanciar um aplicativo personalizado ou criar um aplicativo, as configurações do Proxy de Aplicativo para o aplicativo podem ser definidas atualizando as propriedades onPremisesPublishing do aplicativo.
Para obter um tutorial sobre como configurar o Proxy de Aplicativo, consulte Automatizar a configuração do Proxy de Aplicativo usando a API do Graph.
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| alternateUrl | Cadeia de caracteres | Se você estiver configurando um gerenciador de tráfego na frente de vários aplicativos de proxy de aplicativo, essa URL amigável apontará para o gerenciador de tráfego. |
| applicationServerTimeout | Cadeia de caracteres | A duração que o conector aguarda uma resposta do aplicativo de back-end antes de fechar a conexão. Os valores possíveis são default, long. Quando definido como padrão, o tempo limite do aplicativo de back-end tem uma duração de 85 segundos. Quando definido como longo, o tempo limite de back-end é aumentado para 180 segundos. Use long se o servidor demorar mais de 85 segundos para responder às solicitações ou se você não conseguir acessar o aplicativo e o status de erro for "Tempo limite de back-end". O valor padrão é default. |
| applicationType | Cadeia de caracteres | Valor definido pelo sistema que indica se esse aplicativo é um aplicativo configurado de proxy de aplicativo. Os valores possíveis são quickaccessapp e nonwebapp. Somente leitura. |
| externalAuthenticationType | externalAuthenticationType | Detalha a configuração de pré-autenticação do aplicativo. A pré-autenticação impõe que os usuários se autentiquem antes de acessar o aplicativo. A passagem não requer autenticação. Os valores possíveis são: passthru, aadPreAuthentication. |
| externalUrl | Cadeia de caracteres | A URL externa publicada para o aplicativo. Por exemplo, https://intranet-contoso.msappproxy.net/. |
| internalUrl | Cadeia de caracteres | A URL interna do aplicativo. Por exemplo, https://intranet/. |
| isAccessibleViaZTNAClient | Booliano | Indica se o aplicativo está acessível por meio de um cliente de Acesso Seguro Global em um dispositivo gerenciado. |
| isBackendCertificateValidationEnabled | Booliano | Indica se a validação de certificado SSL de back-end está habilitada para o aplicativo. Para todos os novos aplicativos de Proxy de Aplicativo, a propriedade é definida true como por padrão. Para todos os aplicativos existentes, a propriedade é definida como false. |
| isContinuousAccessEvaluationEnabled | Booliano | Indica se a avaliação contínua de acesso está habilitada para o aplicativo Proxy de Aplicativo. Para todos os aplicativos de Proxy de Aplicativo, a propriedade é definida true como por padrão. |
| isDnsResolutionEnabled | Booliano | Indica que o Acesso privado do Microsoft Entra deve lidar com a resolução DNS.
false por padrão. |
| isHttpOnlyCookieEnabled | Booliano | Indica se o sinalizador de cookie HTTPOnly deve ser definido nos cabeçalhos de resposta HTTP. Defina esse valor para true que os cookies de Proxy de Aplicativo incluam o sinalizador HTTPOnly nos cabeçalhos de resposta HTTP. Se estiver usando os Serviços de Área de Trabalho Remota, defina esse valor como False. O valor padrão é false. |
| isOnPremPublishingEnabled | Booliano | Indica se o aplicativo está sendo publicado atualmente por meio do Proxy de Aplicativo ou não. Isso é predefinido pelo sistema. Somente leitura. |
| isPersistentCookieEnabled | Booliano | Indica se o sinalizador de cookie persistente deve ser definido nos cabeçalhos de resposta HTTP. Mantenha esse valor definido como false. Use essa configuração apenas para aplicativos que não podem compartilhar cookies entre processos. Para obter mais informações sobre configurações de cookies, consulte Configurações de cookies para acessar aplicativos locais no Microsoft Entra ID. O valor padrão é false. |
| isSecureCookieEnabled | Booliano | Indica se o sinalizador de cookie seguro deve ser definido nos cabeçalhos de resposta HTTP. Defina esse valor como true para transmitir cookies por um canal seguro, como uma solicitação HTTPS criptografada. O valor padrão é true. |
| isStateSessionEnabled | Booliano | Indica se a validação do parâmetro state quando o cliente usa o fluxo de concessão de código de autorização OAuth 2.0 está habilitada. Essa configuração permite que os administradores especifiquem se desejam habilitar a proteção CSRF para seus aplicativos. |
| isTranslateHostHeaderEnabled | Booliano | Indica se o aplicativo deve traduzir URLs nos cabeçalhos de resposta. Mantenha esse valor, a true menos que seu aplicativo exija o cabeçalho de host original na solicitação de autenticação. O valor padrão é true. |
| isTranslateLinksInBodyEnabled | Booliano | Indica se o aplicativo deve traduzir URLs no corpo do aplicativo. Mantenha esse valor, a false menos que você tenha links HTML embutidos em código para outros aplicativos locais e não use domínios personalizados. Para obter mais informações, consulte Tradução de links com o Proxy de Aplicativo. O valor padrão é false. |
| onPremisesApplicationSegments (preterido) | Coleção onPremisesApplicationSegment | Representa a coleção de segmentos de aplicativo para um aplicativo curinga local. Esta propriedade foi preterida e deixará de retornar dados em 1º de junho de 2023. Em vez disso, use segmentsConfiguration . |
| segmentsConfiguration | segmentConfiguration | Representa a coleção de segmentos de aplicativo para um aplicativo curinga local publicado por meio do proxy de aplicativo do Microsoft Entra. |
| singleSignOnSettings | onPremisesPublishingSingleSignOn | Representa a configuração de logon único para o aplicativo local. |
| trafficRoutingMethod | trafficRoutingMethod | Indica como o tráfego é distribuído entre vários conectores em um grupo de conectores. Os valores possíveis são: none, random, sessionPersistenceperformance , (Não implementado), unknownFutureValue. |
| useAlternateUrlForTranslationAndRedirect | Booliano | Indica se o aplicativo deve usar alternateUrl em vez de externalUrl. |
| verifiedCustomDomainCertificatesMetadata | verifiedCustomDomainCertificatesMetadata | Detalhes do certificado associado ao aplicativo quando um domínio personalizado está em uso.
null ao usar o domínio padrão. Somente leitura. |
| verifiedCustomDomainKeyCredential | keyCredential | A credencial de chave associada ao domínio personalizado usado. |
| verifiedCustomDomainPasswordCredential | passwordCredential | A credencial de senha associada ao domínio personalizado usado. |
Relações
Nenhum
Representação JSON
A representação JSON a seguir mostra o 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"}
}