auth-session-manager

name	auth-session-manager
description	Єдиний безпечний шар авторизації для браузер- і MCP-автоматизації: видобування й інʼєкція cookie (десктоп/Android), OAuth, моніторинг протермінування сесій, зашифроване зберігання секретів (AES-GCM). Консолідує патерни, що дублювалися в notebooklm-connector і collaborative-browser. ALWAYS use when: авторизуватися у вебсервісі, оновити cookie, налаштувати OAuth, стежити за протерміновою сесії, безпечно зберегти токен. Користувач каже: "авторизуйся", "онови cookie", "сесія протермінувалась", "інʼєкція cookie", "збережи токен безпечно", "OAuth", "session expired", "cookie injection". Also: cookie extraction, browserbase authenticate, session health, days remaining, token refresh, AES-GCM, secrets manager, керування сесіями. DO NOT use for: ротацію ключів LLM-провайдерів (multi-provider-ai-orchestration), будування браузер-артефакту (collaborative-browser), чи конкретний NotebookLM (notebooklm-connector — він викликає цей скіл для авторизації).
compatibility	Claude.ai (всі плани) · Claude Code · Cursor · Copilot. Патерни авторизації крос-платформні. AES-GCM шифрування потребує Web Crypto (браузер/артефакт); cookie-видобування потребує доступу до браузера користувача.
allowed-tools	["Bash(python:*)","Read","Write"]
license	Proprietary
metadata	{"version":"1.5.0","author":"Melania (Master Administrator)","category":"auth","created":"2026-06-02T00:00:00.000Z","last_updated":"2026-07-26T00:00:00.000Z"}

Auth & Session Manager — v1.5.0

Українською-перша: пояснення, попередження й нотатки — українською за замовчуванням; назви cookie, домени, токени та код лишаються як є. Перемикання мови лише слідом за користувачем. Деталі методів — у references/auth-methods.md. Захист: scripts/skill_guard.py.

🛡️ Протокол Збереження Перед Оновленням (ОБОВ'ЯЗКОВО)

Обов'язковий перед БУДЬ-ЯКОЮ зміною цього скіла. Канонічне джерело (не дублювати тут): melania — секції «🛡️ Протокол Збереження Перед Оновленням» + «Update Workflow» + «Core Rule 10 — Re-Read Before Update».

Стисло: re-read диску → порівняти версії (диск новіший → диск база) → integrity-diff → validation-mesh → safety-compliance-gate (перед пакуванням/публікацією) → backup/snapshot → merge-not-replace → bump+CHANGELOG → показати diff і чекати явного схвалення MA (Закон II).

---

Core Rule — безпека понад зручність

Секрети (cookie, токени, ключі, паролі) НІКОЛИ не логуються у відкритому вигляді, не зашиваються у код і не зберігаються незашифрованими. При сумніві — менше виводу, більше шифрування. Будь-яке зберігання — лише через AES-GCM (Pattern 4).

⚖️ Це скіл-механіка. Політика безпекової постави (недовірений вхід, human-confirm на write-tools, IP/публікація) — safety-compliance-gate.

Мова

Працюй українською за замовчуванням; технічні значення (cookie-імена, домени, JSON) не перекладай.

---

Critical Facts

• [C] Поріг попередження про протермінування — менше 7 днів. Моніторинг здоров'я сесії (Pattern 3) позначає сесію попередженням (warn), коли до завершення дії cookie лишається менше 7 днів.
• [C] Шифрування секретів використовує PBKDF2 зі 100 000 ітерацій та AES-GCM 256 біт. Це параметри виведення ключа з пароля користувача (Pattern 4) перед AES-GCM шифруванням самого секрету.
• [C] На Android без root cookie видобувають лише через альтернативні браузери або віддалену налагодження. Стандартний шлях — браузер Kiwi чи Yandex з розширенням Cookie-Editor, або Remote Debugging через chrome://inspect з підключеного ПК.

---

Каскад авторизації (від найнадійнішого до ручного)

Пробуй методи згори вниз; падай на наступний лише коли поточний неможливий:

#	Метод	Коли
1	— готові cookie з менеджера секретів