find-my-iphone: Alexa/REST bridge to ring iPhone via iCloud

2026-08-12 03:19:17 -07:00
parent b08a68d591
commit 768b010afe
5 changed files with 144 additions and 0 deletions
@@ -0,0 +1,13 @@
+# find-my-iphone image
+
+Node/Express bridge exposing Alexa + REST endpoints over the find-my-iphone
+module (icloudjs SRP auth). Dockerfile lives in the source repo -
+https://git.alexzaw.dev/alexz/find-my-iphone (working copy:
+~/projects/find-my-iphone). Build + push with ./build.sh.
+
+Gotchas:
+- APPLE_ID/APPLE_PASSWORD/API_KEY are required at boot or the container exits.
+- The 2FA trust token is written to /data (mounted from ${APP_DATA_DIR}/data);
+  wiping that volume forces a new MFA round via POST /api/mfa.
+- /alexa signature verification requires the raw request body - never put a
+  JSON body parser in front of it (server.js mounts express.json on /api only).