1. «ACL Audit — Drive Permissions»

Описание программного продукта «ACL Audit — Drive Permissions»

Краткое назначение:

Расширение для Google Chrome, предназначенное для организаций, использующих экосистему Google Workspace (Drive и Sheets). 

Инструмент:

- проводит аудит внешних и внутренних прав доступа к файлам Google Drive, 

- формирует отчёт в корпоративной Google Таблице 

- позволяет оперативно отозвать лишние разрешения. 

Продукт ориентирован на:

- специалистов по информационной безопасности

- администраторов Google Workspace 

- compliance-команды.

Основные функции

1. Полный аудит хранилища: сканирование всех доступных пользователю файлов Google Drive с фиксацией владельцев, перечня внешних адресов и ролей (редактор/читатель).
2. Таргетированный аудит по адресу Gmail: поиск файлов, где конкретный пользователь имеет права доступа.
3. План и исполнение отзывов: формирование планов удаления внешних разрешений и пакетное удаление через API Drive.
4. Логирование и диагностика: модуль ErrorCollector сохраняет все исключения и ошибки обмена с API, что обеспечивает прозрачность и облегчает сопровождение.

Интерфейс в сайд-панели: пользовательский интерфейс локализован (RU/EN), содержит:

- прогресс-бар

- логи

- кнопки запуска сценариев 

- отображение текущей версии продукта.

Отчётность

Результаты записываются в заранее подготовленную Google Таблицу (обязательные листы: «Режим», «Полное сканирование доступов», «Результаты поиска», «Сканирование по gmail», «План отзыва», «Лог», «Снапшоты», «Сотрудники», «Белый список», «Чёрный список»).

Архитектура и стек технологий

• Тип приложения: расширение Chrome на Manifest V3 (подходит для распространения через Chrome Web Store).
• Языки программирования:
• - JavaScript (ES2015+), как для фонового сервиса (background.js), так и для интерфейса (sidepanel.js, popup.js, settings.js).
• - HTML5 и CSS3 для шаблонов UI (sidepanel.html, popup.html, settings.html, стили в assets/styles.css).

Инфраструктура авторизации: OAuth 2.0 с implicit flow через chrome.identity.launchWebAuthFlow. Redirect URI формата https://<ExtensionID>.chromiumapp.org/.

Используемые API Google:

Google Drive API v3 — перечисление файлов, чтение и отзыв разрешений.

Google Sheets API v4 — запись результатов аудита, обновление листов.

Google OAuth UserInfo endpoint — получение сведений о профиле пользователя.

Chrome API:

chrome.identity — авторизация пользователей.

chrome.storage.local — хранение конфигурации, токенов и логов.

chrome.runtime, chrome.alarms, chrome.notifications, chrome.sidePanel — сервисные функции расширения.

Тестирование и автоматизация: набор вспомогательных скриптов и тестовых страниц (например, test-runner.html, functional-tests.js) для ручной и полуавтоматической проверки сценариев.

Безопасность и соответствие

OAuth-конфигурация: указанный client_id зарегистрирован в Google Cloud Console, привязан к Extension ID likjenndpgeebpmjlnmlfogdkcnpikmo, включены Drive и Sheets API, Consent Screen переведён в Production.

XSS/инъекции: пользовательский ввод (например, ссылки на таблицы) проходит экранирование через escapeHtml.

Логирование:

• любые ошибки API и авторизации обрабатываются и записываются в ErrorCollector; 
• предусмотрены функции экспорта логов в JSON/TXT.

Хранение данных:

Чувствительные значения (токены OAuth) сохраняются локально в chrome.storage.local со сроком жизни, соответствующим expires_in. При обновлении расширения кэш автоматически очищается.

Права доступа:

Расширение запрашивает только необходимые разрешения: identity, storage, sidePanel, alarms, notifications, плюс точечные host_permissions к доменам googleapis.com, docs.google.com, drive.google.com.

Процесс использования

• Пользователь устанавливает расширение из Chrome Web Store.
• В интерфейсе сайд-панели нажимает «Авторизация Google». Открывается окно Google OAuth, где пользователь подтверждает доступ к Drive и Sheets.
• После получения токена можно привязать рабочую таблицу и запускать аудит (полный или выборочный).
• Результаты и логи отображаются в интерфейсе и автоматически записываются в Google Таблицу.

При необходимости администратор может экспортировать журнал ошибок или повторить авторизацию.

Поддержка и сопровождение

Сбор логов и отчётов обеспечивает возможность оперативного реагирования на инциденты.

Версия продукта отображается в футере интерфейса (v6.1.0 на текущий момент), что помогает синхронизировать обновления и обращения в поддержку.

Архив дистрибутива формируется автоматически (скрипт PowerShell/Compress-Archive) и готов к загрузке в Chrome Web Store или к документированию для органов сертификации.

“Sheets Backup Admin”

1. Общие сведения о программном продукте

Наименование: Sheets Backup Admin

Категория: Программное обеспечение класса «Расширения браузера» и облачных сервисов автоматизации.Назначение: Автоматизация резервного копирования таблиц Google Sheets в Google Drive с возможностью централизованного управления расписаниями.Статус: Готов к эксплуатации. Доступно размещение в Chrome Web Store.

2. Назначение и область применения

Sheets Backup Admin предназначен для организаций и частных пользователей, которым необходима регулярная фиксация и архивация данных, ведёмых в Google Sheets. Решение актуально для:

• финансовых и бухгалтерских служб (хранение версий отчётности, движение средств);
• HR‑подразделений (резервное копирование кадровых таблиц, планов отпусков, мотивационных схем);
• ИТ-отделов (сохранение регистров, конфигураций, инвентаризационных таблиц);
• руководителей проектов (фиксация контрольных версий планов, производственных графиков).

Продукт уменьшает операционные риски, упрощает восстановление после ошибок и обеспечивает прозрачность управления резервными копиями.

3. Основные функциональные возможности

• Поиск и подключение таблиц: сканирование Google Drive пользователя для выявления файлов формата Google Sheets; выбор и добавление нужных таблиц в реестр.
• Гибкие расписания: назначение дней недели и конкретного времени для Daily и Monthly бэкапов для каждого файла или группы файлов.
• Резервное копирование «только значения»: копирование данных без формул и скриптов с сохранением форматирования, ширин столбцов и высоты строк.
• Автоматическое ведение структуры хранения: создание папок Sheets Backups / <Наименование таблицы> / daily|monthly.
• Журналирование и уведомления: отображение статусов выполнения бэкапов, лог действий в интерфейсе расширения.
• Очистка старых копий: функция retention — удаление ежедневных копий старше 60 дней (при необходимости можно отключить).
• Интеграция с учетными записями Google: OAuth 2.0 авторизация, работа в домене организации, поддержка нескольких пользователей.

4. Архитектура и стек технологий

Клиентская часть (Chrome Extension):

• Языки: JavaScript (ES2020), HTML5, CSS3.
• Интерфейс: боковая панель Chrome с кастомным UI.
• Библиотеки: native Chrome Extension APIs (identity, sidePanel, storage), никаких сторонних JS‑фреймворков.

Серверная часть (Google Apps Script):

• Платформа: Google Apps Script (runtime V8).
• Язык: ECMAScript 2019 (подсет JavaScript от Google).
• Сервисы: DriveApp, SpreadsheetApp, ContentService, ScriptApp.

Инфраструктура и интеграция:

• OAuth 2.0 client (тип Chrome App) в Google Cloud Platform.
• Хранение данных реестра: персональные Google Sheets пользователей (каждый пользователь имеет собственную таблицу).
• Хранение резервных копий: Google Drive пользователя.
• Отсутствие внешних серверов и СУБД — решение полностью использует облачную инфраструктуру Google.

Сборка и поставка:

• Жёсткая структура проекта в каталоге extension/ (manifest.json, background.js, sidebar.html/js/css, assets).
• Упаковка в ZIP для Chrome Web Store.
• Управление версиями: нумерация в manifest.json (текущая версия 2.4.1).

6. Лицензионные и авторские права

• Все элементы исходного кода принадлежат разработчику продукта.
• В проекте не используется ПО с ограничительными лицензиями; авторские права на UI, лог и вспомогательные скрипты также принадлежат правообладателю.
• Для публикации в Chrome Web Store соблюдены требования Google и принимаемые пользовательские соглашения.

7. Интеграции и совместимость

• Требования: Google Chrome версии 114+ (поддержка Manifest V3).
• Совместимость: работает в Windows, macOS, Linux, ChromeOS (везде, где доступен Chrome).
• Интеграции: Google Drive, Google Sheets, Google Identity Platform.
• API: REST-запросы к Google Apps Script Web App, работающие по HTTPS.

8. Надёжность и безопасность

• OAuth 2.0: авторизация через официальные механизмы Google.
• Разделение данных: каждый пользователь работает только со своими файлами, реестр хранится в личном Google Sheet.
• Отсутствие лишних прав: запрашиваются только drive, spreadsheets, userinfo.email, storage.
• Retained copies: поддержка политики хранения (удаление устаревших копий), что ограничивает потребление места.
• Журналы и диагностика: консоль расширения фиксирует результаты операций, ошибки авторизации, состояние бэкапов.
• Скрипты проверки: автоматические PowerShell‑скрипты (verify_code.ps1, fix_descriptions.ps1) позволяют отслеживать корректность версий, описаний и структуры.

9. Техническая поддержка и развитие

• Регламенты сопровождения: ручные и автоматизированные тесты (скрипты запускаются через PowerShell в рамках CI‑процесса).
• Развитие: добавление новых типов бэкапов, расширение набора фильтров, локализация (текущий интерфейс — русский язык).
• Документация: UPDATE_STORE_DESCRIPTION.md, AUTO_FIX_README.md, QUICK_FIX_GUIDE.md, README.md и другие методические материалы.

10. Заключение

Sheets Backup Admin — это стабильное решение для автоматизации резервного копирования Google Sheets. Оно сочетает удобство установки (Chrome Extension), гибкость настроек расписаний и надёжную облачную инфраструктуру Google. Программный продукт готов к регистрации в реестрах отечественного ПО и удовлетворяет критериям, предъявляемым Минцифры РФ: независимость от закрытых зарубежных API, ясная архитектура, документация и механизмы контроля безопасности.