/auth

Google Drive Authentication

Este comando ejecuta el flujo de autenticación OAuth para obtener acceso a archivos nativos de Google Drive.

Pre-requisitos

Antes de ejecutar este comando, asegúrate de haber completado /context-sources:gdrive:setup <source-id>:

1. Proyecto de Google Cloud creado
2. Google Drive API habilitada
3. Credenciales OAuth descargadas
4. credentials.json guardado en la ruta correcta

Paso 1: Identificar la fuente

Si se pasó argumento ($1)

Usa $1 como source_id. Verifica que existe en .context-sources/sources.yaml y tiene provider: gdrive.

Si no se pasó argumento

Lee .context-sources/sources.yaml y filtra las fuentes con provider: gdrive. Luego pregunta:

tool: AskUserQuestion
questions:
  - question: "¿Para qué fuente de Google Drive quieres autenticarte?"
    header: "Fuente"
    multiSelect: false
    options:
      # Generar dinámicamente desde sources.yaml
      - label: "<source-id-1>"
        description: "<path de la fuente>"
      - label: "<source-id-2>"
        description: "<path de la fuente>"

Paso 2: Buscar credenciales

Busca credentials.json en orden de prioridad:

1. Nivel proyecto: .context-sources/gdrive/<source-id>/credentials.json
2. Nivel usuario: ~/.context-sources/gdrive/<source-id>/credentials.json

# Verificar nivel proyecto
PROJECT_CREDS=".context-sources/gdrive/<source-id>/credentials.json"
USER_CREDS="$HOME/.context-sources/gdrive/<source-id>/credentials.json"

if [ -f "$PROJECT_CREDS" ]; then
    CREDS_PATH="$PROJECT_CREDS"
    CREDS_DIR=".context-sources/gdrive/<source-id>"
elif [ -f "$USER_CREDS" ]; then
    CREDS_PATH="$USER_CREDS"
    CREDS_DIR="$HOME/.context-sources/gdrive/<source-id>"
else
    echo "NOT_FOUND"
fi

Si no se encuentran credenciales

Informa al usuario:

No se encontraron credenciales para la fuente <source-id>.

Ejecuta primero:

/context-sources:gdrive:setup <source-id>

Paso 3: Ejecutar autenticación

Si las credenciales existen, ejecuta el script de autenticación pasando la ruta:

python3 $PLUGIN_DIR/tools/gdrive/gdrive_auth.py --credentials "$CREDS_PATH" --token-dir "$CREDS_DIR"

Esto:

1. Abrirá tu navegador predeterminado
2. Te pedirá iniciar sesión en tu cuenta de Google
3. Solicitará permiso para acceder a Google Drive
4. Guardará el token en <CREDS_DIR>/token.json

Paso 4: Autorización en el navegador

Cuando se abra el navegador:

1. Selecciona tu cuenta de Google
2. Si ves "Esta app no está verificada", haz click en "Avanzado" > "Ir a Context Sources"
3. Revisa los permisos solicitados:
   • Ver y descargar archivos de Google Drive
   • Ver, editar, crear y eliminar archivos que la app cree
4. Click en "Permitir"
5. Cierra la ventana del navegador cuando veas el mensaje de éxito

Paso 5: Verificación

Después de autenticar, verifica que el token se haya creado:

test -f "$CREDS_DIR/token.json" && echo "✅ Autenticación exitosa para <source-id>" || echo "❌ Error en autenticación"

Muestra resumen:

Autenticación completada para <source-id>

• Credenciales: <CREDS_DIR>/credentials.json
• Token: <CREDS_DIR>/token.json

Ya puedes usar esta fuente con:

/context-sources:load <source-id>

Renovación del token

El token se renueva automáticamente cuando expira. Si tienes problemas:

1. Elimina el token existente:

   rm "<CREDS_DIR>/token.json"
   

2. Vuelve a ejecutar este comando:

   /context-sources:gdrive:auth <source-id>
   

Solución de problemas

"redirect_uri_mismatch"

Las credenciales no están configuradas como "Desktop app". Crea nuevas credenciales en Google Cloud Console.

"access_denied"

El usuario rechazó el acceso o no tiene permisos en el Drive especificado.

"invalid_client"

El archivo credentials.json está corrupto o es inválido. Descárgalo de nuevo desde Google Cloud Console.

El navegador no se abre

Si estás en un entorno sin GUI, el script imprimirá una URL. Cópiala y ábrela manualmente en un navegador.

"credentials.json not found"

Ejecuta primero /context-sources:gdrive:setup <source-id> para configurar las credenciales.