Skip to content

Latest commit

 

History

History
194 lines (140 loc) · 9.57 KB

README.md

File metadata and controls

194 lines (140 loc) · 9.57 KB
Raw

Apple ID One-Click Unlocking Tool

GitHub issues GitHub stars GitHub forks GitHub license

中文文档 | English

Follow the instruction below to have better experience

Our project is open-source and will be updated from time to time

Basic Introduction

"Manage your Apple ID in a brand-new way" - This is an automated Apple ID detection & unlocking program based on security questions.

The frontend is used to manage accounts, support adding multiple accounts, and provide a display account page.

Creates a shared page containing multiple accounts and setting a password for the shared page.(Optional)

The backend regularly checks whether the account is locked. If it is locked or 2FA is enabled, it will be automatically unlocked, the password will be changed, and the password will be reported to the API.

Log in to Apple ID and automatically delete devices in Apple ID.

Enable proxy pool and Selenium cluster to improve the success rate and prevent risk control.(Optional)

Reminder:

  1. The backend runs based on docker, please make sure that docker is installed on the machine;
  2. unblocker_manager is the backend management program, which will get the task list from the API at regular intervals and deploy docker containers (one container for each account);
  3. The program needs to use Chrome webdriver, it is recommended to use the Docker version selenium/standalone-chrome, the docker deployment command is as follows, please modify the parameters according to your needs.(Only supports x86_64, if you are using ARM, try seleniarm/standalone-chromium or use cluster grid: sahuidhsu/selenium-grid-docker)
docker run -d --name=webdriver --log-opt max-size=1m --log-opt max-file=1 --shm-size="2g" --restart=always -e SE_NODE_MAX_SESSIONS=10 -e SE_NODE_OVERRIDE_MAX_SESSIONS=true -e SE_SESSION_RETRY_INTERVAL=1 -e SE_VNC_VIEW_ONLY=1 -p 4444:4444 -p 5900:5900 selenium/standalone-chrome
  1. The program backend supports 3 languages currently: English, Simplified Chinese, and Vietnamese. The language can be easily set by using the one-click deployment script provided in section Usage.

Usage

Please deploy the frontend first, and then install the backend. The backend installation script provides a one-click installation of webdriver
If you want to know more about Selenium Grid cluster, please go to sahuidhsu/selenium-grid-docker
The recommended web page running environment is php7.4 & MySQL8.0, theoretically supporting MySQL5.x, other versions of php may not be supported.

  1. Download the web page source code from Release and deploy it, import the database (sql/db.sql), copy the configuration file config.bak.php to config.php, and fill in the settings
    Default account: admin password: admin
  2. After logging in to the website, add the Apple account and fill in the account information
  3. Deploy backend\unblocker_manager.py (we provide a one-click deployment script, please see below)
  4. Check whether unblocker_manager successfully obtains the task list
  5. Check whether the container is deployed and running normally

One-click deployment of unblocker_manager (backend + webdriver):

bash <(curl -Ls https://raw.githubusercontent.com/pplulee/appleid_auto/main/backend/install_unblocker.sh)

Description of security questions:

Questions only need to fill in keywords, such as "birthday", "work", etc., but please be aware of the language of the account security questions.

Frontend update

Download the web page source code from Release and overwrite the original files, re-fill in config.php, and import the updated database file (the file beginning with update_).

Backend update

If you are using the latest version of the backend management script, just simply restart the appleauto service to update. If not working, re-run the installation script.

Feedback and Communication

We are not professional, so as the program. Issues and Pull Requests are welcomed, and we're looking forward for your contribution!
Telegram group: @appleunblocker

File Description

  • backend\unblocker_manager.py Backend management program
    Description: Regularly fetch the task list from API and deploy docker containers corresponding to task
    Launch parameters: -api_url <API address> -api_key <API key> -lang <1/2/3> (The API address should be in the format of http(s)://xxx.xxx, never include a / or path at the end. lang: 1 - Simplified Chinese, 2 - English, 3 - Vietnamese)
  • backend\unlocker\main.py Backend unlock program
    Description: Unlock the account by changing the password through Webdriver and return the new password to the API. This program depends on the API to run
    Launch parameters: -api_url <API地址> -api_key <API key> -taskid <Task ID> -lang <zh_cn/en_us/vi_vn>

The backend management program is only necessary program to be running, it will automatically obtain the task from the API site and deploy the docker containers. The default sync time is 10 minutes (restart the service to manually sync)
If you only want to use the backend unlock program, feel free to use the docker version sahuidhsu/appleid_auto

Buy me a coffee

ko-fi
USDT-TRC20: TV1su1RnQny27YEF9WG4DbC8AAz3udt6d4
ETH-ERC20：0xea8fbe1559b1eb4b526c3bb69285203969b774c5
[AD] If you have a need to use the mailbox, please feel free to consult the developer (Telegram)

API Documentation

Path: /api/
Method: GET
All actions need to pass the key parameter, which is the apikey argument in config.php
Return type: JSON
Common return parameters

parameter value / type description
status success/fail operation success / fail
message String prompt info

Action: random_sharepage_password
Description: Generate a random share page password
Input parameters:

parameter value / type description
action random_sharepage_password operation
id Int share page ID

return parameters:

parameter value / type description
password String new password

……The rest are waiting to be added (๑•̀ㅂ•́)و✧

JSON API interface

It is possible to obtain account information in JSON format by sharing a page link, which can be used to integrate with other apps.
The page link refers to the page's code, rather than the entire URL.

API address: /api/share.php
Request method: GET
Input parameters:

parameter value / type description
share_link String 分享页代码
password String 分享页密码（若未设置密码则不需要）

return parameters:

parameter value / type description
status success/fail operation success / fail
message String prompt information
accounts Array List of account information (see the table below)

Account information:

parameter value / type description
id Int Account ID
username String Account
password String Password
status Bool Account status
last_check String Last check time
remark String Account front-end remarks

TODO List

  • Auto recognition of verification code
  • Check if the account is locked
  • Check 2FA status
  • Add supports for multiple accounts in share page
  • Add restriction to share page(password protection)
  • Check password
  • Delete device
  • Change password at regular intervals
  • Report password
  • Proxy pool
  • Telegram Bot notification
  • JSON API interface to obtain account information