onPremisesPublishing resource type (Tipo de recurso onPremisesPublishing)
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.
Uma aplicação no local publicada através de Microsoft Entra proxy de aplicações é representada por um objeto de aplicação e a respetiva propriedade onPremisesPublishing associada. Proxy de Aplicativo fornece acesso remoto seguro a aplicações no local.
Um objeto onPremisesPublishing representa o conjunto de propriedades para configurar Proxy de Aplicativo para uma aplicação no local.
Após instanciar uma aplicação personalizada ou criar uma aplicação, as definições de Proxy de Aplicativo da aplicação podem ser configuradas ao atualizar as propriedades onPremisesPublishing da aplicação.
Para obter um tutorial sobre como configurar Proxy de Aplicativo, veja Automatizar a configuração de Proxy de Aplicativo com o Microsoft API do Graph.
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| alternateUrl | Cadeia de caracteres | Se estiver a configurar um gestor de tráfego à frente de várias aplicações de proxy de aplicações, este URL amigável aponta para o gestor de tráfego. |
| applicationServerTimeout | Cadeia de caracteres | A duração em que o conector aguarda uma resposta da aplicação de back-end antes de fechar a ligação. Os valores possíveis são default, long. Quando definido como predefinição, o tempo limite da aplicação de back-end tem um comprimento de 85 segundos. Quando definido como longo, o tempo limite do back-end é aumentado para 180 segundos. Utilize long se o servidor demorar mais de 85 segundos a responder a pedidos ou se não conseguir aceder à aplicação e o erro status for "Tempo Limite de Back-end". O valor padrão é default. |
| applicationType | Cadeia de caracteres | Valor definido pelo sistema que indica se esta aplicação é uma aplicação configurada por proxy de aplicações. Os valores possíveis são quickaccessapp e nonwebapp. Somente leitura. |
| externalAuthenticationType | externalAuthenticationType | Detalha a definição de pré-autenticação da aplicação. A pré-autenticação impõe que os utilizadores tenham de se autenticar antes de acederem à aplicação. A passagem não requer autenticação. Os valores possíveis são: passthru e aadPreAuthentication. |
| externalUrl | Cadeia de caracteres | O URL externo publicado para a aplicação. Por exemplo, https://intranet-contoso.msappproxy.net/. |
| internalUrl | Cadeia de caracteres | O URL interno da aplicação. Por exemplo, https://intranet/. |
| isAccessibleViaZTNAClient | Booliano | Indica se a aplicação está acessível através de um cliente de Acesso Seguro Global num dispositivo gerido. |
| isBackendCertificateValidationEnabled | Booliano | Indica se a validação do certificado SSL de back-end está ativada para a aplicação. Para todas as novas aplicações Proxy de Aplicativo, a propriedade está definida como true por predefinição. Para todas as aplicações existentes, a propriedade está definida como false. |
| isDnsResolutionEnabled | Booliano | Indica Acesso privado do Microsoft Entra deve processar a resolução de DNS.
false por predefinição. |
| isHttpOnlyCookieEnabled | Booliano | Indica se o sinalizador de cookie HTTPOnly deve ser definido nos cabeçalhos de resposta HTTP. Defina este valor para true ter Proxy de Aplicativo cookies incluem o sinalizador HTTPOnly nos cabeçalhos de resposta HTTP. Se estiver a utilizar os Serviços de Ambiente de Trabalho Remoto, defina este valor como Falso. O valor padrão é false. |
| isOnPremPublishingEnabled | Booliano | Indica se a aplicação está atualmente a ser publicada através de Proxy de Aplicativo ou não. Isto é predefinido pelo sistema. Somente leitura. |
| isPersistentCookieEnabled | Booliano | Indica se o sinalizador de cookie Persistente deve ser definido nos cabeçalhos de resposta HTTP. Mantenha este valor definido como false. Utilize esta definição apenas para aplicações que não podem partilhar cookies entre processos. Para obter mais informações sobre as definições de cookies, veja Definições de cookies para aceder a aplicações no local 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 este valor como para true transmitir cookies através de um canal seguro, como um pedido HTTPS encriptado. O valor padrão é true. |
| isStateSessionEnabled | Booliano | Indica se a validação do parâmetro de estado quando o cliente utiliza o fluxo de concessão de código de autorização OAuth 2.0 está ativada. Esta definição permite que os administradores especifiquem se querem ativar a proteção CSRF para as respetivas aplicações. |
| isTranslateHostHeaderEnabled | Booliano | Indica se a aplicação deve traduzir URLs nos cabeçalhos de resposta. Mantenha este valor como true , a menos que a aplicação necessite do cabeçalho de anfitrião original no pedido de autenticação. O valor padrão é true. |
| isTranslateLinksInBodyEnabled | Booliano | Indica se a aplicação deve traduzir URLs no corpo da aplicação. Mantenha este valor como false , a menos que tenha ligações HTML codificadas para outras aplicações no local e não utilize domínios personalizados. Para obter mais informações, consulte Ligar a tradução com Proxy de Aplicativo. O valor padrão é false. |
| onPremisesApplicationSegments (preterido) | onPremisesApplicationSegment collection (Coleção onPremisesApplicationSegment) | Representa a coleção de segmentos de aplicação para uma aplicação de carateres universais no local. Esta propriedade foi preterida e deixará de devolver dados a 1 de junho de 2023. Em vez disso , utilize segmentsConfiguration . |
| segmentsConfiguration | segmentConfiguration | Representa a coleção de segmentos de aplicações para uma aplicação de carateres universais no local que é publicada através de Microsoft Entra proxy de aplicações. |
| singleSignOnSettings | onPremisesPublishingSingleSignOn | Representa a configuração de início de sessão único para a aplicação no local. |
| useAlternateUrlForTranslationAndRedirect | Booliano | Indica se a aplicação deve utilizar alternateUrl em vez de externalUrl. |
| verifiedCustomDomainCertificatesMetadata | verifiedCustomDomainCertificatesMetadata | Detalhes do certificado associado à aplicação quando um domínio personalizado está em utilização.
null ao utilizar o domínio predefinido. Somente leitura. |
| verifiedCustomDomainKeyCredential | keyCredential | A credencial de chave associada para o domínio personalizado utilizado. |
| verifiedCustomDomainPasswordCredential | passwordCredential | A credencial de palavra-passe associada para o domínio personalizado utilizado. |
Relações
Nenhum
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"alternateUrl": "String",
"applicationServerTimeout": "String",
"applicationType": "String",
"externalAuthenticationType": "String",
"externalUrl": "String",
"internalUrl": "String",
"isAccessibleViaZTNAClient": "Boolean",
"isBackendCertificateValidationEnabled": true,
"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"},
"useAlternateUrlForTranslationAndRedirect": "Boolean",
"verifiedCustomDomainCertificatesMetadata": {"@odata.type": "microsoft.graph.verifiedCustomDomainCertificatesMetadata"},
"verifiedCustomDomainKeyCredential": {"@odata.type": "microsoft.graph.keyCredential"},
"verifiedCustomDomainPasswordCredential": {"@odata.type": "microsoft.graph.passwordCredential"}
}