Skip to content

Gadem/PyDomain

Repository files navigation

Activos (Dominios + Hosting -> Google Calendar)

Script para auditar vencimientos de dominios vía WHOIS y vencimientos de hosting desde archivo local, y sincronizarlos con Google Calendar.

Instalacion

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Uso basico

python3 procesar.py

El script:

  • lee dominios.txt (lista de dominios, uno por línea)
  • lee hosting.csv (activos de hosting)
  • consulta WHOIS
  • genera un CSV con el reporte
  • crea o actualiza eventos anuales en Google Calendar

Archivos locales (no versionar)

Por seguridad/privacidad, estos archivos deben mantenerse locales y no subirse al repo:

  • dominios.txt (puede contener dominios reales)
  • hosting.csv (puede contener información de clientes/proveedores)
  • .env.local (SMTP y correos)
  • credentials.local.json (OAuth)
  • token.local.json (sesión OAuth)
  • calendar_sync.local.json (mapeo activo → evento)

El repo incluye ejemplos:

  • dominios.example.txt → copia a dominios.txt
  • hosting.example.csv → copia a hosting.csv
  • .env.example → copia a .env.local
  • credentials.example.json → copia a credentials.local.json

Archivo de hosting

hosting.csv usa estas columnas:

  • clave: identificador estable del hosting
  • nombre: nombre visible del activo
  • proveedor: proveedor del hosting
  • vencimiento: fecha en formato YYYY-MM-DD
  • origen: opcional, por defecto manual
  • notas: opcional

Hay un ejemplo en hosting.example.csv.

Configurar Google Calendar

  1. Crea un proyecto en Google Cloud.
  2. Habilita la Google Calendar API.
  3. Crea credenciales OAuth para aplicacion de escritorio.
  4. Descarga el archivo y guardalo como credentials.local.json dentro de dominios/.
  5. Ejecuta python3 procesar.py y completa la autorización en el navegador.

Se generaran estos archivos locales:

  • .env.local: credenciales SMTP locales
  • token.local.json: sesión OAuth reutilizable
  • calendar_sync.local.json: mapeo local entre activo y evento de calendario

Usa credentials.example.json y .env.example como base para crear tus archivos locales.

Notas

  • El calendario usado por defecto se llama Renovación de activos.
  • Si ya existe un evento del activo, el script lo actualiza si cambia la fecha.
  • Los recordatorios por defecto son a 30, 15 y 7 dias antes.

About

Audita vencimientos de dominios (WHOIS) y hosting y sincroniza con Google Calendar

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages