Conectar Outlook.com o Microsoft 365

Usa esta página para conectar un buzón de Outlook.com, Hotmail o Microsoft 365 a mail. Inicias sesión en Microsoft en el navegador y apruebas el acceso. No escribes ninguna contraseña en mail, y la aplicación de Microsoft de WireCat ya viene incluida, así que no registras nada. Al terminar, mail lee tu correo en el almacén local y puede enviar desde esa dirección.

Antes de empezarCopy Anchor Link

1. Instala mail (instalación).
2. Solo Outlook.com: activa IMAP. Microsoft lo tiene desactivado por defecto (página de Microsoft). Con IMAP desactivado, el inicio de sesión en el navegador funciona pero el servidor de correo rechaza el token, así que saltarte este paso te saldrá caro:
   1. Abre outlook.live.com e inicia sesión.
   2. Elige Settings (la rueda dentada), luego "Mail" y "Forwarding and IMAP".
   3. Activa "Let devices and apps use IMAP" y pulsa "Save".
3. Cuenta de trabajo o de centro educativo de Microsoft 365: no hay nada que activar en el buzón. Lo que puede que un administrador tenga que permitir está en cuenta de trabajo o de centro educativo.

Iniciar sesiónCopy Anchor Link

Elige un nombre de perfil (aquí outlook) y usa tu propia dirección:

mail outlook session start --address [email protected]

mail abre el navegador en la página de inicio de sesión de Microsoft. Inicia sesión y aprueba el acceso. La pestaña dirá "Sign-in received; you can close this tab". Vuelve a la terminal: mail responde con el perfil, signed_in, el inicio de sesión (auth es oauth, provider es microsoft, client es wirecat), los permisos concedidos (IMAP.AccessAsUser.All y SMTP.Send) y las carpetas que encontró.

En un ordenador sin navegador, por ejemplo por SSH, añade --no-browser. mail imprime el enlace; ábrelo en cualquier ordenador, inicia sesión y la terminal termina igual.

Leer y enviarCopy Anchor Link

mail outlook sync                                  # INBOX and Sent by default
mail outlook schedule command mail-outlook --every 5m -- sync   # sync every 5 minutes
mail outlook search messages invoice               # search what sync stored

Enviar usa el mismo inicio de sesión, por el servidor SMTP de Microsoft con OAuth. mail guarda una copia en Sent. Los comandos están en el uso y en todos los comandos.

Cuenta de trabajo o de centro educativo (Microsoft 365)Copy Anchor Link

Usa el mismo comando con tu dirección de trabajo. Las cuentas personales de Outlook.com y Hotmail no se ven afectadas por esta sección.

Qué ves y por quéCopy Anchor Link

La aplicación de Microsoft de WireCat aún no tiene el editor verificado. Una cuenta de trabajo o de centro educativo pertenece a una organización (un "tenant"), y Microsoft no deja que los usuarios corrientes de otro tenant aprueben una aplicación multitenant sin editor verificado. En su lugar, el inicio de sesión se detiene en una página que dice "Need admin approval" o con el error AADSTS90094 (el administrador debe dar el consentimiento). Esa página la muestra el navegador, así que mail no imprime ningún código de error de Microsoft. No es un fallo de tu cuenta ni de mail. Un administrador debe actuar una vez, y después todos en la organización inician sesión como siempre. Microsoft describe la regla en Configure risk-based step-up consent.

Elige una de las dos opciones siguientes y envíasela a tu administrador.

Opción A: el administrador permite la aplicación de WireCat para la organizaciónCopy Anchor Link

El administrador abre este enlace en un navegador e inicia sesión con una cuenta de administrador. Sustituye {tenant} por el dominio de la organización (por ejemplo contoso.com) o por su id de tenant:

https://login.microsoftonline.com/{tenant}/v2.0/adminconsent?client_id=f7f05d3a-b948-4d50-b3ce-59c816ce69e9&scope=offline_access%20https://outlook.office.com/IMAP.AccessAsUser.All%20https://outlook.office.com/SMTP.Send&redirect_uri=http://localhost/callback

El formato viene del protocolo de consentimiento de administrador de Microsoft: el punto de conexión /v2.0/adminconsent con client_id, scope (separado por espacios, escrito %20 en un enlace) y un redirect_uri registrado para la aplicación. La cuenta necesita un rol que pueda dar el consentimiento en nombre de la organización, como Cloud Application Administrator o Privileged Role Administrator (roles).

El administrador ve la página de consentimiento de Microsoft para WireCat. Lista los tres permisos y marca al editor como no verificado. El administrador pulsa "Accept". Después Microsoft envía el navegador a http://localhost/callback; la pestaña puede mostrar un error de conexión porque nada escucha ahí, y es lo esperado. El consentimiento ya está guardado.

Para deshacerlo, el administrador abre el Microsoft Entra admin center, luego "Entra ID", "Enterprise apps", "All applications", WireCat, "Permissions", la pestaña "Admin consent", y pulsa "Revoke permission" en cada entrada. Para quitar la aplicación de la organización, el administrador elimina WireCat de "Enterprise apps" (pasos).

Opción B: la organización registra su propia aplicaciónCopy Anchor Link

Si tu organización no permite aplicaciones de terceros, un administrador registra una aplicación privada, que dentro de su propio tenant no necesita verificación del editor:

1. En el Microsoft Entra admin center, registra una aplicación. Plataforma: "Mobile and desktop applications". Redirect URI: http://localhost/callback. Pon "Allow public client flows" en Yes.

2. Copia el Application (client) ID.

3. Cada usuario lo configura una vez, en una terminal:

   Copy Text

   mail config set --defaults microsoft_client_id <application-client-id>

Los pasos completos, con los permisos que hay que listar, están en registro de la aplicación de Microsoft.

Enviar aún puede fallarCopy Anchor Link

La organización también puede tener "Authenticated SMTP" desactivado para tu buzón. Los valores de seguridad predeterminados, y las organizaciones creadas después de enero de 2020, lo tienen desactivado hasta que un administrador lo activa. Leer funciona igual; solo falla el envío.

Si no funcionaCopy Anchor Link

Más errores: solución de problemas.

Avanzado: tu propia aplicación de MicrosoftCopy Anchor Link

Úsalo solo si tu organización exige su propia aplicación. Regístrala (pasos): plataforma "Mobile and desktop applications", redirección http://localhost/callback sin puerto, nunca "Web". Después configura su id una vez, en una terminal:

mail config set --defaults microsoft_client_id <application-client-id>

Solo tú puedes configurarlo; a un agente por MCP se le rechaza.