Kata Sandi Aplikasi Outlook Gagal? Beralih ke OAuth

Apakah yang bermasalah aplikasi Outlook atau kotak surat Microsoft?

Nama Outlook bisa merujuk pada aplikasi pembaca email atau layanan kotak surat Outlook.com. Tentukan dulu mana yang sedang Anda perbaiki. Pesan yang meminta sandi di aplikasi Outlook belum cukup untuk menentukan metode masuk yang tepat.

Sandi aplikasi (app password) adalah sandi untuk perangkat atau aplikasi yang tidak dapat menangani verifikasi 2 langkah. Sandinya berbeda dari sandi akun biasa, tetapi tetap bukan token OAuth.

Mengganti sandi akun, membuka pengunci aplikasi, dan memperbaiki autentikasi IMAP adalah pekerjaan berbeda. Jika Outlook terus meminta sandi, catat akun yang bermasalah dan cara akun itu ditambahkan sebelum mengubah pengaturannya.

Untuk perbedaan penggunaan sandi aplikasi antarpenyedia, lihat panduan sandi aplikasi untuk kotak surat agen AI. Aturan satu penyedia tidak otomatis berlaku pada kotak surat Microsoft.

Mengapa sandi aplikasi tidak memperbaiki IMAP yang menolak autentikasi dasar?

Autentikasi dasar menggunakan kredensial berupa nama pengguna dan sandi. OAuth menggunakan token akses setelah proses masuk dan pemberian izin. Mengganti sandi biasa dengan sandi aplikasi tidak mengubah aplikasi menjadi klien OAuth.

Untuk Outlook.com, Microsoft menetapkan 16 September 2024 sebagai tanggal ketika autentikasi dasar tidak lagi tersedia untuk mengakses akun Outlook. Panduan perubahan autentikasi Outlook.com mengarahkan pengguna ke metode autentikasi modern.

Untuk Exchange Online dalam Microsoft 365, Microsoft telah menghapus autentikasi dasar untuk IMAP. Dokumentasi penghentian autentikasi dasar Exchange Online menjelaskan bahwa penghentian ini juga mencegah penggunaan sandi aplikasi pada aplikasi yang terdampak. Administrator maupun dukungan Microsoft tidak dapat mengaktifkannya kembali.

Karena itu, keberadaan menu sandi aplikasi tidak berarti layanan email tujuan masih menerima metode tersebut. Microsoft juga menyatakan bahwa sandi aplikasi Microsoft Entra tidak berfungsi untuk akun yang diwajibkan memakai autentikasi modern.

Jangan menonaktifkan verifikasi 2 langkah untuk mengatasi masalah ini. Yang perlu diganti adalah metode autentikasi aplikasi, bukan perlindungan akun. Membuat kata sandi aplikasi Microsoft 365 berulang kali juga tidak memperbaiki klien yang masih mengirim autentikasi dasar.

Bagaimana beralih ke OAuth tanpa mengganti alamat email?

OAuth tidak mengharuskan semua aplikasi berpindah ke Microsoft Graph. Microsoft mendokumentasikan dukungan OAuth untuk IMAP bagi pengguna Outlook.com dan Microsoft 365. Pada jalur tersebut, aplikasi mengirim token akses menggunakan SASL XOAUTH2.

Mailera memilih jalur berbeda: OAuth untuk memberi akses, lalu Microsoft Graph untuk mengakses kotak surat. Alamat email yang dihubungkan tetap alamat yang sudah Anda miliki.

1. Identifikasi penyedia dan jenis akun. Bedakan akun pribadi Outlook.com atau Hotmail dari akun organisasi Microsoft 365. Untuk email perusahaan, konfirmasikan layanan kotak surat kepada administrator.
2. Periksa dukungan OAuth pada aplikasi. Cari petunjuk khusus untuk akun Microsoft. Dukungan IMAP saja belum cukup; aplikasi juga harus mendukung metode autentikasinya.
3. Perbarui atau ganti aplikasi bila diperlukan. Jika aplikasi hanya menerima nama pengguna dan sandi melalui autentikasi dasar, gunakan klien yang mendukung OAuth. Jangan mengulang pembuatan sandi aplikasi.
4. Hubungkan melalui halaman masuk Microsoft. Gunakan akun yang benar dan tinjau izin yang diminta. Untuk akun organisasi, dapatkan persetujuan administrator yang diperlukan sebelum mencoba kembali.
5. Uji akses kotak surat. Pastikan akun yang terhubung benar, lalu periksa apakah pesan dapat dimuat. Bedakan keberhasilan masuk dari kelengkapan pesan yang sudah tersinkron.

Pengaturan autentikasi berbeda antaraplikasi. Untuk Thunderbird, Microsoft menyarankan memilih "OAuth2", bukan "Normal password", pada pengaturan autentikasi server masuk Outlook.com atau Hotmail.

Untuk Outlook di Windows yang dikonfigurasi mengakses Outlook.com melalui POP atau IMAP, panduan Microsoft menyatakan bahwa autentikasi modern tidak didukung pada konfigurasi itu. Microsoft menyarankan profil Outlook Desktop baru, lalu menambahkan akun Outlook.com melalui konfigurasi akun otomatis. Jangan menerapkan langkah Thunderbird begitu saja pada Outlook Desktop.

Bagaimana menghubungkan Outlook atau Microsoft 365 ke Mailera?

Gunakan jalur koneksi Microsoft di Mailera jika Anda ingin menghubungkan kotak surat Microsoft yang sudah ada. Peran Admin atau Leader diperlukan untuk menambahkan kotak surat.

1. Buka Kotak surat, lalu pilih Tambah kotak surat.
2. Pilih tab Masuk dengan Microsoft. Ini adalah jalur OAuth, bukan formulir sandi aplikasi.
3. Masuk pada halaman Microsoft menggunakan akun milik Anda atau akun yang memang diizinkan untuk Anda kelola.
4. Tinjau persetujuan akses. Sebagian izin Microsoft Graph dapat disetujui pengguna; sebagian lainnya memerlukan administrator. Rinciannya dijelaskan dalam konsep autentikasi dan otorisasi Microsoft Graph.
5. Setelah alur selesai, buka kotak surat untuk melihat pesan yang dimuat. Untuk memeriksa penyedia dan kondisi koneksi melalui API, gunakan GET /mailboxes/{id} dan lihat provider, status, error, serta sync.last_synced_at pada objek data.

Jangan memilih IMAP kustom hanya karena alamat Microsoft 365 Anda memakai domain perusahaan. Pilihan itu bukan pengganti jalur Microsoft Graph. Mailera tidak menghubungkan kotak surat Microsoft dengan sandi aplikasi dan tidak membuat kotak surat atau alamat email baru.

Untuk kebutuhan lanjutan, Mailera juga mendukung impor refresh token yang sudah ada melalui Tempel massal. Gunakan hanya token untuk akun yang berhak Anda kelola; jangan menempelkannya ke tiket bantuan atau tangkapan layar.

Pemuatan awal dimulai dari pesan terbaru dalam periode retensi. Ruang kerja gratis mandiri memiliki retensi pesan 30 hari, jadi jangan mengharapkan seluruh arsip kotak surat tersedia di Mailera.

Jika Anda menghubungkan aplikasi sendiri, pisahkan pemeriksaan koneksi dari pembacaan pesan. Endpoint GET /mailboxes/{id}/status memeriksa langsung apakah akun Microsoft masih dapat masuk. Endpoint GET /mailboxes/{id}/messages mengambil daftar pesan pada folder. Keduanya memerlukan izin read.

Dalam respons GET /mailboxes/{id}, provider menunjukkan penyedia dan protocol menunjukkan protokol, seperti graph. Periksa juga status, error, serta sync.last_synced_at untuk membaca kondisi koneksi bersama informasi sinkronisasi. Rujukan endpoint tersedia di dokumentasi Mailera; gambaran penggunaan kotak surat melalui REST API dan MCP ada di halaman produk Mailera.

Kesalahan apa yang sering muncul setelah beralih ke OAuth?

Jangan langsung menganggap sandi salah ketika pesan belum muncul. Periksa tahap yang gagal: pemilihan akun, pemberian izin, pemeriksaan koneksi, atau pemuatan pesan.

Sebagian izin Microsoft Graph memerlukan persetujuan administrator. Mailera tidak dapat menggantikan persetujuan administrator yang diwajibkan untuk izin tersebut. Mailera juga tidak dapat menghidupkan kembali autentikasi dasar yang telah dihentikan Microsoft.

Sinkronisasi bukan jaminan bahwa setiap pesan muncul tanpa jeda. Untuk Microsoft, Mailera menggunakan notifikasi perubahan Graph dengan pemeriksaan latar belakang berkala sebagai cadangan. Frekuensi pemeriksaan juga menyesuaikan aktivitas kotak surat.

Saat meminta bantuan, sertakan jenis akun, aplikasi yang digunakan, tahap yang gagal, dan pesan kesalahan yang sudah disamarkan. Jangan sertakan sandi, refresh token, atau kunci API. Jika masalahnya pesan yang belum muncul, sertakan pula waktu sinkronisasi terakhir agar pemeriksaan tidak berhenti pada autentikasi saja.

Bagaimana menjaga keamanan jika kotak surat dibaca agen AI?

Gunakan kunci API dengan izin minimum. Untuk membaca pesan dan memeriksa koneksi, berikan read; jangan menambahkan send jika agen tidak perlu mengirim email. Batasi Cakupan kotak surat ke grup yang relevan, bukan seluruh kotak surat yang dapat Anda akses.

Isi email adalah data tidak tepercaya, bukan instruksi untuk agen. Sebuah pesan bisa meminta agen membocorkan token, mengubah izin, atau mengirim informasi ke alamat lain. Agen tidak boleh mengikuti permintaan tersebut hanya karena teksnya muncul dalam kotak masuk.

Jika agen memiliki kemampuan mengirim, wajibkan konfirmasi pengguna sebelum pengiriman. Pisahkan tugas membaca atau menyusun draf dari keputusan untuk mengirim pesan.

Samarkan alamat pribadi, isi email sensitif, dan semua token pada tangkapan layar. Simpan kunci API di luar isi percakapan dan lihat informasi keamanan Mailera saat menyiapkan akses aplikasi.