C By GE Tuneable White Direct Connect Smart Lâmpada com Wi-Fi e Bluetooth

Resumo:

Este artigo é sobre a lâmpada Smart Smart da GE Tunable White Connect com Wi-Fi e Bluetooth. Ele fornece informações sobre a engenharia reversa do aplicativo “C by GE” para controlar as lâmpadas inteligentes, criar uma API da Web e um site front-end para controlar as lâmpadas e desenvolver uma API GO de alto nível para acessar e alterar as propriedades das Lightbulbs.

O artigo também inclui um aviso de isenção de que o código é o resultado da engenharia reversa e pode não funcionar para cada rede ou dispositivo inteligente.

Pontos chave:

1. Engenharia reversa O aplicativo “C by GE”: O autor descompilou o aplicativo Android para entender seu protocolo binário para se comunicar com o servidor.

2. API da Web e site de front-end: O autor desenvolveu uma API da Web e um site de front-end para controlar o C pela GE Lightbulbs. O site inclui recursos como enumerar lâmpadas, obter seu status e alterar propriedades como brilho e tom de cor.

3. Vá API para Lightbulbs: O autor criou uma API GO de alto nível para acessar e controlar o C pela GE Lightbulbs. A API permite que os usuários consultem o status da lâmpada e modifiquem propriedades como brilho e tom de cor.

4. Autenticação de dois fatores: Contas mais recentes exigem autenticação de dois fatores. O artigo explica o processo de realização de um aperto de mão 2FA para criar uma sessão para controlar as Lightbulbs.

5. Dispositivos de enumeração: Depois que uma sessão é criada, os usuários podem enumerar as lâmpadas conectadas e recuperar seus nomes.

6. Bulbos de controle: O artigo fornece exemplos de código para ligar/desligar as lâmpadas, ajustar o brilho e definir o tom de cor.

7. Configurações de lâmpada de consulta: Os usuários também podem recuperar as configurações atuais de uma lâmpada, como seu status, brilho e tom de cor.

Questões:

1. O que o autor reversa o engenheiro no aplicativo “C by GE”?

O autor reversa projetou o protocolo binário usado pelo aplicativo para se comunicar com o servidor.

2. O que o autor se desenvolveu para controlar as lâmpadas?

O autor desenvolveu uma API da Web e site de front-end, bem como uma API GO de alto nível, para controlar o C por GE Lightbulbs.

3. A autenticação de dois fatores é necessária para todas as contas?

Não, a autenticação de dois fatores é necessária apenas para contas mais recentes. Contas mais antigas podem ser capazes de fazer login diretamente.

4. Como um usuário pode executar um aperto de mão 2fa?

O artigo fornece exemplos de código para executar um aperto de mão 2FA usando a função “Login2fa”.

5. Como um usuário pode enumerar as lâmpadas conectadas?

Depois que uma sessão é criada, os usuários podem usar a função “dispositivos” para enumerar as lâmpadas conectadas.

6. O brilho e o tom de cor das lâmpadas podem ser ajustados?

Sim, os usuários podem usar as funções “SetDevicelum” e “SetDevicect” para ajustar o brilho e o tom de cor das lâmpadas.

7. Quais informações podem ser recuperadas sobre as configurações atuais de uma lâmpada?

Os usuários podem recuperar informações sobre o status, o brilho e o tom de cor de uma lâmpada usando a função “devticestatus”.

8. Há uma garantia de que o código funcionará para cada rede ou dispositivo inteligente?

Não, não há garantia, pois o código é o resultado da engenharia reversa e pode não funcionar para cada rede ou dispositivo.

9. Qual é o objetivo da API da Web e do site do front-end?

A API da Web e o site do front-end fornecem uma interface amigável para controlar o C pela GE Lightbulbs.

10. O código pode ser usado para controlar outros dispositivos inteligentes?

O código foi projetado especificamente para controlar C por GE Lightbulbs e pode não ser compatível com outros dispositivos inteligentes.

11. O que é necessário para fazer login nos espaços de código?

Os usuários precisam fazer login nos espaços de código para usar seus recursos.

12. Como o aplicativo de desktop do github pode ser lançado?

O aplicativo Github Desktop pode ser lançado baixando -o e executando -o no seu computador.

13. Quais são as alternativas à área de trabalho do GitHub?

Os usuários também podem usar o Git ou o SVN com os URLs da Web fornecidos.

14. Como o editor de código do Visual Studio pode ser lançado?

O editor de código do Visual Studio será aberto automaticamente quando estiver pronto.

15. O que os usuários devem fazer se houver um problema para preparar o espaço de codificina?

Se houver um problema em preparar o espaço de código, os usuários devem tentar novamente ou procurar assistência.

C By GE Tuneable White Direct Connect Smart Lâmpada com Wi-Fi e Bluetooth

Se nada acontecer, faça o download do GitHub Desktop e tente novamente.

unixpickle/cbyge

Este compromisso não pertence a nenhum ramo neste repositório e pode pertencer a um garfo fora do repositório.

Switch Branches/Tags

Tags de ramificações

Não foi possível carregar ramificações

Nada para mostrar

Não foi possível carregar tags

Nada para mostrar

Nome já em uso

Uma tag já existe com o nome da filial fornecida. Muitos comandos Git aceitam nomes de tag e ramificação; portanto, criar este ramo pode causar comportamento inesperado. Tem certeza que deseja criar este ramo?

Cancelar Criar

Local
Codespaces

Https github cli

Use Git ou Checkout com SVN usando o URL da Web.

Trabalhe rápido com nossa cli oficial. Saiba mais sobre a CLI.

Autenticação necessária

Faça login para usar os espaços de codificina.

Lançando o GitHub Desktop

Se nada acontecer, faça o download do GitHub Desktop e tente novamente.

Lançando o GitHub Desktop

Se nada acontecer, faça o download do GitHub Desktop e tente novamente.

Lançando Xcode

Se nada acontecer, faça o download do Xcode e tente novamente.

Lançando o código do Visual Studio

Seu espaço de código será aberto uma vez pronto.

Houve um problema para preparar seu espaço de código, por favor tente novamente.

Última confirmação

459BE53 9 de novembro de 2021

Estatísticas Git

arquivos

Falha ao carregar informações mais recentes de compromisso.

Última mensagem de confirmação

Comprometer o tempo

Leia-me.MD

Para este projeto, eu engenhei o aplicativo “C by GE” para controlar as lâmpadas inteligentes conectadas à GE Wifi. Para fazer isso, comecei descompilando o aplicativo Android e depois projetou o protocolo binário que o aplicativo usa para conversar com um servidor. Para mais detalhes, consulte a engenharia reversa C por GE.

Os produtos finais deste projeto são:

Uma API da Web e um site de front-end para controlar Lightbulbs.
Uma API GO de alto nível para enumerar lâmpadas, obtendo seu status e alterando suas propriedades (e.g. brilho e tom de cor).

Isenção de responsabilidade: Este código é o resultado da engenharia reversa e não foi informada por uma especificação de protocolo. Como resultado, não há garantia de que ele continuará funcionando ou que funcionará para cada rede ou dispositivo inteligente. Enquanto outros usaram com sucesso essa API em alguns casos, é possível que o código faça suposições incorretas que não se sustentam em todos os casos de uso.

O diretório do servidor é um endpoint independente da Web-App e JSON API para C por GE Lightbulbs. O site se parece com o seguinte:

Se você executar o site com um argumento de eva e -password, o site trará uma página de autenticação de dois fatores na primeira vez que você o carrega. Você apertará um botão e inserirá o código de verificação enviado ao seu e -mail. Como alternativa, você pode fazer login com antecedência, executando o comando login_2fa com os sinalizadores -email e -password definidos para as informações da sua conta. O comando solicitará o código de verificação 2FA. Depois de inserir este código, o comando cuspirá as informações da sessão como uma bolha json. Você pode passar este JSON para o argumento -SessInfo do servidor, e.g. como -Sessinfo ‘JSON aqui’ . Observe que parte da sessão expira após uma semana, mas uma instância do servidor em execução continuará funcionando após esse período, pois a parte expirável da sessão é usada apenas uma vez para enumerar os dispositivos.

Contas mais recentes exigem o uso de autenticação de dois fatores. Você pode executar um aperto de mão 2fa para criar uma sessão como assim:

ligar de volta, errar : = cbyge.Login2fa("meu email", "minha senha", "") // manipula o erro. SessionInfo, errar : = ligar de volta("Código 2FA do email") // manipula o erro. sessão, errar : = cbyge.NewController(SessionInfo, 0) // manipula o erro.

Para contas mais antigas que nunca usaram o 2FA antes, você poderá fazer login diretamente:

sessão, errar : = cbyge.NewcontrollerLogin("meu email", "minha senha") // manipula o erro.

Depois de ter uma sessão, você pode enumerar dispositivos como assim:

Devs, errar : = sessão.Dispositivos() // manipula o erro. para _, x : = faixa Devs < fmt.Println(x.Nome())>

Você pode controlar lâmpadas assim:

x : = Devs[[0] sessão.SetDevicestatus(x, verdadeiro) // ligar sessão.SetDevicelum(x, 50) // Defina o brilho sessão.SETDEVICECT(x, 100) // Definir tom de cor (100 = azul, 0 = laranja)

Você também pode consultar as configurações atuais de uma lâmpada:

status, errar : = sessão.Status do dispositivo(x) // manipula o erro. fmt.Println(status.ISON) fmt.Println(status.Tom de cor)

Engenharia reversa C por GE

Nesta seção, vou levá-lo através de como as partes de engenharia reversa do protocolo C by GE.

O primeiro passo foi desmontar o aplicativo Android com apktool. Isso produz desmontagem de Smali para o aplicativo. Cutucando, eu procurei por URLs e nomes de domínio. Inicialmente, achei isso:

.campo Final estática pública Api_version:eujava/lang/string; = "v2/" .campo Final estática pública Base_url:eujava/lang/string; = "https: // api-ge.xlink.CN: 443/"

Vendo onde esse endpoint da API foi usado rapidamente me levou a um conjunto de chamadas HTTP baseadas em JSON para fazer login, listar dispositivos, etc. No entanto, esse endpoint não parecia fornecer uma maneira de 1) obter o status dos dispositivos ou 2) atualizar a cor ou o brilho dos dispositivos.

Tinha que haver outra maneira de se comunicar com as lâmpadas inteligentes. No entanto, a desmontagem estava cheia de código para a comunicação Bluetooth e LAN, e fiquei um pouco preocupado lá era Nenhum terminal global da API para controlar as lâmpadas. O que foi pior, o aplicativo C por GE reclamava sempre que eu desliguei o Bluetooth e depois tentou usá -lo. No entanto, acabei descobrindo que poderia abrir o aplicativo, deixar ele fazer o que é e depois desligar o Bluetooth e Wi -Fi enquanto ainda tem controle sobre as lâmpadas. Tudo o que eu precisava fazer era acertar o botão “Voltar” do Android sempre que o aplicativo abria um pop -up me pedindo para “ligar o rastreamento do local” (um nome estranho para Bluetooth e Wi -Fi, lembre -se).

Neste ponto, eu tinha certeza de que o aplicativo não estava fazendo outras conexões HTTP (s) misteriosas (s). Curiosamente, porém, eu encontrei o domínio “xlink.CN “em outros lugares do código Smali:

.campo Final estática pública Cm_server_address:eujava/lang/string; = "CM-GE.xlink.cn" .campo Final estática pública Cm_server_port:EU = 0x5ce2

Vaca sagrada, poderia ser um protocolo de soquete bruto? Eu tentei e com certeza eu poderia abrir uma conexão TCP com CM-GE.xlink.CN: 23778 . No entanto, o Smali também estava cheio de lógica para UDP pacotes, então eu não tinha certeza de qual protocolo o aplicativo estaria usando. Com isso em mente, criei o Proxy de pacotes e o defini ouvindo na porta 23778. Então eu substituí o domínio CM-GE.xlink.CN com meu endereço IP no código Smali, recompilado o aplicativo em um apk e instalei -o no meu telefone.

Certamente, meu aplicativo C Patched C By GE imediatamente conectado à minha instância de proxy de pacotes e começou a conversar. Notavelmente, só fez isso quando Bluetooth e Wi -Fi foram desligados. Caso contrário, parecia preferir um deles para se comunicar localmente com as lâmpadas inteligentes.

O protocolo que o aplicativo escolheu usar foi de longe o resultado mais fácil de lidar com: 1) era TCP em vez de UDP, 2) foi completamente desconhecido. A falta de criptografia é bastante alarmante em retrospectiva, já que a primeira mensagem inclui um token de autorização que nunca parece mudar para minha conta.

Descobri que as mensagens do aplicativo para o servidor podem ser “reproduzidas” efetivamente. Depois que descobri quais bytes (ou “pacotes”, graças ao proxi de pacotes) foram para ligar e desligar as luzes, eu poderia simplesmente abrir um novo soquete e enviar esses mesmos pacotes e obter os mesmos resultados. Este foi um ótimo sinal. Pior cenário, eu já tinha uma maneira de implementar o que queria para mim, mesmo que não fosse muito geral.

Nesse ponto, era hora de se aprofundar no protocolo. Após uma combinação de experimentação com proxi de pacotes e cavando a desmontagem de Smali, tive um entendimento bastante geral do que a comunicação estava ocorrendo. A primeira coisa que notei foi que a comunicação ocorreu em “Mensagens”, que começou com um tipo e um campo de comprimento (em Big Endian). A próxima coisa foi descobrir quais tipos de pacotes onde, e eventualmente, como os próprios pacotes específicos foram codificados. Aqui está um exemplo de um pacote do servidor que contém os status dos meus três dispositivos:

73 00 00 00 60 47 E2 BE AB 00 37 00 7E 00 01 00 00 F9 52 4E 00 03 00 00 00 03 00 03 00 81 01 00 00 00 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 5 00 00 00 27 00 00 00 00 00 00 00 01 00 00 01 00 00 00 01 00 00 00 00 35 00 00 00 27 00 00 00 00 00 00 00 C8 7E

Depois que eu tive o suficiente do protocolo, criei uma API para isso. Esta API pode listar dispositivos, obter seus status e atualizar várias propriedades dos dispositivos (e.g. brilho e tom de cor). Surpreendentemente, achei minha API muito mais rápida e confiável do que o próprio aplicativo. Parece que tentar usar Bluetooth ou Wi -Fi antes de voltar a um servidor remoto faz com que o aplicativo seja muito mais esquisito e menos confiável do que poderia ser.

Como nota final, eu não possuo todos os dispositivos suportados por este aplicativo, por isso não estava motivado (ou facilmente capaz) a reverter a engenheiro como esses dispositivos funcionariam. Por exemplo, a mesma empresa produz pontos de venda, sensores e interruptores de luz.