Para administradores
← Todos los temas

Microsoft 365: conectar buzones

La conexión con la cuenta del buzón (cliente de la organización) y, además, un registro para buzones compartidos, y qué configurar en Microsoft Entra, paso a paso.

Para que el asistente pueda leer el correo en Microsoft 365 y crear borradores en él, necesita acceso a través de Microsoft Graph. Para ello, la organización registra una aplicación en su propio Microsoft Entra ID; draften no tiene una aplicación común a la que usted solo dé su consentimiento. Esto vale tanto para nuestro servicio como para una instalación en su propio servidor.

Todo lo que se describe aquí vale solo para cuentas profesionales y educativas de Microsoft 365. Las cuentas personales outlook.com, hotmail.com y live.com no se pueden conectar de ninguna forma: consulte Proveedores compatibles y límites.

Qué quiere y qué configurar

Qué quiereQué configurar
Los miembros inician sesión con su cuenta de Microsoft y cada uno tiene su propio buzónel cliente de la organización; con eso basta
Además, buzones compartidos (info@, ventas@) o un acceso a los buzones configurado de forma centralizada, sin sus propietariosademás, el registro de la organización
No quiere el inicio de sesión con cuenta de Microsoftlas personas inician sesión con la contraseña de la invitación y el correo lo conecta el registro de la organización (o IMAP)

Dos aplicaciones distintas

El cliente de la organización y el registro de la organización son dos aplicaciones independientes en Entra. Cada una hace algo distinto y una no sustituye a la otra:

Cliente de la organizaciónRegistro de la organización
Qué haceel inicio de sesión de los miembros con el botón Iniciar sesión con Microsoft y el botón Conectar Outlook en el buzón propioel acceso del asistente a los buzones sin que sus propietarios inicien sesión
Dónde en draftenOrganización › Inicio de sesión y acceso al correo › tarjeta Inicio de sesión con cuenta y conexión de buzonesOrganización › Inicio de sesión y acceso al correo › tarjeta Registros para buzones compartidos y gestión central
Quién lo configura en draftenel propietario de la organizaciónel propietario o un administrador de la organización
Permisos en Entradelegados (Delegated)de aplicación (Application)
Quién inicia sesión en el buzónel propietario de cada buzón, una veznadie
A qué buzones llegasolo a los que las personas conectan ellas mismasa los buzones del directorio (se puede restringir)
Buzones compartidosno: no tienen inicio de sesión propiosí
Cuando alguien deja la empresaal bloquearse su cuenta, el buzón se desconectano cambia nada

Son dos aplicaciones a propósito. El consentimiento para el cliente da derechos solo sobre los buzones que las personas conectan ellas mismas, nunca sobre el correo de toda la organización. El registro de la organización, en cambio, llega a todos los buzones, y por eso draften solo lo usa para el acceso a los buzones, no para el inicio de sesión. No los junte en una sola aplicación.

Cada buzón usa uno de los dos accesos. Puede tener ambas aplicaciones a la vez: por ejemplo, el cliente para el inicio de sesión y los buzones propios, y el registro para el buzón compartido info@.

Nunca dé a ninguna de las dos aplicaciones el permiso Mail.Send. draften no envía nada y sin ese permiso ni siquiera podría hacerlo: de eso se trata.

Cliente de la organización: inicio de sesión y Conectar Outlook

El cliente tiene permisos delegados: la aplicación solo puede hacer lo que puede hacer la persona que ha iniciado sesión, y solo en su propio buzón. Se crea una vez; después, los propietarios de los buzones se conectan por sí mismos y ya no necesitan al administrador de Entra.

En Microsoft Entra

Trabaja en el Microsoft Entra admin center, https://entra.microsoft.com, con la sesión iniciada con una cuenta de administrador de su directorio de Microsoft 365.

  1. Primero abra en draften Organización › Inicio de sesión y acceso al correo, la tarjeta Inicio de sesión con cuenta y conexión de buzones. Muestra dos redirect URI exactos para la dirección de su draften: terminan en /auth/callback y /mailboxes/connect/callback. Cópielos de allí; deben coincidir carácter por carácter.
  2. Abra la lista de registros de aplicaciones: en el menú de la izquierda, Entra ID → App registrations (en la versión anterior del menú, Identity → Applications → App registrations). Directamente: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  3. Arriba, haga clic en + New registration y rellene:
    • Name: por ejemplo draften – inicio de sesión,
    • Supported account types: Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI: en la lista desplegable Select a platform elija Web y, al lado, pegue la primera dirección de la tarjeta (termina en /auth/callback).

    Haga clic en Register. Se abre la página de la nueva aplicación.

  4. En la página Overview, copie el Application (client) ID y el Directory (tenant) ID (icono de copiar junto al valor).
  5. En el menú de la aplicación, a la izquierda, abra Authentication. En la plataforma Web, en la parte Redirect URIs, haga clic en Add URI, pegue la segunda dirección de la tarjeta (termina en /mailboxes/connect/callback) y, abajo, haga clic en Save.
  6. Certificates & secrets → pestaña Client secrets → + New client secret. Description, por ejemplo draften; en Expires elija la validez (24 meses como máximo) y haga clic en Add. En la tabla, copie enseguida el valor de la columna Value: solo se muestra ahora; el Secret ID no lo necesita draften. Anote también la fecha de la columna Expires.
  7. API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Escriba en la búsqueda y marque uno por uno openid, profile, email, offline_access, User.Read, Mail.ReadWrite y MailboxSettings.ReadWrite y, abajo, haga clic en Add permissions. User.Read suele estar en la lista desde la creación. Sin offline_access la conexión no se mantiene: draften no recibiría un token de actualización.
  8. En la misma página, haga clic en Grant admin consent for … y confirme con Yes. Todas las filas deben tener una marca verde en la columna Status. Si su organización no permite a los usuarios dar su consentimiento a aplicaciones, sin este paso la conexión terminaría con un mensaje de que se rechazó el consentimiento.

En draften

  1. El propietario de la organización abre Organización › Inicio de sesión y acceso al correo y, en la tarjeta Inicio de sesión con cuenta y conexión de buzones, rellena en Registro de Entra para «Iniciar sesión con Microsoft» y «Conectar Outlook» los valores Application (client) ID (paso 4) y Client secret (paso 6) y hace clic en Guardar.
  2. El inicio de sesión con cuenta de Microsoft lo activa en la misma página, en la tarjeta Cómo inician sesión los miembros: en ID del directorio de Microsoft (Entra) pega el Directory (tenant) ID. En cuanto la organización tiene el cliente y el ID del directorio, los miembros inician sesión con su cuenta de Microsoft y sus contraseñas dejan de funcionar: consulte Cómo inician sesión los miembros.
  3. El propietario del buzón abre la página del buzón y, en la tarjeta Acceso al correo, en la fila Conectar con la cuenta del buzón:, hace clic en Conectar Outlook. Inicia sesión con la cuenta de ese buzón (draften rechaza cualquier otra cuenta) y permite el acceso. El botón solo lo ve el propietario del buzón, y solo si la organización tiene el cliente; sin él, la tarjeta indica en lugar del botón que la conexión con la cuenta será posible cuando el propietario de la organización añada el cliente.
  4. Después, Probar la conexión.

Cuando un buzón se desconecta

Registro de la organización: acceso sin inicio de sesión

El registro tiene permisos de aplicación: el asistente entra en el buzón sin que nadie inicie sesión. Sirve para buzones compartidos y para organizaciones que quieren administrar el acceso a los buzones de forma centralizada. No tiene nada que ver con el inicio de sesión en draften.

Necesita una cuenta con el rol administrador global o administrador de roles con privilegios: solo ellos conceden el consentimiento para los permisos de aplicación de Microsoft Graph. El registro en sí también lo puede crear un administrador de aplicaciones.

En Microsoft Entra

Trabaja en el Microsoft Entra admin center, https://entra.microsoft.com.

  1. Abra la lista de registros de aplicaciones: en el menú de la izquierda, Entra ID → App registrations (en la versión anterior del menú, Identity → Applications → App registrations). Directamente: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. Arriba, haga clic en + New registration y rellene:
    • Name: por ejemplo draften – correo,
    • Supported account types: Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI: déjelo vacío.

    Haga clic en Register. Se abre la página de la nueva aplicación.

  3. En la página Overview, copie el Application (client) ID y el Directory (tenant) ID (icono de copiar junto al valor).
  4. En el menú de la aplicación, a la izquierda, Certificates & secrets → pestaña Client secrets → + New client secret. Description, por ejemplo draften; en Expires elija la validez (24 meses como máximo) y haga clic en Add. En la tabla, copie enseguida el valor de la columna Value: solo se muestra ahora; el Secret ID no lo necesita draften. Anote también la fecha de la columna Expires.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (no Delegated). Escriba en la búsqueda y marque Mail.ReadWrite y MailboxSettings.ReadWrite y, abajo, haga clic en Add permissions. MailboxSettings.ReadWrite solo sirve para el color de la categoría en Outlook; sin él, la categoría se añade sin color. Si quiere, añada User.Read.All: con él draften comprueba los alias del buzón; sin él, la prueba de la conexión indica en los alias que no puede comprobarlos.
  6. En la misma página, haga clic en Grant admin consent for … y confirme con Yes. Todas las filas deben tener una marca verde en la columna Status.

En draften

  1. Abra Organización › Inicio de sesión y acceso al correo, la tarjeta Registros para buzones compartidos y gestión central. Los registros los administran el propietario o los administradores de la organización.
  2. Sistema: Microsoft 365 (Entra). Rellene Nombre, Directory (tenant) ID, Application (client) ID, Client secret (el valor del paso 4, no su ID) y El secreto caduca. Haga clic en Añadir registro. El secreto se guarda cifrado y no se vuelve a mostrar.
  3. Un registro no conecta nada por sí solo. En la página de cada buzón, en la tarjeta Acceso al correo, elija este registro en Registro de la organización, haga clic en Aplicar y después en Probar la conexión. La selección solo la ve quien es a la vez propietario del buzón y propietario o administrador de la organización (el propietario de la organización es propietario de todos los buzones). El procedimiento completo con capturas lo muestra la guía «Añadir y conectar un buzón».

Con el buzón automático activado (Cómo inician sesión los miembros), un buzón nuevo se vincula solo al registro cuando hay exactamente uno activo para Microsoft 365.

Restringir a determinados buzones (opcional)

Un permiso de aplicación llega a todos los buzones del directorio; draften es quien vigila (un miembro no puede añadir un buzón; el asistente no envía ni elimina nada). Quien quiera además una barrera técnica restringe la aplicación a un grupo de seguridad con la política ApplicationAccessPolicy de Exchange Online. Necesita PowerShell y el rol de administrador de Exchange (o de administrador global).

Paso 1 — módulo de Exchange Online. Instálelo una sola vez: inicie PowerShell como administrador del equipo y escriba:

Install-Module ExchangeOnlineManagement

Paso 2 — grupo y política. Inicie sesión en Exchange Online, cree un grupo de seguridad con los buzones a los que draften puede acceder y una política que restrinja la aplicación solo a ese grupo. Sustituya <Application (client) ID> por el ID del registro del paso 3 de arriba y las direcciones, por las de sus buzones:

Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - buzones permitidos" -Alias draften-buzones -Type Security -Members buzon@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-buzones@firma.cz -AccessRight RestrictAccess -Description "draften: solo buzones permitidos"

Paso 3 — comprobación. Para un buzón del grupo, el comando debe mostrar AccessCheckResult : Granted; para un buzón fuera del grupo, Denied:

Test-ApplicationAccessPolicy -Identity buzon@firma.cz -AppId <Application (client) ID>

Después, añada cada buzón nuevo al grupo en el Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups) o con el comando Add-DistributionGroupMember -Identity draften-buzones@firma.cz -Member otro@firma.cz. Un buzón fuera del grupo falla en la prueba de la conexión con el error 403 (AppOnly AccessPolicy). La política suele aplicarse en menos de una hora; también hemos visto cuatro horas. Como alternativa más reciente, Microsoft ofrece RBAC for Applications en Exchange Online; por ahora no lo describimos.

Sustituir el secreto

El secreto tiene una validez limitada y draften no envía ningún aviso de su caducidad: la fecha de la tarjeta se vuelve amarilla 30 días antes y roja después. Póngase un recordatorio en el calendario. Antes de que caduque:

  1. En Entra, abra App registrations → su registro (por ejemplo, draften – correo) → Certificates & secrets → + New client secret y copie el nuevo Value (como en el paso 4 de arriba).
  2. En draften, en Organización › Inicio de sesión y acceso al correo, elija Nuevo secreto en el registro, pegue el nuevo valor y la nueva fecha.
  3. Elimine el secreto antiguo en Entra con el icono de la papelera de su fila.

Si el secreto caduca antes, los buzones se desconectan (invalid_client) y los asistentes los omiten. Después de sustituir el secreto, ejecute Probar la conexión en los buzones: una prueba superada vuelve a activar el buzón.

Errores de la prueba de la conexión

La prueba comprueba tres pasos: Acceso, Token y permiso y Lectura de la Bandeja de entrada. Cada uno muestra una marca o una cruz con el motivo:

En el mensajeQué significaQué hacer
AADSTS7000215, AADSTS7000222, invalid_clientclient secret incorrecto o caducadocrear un secreto nuevo y guardarlo en draften
AADSTS700016, AADSTS90002, unauthorized_clientApplication ID o Directory ID incorrectosvolver a copiar ambos ID desde Overview
AADSTS65001, AADSTS650057, consent_requiredfalta el consentimiento del administradorGrant admin consent en la aplicación
token sin Mail.ReadWriteel permiso falta o no tiene consentimientoañadir el permiso y conceder el consentimiento
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008la conexión con la cuenta caducó o se revocóVolver a conectar Outlook
HTTP 403 AppOnly AccessPolicyel buzón no está en el grupo de la política de accesoañadirlo al grupo y esperar
HTTP 404ese buzón no existecomprobar la dirección; el buzón debe tener Exchange Online
HTTP 401otro directorio, o falta un permisocomprobar el Directory ID y los permisos

Otros errores se describen en Solución de problemas.

Versión en texto