<div id="readability-page-1" class="page"><div><div><h2 id="176d">원인</h2><div aria-hidden="false"><a rel="noopener follow" href="/?source=post_page---byline--f3abc6df610c---------------------------------------"><div><p><img alt="이상문" src="https://miro.medium.com/v2/resize:fill:88:88/1*PdFTYwkEj-ebxhH52VWJ8w.png" width="44" height="44" loading="lazy" data-testid="authorPhoto"></p></div></a></div></div><p id="bd24">안드로이드 에뮬레이터는 실제 장치와는 다른 네트워크 환경을 사용한다. 에뮬레이터에서 <code>localhost</code> 또는 <code>127.0.0.1</code>은 에뮬레이터 자체의 로컬 주소를 가리키게 되므로, 개발 PC에서 실행 중인 서버에 접근할 수 없다. 따라서, Retrofit과 같은 HTTP 클라이언트를 사용하여 <code>localhost</code> 또는 <code>127.0.0.1</code>로 서버에 접근하려고 하면 <code>IOException</code>이 발생한다.</p><h2 id="6ed0">해결 방법(windows)</h2><p id="980a">Windows 환경에서 안드로이드 에뮬레이터가 개발 PC의 로컬 서버에 접근하려면, <code>ipconfig</code> 명령을 사용하여 PC의 IP 주소를 확인하고, 이를 Retrofit의 <code>baseUrl</code>에 설정해야 한다.</p><ol><li id="96ce"><strong>IP 주소 확인:</strong></li></ol><ul><li id="02a3">Windows 명령 프롬프트(cmd)를 실행한다.</li><li id="810f"><code>ipconfig</code> 명령을 입력한다.</li><li id="72db">출력 결과에서 “IPv4 주소”를 찾는다. 이 주소가 PC의 로컬 IP 주소이다. (예: 192.168.0.5).</li></ul><p id="79b0"><strong>2. Retrofit baseUrl 설정:</strong></p><ul><li id="e260">Retrofit을 초기화할 때, 확인한 IPv4 주소와 로컬 서버의 포트 번호를 사용하여 <code>baseUrl</code>을 설정한다.</li></ul><pre><span id="ddd3">// 192.168.0.5는 예시 IP 주소이며, 8080은 예시 포트 번호이다.<br>// 실제 값으로 변경해야한다.<br>val retrofit = Retrofit.Builder()<br>    .baseUrl("http://192.168.0.5:8080/") <br>    .addConverterFactory(GsonConverterFactory.create())<br>    .build()</span></pre><h2 id="295b"><code>android:usesCleartextTraffic="true"</code> 설정</h2><h2 id="f1ee">HTTP와 보안</h2><p id="c525">HTTP는 평문(cleartext) 프로토콜로, 데이터를 암호화하지 않고 전송한다. 이는 민감한 정보(예: 비밀번호, 개인 정보)가 네트워크를 통해 그대로 노출될 수 있음을 의미한다. HTTPS는 HTTP에 보안 계층인 SSL/TLS를 추가하여 데이터 암호화를 제공함으로써 이러한 문제를 해결한다.</p><h2 id="1377">Android의 보안 정책</h2><p id="9aba">안드로이드는 앱의 네트워크 보안을 강화하기 위해, Android 9 (API 레벨 28)부터는 앱이 기본적으로 평문 HTTP 트래픽을 사용하는 것을 제한한다. 즉, HTTPS를 사용하도록 권장하고, 필요한 경우에만 평문 HTTP 사용을 허용하도록 변경되었다.</p><h2 id="4278"><code>android:usesCleartextTraffic="true"</code>의 역할</h2><p id="956b"><code>android:usesCleartextTraffic="true"</code>는 <code>AndroidManifest.xml</code> 파일의 <code>&lt;application&gt;</code> 또는 <code>&lt;activity&gt;</code> 요소에 추가하는 속성이다. 이 속성은 앱이 평문 HTTP 트래픽을 사용하도록 명시적으로 허용하는 역할을 한다.</p><ul><li id="6613"><code><strong>&lt;application&gt;</strong></code>에 설정: 앱 전체에 대한 평문 트래픽 허용 여부를 설정한다.</li><li id="694f"><code><strong>&lt;activity&gt;</strong></code>에 설정: 특정 액티비티에 대해서만 평문 트래픽을 허용한다.</li></ul><h2 id="d046">설정 이유</h2><p id="a39a">HTTP로 서비스하는 호스트에 접근해야 하는 경우, 이 설정을 추가하지 않으면 <code>NetworkOnMainThreadException</code> 또는 <code>Cleartext HTTP traffic to [호스트 주소] not permitted</code>와 같은 예외가 발생하며 연결이 차단된다. 이는 안드로이드의 기본 보안 정책 때문이며, 개발자가 명시적으로 평문 트래픽을 허용해야 한다.</p><h2 id="3d4c">주의사항</h2><p id="bd4b"><code>android:usesCleartextTraffic="true"</code> 설정은 보안에 취약할 수 있으므로, 가능한 한 HTTPS를 사용하는 것이 좋다. 이 설정은 개발 또는 테스트 목적으로, 또는 레거시 시스템과의 연동 등 불가피한 경우에만 사용하는 것이 바람직하다. 프로덕션 환경에서는 보안 강화를 위해 HTTPS를 적용하고, 필요한 경우 네트워크 보안 구성(Network Security Configuration)을 사용하여 특정 도메인에 대해서만 평문 트래픽을 허용하는 것이 좋다.</p></div></div>

Stories by 이상문 on Medium

원인
안드로이드 에뮬레이터는 실제 장치와는 다른 네트워크 환경을 사용한다. 에뮬레이터에서 localhost 또는 127.0.0.1은 에뮬레이터 자체의 로컬 주소를 가리키게 되므로, 개발 PC에서 실행 중인 서버에 접근할 수 없다. 따라서, Retrofit과 같은 HTTP 클라이언트를 사용하여 localhost 또는 127.0.0.1로 서버에 접근하려고 하면 IOException이 발생한다.
해결 방법(windows)
Windows 환경에서 안드로이드 에뮬레이터가 개발 PC의 로컬 서버에 접근하려면, ipconfig 명령을 사용하여 PC의 IP 주소를 확인하고, 이를 Retrofit의 baseUrl에 설정해야 한다.
IP 주소 확인:
Windows 명령 프롬프트(cmd)를 실행한다.
ipconfig 명령을 입력한다.
출력 결과에서 “IPv4 주소”를 찾는다. 이 주소가 PC의 로컬 IP 주소이다. (예: 192.168.0.5).
2. Retrofit baseUrl 설정:
Retrofit을 초기화할 때, 확인한 IPv4 주소와 로컬 서버의 포트 번호를 사용하여 baseUrl을 설정한다.
// 192.168.0.5는 예시 IP 주소이며, 8080은 예시 포트 번호이다.
// 실제 값으로 변경해야한다.
val retrofit = Retrofit.Builder()
    .baseUrl("http://192.168.0.5:8080/") 
    .addConverterFactory(GsonConverterFactory.create())
    .build()
android:usesCleartextTraffic="true" 설정
HTTP와 보안
HTTP는 평문(cleartext) 프로토콜로, 데이터를 암호화하지 않고 전송한다. 이는 민감한 정보(예: 비밀번호, 개인 정보)가 네트워크를 통해 그대로 노출될 수 있음을 의미한다. HTTPS는 HTTP에 보안 계층인 SSL/TLS를 추가하여 데이터 암호화를 제공함으로써 이러한 문제를 해결한다.
Android의 보안 정책
안드로이드는 앱의 네트워크 보안을 강화하기 위해, Android 9 (API 레벨 28)부터는 앱이 기본적으로 평문 HTTP 트래픽을 사용하는 것을 제한한다. 즉, HTTPS를 사용하도록 권장하고, 필요한 경우에만 평문 HTTP 사용을 허용하도록 변경되었다.
android:usesCleartextTraffic="true"의 역할
android:usesCleartextTraffic="true"는 AndroidManifest.xml 파일의 <application> 또는 <activity> 요소에 추가하는 속성이다. 이 속성은 앱이 평문 HTTP 트래픽을 사용하도록 명시적으로 허용하는 역할을 한다.
<application>에 설정: 앱 전체에 대한 평문 트래픽 허용 여부를 설정한다.
<activity>에 설정: 특정 액티비티에 대해서만 평문 트래픽을 허용한다.
설정 이유
HTTP로 서비스하는 호스트에 접근해야 하는 경우, 이 설정을 추가하지 않으면 NetworkOnMainThreadException 또는 Cleartext HTTP traffic to [호스트 주소] not permitted와 같은 예외가 발생하며 연결이 차단된다. 이는 안드로이드의 기본 보안 정책 때문이며, 개발자가 명시적으로 평문 트래픽을 허용해야 한다.
주의사항
android:usesCleartextTraffic="true" 설정은 보안에 취약할 수 있으므로, 가능한 한 HTTPS를 사용하는 것이 좋다. 이 설정은 개발 또는 테스트 목적으로, 또는 레거시 시스템과의 연동 등 불가피한 경우에만 사용하는 것이 바람직하다. 프로덕션 환경에서는 보안 강화를 위해 HTTPS를 적용하고, 필요한 경우 네트워크 보안 구성(Network Security Configuration)을 사용하여 특정 도메인에 대해서만 평문 트래픽을 허용하는 것이 좋다.

안드로이드 에뮬레이터에서 로컬 호스트 접근 시 IOException 발생 원인 및 해결 방법

댓글