Guía para administradores: Ascripto y Google Workspace

Última revisión: 19 de octubre de 2026

Para el administrador o el administrador avanzado de Google Workspace a quien se ha pedido que autorice algo, y para cualquiera que esté evaluando a qué accede Ascripto. Primero el mecanismo, en los términos de Google.

Qué pide Ascripto y a quién

AutorizaciónQuién la concedeDóndeQué permite
Inicio de sesióncada persona que usa Ascriptoel inicio de sesión de Googleopenid, email, profile. La identidad se basa en el identificador estable (subject) y el dominio alojado de la cuenta de Google, nunca en la dirección de correo electrónico
Directorio, solo lecturaun administrador de Google Workspaceel consentimiento de OAuth al que se llega desde Ascripto (página de bienvenida o Configuración → Conexiones)admin.directory.user.readonly y admin.directory.domain.readonly: los usuarios con su nombre, cargo, departamento, teléfonos, unidad organizativa y atributos personalizados; los dominios verificados de la organización. Los grupos no se leen
Firmasun administrador avanzadoConsola de administración → Seguridad → Control de acceso y datos → Controles de API → Administrar la delegación de todo el dominiowww.googleapis.com/auth/gmail.settings.basic para la cuenta de servicio de Ascripto, cuyo ID de cliente se muestra en la página. Solo se usa para users.settings.sendAs

Ascripto nunca lee, envía ni elimina correo. Su uso de los datos de Google está sujeto a la Política de Datos del Usuario de los Servicios de las APIs de Google, incluidos los requisitos de uso limitado; la declaración figura en la política de privacidad, en ascripto.com/es/privacy/.

Por qué delegación de todo el dominio y no una instalación desde Marketplace

Por dos motivos, y ambos seguirían siendo válidos cuando exista la ficha en Marketplace:

  1. Leer o escribir la firma de un alias (función “Enviar como”) en un buzón que no sea el de quien hace la llamada solo es posible para un cliente de cuenta de servicio con autoridad en todo el dominio. El consentimiento por usuario no lo permite.
  2. Google no ofrece una variante de solo lectura de gmail.settings.basic. La auditoría solo lee, pero la autorización también permite, necesariamente, escribir.

Google verificó la aplicación OAuth de Ascripto (marca y permisos sensibles) el 17 de octubre de 2026, así que la pantalla de consentimiento para la autorización del directorio no muestra el aviso de “aplicación no verificada”. La entrada de delegación para las firmas se sigue creando a mano en la Consola de administración, y los permisos son los de la tabla anterior.

Frecuencia y funcionamiento

ActividadFrecuenciaMecanismo
Cambios en el directorioen cuanto ocurren: Google avisa a Ascripto de cada cambio, y la persona se lee en ese momento, un minuto después y cinco minutos despuésAdmin SDK Directory API users.watch, un canal por tipo de cambio (alta, modificación, eliminación, restauración), renovado cada dos días y cerrado con channels.stop; users.get para la persona
Lectura del directoriocada hora; cada 15 minutos mientras falte un canal de avisos; y al pulsar Leer ahoraAdmin SDK Directory API users.list, domains.list
Auditoríauna vez al día y al pulsar Volver a comprobarsendAs.list por persona; la firma de la dirección principal se compara con el registro del directorio
Implementaciónen una implementación revisada; después, automáticamente para las incorporaciones y los registros modificadossendAs.patch por persona, unas veinte escrituras por segundo. Cada buzón se lee primero y solo se escribe si es distinto, salvo que esté marcada la casilla Reescribir aunque esté al día
Importacióna peticiónsendAs.get para la persona elegida; los valores se cotejan con su registro del directorio

Se usa sendAs.patch en lugar de sendAs.update, para que una implementación nunca borre el nombre visible, la dirección de respuesta ni los indicadores de alias de una persona.

Qué compara la auditoría

Por persona, la firma que Gmail usa en los mensajes nuevos frente al registro del directorio. Hallazgos:

HallazgoComprobación
sin firmala firma está vacía
falta el nombreel nombre de la persona no aparece en el texto
falta el cargoel cargo del directorio no aparece en el texto
falta el teléfono del trabajoel teléfono del trabajo del directorio no aparece en el texto
sin logotipola firma no lleva ninguna imagen de logotipo
no se pudo leerGoogle denegó el acceso al buzón; se cuenta aparte, nunca como conforme ni como no conforme a la marca

No se examinan, y así se indica junto a las cifras: la firma independiente que una persona puede elegir para respuestas y reenvíos (Gmail la guarda en la configuración web y ninguna API indica cuál está en uso), una Firma para móviles configurada en la aplicación Gmail (local en el dispositivo e invisible para cualquier API), las fuentes, los tamaños y los colores, y cualquier cosa que una persona añada aparte del contenido implementado.

Qué escribe la implementación

El HTML generado para esa persona (las imágenes se alojan en img.ascripto.com, ya que una firma de Gmail es una cadena HTML y no puede incrustarlas) y el texto sin formato correspondiente. Gmail aplica la firma en la web y en las aplicaciones de Gmail. La implementación omite a las personas suspendidas en el directorio, a las que tienen una dirección fuera de los dominios de la organización y a las que no llega ninguna firma.

Salidas

Una persona eliminada del directorio pasa a la papelera de reciclaje de Ascripto (7 días de forma predeterminada, configurable hasta un año en Configuración → Conexiones) y deja de gestionarse. Ascripto no vuelve a escribir nunca en su buzón y no borra la firma que ya tiene. En los usuarios suspendidos no se escribe mientras dura la suspensión.

Firmas duplicadas

Si en la Consola de administración (Apps → Google Workspace → Gmail → Cumplimiento) está activada la opción Agregar pie de página (Append footer), Google añade ese pie de página debajo de la firma de cada usuario, incluida la que escribe Ascripto. Cuando Ascripto ya incluya el texto legal, desactiva el pie de página en todas las unidades organizativas donde esté configurado.

Modos de fallo, tal como los notifica el producto

Qué ha pasadoQué muestra AscriptoSolución
Falta la entrada de delegación o se ha eliminadoGoogle se negó a abrir los buzones. Puede que se haya retirado el acceso a las firmas en tu Consola de administración. La auditoría o la implementación se detiene; los recuentos se quedan donde llegaronVuelve a añadir el ID de cliente y el permiso de OAuth. Se detecta en el extremo de tokens (unauthorized_client), así que entretanto no se toca ningún buzón
Se revocó el consentimiento del directorio o el administrador que lo dio perdió el rolConfiguración → Conexiones: Se ha retirado la conexión. Vuelve a conectar para leer de nuevo el directorio.Volver a conectar como administrador actual
Google tarda en aplicar una delegación nuevaAún no está permitido, con una nueva comprobación cada 20 segundosEspera; Google documenta hasta 24 horas, aunque suelen ser minutos
Falla una comprobación o una lectura por parte de Ascriptose indica así y se reintentanada

Revocar el acceso de Ascripto

  1. Firmas: Consola de administración → Seguridad → Control de acceso y datos → Controles de API → Administrar la delegación de todo el dominio → el cliente de Ascripto → Eliminar. Las auditorías y las implementaciones se detienen de inmediato.
  2. Directorio: el administrador que dio el consentimiento quita Ascripto en su cuenta de Google → Aplicaciones vinculadas (myaccount.google.com/linkedapps) (o Configuración → Conexiones → la conexión aparece como retirada en cuanto Google rechaza la siguiente lectura).
  3. Las firmas ya escritas se quedan en el Gmail de cada persona; Ascripto nunca las borra.

Tratamiento de datos

Licencias

En Google Workspace ocupa una licencia cualquier persona cuyo Gmail haya llevado tu firma actual en algún momento del mes, porque una implementación la escribió o porque una implementación o la auditoría la encontró todavía ahí. Una persona suspendida o eliminada durante todo el mes no cuenta. El recuento del mes hasta la fecha está en Configuración → Facturación.

Fuentes