홈어시스턴트(HA) 샤오미 홈(Xiaomi Home) 로그인 안 됨 해결법 / Credentials 에러

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

홈어시스턴트(Home Assistant)에 샤오미 기기를 연동하려는데, 계속되는 'Credential' 오류 때문에 답답하셨나요? 샤오미 계정의 보안이 강화되면서 예전 방식으로는 기기 토큰(Token)을 가져오기 어려워졌습니다. 특히 캡챠(CAPTCHA)나 2단계 인증(2FA)을 사용한다면 문제는 더 복잡해지죠.



하지만 걱정 마세요. 이 문제를 아주 간단하고 확실하게 해결할 수 있는 방법이 있습니다. 이 블로그 글에서는 파이썬 스크립트를 사용해 단 몇 분 만에 샤오미 기기의 토큰을 추출하는 방법을 자세히 알려드립니다.


무엇이 문제일까요?

과거에 많이 사용되던 토큰 추출 프로그램들은 아이디와 비밀번호만으로 로그인을 시도합니다. 아래 이미지와 같은 프로그램이 대표적이죠.

하지만 샤오미 계정 로그인 시 캡챠나 2단계 인증(2FA) 같은 보안 기능이 활성화되어 있으면, 자동화된 프로그램은 사람의 개입이 필요한 이 과정을 통과하지 못하고 '잘못된 인증 정보(Invalid credential)' 오류를 뿜어내게 됩니다.


수동 구성: IP 주소와 토큰만 있다면...

사실 홈어시스턴트의 샤오미 연동(Xiaomi Miio) 설정에는 '수동 구성' 옵션이 있습니다. 이 방법을 사용하면 샤오미 계정으로 로그인하는 대신, 기기의 IP 주소와 토큰(Token) 값만 직접 입력하여 간단하게 기기를 추가할 수 있습니다.




이제부터 이 핵심 열쇠인 토큰을 찾는 가장 확실한 방법을 알아보겠습니다.


해결책: 대화형 스크립트로 정면 돌파!

여기서 우리가 사용할 방법은 PiotrMachowski의 Xiaomi-cloud-tokens-extractor라는 프로그램입니다. 이 스크립트의 가장 큰 장점은 '대화형 프롬프트'를 지원한다는 점입니다. 


https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor


즉, 프로그램이 로그인을 시도하다가 캡챠가 나타나면 우리에게 이미지를 보여주고 직접 입력하게 하며, 2단계 인증 코드가 필요하면 입력을 기다려줍니다. 마치 우리가 직접 웹사이트에 로그인하는 것처럼 말이죠!

최근에는 압축된 실행 파일(.exe)이 바이러스로 오진되는 경우가 있어, 우리는 소스 코드를 직접 내려받아 파이썬으로 실행하는 가장 안전한 방법을 사용하겠습니다.




초간단 따라하기 가이드 (5분 컷)

준비물: Python이 설치된 컴퓨터

컴퓨터를 잘 다루는 분이라면 아래 과정이 매우 간단하게 느껴지실 겁니다.

1. 토큰 추출기 다운로드 및 준비

먼저 터미널(Windows의 경우 PowerShell 또는 CMD)을 열고 아래 명령어를 순서대로 입력하세요.

# 최신 버전의 프로그램을 다운로드합니다.
wget https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor/releases/latest/download/token_extractor.zip

# 다운로드한 파일의 압축을 풉니다.
unzip token_extractor.zip

# 압축 해제된 폴더로 이동합니다.
cd token_extractor

2. 스크립트 실행 및 정보 입력

이제 모든 준비가 끝났습니다. 아래 명령어로 파이썬 스크립트를 실행해주세요.

python token_extractor.py

스크립트가 실행되면 다음과 같은 정보를 순서대로 물어볼 것입니다.

  • Mi Home 아이디 (이메일 또는 전화번호)

  • Mi Home 비밀번호

  • 서버 지역

*참고로 대한민국의 서버 지역은 sg

3. 캡챠 및 2단계 인증(2FA) 진행

정보를 모두 입력하면 스크립트가 로그인을 시도합니다.

  • 캡챠(CAPTCHA): 만약 캡챠가 필요하다면, 관련 이미지가 자동으로 열리거나 링크가 표시됩니다. 이미지에 보이는 글자나 숫자를 터미널에 그대로 입력하고 엔터를 누르세요.

  • 2단계 인증(2FA): 스마트폰으로 전송된 2단계 인증 코드를 터미널에 입력하고 엔터를 누르세요.

4. 토큰 확인 및 복사

로그인에 성공하면, 여러분의 계정에 등록된 모든 샤오미 기기 목록이 아래와 같은 형식으로 나타납니다.

---
Name: Mi Smart Plug
Model: chuangmi.plug.v3
IP: 192.168.1.100
Token: abcdef1234567890abcdef1234567890  <-- 바로 이것!
---
Name: Mi Air Purifier 3H
Model: zhimi.airpurifier.mb3
IP: 192.168.1.101
Token: 1234567890abcdef1234567890abcdef
---

이제 여기서 필요한 기기의 IP와 Token 값을 복사하여 홈어시스턴트 설정에 붙여넣기만 하면 모든 과정이 끝납니다!



혹시 다른 방법은 없나요?

물론입니다. 안드로이드 스마트폰(또는 PC의 BlueStacks 앱)이 있다면, Mi Home 앱의 데이터베이스 파일에서 토큰을 직접 추출하는 방법도 있습니다. 하지만 개발 환경에 익숙하거나 컴퓨터를 다루는 데 어려움이 없는 홈어시스턴트 사용자에게는 오늘 소개해드린 파이썬 스크립트 방식이 훨씬 직관적이고 빠릅니다.

이제 답답했던 로그인 오류에서 벗어나, 여러분의 모든 샤오미 기기를 홈어시스턴트에 완벽하게 연동하고 진정한 스마트홈을 완성해 보세요!

댓글

댓글 쓰기

이 블로그의 인기 게시물

리디페이퍼프로 PC 연결/인식 안 됨? 3가지 해결 방법 총정리

이미지
"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다." 리디페이퍼를 PC에 연결했는데 아무 반응이 없어 당황하셨나요? 간단한 방법으로 해결할 수 있는 경우가 많습니다. 아래 3가지 방법을 순서대로 확인해 보세요. 1. Windows Media Player 설치 확인 리디페이퍼는 MTP(미디어 전송 프로토콜) 방식으로 PC와 연결됩니다. Windows 10 'N' 또는 'KN' 버전 을 사용하신다면 MTP 연결에 필요한 미디어 기능 팩(Windows Media Player 포함)이 기본적으로 설치되어 있지 않을 수 있습니다. 아래 리디북스 공식 도움말 링크에서 내 PC 버전과 비트에 맞는 미디어 기능 팩을 설치하면 간단하게 해결될 수 있습니다. 리디북스 공식 도움말: 페이퍼 PC 연결 인식 불가 문제 2. USB 케이블 교체 가장 흔한 원인 중 하나입니다. 눈으로 보기엔 멀쩡해도 케이블 내부에 문제가 있거나, 처음부터 데이터 전송 기능이 없는 충전 전용 케이블 일 수 있습니다. 가지고 있는 다른 USB 케이블(스마트폰 데이터 케이블 등)로 연결을 시도해 보세요. 의외로 쉽게 문제가 해결될 수 있습니다. 3. PC 본체 후면 USB 포트 사용 PC 본체 전면의 USB 포트는 케이스 내부에서 메인보드와 별도의 케이블로 연결되는 경우가 많습니다. 이 과정에서 전력 공급이 불안정하거나 데이터 전송에 오류가 발생할 수 있습니다. 반면, 후면 USB 포트는 메인보드에 직접 연결 되어 있어 훨씬 더 안정적인 전력과 데이터 통신을 보장합니다. 전면 포트에서 인식이 안 된다면 꼭 후면 포트에 연결해 보세요.
자세한 내용 보기

네이버 클립 영상을 클릭 한 번으로 다운로드 - 네이버 클립을 인스타릴스,유튜브쇼츠 공유하기

이미지
클립 다운로더 바로가기! 개인적인 용도로만 사용해주세요. 본 서비스는 네이버와 관련이 없으며, 저작권은 원 제작자에게 있습니다. 네이버 클립 영상을 클릭 한 번 으로 다운로드 2단계: 사용 방법 1 네이버 클립 방문 다운로드할 네이버 클립 페이지를 엽니다 💡 PC 버전 블로그의 경우 blog.naver.com  → m.blog.naver.com 으로 접속 후 클립 클릭 2 북마크 클릭 북마크바의 "네이버 클립 다운로더"를 클릭 3 다운로드 새 탭에서 다운로드 링크가 자동 생성됩니다! Q. 북마크바가 안 보여요! A. Ctrl+Shift+B (Windows) 또는 Cmd+Shift+B (Mac)를 눌러 북마크바를 표시하세요. Q. 비디오 URL을 못 찾는다고 나와요 A. 페이지를 새로고침하고 비디오를 재생한 후 다시 시도해보세요. 비디오가 완전히 로드된 후에 사용하면 성공률이 높습니다. Q. 모바일에서도 사용할 수 있나요? A. 현재는 PC 브라우저에서만 지원됩니다. Q. 개인정보는 안전한가요? A. 네! 서비스 개선을 위한 목적의 익명 데이터 수집 외에는 어떠한 정보도 서버로 전송하지 않습니다. Q. 왜 무료인가요? A. 개인적인 편의를 위해 만든 서비스입니다. 광고 수익으로 운영되며, 지속 가능하다면 무료로 제공할 예정입니다.
자세한 내용 보기

메디큐브 딥샷 내돈내산 후기: 부스터프로 유저가 1세대 기기를 선택한 이유

이미지
 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다. 요즘 홈케어 뷰티 디바이스 하나쯤은 다들 가지고 계시죠? 저도 유행에 따라 메디큐브 부스터프로 를 아주 잘 사용하고 있었는데요, 쓰다 보니 다른 기능의 기기도 하나 더 들이고 싶다는 욕심이 생기더라고요. 신제품인 하이포커스샷, 울트라튠 등 쟁쟁한 후보들이 많았지만, 저는 고민 끝에 출시된 지는 조금 지났지만 여전히 평이 좋은 '유쎄라딥샷'을 선택했습니다. 오늘은 부스터프로 유저가 직접 구매하고 일주일간 사용해 본 메디큐브 유쎄라딥샷 솔직 후기 를 들려드릴게요!
자세한 내용 보기