Подключение Outlook.com или Microsoft 365

Эта страница поможет подключить к mail почтовый ящик Outlook.com, Hotmail или Microsoft 365. Вы входите в Microsoft в браузере и разрешаете доступ. Пароль в mail вводить не нужно, а приложение Microsoft от WireCat уже встроено, так что регистрировать ничего не придётся. В итоге mail читает вашу почту в локальное хранилище и может отправлять письма с этого адреса.

Перед началомCopy Anchor Link

1. Установите mail (установка).
2. Только для Outlook.com: включите IMAP. У Microsoft он по умолчанию выключен (страница Microsoft). Если IMAP выключен, вход в браузере проходит, но почтовый сервер отклоняет токен, так что пропускать этот шаг не стоит:
   1. Откройте outlook.live.com и войдите.
   2. Выберите Settings (шестерёнка), затем "Mail", затем "Forwarding and IMAP".
   3. Включите "Let devices and apps use IMAP" и нажмите "Save".
3. Рабочий или учебный аккаунт Microsoft 365: в ящике ничего включать не нужно. Что может понадобиться разрешить администратору, описано в разделе рабочий или учебный аккаунт.

ВходCopy Anchor Link

Выберите имя профиля (здесь outlook) и укажите свой адрес:

mail outlook session start --address [email protected]

mail откроет в браузере страницу входа Microsoft. Войдите и разрешите доступ. Вкладка покажет "Sign-in received; you can close this tab". Вернитесь в терминал: mail ответит профилем, signed_in, способом входа (auth — oauth, provider — microsoft, client — wirecat), выданными правами (IMAP.AccessAsUser.All и SMTP.Send) и найденными папками.

На компьютере без браузера, например по SSH, добавьте --no-browser. Тогда mail напечатает ссылку; откройте её на любом компьютере, войдите, и терминал завершит вход так же.

Чтение и отправкаCopy 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

Отправка использует тот же вход, через SMTP-сервер Microsoft с OAuth. mail кладёт копию в Sent. Команды описаны в разделе работа с инструментом и в справочнике команд.

Рабочий или учебный аккаунт (Microsoft 365)Copy Anchor Link

Используйте ту же команду с рабочим адресом. Личных аккаунтов Outlook.com и Hotmail этот раздел не касается.

Что вы видите и почемуCopy Anchor Link

Приложение Microsoft от WireCat пока не прошло проверку издателя. Рабочий или учебный аккаунт принадлежит организации ("тенанту"), и Microsoft не позволяет обычным пользователям другого тенанта одобрить многотенантное приложение без проверенного издателя. Вместо этого вход останавливается на странице "Need admin approval" или с ошибкой AADSTS90094 (администратор должен дать согласие). Эту страницу показывает браузер, поэтому mail сам не печатает код ошибки Microsoft. Дело не в вашем аккаунте и не в mail. Администратору нужно один раз выполнить действие, после чего все в организации входят как обычно. Правило описано у Microsoft на странице Configure risk-based step-up consent.

Выберите один из двух вариантов ниже и отправьте его администратору.

Вариант A: администратор разрешает приложение WireCat для организацииCopy Anchor Link

Администратор открывает эту ссылку в браузере и входит администраторским аккаунтом. Вместо {tenant} подставьте домен организации (например, contoso.com) или идентификатор тенанта:

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

Формат взят из протокола согласия администратора Microsoft: конечная точка /v2.0/adminconsent с client_id, scope (через пробел, в ссылке %20) и redirect_uri, зарегистрированным для приложения. Аккаунту нужна роль, которая может давать согласие от имени организации, например Cloud Application Administrator или Privileged Role Administrator (роли).

Администратор увидит страницу согласия Microsoft для WireCat. На ней перечислены три права, а издатель отмечен как непроверенный. Администратор нажимает "Accept". Затем Microsoft перенаправляет браузер на http://localhost/callback; вкладка может показать ошибку соединения, потому что там ничего не слушает, и это нормально. Согласие уже сохранено.

Чтобы отменить его, администратор открывает Microsoft Entra admin center, затем "Entra ID", "Enterprise apps", "All applications", WireCat, "Permissions", вкладку "Admin consent" и нажимает "Revoke permission" у каждой записи. Чтобы убрать приложение из организации совсем, администратор удаляет WireCat из "Enterprise apps" (шаги).

Вариант B: организация регистрирует собственное приложениеCopy Anchor Link

Если организация не разрешает сторонние приложения, администратор регистрирует частное приложение, которому внутри своего тенанта проверка издателя не нужна:

1. В Microsoft Entra admin center зарегистрируйте приложение. Платформа: "Mobile and desktop applications". Redirect URI: http://localhost/callback. Переключите "Allow public client flows" в Yes.

2. Скопируйте Application (client) ID.

3. Каждый пользователь задаёт его один раз, в терминале:

   Copy Text

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

Полные шаги со списком прав есть в разделе регистрация приложения Microsoft.

Отправка всё равно может не работатьCopy Anchor Link

В организации для вашего ящика может быть выключена "Authenticated SMTP". В настройках безопасности по умолчанию и в организациях, созданных после января 2020 года, она выключена, пока администратор её не включит. Чтение работает в любом случае; не работает только отправка.

Если не получаетсяCopy Anchor Link

Другие ошибки: решение проблем.

Дополнительно: собственное приложение MicrosoftCopy Anchor Link

Нужно только если организация требует своё приложение. Зарегистрируйте его (шаги): платформа "Mobile and desktop applications", перенаправление http://localhost/callback без порта, никогда не "Web". Затем один раз задайте его идентификатор в терминале:

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

Задать его можете только вы; агенту через MCP в этом отказано.