Management API의 TLS 구성

Private Cloud용 Edge v. 4.16.05

기본적으로 관리 API에는 TLS가 사용 중지되어 있으며 사용자는 다음을 통해 Edge 관리 API에 액세스합니다. 관리 서버 노드의 IP 주소와 포트 8080을 사용한 HTTP. 예를 들면 다음과 같습니다.

http://ms_IP:8080

또는 다음 위치에서 액세스할 수 있도록 관리 API에 대한 TLS 액세스를 구성할 수 있습니다. 양식:

https://ms_IP:8443

이 예시에서는 포트 8443을 사용하도록 TLS 액세스를 구성합니다. 그러나 해당 포트 번호는 다른 포트 값을 사용하도록 관리 서버를 구성할 수 있습니다. 유일한 방화벽이 지정된 포트를 통한 트래픽을 허용해야 합니다.

관리 API를 오가는 트래픽 암호화를 보장하려면 /<install_dir>/apigee/customer/application/management-server.properties 파일에서 참조됩니다.

TLS 구성 외에도 비밀번호 유효성 확인 (비밀번호 길이)을 제어할 수 있습니다. management-server.properties 파일을 수정하여 이러한 속성을 적용합니다.

TLS 포트가 열려 있는지 확인하세요.

이 섹션의 절차는 관리 서버에서 포트 8443을 사용하도록 TLS를 구성합니다. 사용하는 포트와 관계없이 관리에서 포트가 열려 있는지 확인해야 합니다. 서버. 예를 들어 다음 명령어를 사용하여 파일을 열 수 있습니다.

$ iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 8443 -j ACCEPT --verbose 

TLS 구성

/<install_dir>/apigee/customer/application/management-server.properties를 수정합니다. 파일을 사용하여 관리 API를 오가는 트래픽에 대한 TLS 사용을 제어합니다. 이 파일이 없으면 만듭니다

다음 절차에 따라 관리 API에 대한 TLS 액세스를 구성합니다.

1. TLS 인증서와 비공개 키가 포함된 키 저장소 JKS 파일을 생성합니다. 자세한 내용은 자세한 내용은 Edge On용 TLS/SSL 구성 전제.
2. 키 저장소 JKS 파일을 관리 서버 노드의 디렉터리(예: /tmp입니다.
3. JKS 파일의 소유권을 Apigee로 변경합니다.
   $ chown apigee:apigee keystore.jks
   
   여기서 keystore.jks는 키 저장소 파일의 이름입니다.
4. /<install_dir>/apigee/customer/application/management-server.properties를 수정합니다. 다음과 같은 속성을 설정합니다. 이 파일이 존재하지 않으면 다음과 같이 만듭니다.
   conf_webserver_ssl.enabled=true
   # 모든 통신이 HTTPS를 통해 이루어져야 하는 경우 true로 설정합니다.
   # Edge 내부 호출이 HTTP를 사용하는 경우가 많으므로 권장되지 않습니다.
   conf_webserver_http.turn.off=false
   conf_webserver_ssl.port=8443
   conf_webserver_keystore.path=/tmp/keystore.jks
   # 아래에 난독화된 키 저장소 비밀번호를 입력하세요.
   conf_webserver_keystore.password=OBF:obfuscatedPassword
   conf_webserver_cert.alias=apigee-devtest
   
   여기서 keyStore.jks는 키 저장소 파일입니다. obfuscatedPassword는 난독화된 키 저장소 비밀번호입니다. 자세한 내용은 Edge 온프레미스용 TLS/SSL 구성에서 난독화된 비밀번호 생성에 대한 정보를 제공합니다.
5. 
   명령어를 사용하여 에지 관리 서버를 다시 시작합니다. $ /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-management-server 다시 시작

이제 관리 API에서 TLS를 통한 액세스를 지원합니다.

TLS를 사용하여 액세스하도록 Edge UI를 구성합니다. Edge API

위 절차에서 Apigee는 conf_webserver_http.turn.off=false를 그대로 두어 Edge UI는 HTTP를 통해 Edge API를 계속 호출할 수 있습니다. 다음 절차를 따르세요. HTTPS를 통해서만 이러한 호출을 하도록 Edge UI를 구성합니다.

1. 위에 설명된 대로 관리 API에 대한 TLS 액세스를 구성합니다.
2. TLS가 관리 API에서 작동하는지 확인한 후 /<install_dir>/apigee/customer/application/management-server.properties를 수정합니다. 다음 속성을 설정합니다.
   conf_webserver_http.turn.off=true
3. 
   명령어를 사용하여 에지 관리 서버를 다시 시작합니다. $ /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-management-server 다시 시작
4. /<install_dir>/apigee/customer/application/ui.properties를 수정합니다. 을 사용하여 Edge UI에 다음 속성을 설정합니다. 이 파일이 존재하지 않으면 다음과 같이 만듭니다.
   conf_apigee_apigee.mgmt.baseurl=&quot;https://MS_IP:8443/v1&quot;
   
   여기서 MS_IP는 관리 서버의 IP 주소이고 포트는 number는 conf_webserver_ssl.port에서 위에 지정된 포트입니다.
5. 다음에 대한 TLS 액세스를 구성할 때 자체 서명 인증서를 사용한 경우에만 위의 관리 API를 실행하려면 다음 속성을 ui.properties에 추가하세요.
   conf/application.conf+ws.acceptAnyCertificate=true
   
   그렇지 않으면 Edge UI에서 자체 서명 인증서를 거부합니다.
6. 
   명령어를 사용하여 Edge UI를 다시 시작합니다. $ /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-ui 재시작

관리 서버의 TLS 속성

다음 표에는 management-server.properties에서 설정할 수 있는 모든 TLS/SSL 속성이 나와 있습니다.