Seeker на macOS: навчальний приклад перевірки дозволів геолокації

Важливо: ця стаття є навчальним прикладом для власного пристрою, лабораторного стенда або демонстрації з явною згодою учасника.
Не використовуйте Seeker для відстеження людей без дозволу.

Що таке Seeker

Seeker — це open-source інструмент, який демонструє, як вебсторінка може запросити дозвіл на доступ до геолокації пристрою.
Якщо користувач самостійно дозволяє доступ до Location Permission у браузері, сторінка може отримати координати, точність, висоту, напрямок і швидкість, якщо ці дані доступні на пристрої.

Це не “магічний злом GPS”, а приклад соціальної інженерії та неправильного ставлення користувачів до дозволів браузера.
Саме тому цей інструмент корисний для навчання: він показує, чому не можна бездумно натискати Allow / Дозволити на будь-якій сторінці.

Коли це можна використовувати

для навчання з кібербезпеки;
для демонстрації ризиків Location Permission;
для власного пристрою;
для внутрішнього security awareness-тренінгу;
для тестового стенда з письмовим дозволом.

Коли це не можна використовувати

для відстеження іншої людини без її згоди;
для прихованого збору координат;
для фішингу або обману;
для “перевірки” партнера, друзів, співробітників або клієнтів без дозволу;
для публічного розсилання посилань без пояснення, що саме збирається.

Офіційний репозиторій

Проєкт доступний на GitHub:
https://github.com/thewhiteh4t/seeker

Станом на 2026 рік GitHub Releases у репозиторії відсутні, тому краще орієнтуватися на актуальний README у репозиторії.

Встановлення на macOS

Нижче — приклад встановлення для лабораторного використання на macOS.

1. Встановити Homebrew

Якщо Homebrew ще не встановлений, встановіть його з офіційного сайту:
https://brew.sh/

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

На Apple Silicon Homebrew зазвичай встановлюється в /opt/homebrew, на Intel Mac — в /usr/local.

2. Встановити залежності

Для Seeker потрібні Python 3, PHP і Git.

brew install git python php

Перевірка:

python3 --version
php --version
git --version

3. Завантажити Seeker з GitHub

git clone https://github.com/thewhiteh4t/seeker.git
cd seeker

4. Встановити Python-залежності

У старій версії інструкції встановлювався тільки requests.
У 2026 році правильніше перевірити наявність requirements.txt у репозиторії і встановлювати залежності з нього.

python3 -m pip install --upgrade pip

if [ -f requirements.txt ]; then
    python3 -m pip install -r requirements.txt
else
    python3 -m pip install requests
fi

Якщо macOS або Homebrew блокує глобальне встановлення Python-пакетів, краще створити virtualenv:

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip

if [ -f requirements.txt ]; then
    python3 -m pip install -r requirements.txt
else
    python3 -m pip install requests
fi

Варіант із Docker

Якщо у вас встановлений Docker, можна використати Docker-образ:

docker pull thewhiteh4t/seeker

Далі дивіться актуальну команду запуску в README проєкту, тому що параметри контейнера можуть змінюватися.

ngrok для локального тунелю

Для лабораторної демонстрації з телефону або іншого пристрою можна використати ngrok, щоб тимчасово відкрити локальний порт у публічний HTTPS URL.

1. Встановити ngrok

У 2026 році актуальна команда Homebrew:

brew install --cask ngrok

2. Зареєструватися в ngrok

Потрібно створити акаунт:
https://dashboard.ngrok.com/login

3. Підключити authtoken

ngrok config add-authtoken <ваш_токен>

У старих інструкціях використовувалась команда ngrok authtoken.
Зараз краще використовувати ngrok config add-authtoken, як у новій CLI-документації ngrok.

4. Запустити tunnel на порт 8080

ngrok http 8080

Запуск Seeker у лабораторному режимі

Перейдіть у папку з проєктом:

cd seeker

Приклад запуску:

python3 seeker.py -t manual -k testkml

Далі в рамках лабораторної демонстрації можна вибрати тестовий шаблон або використати власний шаблон у папці:

seeker/template

Важливо: посилання з ngrok можна відкривати тільки на власному пристрої або передавати учаснику, який прямо погодився на демонстрацію і розуміє, що сторінка запитує доступ до геолокації.

Як виглядає безпечний сценарій демонстрації

Пояснити учаснику, що це тест Location Permission.
Показати, що браузер просить дозвіл на геолокацію.
Пояснити різницю між Allow і Block.
Показати, які дані може віддати браузер після дозволу.
Після демонстрації видалити всі зібрані дані.

Що саме демонструє Seeker

користувач сам надає дозвіл браузеру;
геолокація може бути дуже точною на смартфоні;
HTTPS-посилання виглядає “безпечним”, але це не гарантує чесність сторінки;
короткі посилання можуть приховувати реальний домен;
соціальна інженерія часто небезпечніша за технічну вразливість.

Як захиститися від подібних атак

не натискати Allow для геолокації на випадкових сайтах;
перевіряти домен перед наданням дозволів;
не відкривати підозрілі короткі посилання;
регулярно перевіряти дозволи сайтів у браузері;
вимикати геолокацію для браузера, якщо вона не потрібна;
на iPhone і Android перевіряти дозволи застосунків і браузерів окремо;
пояснювати користувачам, що HTTPS не означає “сайт безпечний”.

Як відкликати дозвіл на геолокацію

Chrome / Chromium

Відкрийте Settings.
Перейдіть у Privacy and security.
Відкрийте Site settings.
Знайдіть Location.
Видаліть або заблокуйте дозволи для підозрілих сайтів.

Safari на macOS

Відкрийте Safari.
Перейдіть у Settings / Preferences.
Відкрийте вкладку Websites.
Знайдіть Location.
Змініть дозвіл на Deny або Ask.

iPhone

Відкрийте Settings.
Перейдіть у Privacy & Security.
Відкрийте Location Services.
Перевірте дозволи Safari, Chrome або іншого браузера.

Android

Відкрийте Settings.
Перейдіть у Location або Privacy.
Перевірте дозволи браузера.
Вимкніть доступ до геолокації для сайтів або застосунків, яким не довіряєте.

Типові проблеми при встановленні

python3 не знайдено: встановіть Python через brew install python.
pip3 не працює: використовуйте python3 -m pip замість окремої команди pip3.
ngrok не запускається: перевірте, чи виконано ngrok config add-authtoken.
порт 8080 зайнятий: зупиніть інший процес або використайте інший порт.
сторінка не відкривається з телефону: перевірте активний ngrok URL і firewall.

Висновок

Seeker корисний як навчальний приклад того, наскільки небезпечним може бути бездумне надання дозволу на геолокацію у браузері.

У 2026 році для macOS актуальніше встановлювати залежності через Homebrew, використовувати python3 -m pip,
а ngrok встановлювати через brew install --cask ngrok.

Головне — використовувати цей інструмент тільки етично: власний пристрій, тестовий стенд або учасник, який прямо погодився на демонстрацію.

Окрема сторінка блогу