Configuración de cuentas de correo de Gmail con GoogleAuth

Esta guía explica cómo conectar una cuenta de Gmail a AstroHMS mediante Google OAuth para enviar correos electrónicos seguros directamente desde la plataforma.

La integración permite que AstroHMS utilice una cuenta de Gmail como servidor de correo saliente autenticado, evitando el uso de contraseñas directas y usando en su lugar el protocolo OAuth 2.0 de Google, que es más seguro.

Paso a paso

1. Crear un proyecto en Google API Console

1. Accede a Google API Console.
2. Inicia sesión con tu cuenta de Google Workspace (si dispones de una) o con tu cuenta personal de Gmail. La cuenta debe coincidir con la dirección de correo electrónico que deseas configurar en AstroHMS.
3. Haz clic en Crear proyecto en la parte derecha de la pantalla de consentimiento de OAuth. Si ya existe un proyecto en esta cuenta, la opción Nuevo proyecto aparecerá en la parte superior derecha, en el menú desplegable Seleccionar un proyecto.
4. En la pantalla Nuevo proyecto, asigna un nombre al proyecto y establece la Ubicación:
   • Si usas Google Workspace: establece la ubicación como la organización de Google Workspace.
   • Si usas una cuenta personal de Gmail: establece la ubicación como Sin organización.
5. Haz clic en Crear para finalizar este paso.

2. Configurar la pantalla de consentimiento de OAuth

1. Si la página no redirige automáticamente a las opciones de tipo de usuario, haz clic en Pantalla de consentimiento de OAuth en el menú izquierdo.
2. Selecciona el tipo de usuario correspondiente:
   • Interno: disponible solo para cuentas de Google Workspace. Recomendado para uso empresarial.
   • Externo: obligatorio para cuentas personales de Gmail. Google puede requerir aprobación o añadir alcances adicionales. En modo de prueba externo no se requiere aprobación de Google. El límite en modo de prueba es de 100 usuarios.
3. Haz clic en Crear.
4. En la sección Información de la aplicación:
   • Escribe un nombre descriptivo en el campo Nombre de la aplicación (por ejemplo, AstroHMS).
   • Selecciona la dirección de correo de la organización en el campo Correo electrónico de asistencia al usuario.
5. En Dominio de la aplicación > Dominios autorizados, haz clic en Agregar dominio e introduce el dominio de tu instancia.
6. En la sección Información de contacto del desarrollador, introduce la dirección de correo de la organización. Google usará esta dirección para notificar cambios en el proyecto.
7. Haz clic en Guardar y continuar.
8. En la página de Alcances, deja todos los campos como están y haz clic en Guardar y continuar.
9. Si sigues en modo de prueba (Externo) y deseas añadir las cuentas de correo que vas a configurar, haz clic en Agregar usuarios en el paso Usuarios de prueba y luego en Guardar y continuar.
10. Revisa el resumen del registro de la aplicación. Al terminar, desplázate al final de la página y haz clic en Volver al tablero.

3. Crear las credenciales OAuth (ID de cliente y Secreto)

1. Haz clic en Credenciales en el menú de la barra lateral izquierda.
2. Haz clic en Crear credenciales en el menú superior y selecciona ID de cliente de OAuth en el menú desplegable.
3. En Tipo de aplicación, selecciona Aplicación web.
4. En el campo Nombre, escribe un nombre identificativo (por ejemplo, AstroHMS).
5. En la sección URI de redirección autorizados, haz clic en AGREGAR URI e introduce la siguiente URL en el campo URI 1:

   https://[nombre-de-tu-base-de-datos]/google_gmail/confirm

Nota: Sustituye [nombre-de-tu-base-de-datos] por el nombre real de tu instancia de AstroHMS.

1. Haz clic en Crear para generar el ID de cliente de OAuth y el Secreto de cliente.
2. Copia ambos valores (ID de cliente y Secreto de cliente) para usarlos en el siguiente paso.

4. Configurar las credenciales en AstroHMS

1. Ve a Ajustes > Ajustes generales.
2. En la sección Conversaciones, asegúrate de que la casilla Servidores de correo electrónico personalizados (o Servidores de correo electrónico externos) esté marcada. Al activarla, aparecerán nuevos campos para las credenciales de Gmail.
3. Pega el ID de cliente y el Secreto de cliente obtenidos en el Paso 3 en sus respectivos campos.
4. Guarda los ajustes.

5. Configurar el servidor de correo saliente

1. Desde la página de Ajustes generales, en la sección Servidores de correo electrónico personalizados, haz clic en el enlace Servidores de correo electrónico salientes.
2. Haz clic en Nuevo o Crear para crear un nuevo servidor de correo.
3. Completa los campos Nombre, Descripción y Nombre de usuario (dirección de Gmail que se va a usar).
4. En la sección de autenticación, haz clic en Autenticación de Gmail con OAuth o Gmail.
5. Haz clic en Conectar su cuenta de Gmail. Se abrirá una nueva ventana de Google para completar el proceso de autorización.
6. Selecciona la dirección de correo electrónico que estás configurando.
   • Si es una cuenta personal, aparecerá un paso adicional: haz clic en Continuar para permitir la verificación.
7. Concede a AstroHMS acceso a la cuenta de Google haciendo clic en Continuar o Permitir.
8. La página redirigirá al servidor de correo recién configurado en AstroHMS. El sistema cargará el token automáticamente y aparecerá una etiqueta verde con el texto Token de Gmail válido.
9. Guarda los ajustes y haz clic en Probar conexión. Debe aparecer un mensaje de confirmación. AstroHMS ya puede enviar correos electrónicos seguros a través de Google mediante autenticación OAuth.

Nota: Si en la Consola de Google cambias el estado de publicación a Producción (en lugar de Prueba), Google mostrará un mensaje de advertencia sobre verificación de la aplicación. Para resolver esta advertencia, accede a la plataforma de API de Google y sigue el proceso de verificación correspondiente.