type de ressource de publication locale

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Une application locale publiée via le proxy d’application Microsoft Entra est représentée par un objet d’application et sa propriété onPremisesPublishing associée. Le proxy d’application fournit un accès distant sécurisé aux applications locales.

Un objet onPremisesPublishing représente l’ensemble des propriétés de configuration du proxy d’application pour une application locale.

Après avoir instancié une application personnalisée ou créé une application, les paramètres du proxy d’application pour l’application peuvent être configurés en mettant à jour les propriétés onPremisesPublishing de l’application.

Pour consulter un didacticiel sur la configuration du proxy d’application, consultez Automatiser la configuration du proxy d’application à l’aide de l’API Graph Microsoft.

Propriétés

Propriété Type Description
alternateUrl String Si vous configurez un traffic manager devant plusieurs applications de proxy d’application, cette URL conviviale pointe vers le traffic manager.
applicationServerTimeout String Durée pendant laquelle le connecteur attend une réponse de l’application principale avant de fermer la connexion. Les valeurs possibles sont default, long. Lorsqu’il est défini sur la valeur par défaut, le délai d’expiration de l’application principale est de 85 secondes. Lorsqu’il est défini sur long, le délai d’expiration du back-end est augmenté à 180 secondes. Utilisez cette option long si votre serveur met plus de 85 secondes à répondre aux demandes ou si vous ne parvenez pas à accéder à l’application et que le status d’erreur est « Délai d’expiration du backend ». La valeur par défaut est default.
applicationType String Valeur définie par le système indiquant si cette application est une application configurée par un proxy d’application. Les valeurs possibles sont quickaccessapp et nonwebapp. En lecture seule.
externalAuthenticationType externalAuthenticationType Détaille le paramètre de pré-authentification pour l’application. La pré-authentification oblige les utilisateurs à s’authentifier avant d’accéder à l’application. Le passage ne nécessite pas d’authentification. Les valeurs possibles sont : passthru, aadPreAuthentication.
externalUrl String URL externe publiée pour l’application. Par exemple : https://intranet-contoso.msappproxy.net/.
internalUrl String URL interne de l’application. Par exemple : https://intranet/.
isAccessibleViaZTNAClient Booléen Indique si l’application est accessible via un client Global Secure Access sur un appareil géré.
isBackendCertificateValidationEnabled Booléen Indique si la validation de certificat SSL principale est activée pour l’application. Pour toutes les nouvelles applications de proxy d’application, la propriété est définie sur true par défaut. Pour toutes les applications existantes, la propriété est définie sur false.
isContinuousAccessEvaluationEnabled Booléen Indique si l’évaluation continue de l’accès est activée pour l’application Proxy d’application. Pour toutes les applications de proxy d’application, la propriété est définie sur true par défaut.
isDnsResolutionEnabled Booléen Indique que l’Accès privé Microsoft Entra doit gérer la résolution DNS. false par défaut.
isHttpOnlyCookieEnabled Booléen Indique si l’indicateur de cookie HTTPOnly doit être défini dans les en-têtes de réponse HTTP. Définissez cette valeur pour true que les cookies de proxy d’application incluent l’indicateur HTTPOnly dans les en-têtes de réponse HTTP. Si vous utilisez les services Bureau à distance, définissez cette valeur sur False. La valeur par défaut est false.
isOnPremPublishingEnabled Booléen Indique si l’application est en cours de publication via le proxy d’application ou non. Ceci est prédéfini par le système. En lecture seule.
isPersistentCookieEnabled Booléen Indique si l’indicateur de cookie persistant doit être défini dans les en-têtes de réponse HTTP. Conservez cette valeur définie sur false. Utilisez ce paramètre uniquement pour les applications qui ne peuvent pas partager de cookies entre les processus. Pour plus d’informations sur les paramètres des cookies, consultez Paramètres des cookies pour accéder aux applications locales dans Microsoft Entra ID. La valeur par défaut est false.
isSecureCookieEnabled Booléen Indique si l’indicateur de cookie sécurisé doit être défini dans les en-têtes de réponse HTTP. Définissez cette valeur sur true pour transmettre les cookies sur un canal sécurisé tel qu’une demande HTTPS chiffrée. La valeur par défaut est true.
isStateSessionEnabled Booléen Indique si la validation du paramètre d’état lorsque le client utilise le flux d’octroi de code d’autorisation OAuth 2.0 est activée. Ce paramètre permet aux administrateurs de spécifier s’ils souhaitent activer la protection CSRF pour leurs applications.
isTranslateHostHeaderEnabled Booléen Indique si l’application doit traduire les URL dans les en-têtes de réponse. Conservez cette valeur, sauf si true votre application nécessitait l’en-tête hôte d’origine dans la demande d’authentification. La valeur par défaut est true.
isTranslateLinksInBodyEnabled Booléen Indique si l’application doit traduire les URL dans le corps de l’application. Conservez cette valeur à moins que false vous n’ayez des liens HTML codés en dur vers d’autres applications locales et que vous n’utilisiez pas de domaines personnalisés. Pour plus d’informations, voir Lier la traduction avec le proxy d’application. La valeur par défaut est false.
onPremisesApplicationSegments (déconseillé) collection onPremisesApplicationSegment Représente la collection de segments d’application pour une application locale avec caractère générique. Cette propriété est déconseillée et cessera de retourner des données le 1er juin 2023. Utilisez plutôt segmentsConfiguration .
segmentsConfiguration Configuration du segment Représente la collection de segments d’application pour une application générique locale publiée via le proxy d’application Microsoft Entra.
singleSignOnSettings onLocalPublishingSingleSignOn Représente la configuration d’authentification unique pour l’application locale.
trafficRoutingMethod trafficRoutingMethod Indique comment le trafic est réparti entre plusieurs connecteurs dans un groupe de connecteurs. Les valeurs possibles sont les suivantes : none, , performancerandomsessionPersistence, (Non implémenté), . unknownFutureValue
useAlternateUrlForTranslationAndRedirect Booléen Indique si l’application doit utiliser alternateUrl au lieu de externalUrl.
verifiedCustomDomainCertificatesMetadata verifiedCustomDomainCertificatesMetadata Détails du certificat associé à l’application lorsqu’un domaine personnalisé est en cours d’utilisation. null lors de l’utilisation du domaine par défaut. En lecture seule.
verifiedCustomDomainKeyCredential keyCredential Informations d’identification de la clé associée pour le domaine personnalisé utilisé.
verifiedCustomDomainPasswordCredential passwordCredential Informations d’identification de mot de passe associées pour le domaine personnalisé utilisé.

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "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"}
}
  • Last updated on