Conector de Google Workspace

Vision General

El conector de Google Workspace proporciona funcionalidad para obtener archivos de Google Drive (anteriormente G Suite) y registrarlos en el indice de Fess.

Esta funcionalidad requiere el plugin fess-ds-gsuite.

Servicios Soportados

Google Drive (Mi unidad, Unidades compartidas)
Documentos de Google, Hojas de calculo, Presentaciones, Formularios, etc.

Requisitos Previos

Se requiere la instalacion del plugin
Se requiere la creacion de un proyecto en Google Cloud Platform
Se requiere la creacion de una cuenta de servicio y la obtencion de credenciales
Se requiere la configuracion de delegacion de dominio de Google Workspace

Instalacion del Plugin

Metodo 1: Colocar el archivo JAR directamente

# Descargar desde Maven Central
wget https://repo1.maven.org/maven2/org/codelibs/fess/fess-ds-gsuite/X.X.X/fess-ds-gsuite-X.X.X.jar

# Colocar
cp fess-ds-gsuite-X.X.X.jar $FESS_HOME/app/WEB-INF/lib/
# o
cp fess-ds-gsuite-X.X.X.jar /usr/share/fess/app/WEB-INF/lib/

Metodo 2: Instalar desde la pantalla de administracion

Abra «Sistema» -> «Plugins»
Cargue el archivo JAR
Reinicie Fess

Metodo de Configuracion

Configure desde la pantalla de administracion en «Rastreador» -> «Almacen de datos» -> «Nuevo».

Configuracion Basica

Elemento	Ejemplo
Nombre	Company Google Drive
Nombre del manejador	GSuiteDataStore
Habilitado	Activado

Configuracion de Parametros

private_key=-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQE...\n-----END PRIVATE KEY-----\n
private_key_id=46812a3b4c5d6e7f8g9h0i1j2k3l4m5n6o7p8q9r
client_email=fess-crawler@your-project.iam.gserviceaccount.com

Lista de Parametros

Parametro	Requerido	Descripcion
`private_key`	Si	Clave privada de la cuenta de servicio (formato PEM, saltos de linea como `\n`)
`private_key_id`	Si	ID de la clave privada
`client_email`	Si	Direccion de correo de la cuenta de servicio

Configuracion de Script

title=file.name
content=file.description + "\n" + file.contents
mimetype=file.mimetype
created=file.created_time
last_modified=file.modified_time
url=file.url
thumbnail=file.thumbnail_link
content_length=file.size
filetype=file.filetype
role=file.roles
filename=file.name

Campos Disponibles

Campo	Descripcion
`file.name`	Nombre del archivo
`file.description`	Descripcion del archivo
`file.contents`	Contenido de texto del archivo
`file.mimetype`	Tipo MIME del archivo
`file.filetype`	Tipo de archivo
`file.created_time`	Fecha de creacion
`file.modified_time`	Ultima fecha de modificacion
`file.web_view_link`	Enlace para abrir en el navegador
`file.url`	URL del archivo
`file.thumbnail_link`	Enlace de miniatura (valido por tiempo limitado)
`file.size`	Tamano del archivo (bytes)
`file.roles`	Permisos de acceso

Para mas detalles, consulte Google Drive Files API.

Configuracion de Google Cloud Platform

1. Crear Proyecto

Acceda a https://console.cloud.google.com/:

Cree un nuevo proyecto
Ingrese el nombre del proyecto
Seleccione la organizacion y la ubicacion

2. Habilitar Google Drive API

En «APIs y servicios» -> «Biblioteca»:

Busque «Google Drive API»
Haga clic en «Habilitar»

3. Crear Cuenta de Servicio

En «APIs y servicios» -> «Credenciales»:

Seleccione «Crear credenciales» -> «Cuenta de servicio»
Ingrese el nombre de la cuenta de servicio (ej: fess-crawler)
Haga clic en «Crear y continuar»
El rol no es necesario (omitir)
Haga clic en «Listo»

4. Crear Clave de Cuenta de Servicio

En la cuenta de servicio creada:

Haga clic en la cuenta de servicio
Abra la pestana «Claves»
«Agregar clave» -> «Crear nueva clave»
Seleccione el formato JSON
Guarde el archivo JSON descargado

5. Habilitar Delegacion de Dominio

En la configuracion de la cuenta de servicio:

Marque «Habilitar delegacion de dominio»
Haga clic en «Guardar»
Copie el «ID de cliente OAuth 2»

6. Autorizar en la Consola de Administracion de Google Workspace

Acceda a https://admin.google.com/:

Abra «Seguridad» -> «Acceso y control de datos» -> «Controles de API»
Seleccione «Delegacion de dominio»
Haga clic en «Agregar nuevo»
Ingrese el ID de cliente

Ingrese los ambitos OAuth:

https://www.googleapis.com/auth/drive.readonly

Haga clic en «Autorizar»

Configuracion de Credenciales

Obtener Informacion del Archivo JSON

Archivo JSON descargado:

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "46812a3b4c5d6e7f8g9h0i1j2k3l4m5n6o7p8q9r",
  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgk...\n-----END PRIVATE KEY-----\n",
  "client_email": "fess-crawler@your-project.iam.gserviceaccount.com",
  "client_id": "123456789012345678901",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/..."
}

Configure la siguiente informacion en los parametros:

private_key_id -> private_key_id
private_key -> private_key (los saltos de linea permanecen como \n)
client_email -> client_email

Formato de Clave Privada

private_key mantiene los saltos de linea como \n:

private_key=-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG...\n-----END PRIVATE KEY-----\n

Solucion de Problemas

Error de Autenticacion

Sintoma: 401 Unauthorized o 403 Forbidden

Verificar:

Verificar que las credenciales de la cuenta de servicio sean correctas:
- Los saltos de linea de private_key estan como \n
- private_key_id es correcto
- client_email es correcto
Verificar que Google Drive API este habilitada
Verificar que la delegacion de dominio este configurada
Verificar que este autorizado en la consola de administracion de Google Workspace
Verificar que el ambito OAuth sea correcto (https://www.googleapis.com/auth/drive.readonly)

Error de Delegacion de Dominio

Sintoma: Not Authorized to access this resource/api

Solucion:

Verificar la autorizacion en la consola de administracion de Google Workspace:
- El ID de cliente esta registrado correctamente
- El ambito OAuth es correcto (https://www.googleapis.com/auth/drive.readonly)
Verificar que la delegacion de dominio este habilitada en la cuenta de servicio

No se Pueden Obtener Archivos

Sintoma: El rastreo tiene exito pero hay 0 archivos