Wi-Fi QR 코드 생성기

휴대폰이 비밀번호를 직접 입력하지 않고 한 번의 스캔만으로 Wi-Fi 네트워크에 연결할 수 있는 QR 코드를 생성합니다. iOS와 Android 카메라에서 기본적으로 인식됩니다. 모든 처리가 브라우저 안에서 이루어집니다.

조회수 216회

Wi-Fi QR 코드 형식

Wi-Fi QR 코드를 스캔하면 작동하는 이유는, 이 코드가 일반 링크가 아니라 작은 구조화된 문자열을 인코딩하기 때문입니다: WIFI:T:WPA;S:MyNetwork;P:MyPassword;H:false;;. 각 필드는 한 글자짜리 키를 가집니다 — 보안 유형(WPA, WEP, 개방형 네트워크는 nopass)에는 T, 네트워크 이름(SSID)에는 S, 비밀번호에는 P, 네트워크가 숨겨져 있는지 여부에는 H를 사용하며, 각 필드는 세미콜론으로 구분되고 이중 세미콜론으로 마무리됩니다. 휴대폰의 카메라 앱은 이 문자열을 분석하여 WIFI: 접두사를 인식하고, 이를 링크나 일반 텍스트로 여는 대신 곧바로 네트워크에 연결하겠냐고 제안합니다.

이 형식에는 공식적인 IEEE나 Wi-Fi Alliance 규격이 존재하지 않습니다. 초창기 많은 Android QR 리더의 기반이 되었던 오픈소스 바코드 스캔 라이브러리 ZXing(Zebra Crossing)이 이 형식을 대중화시켰고, 모두가 동일한 구문을 그대로 채택하면서 사실상의 업계 표준이 되었습니다. Apple은 2017년 iOS 11부터 이 형식을 공식적으로 완전히 지원하기 시작했는데, 이때 기본 카메라 앱이 Wi-Fi QR 코드를 인식하여 한 번의 탭으로 "네트워크 참가" 제안을 표시할 수 있게 되었습니다. Android의 기본 카메라와 Google 렌즈 역시 동일한 형식을 기본적으로 지원합니다. 이 형식은 공식 규격에 묶인 적이 없었기 때문에 스캐너마다 구현상의 작은 차이가 존재합니다 — 일부는 H: 필드가 아예 생략된 경우 네트워크를 공개된 것으로 간주하고 무리 없이 넘어갑니다 — 하지만 T:, S:, P: 필드는 오늘날 사용되는 사실상 모든 리더에서 동일하게 읽히며, 이것이 공식 표준화 기구가 없음에도 이 형식이 실제로 신뢰할 수 있는 이유입니다.

특수 문자를 이스케이프해야 하는 이유

세미콜론과 쉼표는 이 형식 자체의 필드 및 값 구분자이기 때문에, 네트워크 이름이나 비밀번호에 우연히 이 문자가 포함되어 있으면 — 예를 들어 Office,Floor 2라는 이름의 게스트 네트워크 — 그대로 두었을 때 파서가 조용히 오작동할 수 있습니다: 이스케이프되지 않은 쉼표는 서로 완전히 다른 두 필드의 경계로 잘못 해석되어, 그 뒤에 오는 모든 내용을 손상시킵니다. 이 규격은 값 안에 등장하는 다섯 개 문자 앞에 백슬래시를 붙여 이스케이프하도록 요구함으로써 이 문제를 해결합니다: 백슬래시 자체(\\\), 세미콜론(;\;), 쉼표(,\,), 콜론(:\:), 큰따옴표("\")입니다. 이 도구는 인코딩하기 전에 네트워크 이름과 비밀번호 모두에 이 이스케이프 처리를 자동으로 적용하므로, 라우터가 허용하는 어떤 문자든 안전하게 사용할 수 있습니다.

이것이 정적인 코드라는 점을 기억하세요: 현재 비밀번호가 이미지 안에 직접 내장되므로, Wi-Fi 비밀번호가 변경되면 이 코드는 더 이상 작동하지 않으며 새 코드를 생성해야 합니다. 또한 최신 라우터에서는 이제 WPA3가 흔하지만, 이 도구는 — 대부분의 Wi-Fi QR 생성기와 마찬가지로 — WPA3 네트워크도 여전히 T:WPA로 인코딩한다는 점도 알아둘 만합니다. 이 형식은 WPA3보다 먼저 만들어졌고, 모든 스캐너가 이미 이 값을 "표준 비밀번호 핸드셰이크를 사용하라"는 의미로 처리하기 때문에, 라우터가 실제로 WPA2를 사용하든 WPA3를 사용하든 상관없이 올바르게 작동합니다. 모든 처리는 브라우저 안에서 로컬로 이루어집니다 — 네트워크 이름과 비밀번호는 어디로도 전송되지 않으며, 이는 공개 링크가 아니라 실제 사용 중인 자격 증명을 인코딩하는 것이므로 특히 중요합니다.

자주 묻는 질문

Wi-Fi QR 코드 형식은 공식 표준인가요?

아니요. 이를 위한 공식 IEEE나 Wi-Fi Alliance 규격은 존재하지 않습니다. WIFI: 형식은 오픈소스 바코드 라이브러리인 ZXing(Zebra Crossing)에 의해 대중화되었으며, 주요 카메라 앱과 QR 생성기가 모두 동일한 구문을 채택하면서 사실상의 표준이 되었습니다. 공식적으로 표준화된 적이 없음에도 어디서나 작동합니다.

어떤 휴대폰이 Wi-Fi QR 코드를 스캔할 수 있나요?

iOS 11 이상(2017년 출시)을 실행하는 모든 iPhone은 기본 카메라 앱에서 이를 직접 인식하여 한 번의 탭으로 "네트워크 참가" 제안을 표시합니다. Android 휴대폰도 기본 카메라나 Google 렌즈를 통해 동일한 형식을 지원하지만, 정확한 스캔 화면은 제조사와 Android 버전에 따라 다소 다를 수 있습니다.

네트워크 이름의 특수 문자를 왜 이스케이프해야 하나요?

세미콜론, 쉼표, 콜론은 이 형식 자체의 구조적 문자입니다 — 한 필드가 어디서 끝나고 다음 필드가 어디서 시작하는지를 표시합니다. SSID나 비밀번호에 이스케이프되지 않은 문자가 포함되어 있으면, QR 리더는 이를 필드 구분자로 잘못 인식하여 손상된 값으로 연결을 시도하거나 아예 실패합니다. 이 도구가 자동으로 수행하는 백슬래시 이스케이프는 파서에게 해당 문자를 문자 그대로 처리하라고 알려줍니다.

코드를 생성한 뒤 Wi-Fi 비밀번호를 변경하면 어떻게 되나요?

코드가 더 이상 작동하지 않습니다. 이는 정적인 QR 코드이기 때문입니다 — 생성 당시의 비밀번호가 이미지에 직접 새겨져 있으며, 변경 사항을 자동으로 반영할 수 있는 라우터와의 연결이 없습니다. 비밀번호가 바뀔 때마다 새 코드를 생성하여 다시 인쇄하세요.

이 도구에 Wi-Fi 비밀번호를 입력해도 안전한가요?

네 — 양식을 작성하는 것부터 QR 이미지를 렌더링하는 것까지 전체 과정이 JavaScript를 사용해 브라우저 안에서 로컬로 실행됩니다. 입력한 내용은 어떤 서버에도 업로드되거나 전송되지 않습니다. 다만 인쇄되었거나 공유된 QR 코드 자체는 비밀번호와 동일한 수준으로 주의해서 다루세요: 이를 스캔하는 사람은 누구나 네트워크에 접속할 수 있습니다.

댓글

아직 댓글이 없습니다 — 첫 댓글을 남겨보세요!

비슷한 도구