onPremisesPublishing-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Eine lokale Anwendung, die über Microsoft Entra Anwendungsproxy veröffentlicht wird, wird durch ein Anwendungsobjekt und die zugehörige onPremisesPublishing-Eigenschaft dargestellt. Anwendungsproxy bietet sicheren Remotezugriff auf lokale Anwendungen.

Ein onPremisesPublishing-Objekt stellt den Satz von Eigenschaften zum Konfigurieren von Anwendungsproxy für eine lokale Anwendung dar.

Nach dem Instanziieren einer benutzerdefinierten Anwendung oder dem Erstellen einer Anwendung können die Anwendungsproxy Einstellungen für die Anwendung konfiguriert werden, indem die onPremisesPublishing-Eigenschaften der Anwendung aktualisiert werden.

Ein Tutorial zum Konfigurieren von Anwendungsproxy finden Sie unter Automatisieren der Konfiguration von Anwendungsproxy mithilfe der Microsoft Graph-API.

Eigenschaften

Eigenschaft	Typ	Beschreibung
alternateUrl	Zeichenfolge	Wenn Sie einen Traffic Manager vor mehreren App-Proxyanwendungen konfigurieren, ist alternateUrl die benutzerfreundliche URL, die auf den Traffic Manager verweist.
applicationServerTimeout	Zeichenfolge	Die Dauer, die der Connector auf eine Antwort von der Back-End-Anwendung wartet, bevor die Verbindung geschlossen wird. Mögliche Werte sind default, long. Wenn der Standardwert festgelegt ist, hat das Timeout der Back-End-Anwendung eine Länge von 85 Sekunden. Bei Festlegung auf long wird das Back-End-Timeout auf 180 Sekunden erhöht. Verwenden Sie long , wenn ihr Server mehr als 85 Sekunden benötigt, um auf Anforderungen zu antworten, oder wenn Sie nicht auf die Anwendung zugreifen können und der Fehler status "Back-End-Timeout" lautet. Der Standardwert ist default.
applicationType	Zeichenfolge	Gibt an, ob es sich bei dieser Anwendung um eine Anwendungsproxy konfigurierte Anwendung handelt. Dies wird vom System voreingestellt. Schreibgeschützt.
externalAuthenticationType	externalAuthenticationType	Beschreibt die Vorauthentifizierungseinstellung für die Anwendung. Die Vorauthentifizierung erzwingt, dass Benutzer sich vor dem Zugriff auf die App authentifizieren müssen. Passthrough erfordert keine Authentifizierung. Mögliche Werte sind: passthru und aadPreAuthentication.
Externalurl	Zeichenfolge	Die veröffentlichte externe URL für die Anwendung. Beispiel: https://intranet-contoso.msappproxy.net/.
Internalurl	Zeichenfolge	Die interne URL der Anwendung. Beispiel: https://intranet/.
isBackendCertificateValidationEnabled	Boolesch	Gibt an, ob die Back-End-SSL-Zertifikatüberprüfung für die Anwendung aktiviert ist. Für alle neuen Anwendungsproxy-Apps ist die -Eigenschaft standardmäßig auf true festgelegt. Für alle vorhandenen Apps ist die -Eigenschaft auf falsefestgelegt.
isHttpOnlyCookieEnabled	Boolesch	Gibt an, ob das HTTPOnly-Cookieflag in den HTTP-Antwortheadern festgelegt werden soll. Legen Sie diesen Wert auf festtrue, damit Anwendungsproxy Cookies das HTTPOnly-Flag in den HTTP-Antwortheadern enthalten. Wenn Sie Remotedesktopdienste verwenden, legen Sie diesen Wert auf False fest. Der Standardwert ist false.
isOnPremPublishingEnabled	Boolesch	Gibt an, ob die Anwendung derzeit über Anwendungsproxy veröffentlicht wird oder nicht. Dies wird vom System voreingestellt. Schreibgeschützt.
isPersistentCookieEnabled	Boolesch	Gibt an, ob das Flag "Persistent cookie" in den HTTP-Antwortheadern festgelegt werden soll. Behalten Sie diesen Wert bei false. Verwenden Sie diese Einstellung nur für Anwendungen, die keine Cookies zwischen Prozessen freigeben können. Weitere Informationen zu Cookieeinstellungen finden Sie unter Cookieeinstellungen für den Zugriff auf lokale Anwendungen in Microsoft Entra ID. Der Standardwert ist false.
isSecureCookieEnabled	Boolesch	Gibt an, ob das Secure-Cookie-Flag in den HTTP-Antwortheadern festgelegt werden soll. Legen Sie diesen Wert auf fest true , um Cookies über einen sicheren Kanal wie eine verschlüsselte HTTPS-Anforderung zu übertragen. Der Standardwert ist true.
isStateSessionEnabled	Boolesch	Gibt an, ob die Überprüfung des Zustandsparameters aktiviert ist, wenn der Client den OAuth 2.0-Autorisierungscode-Genehmigungsflow verwendet. Mit dieser Einstellung können Administratoren angeben, ob sie CSRF-Schutz für ihre Apps aktivieren möchten.
isTranslateHostHeaderEnabled	Boolesch	Gibt an, ob die Anwendung URLs in den Antwortheadern übersetzen soll. Behalten Sie diesen Wert bei, true es sei denn, Ihre Anwendung erforderte den ursprünglichen Hostheader in der Authentifizierungsanforderung. Der Standardwert ist true.
isTranslateLinksInBodyEnabled	Boolesch	Gibt an, ob die Anwendung URLs im Anwendungstext übersetzen soll. Behalten Sie diesen Wert bei false , es sei denn, Sie verfügen über hartcodierte HTML-Links zu anderen lokalen Anwendungen und verwenden keine benutzerdefinierten Domänen. Weitere Informationen finden Sie unter Linkübersetzung mit Anwendungsproxy. Der Standardwert ist false.
onPremisesApplicationSegments (veraltet)	onPremisesApplicationSegment-Auflistung	Stellt die Anwendungssegmentauflistung für eine lokale Wildcardanwendung dar. Diese Eigenschaft ist veraltet und gibt am 1. Juni 2023 keine Daten mehr zurück. Verwenden Sie stattdessen segmentConfiguration .
segmentsConfiguration	segmentConfiguration	Stellt die Auflistung von Anwendungssegmenten für eine lokale Platzhalteranwendung dar, die über Microsoft Entra Anwendungsproxy veröffentlicht wird.
singleSignOnSettings	onPremisesPublishingSingleSignOn	Stellt die Konfiguration des einmaligen Anmeldens für die lokale Anwendung dar.
verifiedCustomDomainCertificatesMetadata	verifiedCustomDomainCertificatesMetadata	Details des Zertifikats, das der Anwendung zugeordnet ist, wenn eine benutzerdefinierte Domäne verwendet wird. null bei Verwendung der Standarddomäne. Schreibgeschützt.
verifiedCustomDomainKeyCredential	keyCredential	Die zugeordneten Schlüsselanmeldeinformationen für die verwendete benutzerdefinierte Domäne.
verifiedCustomDomainPasswordCredential	passwordCredential	Die zugeordneten Kennwortanmeldeinformationen für die verwendete benutzerdefinierte Domäne.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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