whatsapp web reveng
1.0.0
Этот проект намеревается предоставить полное описание и повторное внедрение веб-API WhatsApp, что в конечном итоге приведет к пользовательскому клиенту. WhatsApp Web внутренне работает с использованием веб -питания; Этот проект делает также.
Нет необходимости устанавливать или управлять версиями Python и Node, File shell.nix определяет среду со всеми зависимостями, включенными для запуска этого проекта.
В папке nix корневой cd direnv файл .envrc
> cd ~ /dev/whatsapp
Installing node modules
npm WARN prepare removing existing node_modules/ before installation
> [email protected] install /home/rainy/dev/whatsapp/node_modules/fsevents
> node-gyp rebuild
make: Entering directory ' /home/rainy/dev/whatsapp/node_modules/fsevents/build '
SOLINK_MODULE(target) Release/obj.target/.node
COPY Release/.node
make: Leaving directory ' /home/rainy/dev/whatsapp/node_modules/fsevents/build '
> [email protected] postinstall /home/rainy/dev/whatsapp/node_modules/nodemon
> node bin/postinstall || exit 0
added 310 packages in 3.763s
Done.
$$ $$ $$ $$
$$ | $ $$ | $$ | $$ |
$$ | $$ $ $$ | $$$$$$ $ $$$$$$ $$$$$$ $$$$$$ $ $$$$$$ $$$$$$ $$$$$$
$$ $$ $$ $ $ | $$ __ $$ _ ___ $$ \ _ $$ _ | $$ _____ | _ ___ $$ $$ __ $$ $$ __ $$
$$$$ _ $$$$ | $$ | $$ | $$$$$$ $ | $$ | $ $$$$ $ $$$$$$ $ | $$ / $$ | $$ / $$ |
$$ $ / $ $$ | $$ | $$ | $$ __ $$ | $$ | $$ _ ___ $$ $$ __ $$ | $$ | $$ | $$ | $$ |
$$ / $ $ | $$ | $$ | $ $$$$$$ | $ $$ $ | $$$$$$ $ | $ $$$$$$ | $$$$$$ $ | $$$$$$ $ |
_ _/ _ _ | _ _ | _ _ | _ ______ | _ ___/ _ ______/ _ ______ | $$ ____/ $$ ____/
$$ | $$ |
$$ | $$ |
_ _ | _ _ |
Node v13.13.0
Python 2.7.17
Try running server with: npm start
[nix-shell: ~ /dev/whatsapp]$ Если вы не используете direnv или просто хотите вручную попасть в среду сборки:
nix-shellв корне проекта
Прежде чем вы сможете запустить приложение, убедитесь, что у вас установлено следующее программное обеспечение:
async await )pip -пакетами:websocket-client и git+https://github.com/dpallot/simple-websocket-server.git для выступления в качестве сервера и клиента WebSocket.curve25519-donna и pycrypto для шифрования.pyqrcode для QR -кода.protobuf для чтения и написания формата бинарного разговора.curve25519-donna требуется Microsoft Visual C ++ 9.0, и вам необходимо скопировать stdint.h в C:UsersYOUR USERNAMEAppDataLocalProgramsCommonMicrosoftVisual C++ for Python9.0VCinclude . Перед началом приложения в первый раз запустите npm install -f , чтобы установить все узлы и pip install -r requirements.txt для всех зависимостей Python.
Наконец, чтобы, наконец, запустить его, просто запустите npm start OS на базе Linux и npm run win в Windows. Используя фантазию concurrently и магию nodemon , все три локальных компонента будут запущены друг за другом, и при редактировании файла измененный модуль автоматически перезагрузится, чтобы применить изменения.
Недавнее дополнение-это версия подпрограммы дешифрования, переведенная в JavaScript в браузере. Запустите node index_jsdemo.js (просто необходимо, потому что браузеры не позволяют изменять заголовки HTTP для веб-питания), а затем откройте client/login-via-js-demo.html в качестве обычного файла в любом браузере. Вывод консоли должен показывать расшифрованные двоичные сообщения после сканирования QR -кода.
Adiwajshing создал Baileys, библиотеку узлов, которая реализует веб -API WhatsApp.
Ndunks сделали повторную массу типографии в Wajs.
P4KL0NC4T создал Kyros, пакет Python, который реализует веб -API WhatsApp.
С WhatsAppweb-RS Wiomoc создал веб-клиент WhatsApp в Rust.
Rhymen создал Go-Whatsapp, пакет GO, который реализует веб-API WhatsApp.
Vzaramel создал WhatsAppweb-Clj, библиотеку Clojure, реализует веб-API WhatsApp.
Проект организован следующим образом. Обратите внимание на использованные порты и убедитесь, что они не используются в другом месте перед началом приложения.
WhatsApp Web шифрует данные, используя несколько разных алгоритмов. К ним относятся AES 256 CBC, Curve25519 в качестве схемы ключевых соглашений Diffie-Hellman, HKDF для создания расширенного общего секрета и HMAC с SHA256.
Запуск веб-сеанса WhatsApp происходит только с подключением к одному из своих серверов WebSocket на wss://w[1-8].web.whatsapp.com/ws ( wss:// означает, что соединение WebSocket безопасно; w[1-8] означает, что любое число между 1 и 8 может следовать w ). Также убедитесь, что при установлении соединения установлено значение HTTP Header Origin: https://web.whatsapp.com , в противном случае подключение будет отклонено.
Когда вы отправляете сообщения в WhatsApp WebSocket, они должны быть в определенном формате. Это довольно просто и выглядит как messageTag,JSON , EG 1515590796,["data",123] . Обратите внимание, что, по -видимому, тег сообщения может быть чем угодно. Это приложение в основном использует текущую метку времени, чтобы быть немного уникальным. Сам WhatsApp часто использует теги сообщения, такие как s1 , 1234.--0 или что-то в этом роде. Очевидно, что тег сообщения может не содержать запятую. Кроме того, возможны объекты JSON, а также полезную нагрузку.
Чтобы войти в систему на открытом WebSocket, выполните следующие действия:
clientId , который должен составлять 16 базовых байтов Base64 (то есть 25 символов). В этом приложении используются 16 случайных байтов, т.е. base64.b64encode(os.urandom(16)) в Python.messageTag,["admin","init",[0,3,2390],["Long browser description","ShortBrowserDesc"],"clientId",true] .messageTag и clientId на выбранные вами значения[0,3,2390] указывает текущую веб -версию WhatsApp. Последнее значение часто меняется. Это должно быть довольно обратно совместимо, хотя."Long browser description" - это произвольная строка, которая будет отображаться в приложении WhatsApp в списке зарегистрированных веб -клиентов WhatsApp после сканирования QR -кода."ShortBrowserDesc" еще нигде не наблюдался, но также является произвольным.status : должен быть 200ref : В приложении это рассматривается как идентификатор сервера; важно для поколения QR, см. Нижеttl : IS 20000, может быть, время после QR -кода становится недействительнымupdate : логический флагcurr : текущая веб -версия WhatsApp, например, 0.2.7314time : The TimeStamp, на которую ответил сервер, как Milliseconds с плавающей точкой, например, 1515592039037.0curve25519.Private() .privateKey.get_public() .ref с шага 4base64.b64encode(publicKey.serialize())pyqrcode ) и сканируйте ее с помощью приложения WhatsApp.ttl ).messageTag,["admin","Conn","reref"] .status : должно быть 200 (другие: 304 - повторно используйте предыдущий реф, 429 - Новый реф отрицал)ref : новый рефttl : время истечения срока действияConn : массив содержит объект JSON как второй элемент с информацией об соединении, содержащей следующие атрибуты и многое другое:battery : текущий процент батареи вашего телефонаbrowserToken : используется для выхода без активного соединения WebSocket (еще не реализовано)clientToken : используется для возобновления закрытых сессий, известно, «Помни меня» (еще не реализовано)phone : объект с подробной информацией о вашем телефоне, например, device_manufacturer , device_model , os_build_number , os_versionplatform : ваша телефонная ОС, например, androidpushname : ваше имя, которое вы предоставили WhatsAppsecret (помните это!)serverToken : используется для возобновления закрытых сессий, также известно, «Помни меня» (еще не реализовано)wid : ваш номер телефона в формате идентификации чата (см. Ниже)Stream : массив имеет в общей сложности четыре элемента, поэтому вся полезная нагрузка похожа на ["Stream","update",false,"0.2.7314"]Props : массив содержит объект JSON в качестве второго элемента с несколькими свойствами, такими как imageMaxKBytes (1024), maxParticipants (257), videoMaxEdge (960) и другиеsecret от Conn в качестве Base64 и хранить его в secret . Этот декодированный секрет будет длиной 144 байта.sharedSecret . Приложение делает это с использованием privateKey.get_shared_key(curve25519.Public(secret[:32]), lambda a:a) .sharedSecret до 80 байтов с помощью HKDF. Назовите это значение sharedSecretExpanded .HmacSha256(sharedSecretExpanded[32:64], secret[:32] + secret[64:]) . Сравните это значение с secret[32:64] . Если они не равны, прервать вход.sharedSecretExpanded[64:] + secret[64:] как keysEncrypted .sharedSecretExpanded[:32] в качестве ключа, то есть хранить AESDecrypt(sharedSecretExpanded[:32], keysEncrypted) в качестве keysDecrypted .keysDecrypted имеет длину 64 байта и содержит два ключа, каждая 32 байта длиной. encKey используется для расшифровки двоичных сообщений, отправляемых вам веб -сервером WhatsApp или шифрования двоичных сообщений, которые вы отправляете на сервер. macKey необходим для проверки отправленных вам сообщений:encKey : keysDecrypted[:32]macKey : keysDecrypted[32:64]init , проверьте, есть ли у вас serverToken и clientToken .messageTag,["admin","login","clientToken","serverToken","clientId","takeover"]{"status": 200} . Другие статусы:tos в JSON: если он равна или больше, чем 2, вы нарушили TOSserverToken и clientToken вам будет предложено подтвердить, что у вас все еще есть достоверные ключи шифрования.messageTag,["Cmd",{"type":"challenge","challenge":"BASE_64_ENCODED_STRING=="}]challenge от BASE64, подпишите его с MacKey, кодируйте его обратно с BASE64 и отправьте messageTag,["admin","challenge","BASE_64_ENCODED_STRING==","serverToken","clientId"]{"status": 200} , но это ничего не значит.goodbye,,["admin","Conn","disconnect"] .encKey с macKey и кодируйте его с Base64. Допустим, это ваш logoutToken .https://dyn.web.whatsapp.com/logout?t=browserToken&m=logoutTokenТеперь, когда у вас есть два ключа, проверка и расшифровки сообщений, отправленных вам сервера, довольно просто. Обратите внимание, что это необходимо только для двоичных сообщений, все, что вы получаете, остается простым. Двоичные сообщения всегда имеют 32 байта в начале, которые указывают контрольную сумму HMAC. Как JSON , так и бинарные сообщения имеют тег сообщений в самом начале, который можно отбросить, то есть только часть после того, как первый персонаж запятой является значительной.
macKey (здесь messageContent - это все двоичное сообщение): HmacSha256(macKey, messageContent[32:]) . Если это значение не равное messageContent[:32] , сообщение, отправленное вам сервером, является недействительным и должно быть отброшено.encKey : AESDecrypt(encKey, messageContent[32:]) .Данные, которые вы получаете на последнем этапе, имеют двоичный формат, который описан в следующем. Несмотря на то, что это двоичный, вы все равно можете увидеть в нем несколько строк, особенно содержание отправленных сообщений, которые вы там очевидно.
backend/decoder.py реализует класс MessageParser . Он может создать структуру JSON из двоичных данных, в которых данные все еще организованы довольно грязным способом. В разделе о обработке узлов ниже рассказывается о том, как узлы реорганизованы впоследствии.
Первоначально MessageParser просто нуждаются в некоторых данных, а затем обрабатывает их по байту, т.е. как поток. У него есть пара констант и множество методов, которые все нарастают друг на друга.
[None,None,None,"200","400","404","500","501","502","action","add", "after","archive","author","available","battery","before","body", "broadcast","chat","clear","code","composing","contacts","count", "create","debug","delete","demote","duplicate","encoding","error", "false","filehash","from","g.us","group","groups_v2","height","id", "image","in","index","invis","item","jid","kind","last","leave", "live","log","media","message","mimetype","missing","modify","name", "notification","notify","out","owner","participant","paused", "picture","played","presence","preview","promote","query","raw", "read","receipt","received","recipient","recording","relay", "remove","response","resume","retry","s.whatsapp.net","seconds", "set","size","status","subject","subscribe","t","text","to","true", "type","unarchive","unavailable","url","user","value","web","width", "mute","read_only","admin","creator","short","update","powersave", "checksum","epoch","block","previous","409","replaced","reason", "spam","modify_tag","message_info","delivery","emoji","title", "description","canonical-url","matched-text","star","unstar", "media_key","filename","identity","unread","page","page_count", "search","media_message","security","call_log","profile","ciphertext", "invite","gif","vcard","frequent","privacy","blacklist","whitelist", "verify","location","document","elapsed","revoke_invite","expiration", "unsubscribe","disable"]- для 10 , . за 11 и для 15.n и делает следующий n&127 много раз: читает байт l и для каждого шлюза добавляет результат своей распакованной версии в возвращаемое значение (с использованием распаковки байтов с данным тегом). Сначала наиболее значительный шлюз.n , удаляет последний символ возвращаемого значения. LIST_EMPTY , LIST_8 или LIST_16 (т.е. 0, 248 или 249).LIST_EMPTY , возвращает байт чтения для LIST_8 или read int16 для LIST_16 .a и b и получит токен в индексе a*256+b . Чтение строки нуждается в теге в качестве параметра. В зависимости от этой теги, разные данные читаются.
"s.whatsapp.net" , "c.us" возвращается вместо этого, в противном случае токен возвращается как есть.tag-DICTIONARY_0 как первым, а Byte Read-в качестве второго параметра.None ).i с этим тегом.j с этим тегом.i и j объединены вместе с знаком @ , и результат возвращается.Чтение списка атрибутов требует количества атрибутов для чтения как параметр. Список атрибутов всегда является объектом JSON. Для каждого чтения атрибута выполняются следующие шаги для получения пар клавиш (именно в этом порядке!):
Узел всегда состоит из массива JSON с ровно трех записей: описание, атрибуты и содержание. Для чтения узла необходимы следующие шаги:
a читается с помощью байта для чтения в качестве тега. Размер списка 0 недействителен.descr получается путем чтения строки с помощью этого тега.attrs читают путем чтения объекта атрибутов с длиной (a-2 + a%2) >> 1 .a был нечетным, этот узел не имеет никакого контента, то есть [descr, attrs, None] возвращается.[descr, attrs, content] возвращается. Чтение списка требует тега списка (т.е. list_empty , list_8 или list_16 ). Длина списка затем получается путем чтения размера списка с использованием этого тега. Для каждой записи списка читается узел .
После того, как бинарное сообщение было преобразовано в JSON, его все еще довольно сложно прочитать. Вот почему внутренне WhatsApp Web полностью ретрансформирует эту структуру во что -то, что можно легко обработать и в конечном итоге перевести в содержимое пользовательского интерфейса. Этот раздел будет иметь дело с этим и ожидает завершения.
Когда узел был прочитал, содержимое сообщений, которые фактически были отправлены пользователем (т.е. текст, изображение, аудио, видео и т. Д.) До сих пор не видно или доступно через JSON. Вместо этого они хранятся в сообщении Protobuf. Смотрите здесь для определений. Тип сообщения «обертка» - WebMessageInfo .
У WhatsApp Web также есть интересный API. Вы даже можете попробовать это непосредственно в своем браузере. Просто войдите в обычную https://web.whatasapp.com/, затем откройте консоль разработки браузера. Теперь введите что -то вроде следующего (см. Ниже для получения подробной информации об идентификации чата):
window.Store.Wap.profilePicFind("[email protected]").then(res => console.log(res));window.Store.Wap.lastseenFind("[email protected]").then(res => console.log(res));window.Store.Wap.statusFind("[email protected]").then(res => console.log(res)); Используя удивительную консоли разработчиков Chrome, вы можете увидеть это window.Store.Wap содержит много других очень интересных функций. Многие из них возвращают JavaScript обещания. Когда вы нажимаете на вкладку «Сеть» , а затем на WS (возможно, сначала вам нужно перезагрузить сайт), вы можете посмотреть на все связи между WhatsApp Web и его серверами.
WhatsApp Web API использует следующие форматы для идентификации чатов с отдельными пользователями и группами нескольких пользователей.
[country code][number]@c.us , например, [email protected] , когда вы из Германии, а ваш номер телефона 0123 456789 .[phone number of group creator]-[timestamp of group creation]@g.us , например, [email protected] для группы, которая [email protected] создал 5 ноября 2017 года.[timestamp of broadcast channel creation]@broadcast , например, 1509911919@broadcast для трансляционного канала, созданного 5 ноября 2017 года.Существует два типа сообщений WebSocket, которые обмениваются между сервером и клиентом. С одной стороны, простой JSON, который довольно однозначный (особенно для вызовов API выше), с другой стороны зашифровали бинарные сообщения.
К сожалению, эти двоичные нельзя рассмотреть использование инструментов разработчика Chrome. Кроме того, бэкэнд Python, который, конечно, также получает эти сообщения, необходимо расшифровать их, поскольку они содержат зашифрованные данные. В разделе о деталях шифрования обсуждается, как его можно расшифровать.
mediaKey , который должен быть 32 байта.mediaKeyExpanded .mediaKeyExpanded на:iv : mediaKeyExpanded[:16]cipherKey : mediaKeyExpanded[16:48]macKey : mediaKeyExpanded[48:80]refKey : mediaKeyExpanded[80:] (не используется)cipherKey и iv , нанесите его и назовите его enc .iv + enc с macKey с использованием HMAC SHA-256 и храните первые 10 байтов хэша в качестве mac .fileSha256 , хэш enc + mac с SHA-256 и сохраните его в качестве fileEncSha256 .fileEncSha256 с Base64 и сохраните его в качестве fileEncSha256B64 .sidecar . Сделайте это, подписав каждый [n*64K, (n+1)*64K+16] Chunk с macKey , урезав результат до первых 10 байтов. Затем объедините все в целом.messageTag,["action", "encr_upload", filetype, fileEncSha256B64]filetype может быть одним из image , audio , document или videohash : fileEncSha256B64file , Filename: blob : enc+mac?f=j и правильный content-type и формататарная форма, WhatsApp ответит с помощью URL-адреса загрузки для файла.mediaKey и расшифруйте его от Base64, если это необходимо.mediaKeyExpanded .mediaKeyExpanded на:iv : mediaKeyExpanded[:16]cipherKey : mediaKeyExpanded[16:48]macKey : mediaKeyExpanded[48:80]refKey : mediaKeyExpanded[80:] (не используется)url и разделите их на:file : mediaData[:-10]mac : mediaData[-10:]iv + file с macKey с использованием SHA-256. Имейте в виду, что mac усечен до 10 байтов, поэтому вам следует сравнить только первые 10 байтов.file с AES-CBC с использованием cipherKey и iv , и Uncad It. Обратите внимание, что это означает, что ключи вашего сеанса (т.е. encKey и macKey из раздела Generation ) не требуются для расшифровки медиа -файла. В зависимости от типа носителя, буквальные строки в правом столбце являются значениями для параметра appInfo из функции HKDF .
| СМИ тип | Информация о приложении |
|---|---|
| ИЗОБРАЖЕНИЕ | WhatsApp Image Keys |
| ВИДЕО | WhatsApp Video Keys |
| Аудио | WhatsApp Audio Keys |
| ДОКУМЕНТ | WhatsApp Document Keys |
Процедуры пересылки сообщений довольно сложны, так как в процессе участвуют несколько слоев веб -комок. Для добавления собственных команд выполните следующие действия.
Во -первых, определитесь, каким будет конечный пункт назначения вашей команды. Чтобы соответствовать другому, пожалуйста, предварительно профиксируйте его с помощью backend_ , если он должен быть получен бэкэнд Python или используйте api_ если команда направлена на API Nodejs.
Теперь посмотрите на client/js/main.js . В строке 214 вы можете увидеть экземпляр класса JavaScript BootstrapStep . Ему нужна следующая информация:
websocket : вероятно, всегда одинаковоrequest.type : обычно должен быть call , так как это позволяет передавать ответ обратно к отправителю командыrequest.callArgs : объект, который должен содержать атрибут command , указывающий имя вашей команды и столько дополнительных пар клавиш, сколько вы хотите. Все это будет передано приемнику.request.successCondition : При получении ответа для вызова это должна быть функция, возвращающая true когда ответ является действительным/ожидаемым. Используйте следующий атрибут для указания кода, который будет выполнен, когда ответ действителен.request.successActor : Когда условие успеха оценивается на true , эта функция Actor Actor вызывается Когда был построен объект BootstrapStep , вызовите .run() для работы на неопределенный срок или .run(timeout_ms) для сбоя, когда ответ не был получен после определенного тайм -аута. Функция run возвращает обещание.
Далее, редактируйте index.js . Он содержит пару блоков, начиная с clientWebsocket.waitForMessage . Вы можете скопировать один из этих блоков и отредактировать параметры. Функции waitForMessage требуют следующие атрибуты:
condition : Когда сообщение получено, и это условие оценивается на true на нем, сообщение будет обработано следующим .then(...) БлокkeepWhenHit , когда, когда обработчик сообщений может быть отстранен сразу после получения первого подходящего сообщения. Контролировать это здесь. Возвращенное обещание, then блок, наконец, обрабатывает полученное сообщение. Он получает clientCallRequest вы можете позвонить .respond({...}) чтобы отправить ответ JSON на вызывающего абонента. Если API Nodejs не является конечным пунктом назначения сообщения, вам необходимо создать здесь новый BootstrapStep , который свяжется с бэкэндом Python и после получения ответа вернет его первоначальному абоненту. Таким образом, когда вы хотите сообщение для бэкэнда, теперь редактируйте backend/whatsapp-web-backend.py . В IF-ELSE-Compound, начиная с строки 88, добавьте свою собственную ветвь для выбранного вами названия команды. Затем отредактируйте backend/whatsapp.py и добавьте функцию, похожую на generateQRCode в строке 223. Просто использовать что -то вроде в getLoginInfo может быть недостаточно, так как вашей команде может потребоваться асинхронный запрос на веб -серверы WhatsApp. В этом случае обязательно добавьте запись в self.messageQueue выбранного вами тега сообщения, и отправьте соответствующее сообщение self.activeWs . Серверы будут отвечать на ваш запрос ответом, содержащим один и тот же тег, поэтому он разрешен в строке 134. Убедитесь, что в конечном итоге вызовут pend["callback"]["func"]({...}) с объектом JSON, содержащим данные вашего ответа для разрешения обратного вызова.
Обратите внимание, что эта версия недостаточно стабильна, чтобы быть развернутым в производстве.
docker build . -t whatsapp-web-reveng
docker run -p 2019:2019 -p 2018:2018 whatsapp-web-reveng
Фронт (клиент) по адресу: http: // localhost: 2018/
Адреса используемых веб -билетов по умолчанию «локальный хост». Если вы хотите развернуть этот Docker на своем собственном сервере и поделиться им, измените адрес Backend WebSocket на передней части. client/js/main.js
let backendInfo = {
url : "ws://{{your-server-addr}}:2020" ,
timeout : 10000
} ;Front End (Client) AT :: http: // {{your-server-addr}}: 2018/
gh-pages . Этот код никоим образом не связан с, уполномоченным, поддерживаемым, спонсируемым или одобренным WhatsApp или какими -либо из его филиалов или дочерних компаний. Это независимое и неофициальное программное обеспечение. Используйте свой собственный риск.
Это распределение включает в себя криптографическое программное обеспечение. Страна, в которой вы в настоящее время проживаете, может иметь ограничения на импорт, владение, использование и/или реэкспорт в другую страну, программного обеспечения для шифрования. Перед использованием какого-либо программного обеспечения для шифрования, пожалуйста, проверьте законы, правила и политики вашей страны, касающиеся импорта, владения или использования, и реэкспорта программного обеспечения для шифрования, чтобы увидеть, разрешено ли это. См. Http://www.wassenaar.org/ для получения дополнительной информации.
Министерство торговли правительства США, Бюро промышленности и безопасности (BIS), классифицировало это программное обеспечение как экспортный номер контроля товаров (ECCN) 5D002.c.1, который включает в себя программное обеспечение для информационной безопасности или выполнение криптографических функций с асимметричными алгоритмами. Форма и способ этого распределения дают ему право на экспорт в соответствии с исключением лицензии ENC Technology Technology Software Unserricted (TSU) исключения (см. Правила администрирования экспорта BIS, раздел 740.13) как для объектного кода, так и для исходного кода.
