Bandeja de entrada OAuth

TrakIT puede leer un buzón y actuar sobre los correos electrónicos que se envían a él, por ejemplo las tarifas que se envían por correo electrónico a un tarifario. La página OAuth Inbox conecta TrakIT a ese buzón: una cuenta de Gmail o un buzón de Office 365.

Para abrirla, seleccione Admin > SysAdmin Pages > OAuth Inbox. El encabezado de la página es Mailbox Authorisation. Solo los administradores del sistema pueden abrirla.

La página tiene dos pestañas, Gmail y Office 365. Se abre en Gmail.

Cómo usa TrakIT el buzón

Cada 5 minutos, TrakIT lee hasta 50 correos electrónicos de cada buzón conectado aquí:

1. Guarda cada correo electrónico, con sus archivos adjuntos, en la pestaña Emails Received del registro de mensajes.
2. Saca el correo electrónico del buzón: a la papelera en Gmail, o a Deleted Items en Office 365.
3. Actúa sobre los correos electrónicos cuyo asunto es un comando de TrakIT, y responde al remitente.

Como TrakIT saca todos los correos electrónicos del buzón, conecte un buzón que se use solo para TrakIT. En Gmail, TrakIT lee todos los correos electrónicos de la cuenta salvo el spam y la papelera, no solo la bandeja de entrada.

Pestaña Gmail

El soporte de TrakIT configura primero la conexión con Google para su instalación. Después, usted autoriza a TrakIT a leer la cuenta de Gmail.

1. Seleccione la pestaña Gmail.
2. Seleccione Authorise. TrakIT le lleva a Google.
3. Inicie sesión con la cuenta de Gmail que debe leer TrakIT, y permita el acceso que solicita TrakIT.
4. Google le devuelve a la página, que indica You have authorised your GMail account successfully.

Para que TrakIT deje de leer la cuenta, seleccione Disconnect y confirme. TrakIT retira su acceso en Google, olvida la cuenta e indica GMail deauthorised successfully. Si Google no lo confirma, TrakIT se desconecta igualmente y le pide que quite usted mismo TrakIT de las conexiones con terceros de la cuenta de Google.

Mensaje	Significa
Un error al seleccionar Authorise, en lugar de la página de Google	El soporte de TrakIT aún no ha configurado la conexión con Google para su instalación.
Invalid state parameter. Possible CSRF attack.	El regreso desde Google no coincidía con la solicitud que envió TrakIT, por ejemplo porque su sesión terminó entre medias. Vuelva a seleccionar Authorise.
Failed to obtain access token: …	Google se negó a dar acceso a TrakIT. Vuelva a seleccionar Authorise.

Pestaña Office 365

TrakIT lee un buzón compartido de Office 365 en segundo plano con acceso solo de aplicación, a través del registro de aplicación de Microsoft que usa su instalación para el inicio de sesión con Microsoft. La pestaña muestra su Application (Client) ID y su Tenant. Los configura el soporte de TrakIT: hasta entonces muestran (not configured).

Configurar el registro de aplicación

Un administrador de Microsoft 365 (Entra ID) hace esto una vez. La pestaña indica los mismos pasos en How to set up the app registration (app-only access).

1. En el Centro de administración de Microsoft Entra, abra el registro de aplicación cuyo identificador de aplicación (cliente) muestra la pestaña.
2. Cree un nuevo secreto de cliente y copie su valor de inmediato: Microsoft solo lo muestra una vez.
3. Añada el permiso Mail.ReadWrite de Microsoft Graph como permiso de aplicación, no como permiso delegado, y conceda el consentimiento de administrador para su inquilino.
4. Recomendado: restrinja la aplicación a ese único buzón, con una directiva de acceso a aplicaciones en Exchange Online, para que no pueda leer todos los buzones del inquilino.
5. Compruebe que el Tenant que muestra la pestaña es el ID de su propio inquilino, y no un valor compartido como «common». Si no lo es, pida al soporte de TrakIT que lo cambie.

Conectar el buzón

1. Seleccione la pestaña Office 365.
2. En Mailbox to read, introduzca la dirección del buzón.
3. En Client Secret, pegue el secreto. Junto a él, Configured o Not configured indica si hay un secreto guardado. Déjelo vacío para conservar el secreto guardado.
4. Seleccione Save. TrakIT indica Office 365 mailbox settings saved.
5. Seleccione Test Connection. TrakIT indica Connected successfully to y el buzón, o Connection failed: con la respuesta de Microsoft.

A partir de entonces, TrakIT lee el buzón cada 5 minutos. Para leerlo de inmediato, seleccione Check Now: TrakIT indica Office 365 mailbox checked. See the Action Log for details. Los correos electrónicos aparecen en la pestaña Emails Received, y TrakIT actúa sobre ellos en su siguiente ejecución. El registro de acciones de los usuarios muestra cuántos correos electrónicos se han leído, en sus entradas Check O365.

Para que TrakIT deje de leer el buzón, borre Mailbox to read y seleccione Save.

Mensaje	Significa
Please specify a mailbox address.	Introduzca Mailbox to read antes de Test Connection.
No Microsoft sign-in settings found …	Su instalación no tiene configurado el inicio de sesión con Microsoft. Consulte al soporte de TrakIT.
Connection failed: …	Microsoft denegó el acceso. Compruebe el secreto de cliente, el permiso Mail.ReadWrite y el consentimiento de administrador, y la dirección del buzón.

Quién puede usar esta página

Solo los administradores del sistema pueden abrir la página OAuth Inbox. La entrada de menú está en SysAdmin Pages, que solo ven los administradores del sistema.