Verwenden von Nicht-Standard-Ports für ArcGIS Web Adaptor im Portal

Für die meisten Benutzer von ArcGIS Enterprise ist es kein Problem, ArcGIS Web Adaptor an den Standard-Ports 80 und 443 auszuführen. In seltenen Fällen kann jedoch eine Instanz von Web Adaptor diese Standard-Ports auf dem Webserver, der als Host fungiert, nicht verwenden. Zum Beispiel könnte auf dem Host-Webserver bereits eine Anwendung an diesen Ports ausgeführt werden oder der Zugriff auf die Ports in einer gesicherten Organisation eingeschränkt sein.

Wenn die Konfiguration der Web Adaptor-Instanz des Portals an den Ports 80 und 443 nicht möglich ist, können Sie die Ausführung an anderen Ports als den Standard-Ports zulassen. Dazu müssen Sie einen Reverse-Proxyserver oder Load Balancer konfigurieren und ihn in Ihr Portal integrieren. Dadurch können Benutzer über die Standard-Ports wie gewohnt auf das Portal zugreifen. Die Verwendung von HTTPS sollte beibehalten werden, um die Kommunikation zwischen ArcGIS Web Adaptor und Portal for ArcGIS zu verschlüsseln.

Die ArcGIS Web Adaptor-Konfigurationsdatei enthält die Eigenschaft EnableDefaultPortValidation, mit der standardmäßig die Verwendung der Standard-Ports 80 und 443 erzwungen wird, wenn ArcGIS Web Adaptor mit einem Portal konfiguriert wird. Indem diese Eigenschaft auf "false" festgelegt wird, wird diese Validierung umgangen, sodass ArcGIS Web Adaptor an anderen als den Standard-Ports ausgeführt werden kann.

Konfigurieren von ArcGIS Web Adaptor im Portal an Nicht-Standard-Ports

Wenn der Webserver, der als Host für Ihre ArcGIS Web Adaptor-Instanz im Portal vorgesehen ist, die Software an anderen als den Ports 80 und 443 ausführen muss, dann müssen Sie beim Einrichten von Web Adaptor mit‏ den Installations- und Konfigurationsassistenten zusätzliche Schritte ausführen.

1. Aktivieren Sie HTTPS auf dem Webserver, der als Host für Web Adaptor vorgesehen ist. Notieren Sie sich den Port, der für die HTTPS-Kommunikation verwendet wird, da er für den Zugriff auf ArcGIS Web Adaptor während der Erstkonfiguration mit dem Portal verwendet wird.
2. Installieren Sie ArcGIS Web Adaptor auf dem Webserver. Verwenden Sie dabei den Installationsassistenten Setup.exe als Benutzer mit Administratorberechtigungen.
3. Navigieren Sie auf dem Computer, auf dem ArcGIS Web Adaptor gehostet wird, zur Datei webadaptor.config, und öffnen Sie sie in einem Texteditor. Diese Datei befindet sich standardmäßig im Ordner C:\inetpub\wwwroot\<web adaptor name>.
4. Suchen Sie in der Datei webadaptor.config die Eigenschaft EnableDefaultPortValidation mit dem Standardwert "true". Ändern Sie den Wert in "false": <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
5. Starten Sie den Webserver neu.
6. Öffnen Sie die Seite für die Konfiguration von ArcGIS Web Adaptor in einem Internetbrowser an dem HTTPS-Port, der gerade durch den Webserver verwendet wird, und verwenden Sie dabei das URL-Format https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor/portal. Wenn ein DNS-Alias mit dem Portal verwendet wird, sollte Web Adaptor stattdessen mit einer URL (z. B. https://dnsalias.domain.com:<https_port>/<webadaptorname>/webadaptor/portal) über den Alias konfiguriert werden.
7. Geben Sie für die Eigenschaft Portal-URL die URL des Computers ein, der die Portal for ArcGIS-Software hostet. Verwenden Sie in der URL den vollständig qualifizierten Domänennamen des Computers, wie zum Beispiel https://portal.domain.com:7443.
8. Geben Sie den Benutzernamen und das Kennwort für ein Konto ein, dem Administratorberechtigungen für Portal for ArcGIS zugewiesen wurden. In der Regel verwenden Sie das bei der erstmaligen Einrichtung des Portals definierte initiale Administratorkonto. Falls Sie das initiale Administratorkonto herabgestuft oder gelöscht haben, müssen Sie ein anderes Konto mit administrativem Zugriff auf die Portal-Website angeben.
9. Klicken Sie auf Konfigurieren.
10. Konfigurieren Sie das Portal mit dem Reverse-Proxyserver oder Load Balancer Ihrer Organisation, damit die Benutzer über die Standard-Ports auf das Portal zugreifen können. Dazu müssen Sie dem Portal einige Informationen über den Reverse-Proxy oder Load Balancer bereitstellen. Vollständige Anweisungen finden Sie unter Verwenden eines Reverse-Proxyservers mit Portal for ArcGIS.
11. Nachdem Sie den Reverse-Proxy oder Load Balancer mit Ihrem Portal eingerichtet haben, müssen Sie die Seite für die Konfiguration von ArcGIS Web Adaptor aktualisieren.

Hinweis:

Wenn dieser Workflow abgeschlossen ist, ist der Wert der Eigenschaft ‎‎‎EnableDefaultPortValidation in der Datei webadaptor.config auf "true" zurückgesetzt. Sie müssen den Wert wieder auf "false" ändern und den Webserver neu starten, damit die Änderung wirksam wird und Web Adaptor erfolgreich auf dem nicht standardmäßigen Port ausgeführt werden kann.

ArcGIS Web Adaptor ist nun für die Verwendung mit dem ArcGIS Enterprise-Portal konfiguriert. Benutzer greifen dann auf das Portal und das ArcGIS Portal-Administratorverzeichnis nur über den Reverse-Proxyserver mit dem URL-Format https://reverseproxy.domain.com/webadaptorname/home statt über den Port 7443 zu.

Automatisches Konfigurieren von ArcGIS Web Adaptor (IIS) im Portal an Nicht-Standard-Ports

Die Installation und Konfiguration Ihrer ArcGIS Web Adaptor (IIS)-Instanz kann auch auf der Befehlszeile mit zusätzlichen Schritten zur Ausführung an anderen als den Standard-Ports erfolgen.

1. Aktivieren Sie HTTPS auf dem IIS-Webserver, der als Host für Web Adaptor vorgesehen ist. Notieren Sie sich den Port, der für die HTTPS-Kommunikation verwendet wird, da er für den Zugriff auf ArcGIS Web Adaptor während der Erstkonfiguration mit dem Portal verwendet wird.
2. Installieren Sie ArcGIS Web Adaptor (IIS) auf dem Webserver. Verwenden Sie dabei das Befehlszeilendienstprogramm für die Installation als Benutzer mit Administratorberechtigungen.
3. Navigieren Sie auf dem Computer, auf dem ArcGIS Web Adaptor gehostet wird, zur Datei webadaptor.config, und öffnen Sie sie in einem Texteditor. Diese Datei befindet sich standardmäßig im Ordner C:\inetpub\wwwroot\<web adaptor name>.
4. Suchen Sie in der Datei webadaptor.config die Eigenschaft EnableDefaultPortValidation mit dem Standardwert "true". Ändern Sie den Wert in "false": <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
5. Starten Sie den IIS-Webserver neu.
6. Konfigurieren Sie ArcGIS Web Adaptor mit dem Befehlszeilendienstprogramm ConfigureWebAdaptor.exe, das sich im Ordner C:\Program Files (x86)\Common Files\ArcGIS\WebAdaptor\IIS\<current version>\Tools befindet. Verwenden Sie die Syntax ConfigureWebAdaptor.exe /m <Mode> /w <WebAdaptorURL> /g <Machine Name|URL> /u <Username> /p <Password>. Die folgenden Parameter müssen angegeben werden:

   • <Mode>: Der Produktmodus, in dem ArcGIS Web Adaptor konfiguriert wird. Legen Sie diesen Parameter auf portal für die Verwendung mit Portal for ArcGIS fest.
   • <WebAdaptorURL>: Die URL der ArcGIS Web Adaptor-Instanz, die über die Befehlszeile konfiguriert werden soll. Dies ist dieselbe URL, mit der die Konfigurationsseite in einem Webbrowser aufgerufen wird. Sie müssen die HTTPS-URL von ArcGIS Web Adaptorangeben, beispielsweise https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor. Wenn ein DNS-Alias mit dem Portal verwendet wird, sollte Web Adaptor stattdessen mit einer URL (z. B. https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor über den DNS-Alias konfiguriert werden.
   • <URL>: Die URL des Computers, auf dem Portal for ArcGIS gehostet wird. Geben Sie in der URL den vollständig qualifizierten Domänennamen des Computers an, z. B. https://portal.domain.com:7443.
   • <Username>: Der Benutzername eines Kontos, dem Administratorberechtigungen für Portal for ArcGIS zugewiesen wurden. In der Regel verwenden Sie bei der erstmaligen Einrichtung des Portals das initiale Administratorkonto.
   • <Password>: Das Kennwort eines Kontos, dem Administratorberechtigungen für Portal for ArcGIS zugewiesen wurden. In der Regel verwenden Sie bei der erstmaligen Einrichtung des Portals das initiale Administratorkonto.

   Beispielbefehl

   ConfigureWebAdaptor.exe /m portal /w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor /g portal.domain.com /u initialadmin /p secret123

7. Konfigurieren Sie das Portal mit dem Reverse-Proxyserver oder Load Balancer Ihrer Organisation, damit die Benutzer über die Standard-Ports auf das Portal zugreifen können. Dazu müssen Sie dem Portal einige Informationen über den Reverse-Proxy oder Load Balancer bereitstellen. Vollständige Anweisungen finden Sie unter Verwenden eines Reverse-Proxyservers mit Portal for ArcGIS.

Hinweis:

Wenn dieser Workflow abgeschlossen ist, ist der Wert der Eigenschaft ‎‎‎EnableDefaultPortValidation in der Datei webadaptor.config auf "true" zurückgesetzt. Sie müssen den Wert wieder auf "false" ändern und den Webserver neu starten, damit die Änderung wirksam wird und Web Adaptor erfolgreich auf dem nicht standardmäßigen Port ausgeführt werden kann.

ArcGIS Web Adaptor ist nun für die Verwendung mit dem ArcGIS Enterprise-Portal konfiguriert. Benutzer greifen dann auf das Portal und das ArcGIS Portal-Administratorverzeichnis nur über den Reverse-Proxyserver mit dem URL-Format https://reverseproxy.domain.com/webadaptorname/home statt über den Port 7443 zu.