와우자 REST API 외부 접속과 cURL 사용법

윈도우 환경에서 cURL을 실행하는 방법

1. Windows+R 키를 눌러 실행 대화창을 연다.
2. cmd를 입력해 명령 프롬프트를 실행한다.
3. 명령 프롬프트에서 curl --version을 입력하고 엔터를 친다.

Microsoft Windows [Version 10.0.26200.8875]
(c) Microsoft Corporation. All rights reserved.

C:\>curl --version
curl 8.21.0 (Windows) libcurl/8.21.0 Schannel zlib/1.3.2 WinIDN WinLDAP
Release-Date: 2026-06-24
Protocols: dict file ftp ftps gopher gophers http https imap imaps ipfs ipns ldap ldaps mqtt mqtts pop3 pop3s smtp smtps telnet tftp ws wss
Features: alt-svc AsynchDNS HSTS HTTPS-proxy IDN IPv6 Kerberos Largefile libz SPNEGO SSL SSPI threadsafe Unicode UnixSockets

C:\>

위의 예시처럼 cURL의 버전, 지원 프로토콜과 기능 정보가 출력되면 현재 윈도우 환경에서 cURL을 사용할 수 있다는 의미다. 기본적인 cURL 의 사용법은 다음과 같다.

주의할 점은 명령줄에 직접 입력한 아이디와 암호가 명령 기록에 남거나 실행 화면과 로그를 통해 노출될 수 있다는 것이다. 실제 운영 중인 서버라면 인증 정보의 관리에 주의해야 하고, 최소한 배치 파일을 이용 후 삭제하는 등의 방법으로 유출되지 않도록 하거나 추가적인 보안 수단을 사용해야 한다. 본 글에서는 테스트와 구현을 목적으로 하는 만큼 이에 대한 고려는 하지 않는다.

Step 1 : REST API 동작 확인

와우자의 REST API가 정상 동작 중인지 확인해 본다. 웹 UI가 동작하고 있다면 당연히 REST API 역시 동작 중인 상태겠으나, cURL 사용법도 익히고 통신 상태 점검도 할 겸 확인해 보도록 한다. 위에서 설명한 cURL 기본 사용법을 참고하여, 와우자 서버에 접근해 보도록 하겠다.

C:\>curl -X "GET" "http://decteng:dectengpw@blogdemo.eqmaker.kr:8087"
<error><success>false</success><code>403</code><message>Your IP address (w.x.y.z) has been blocked</message></error>
// 해석 : 니 IP (w.x.y.z)는 접근이 안 된다.

위의 모습처럼 응답이 온다면 와우자의 REST API에 정상적으로 접근했다는 의미이다. (현재는 접근 권한을 주지 않은 상태로, 오류 응답이 오는 것이 정상이다.)

만약 응답이 없거나, 연결 시간 초과 등의 오류가 발생하면 서버의 주소와 포트를 확인해 주어야 한다. 만약, The request requires user authentication라는 메시지를 받았다면 접근에는 성공했지만 계정 또는 암호를 잘못 입력했다는 의미이다.

기본적인 cURL 사용법도 익혔고, 와우자 REST API 접근 가능 여부도 확인했으니, 이제 와우자의 REST API 설정을 변경해 외부에서도 접근할 수 있도록 설정할 차례이다.

Step 2 : Server.xml 수정

와우자 REST API 관련 설정은 와우자의 기본 설치 경로 아래에 있는 conf 디렉토리의 Server.xml 파일에서 관리한다. 파일을 열면 앞부분에서 다음과 같은 REST API 설정 블록을 확인할 수 있다.

...(전략)...
<RESTInterface>
 <Enable>true</Enable>
 <IPAddress>*</IPAddress>
 <Port>8087</Port>
 <AuthenticationMethod>basic</AuthenticationMethod>
 <PasswordEncodingScheme>bcrypt</PasswordEncodingScheme>
 <DiagnosticURLEnable>true</DiagnosticURLEnable>
  <SSLConfig>
   <Enable>false</Enable>
   <KeyStorePath></KeyStorePath>
   <KeyStorePassword></KeyStorePassword>
   <KeyStoreType>JKS</KeyStoreType>
   <SSLProtocol>TLS</SSLProtocol>
   <Algorithm>SunX509</Algorithm>
   <CipherSuites></CipherSuites>
   <Protocols></Protocols>
  </SSLConfig>
  <IPWhiteList>127.0.0.1</IPWhiteList>
  <IPBlackList></IPBlackList>
  <EnableXMLFile>false</EnableXMLFile>
  <DocumentationServerEnable>false</DocumentationServerEnable>
  <DocumentationServerPort>8089</DocumentationServerPort>
  <DocumentationServerAuthenticationMethod>none</DocumentationServerAuthenticationMethod>
  <Properties>
  </Properties>
</RESTInterface>
...(생략)...

이 설정 블록에서 붉은색으로 표시된 <IPWhiteList> 태그 부분이 와우자 REST API에 접근할 수 있는 IP 주소를 정의하는 부분이다. 아래의 예시를 참고하여 접속을 허용할 IP를 추가해 준다.

IP 화이트리스트 설정 시 참고할 사항이 있다.

• 주소는 단일 IP 주소 또는 와일드카드 * 를 사용하는 IP 대역으로 설정할 수 있다.
• 여러 주소 또는 대역을 지정할 경우 ,로 구분해 준다.
• localhost를 뜻하는 127.0.0.1는 삭제하면 안 된다. 이 경우 웹 UI 를 사용하지 못하게 된다.

Server.xml 파일의 수정을 완료하고 저장한 후, 와우자 서비스를 재시작해 준다.

Step 3 : 진실의 시간 – 연동 확인

와우자 서비스를 재시작한 뒤 cURL을 이용해 Step 1에서 전송했던 요청을 다시 한번 보내 본다.

C:\>curl -X "GET" "http://decteng:dectengpw@blogdemo.eqmaker.kr:8087"
Wowza Streaming Engine 4 Trial Edition (Expires: May 04, 2025) 4.8.25+2 build20231003151257

Step 1의 결과와 다르게, 이번에는 와우자 스트리밍 엔진의 버전 정보가 출력되고 있다. 이는 와우자가 cURL의 요청을 정상적으로 받아들이고 응답했다는 의미다.

이참에 와우자 제어 방법을 소개하며 예시로 들었던 REST API의 로그 파일 목록 조회 요청도 시험해 보자.

C:\>curl -X "GET" "http://decteng:dectengpw@blogdemo.eqmaker.kr:8087/v2/servers/defaultServer/logfiles"
<?xml version='1.0' encoding='UTF-8'?><ServerLogFiles serverName="defaultServer">
 <ServerLogFiles id="wowzastreamingengine_access.log" href="%2Fv2%2Fservers%2F_defaultServer_%2Flogfiles%2Fwowzastreamingengine_access.log">
  <FileSize>420551</FileSize>
  <StartDateMS>1744729200000</StartDateMS>
      ... 중략 ...
 <ServerLogFiles id="wowzastreamingengine_stats.log" href="%2Fv2%2Fservers%2F_defaultServer_%2Flogfiles%2Fwowzastreamingengine_stats.log">
  <FileSize>313</FileSize>
  <StartDateMS>1744383600000</StartDateMS>
 </ServerLogFiles>
</ServerLogFiles>
C:\>

와우자 서버의 최신 로그 파일 목록을 XML 형태로 반환해 주는 것을 확인할 수 있다. 이로써 Server.xml의 IP 화이트리스트 수정과 서비스 재시작, 외부 접속 확인까지 와우자 REST API를 외부에서 사용할 수 있도록 하는 기본 설정이 완료되었다.