onPremisesPublishing-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Eine lokale Anwendung, die über Azure AD 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 Eigenschaftensatz zum Konfigurieren von Anwendungsproxy für eine lokale Anwendung dar.

Nach der Instanziierung 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 Lernprogramm 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 Datenverkehrs-Manager vor mehreren App-Proxyanwendungen konfigurieren, ist alternateUrl die benutzerfreundliche URL, die auf den Datenverkehrs-Manager verweist.
applicationServerTimeout	Zeichenfolge	Die Dauer, während der 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 Back-End-Anwendungstimeout eine Länge von 85 Sekunden. Bei festlegung auf "long" wird das Back-End-Timeout auf 180 Sekunden erhöht. Verwenden Sie long diese Methode, wenn der Server mehr als 85 Sekunden benötigt, um auf Anforderungen zu reagieren, oder wenn Sie nicht auf die Anwendung zugreifen können und der Fehlerstatus "Back-End-Timeout" lautet. Der Standardwert ist default.
applicationType	String	Gibt an, ob es sich bei dieser Anwendung um eine Anwendungsproxy konfigurierte Anwendung handelt. Dies ist vom System bereits festgelegt. Schreibgeschützt.
externalAuthenticationType	externalAuthenticationType	Details zur Einstellung vor der Authentifizierung für die Anwendung. Die Vorauthentifizierung erzwingt, dass Benutzer sich authentifizieren müssen, bevor sie auf die App zugreifen. Passthru 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	Boolean	Gibt an, ob die Back-End-SSL-Zertifikatüberprüfung für die Anwendung aktiviert ist. Für alle neuen Anwendungsproxy-Apps wird die Eigenschaft standardmäßig festgelegttrue. Für alle vorhandenen Apps wird die Eigenschaft auf falsefestgelegt.
isHttpOnlyCookieEnabled	Boolesch	Gibt an, ob das HTTPOnly-Cookie-Flag in den HTTP-Antwortheadern festgelegt werden soll. Legen Sie diesen Wert so fest, true dass 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 ist vom System bereits festgelegt. Schreibgeschützt.
isPersistentCookieEnabled	Boolesch	Gibt an, ob das Flag für beständiges Cookie in den HTTP-Antwortheadern festgelegt werden soll. Lassen Sie diesen Wert auf false. Verwenden Sie diese Einstellung nur für Anwendungen, die Keine Cookies zwischen Prozessen teilen können. Weitere Informationen zu Cookie-Einstellungen finden Sie unter Cookie-Einstellungen für den Zugriff auf lokale Anwendungen in Azure Active Directory. Der Standardwert ist false.
isSecureCookieEnabled	Boolesch	Gibt an, ob das Flag "Sicheres Cookie" in den HTTP-Antwortheadern festgelegt werden soll. Legen Sie diesen Wert fest, um true Cookies über einen sicheren Kanal, z. B. eine verschlüsselte HTTPS-Anforderung, zu übertragen. Der Standardwert ist true.
isStateSessionEnabled	Boolesch	Gibt an, ob die Überprüfung des Statusparameters aktiviert ist, wenn der Client den OAuth 2.0-Autorisierungscode-Genehmigungsfluss verwendet. Mit dieser Einstellung können Administratoren angeben, ob sie den CSRF-Schutz für ihre Apps aktivieren möchten.
isTranslateHostHeaderEnabled	Boolesch	Gibt an, ob die Anwendung URLs in den Repositoryheadern übersetzen soll. Behalten Sie diesen Wert so bei, als true wenn Ihre Anwendung den ursprünglichen Hostheader in der Authentifizierungsanforderung nicht benötigt hat. Der Standardwert ist true.
isTranslateLinksInBodyEnabled	Boolescher Wert	Gibt an, ob die Anwendung URLs im Anwendungstext übersetzen soll. Behalten Sie diesen Wert so bei, als false ob Sie hartcodierte HTML-Links zu anderen lokalen Anwendungen haben und keine benutzerdefinierten Domänen verwenden. Weitere Informationen finden Sie unter Übersetzung mit Anwendungsproxy verknüpfen. Der Standardwert ist false.
singleSignOnSettings	onPremisesPublishingSingleSignOn	Stellt die Konfiguration für einmaliges Anmelden 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 zugehörigen Schlüsselanmeldeinformationen für die verwendete benutzerdefinierte Domäne.
verifiedCustomDomainPasswordCredential	passwordCredential	Die zugehörigen Kennwortanmeldeinformationen für die verwendete benutzerdefinierte Domäne.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "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,
  "singleSignOnSettings": {"@odata.type": "microsoft.graph.onPremisesPublishingSingleSignOn"},
  "verifiedCustomDomainCertificatesMetadata": {"@odata.type": "microsoft.graph.verifiedCustomDomainCertificatesMetadata"},
  "verifiedCustomDomainKeyCredential": {"@odata.type": "microsoft.graph.keyCredential"},
  "verifiedCustomDomainPasswordCredential": {"@odata.type": "microsoft.graph.passwordCredential"}
}