Skip To Content

포털의 ArcGIS Web Adaptor에 기본 포트가 아닌 포트 사용

대부분의 ArcGIS Enterprise 사용자의 경우에는 기본 포트인 80 및 443에서 ArcGIS Web Adaptor를 실행하는 것이 적절합니다. 하지만 가끔씩 웹어댑터 인스턴스가 호스팅 웹서버에서 이러한 기본 포트를 사용할 수 없는 경우도 있습니다. 예를 들어 호스트 웹서버의 한 응용프로그램이 이미 이러한 포트에서 실행되고 있거나 보안 기관에서 포트 접근이 제한되는 경우가 해당됩니다.

이렇게 포트 80 및 443을 사용할 수 없는 경우에 대비하여 ArcGIS Enterprise 10.6.1에서는 포털의 웹어댑터를 기본 포트가 아닌 포트에서 실행되도록 구성할 수 있습니다. 그런 다음 사용자가 기본 포트를 통해 포털에 접근할 수 있도록 역방향 프록시 서버 또는 로드 밸런서를 구성해야 합니다. ArcGIS Web AdaptorPortal for ArcGIS 간의 통신을 암호화하기 위해 HTTPS 사용이 계속 유지되어야 합니다.

10.6.1의 ArcGIS Web Adaptor 구성 파일에는 EnableDefaultPortValidation이라는 새로운 등록정보가 있는데 이 등록정보는 포털에 ArcGIS Web Adaptor를 구성할 때 기본 설정에 따라 기본 포트 80 및 443이 사용되도록 합니다. 이 등록정보의 값을 false로 변경하면 이 유효성 검사가 무시되므로 ArcGIS Web Adaptor를 기본 포트가 아닌 포트에서 실행할 수 있습니다.

기본 포트가 아닌 포트에 포털의 ArcGIS Web Adaptor 구성

포털의 ArcGIS Web Adaptor를 호스팅하는 웹서버가 80 및 443 이외의 포트에서 소프트웨어를 실행해야 하는 경우 설치 및 구성 마법사를 통해 웹어댑터를 설정할 때 추가 단계를 수행해야 합니다.

  1. 웹어댑터를 호스팅하는 웹서버에 HTTPS를 활성화합니다. HTTPS 통신에 사용되고 있는 포트는 ArcGIS Web Adaptor를 포털에 처음 구성할 때 웹어댑터에 접근하는 데 사용됩니다.
  2. Setup.exe 설치 마법사를 관리 권한이 있는 사용자로 사용하여 웹서버에 ArcGIS Web Adaptor를 설치합니다.
  3. ArcGIS Web Adaptor를 호스팅하는 머신에서 webadaptor.config 파일을 찾아 텍스트 편집기에 엽니다. 기본 설정에 따라 이 파일은 /root/.webadaptor/<web adaptor name> 폴더에 있습니다.
  4. webadaptor.config 파일에서 EnableDefaultPortValidation 등록정보를 찾습니다. 이 등록정보에는 기본값 true가 포함되어 있습니다. 다음과 같이 이 값을 false로 변경합니다. <EnableDefaultPortValidation>false</EnableDefaultPortValidation>
  5. 웹서버를 다시 시작합니다.
  6. ArcGIS Web Adaptor URL 형식을 사용하여 웹서버에서 사용 중인 HTTPS 포트의 인터넷 브라우저에 https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor/portal 구성 페이지를 엽니다. DNS 별칭이 포털에 사용될 경우 https://dnsalias.domain.com:<https_port>/<webadaptorname>/webadaptor/portal 등의 URL을 사용하여 별칭을 통해 웹어댑터가 구성되어야 합니다.
  7. 포털 URL 등록정보에는 Portal for ArcGIS 소프트웨어를 호스팅하는 머신의 URL을 정규화된 도메인 이름이 포함된 URL로 입력합니다(예시: https://portal.domain.com:7443).
  8. Portal for ArcGIS에 대한 관리 권한이 있는 계정의 사용자 이름과 비밀번호를 제공합니다. 일반적으로 처음 포털을 설정할 때 정의한 초기 관리자 계정의 로그인을 사용합니다. 초기 관리자 계정의 수준을 내리거나 계정을 삭제한 경우 포털 웹사이트에 대한 관리 권한이 있는 다른 계정을 지정해야 합니다.
  9. 구성을 클릭합니다.
  10. 사용자가 기본 포트를 통해 포털에 접근할 수 있도록 기관의 역방향 프록시 서버 또는 로드 밸런서로 포털을 구성합니다. 이를 위해서는 역방향 프록시 또는 로드 밸런서에 대한 몇 가지 정보를 포털에 제공해야 합니다. 자세한 내용은 Portal for ArcGIS에서 역방향 프록시 서버 사용을 참고하세요.
  11. 포털에 역방향 프록시 또는 로드 밸런서를 설정한 후에는 ArcGIS Web Adaptor 구성 페이지를 새로 고침하여 업데이트합니다.

이 워크플로가 완료되면 ArcGIS Web AdaptorArcGIS Enterprise 포털에 사용할 수 있도록 구성됩니다. 사용자는 포트 7443을 통해서가 아닌 https://reverseproxy.domain.com/webadaptorname/home URL 형식의 역방향 프록시 서버를 통해서만 포털 및 ArcGIS Portal 관리자 디렉터리에 접근하게 됩니다.

기본 포트가 아닌 포트에 포털의 ArcGIS Web Adaptor (Java Platform) 자동 구성

ArcGIS Web Adaptor (Java Platform) 설치 및 구성은 명령줄에서 수행할 수도 있습니다. 이 경우 기본 포트가 아닌 포트에서 실행되도록 단계가 더 추가됩니다.

비고:

명령줄 유틸리티를 실행하려면 ArcGIS Web Adaptor를 호스팅하는 머신에 JRE(Java Runtime Environment)가 있어야 합니다. 머신에 JRE가 없는 경우 유틸리티를 실행하면 오류가 발생합니다. JRE를 다운로드하여 머신에 설치하는 방법에 대한 자세한 내용은 Java SE 다운로드 사이트를 참고하세요.

  1. 웹어댑터를 호스팅하는 웹서버에 HTTPS를 활성화합니다. HTTPS 통신에 사용되고 있는 포트는 ArcGIS Web Adaptor를 포털에 처음 구성할 때 웹어댑터에 접근하는 데 사용됩니다.
  2. 명령줄 라인 유틸리티를 관리 권한이 있는 사용자로 사용하여 웹서버에 ArcGIS Web Adaptor를 설치합니다.
  3. ArcGIS Web Adaptor를 호스팅하는 머신에서 webadaptor.config 파일을 찾아 텍스트 편집기에 엽니다.
  4. webadaptor.config 파일에서 EnableDefaultPortValidation 등록정보를 찾습니다. 이 등록정보에는 기본값 true가 포함되어 있습니다. 다음과 같이 이 값을 false로 변경합니다. <EnableDefaultPortValidation>false</EnableDefaultPortValidation>
  5. 웹서버를 다시 시작합니다.
  6. ArcGIS Web Adaptor 명령줄 유틸리티(configurewebadaptor.sh 폴더에 있음)를 사용하여 <ArcGIS Web Adaptor installation directory>/webadaptor<version>/java/tools를 구성합니다. ConfigureWebAdaptor.sh -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password> 구문을 사용합니다. 다음과 같은 매개변수를 제공할 수 있습니다.

    • <Mode> - ArcGIS Web Adaptor를 구성할 제품 모드입니다. portal에 사용할 수 있도록 이 매개변수를 Portal for ArcGIS로 설정합니다.
    • <WebAdaptorURL> - 명령줄에서 구성할 ArcGIS Web Adaptor의 URL입니다. 이 URL은 웹 브라우저에서 구성 페이지에 접근하는 데 사용되는 URL과 같습니다. ArcGIS Web Adaptor의 HTTPS URL을 지정해야 합니다(예시: https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor). DNS 별칭이 포털에 사용될 경우 https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor 등의 URL을 사용하여 DNS 별칭을 통해 웹어댑터가 구성되어야 합니다.
    • <URL> - Portal for ArcGIS를 호스팅하는 머신의 URL입니다. URL에 머신의 정규화된 도메인 이름을 포함해야 합니다(예시: https://portal.domain.com:7443).
    • <Username> - Portal for ArcGIS에 대한 관리 권한이 있는 계정의 사용자 이름입니다. 일반적으로 포털을 처음 설정할 때 정의한 초기 관리자 계정을 사용합니다.
    • <Password> - Portal for ArcGIS에 대한 관리 권한이 있는 계정의 비밀번호입니다. 일반적으로 포털을 처음 설정할 때 정의한 초기 관리자 계정을 사용합니다.

    명령 예시

    configurewebadaptor.sh -m portal -w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor -g https://portal.domain.com:7443 -u initialadmin -p secret123
  7. 사용자가 기본 포트를 통해 포털에 접근할 수 있도록 기관의 역방향 프록시 서버 또는 로드 밸런서로 포털을 구성합니다. 이를 위해서는 역방향 프록시 또는 로드 밸런서에 대한 몇 가지 정보를 포털에 제공해야 합니다. 자세한 내용은 Portal for ArcGIS에서 역방향 프록시 서버 사용을 참고하세요.

이 워크플로가 완료되면 ArcGIS Web AdaptorArcGIS Enterprise 포털에 사용할 수 있도록 구성됩니다. 사용자는 포트 7443을 통해서가 아닌 https://reverseproxy.domain.com/webadaptorname/home URL 형식의 역방향 프록시 서버를 통해서만 포털 및 ArcGIS Portal 관리자 디렉터리에 접근하게 됩니다.