Sandi aplikasi email: penyedia, syarat akun, dan koneksi Mailera

Tanggal pembaruan dan pembacaan dokumentasi resmi: 25 Oktober 2026. Matriks di bawah membantu Anda memilih jalur koneksi sesuai penyedia dan jenis akun.

Sandi aplikasi (app password) adalah kredensial untuk memberi aplikasi akses ke akun tanpa memasukkan sandi utama akun tersebut. Istilah kata sandi aplikasi email merujuk pada hal yang sama. Cara membuat dan mencabutnya mengikuti aturan penyedia, bukan aturan yang seragam untuk semua layanan.

Penyedia mana yang menyediakan sandi aplikasi?

Untuk menghubungkan akun ke Mailera, mulai dari jenis akunnya. Gmail pribadi dan Google Workspace perlu dipisahkan karena kebijakan organisasi dapat memengaruhi ketersediaan fitur. Outlook.com dan Microsoft 365 juga dipisahkan, meskipun keduanya menggunakan OAuth di Mailera.

Matriks ini membedakan ketentuan penyedia dari jalur koneksi Mailera. Jalur yang didukung belum tentu berhasil mengautentikasi akun Anda. Jika satu akun gagal, periksa konfigurasi dan kebijakan akun itu sebelum menyimpulkan bahwa penyedianya tidak mendukung sandi aplikasi.

Untuk penyedia lain, gunakan daftar penyedia Mailera. Jangan menganggap semua koneksi IMAP selalu membutuhkan sandi aplikasi; ikuti persyaratan penyedia yang dipilih.

Apa bedanya menu tersedia, kredensial dibuat, dan koneksi berhasil?

Empat tahap ini menjawab pertanyaan yang berbeda. Catat hasilnya secara terpisah agar Anda tahu bagian mana yang perlu diperbaiki.

Pada jalur IMAP/SMTP, server masuk dan server keluar memiliki pemeriksaan tersendiri. Mailera menjalankan keduanya melalui Uji & hubungkan ketika server keluar dikonfigurasi. Pengujian tersebut tidak mengirim email, jadi login SMTP yang berhasil bukan hasil uji pengiriman pesan.

Untuk Microsoft, gunakan jalur OAuth melalui Microsoft Graph. Jangan menjadikan autentikasi IMAP dengan sandi aplikasi sebagai syarat keberhasilan koneksi Microsoft di Mailera.

Jika Anda sedang membandingkan beberapa akun, gunakan urutan berikut:

1. Catat penyedia, jenis akun, paket, dan pengaturan keamanan. Gunakan kotak surat milik sendiri atau yang penggunaannya sudah diizinkan.
2. Baca petunjuk resmi penyedia dan simpan tanggal aksesnya bersama catatan akun.
3. Periksa menu sandi aplikasi, lalu catat apakah pembuatan kredensial berhasil. Jangan salin rahasianya ke catatan hasil.
4. Untuk jalur IMAP/SMTP, catat hasil autentikasi masuk dan keluar secara terpisah.
5. Hubungkan ke Mailera dan catat hasil deteksi folder serta status koneksinya.
6. Simpan tanggal uji, pesan kegagalan yang sudah disamarkan, perubahan konfigurasi, dan hasil pengujian ulang.

Hasilnya berlaku untuk akun dan konfigurasi yang Anda periksa. Akun lain pada penyedia yang sama bisa mengikuti paket atau kebijakan organisasi yang berbeda.

Syarat akun apa yang perlu diperiksa lebih dulu?

Gmail dan Google Workspace

Menurut petunjuk sandi aplikasi Google, verifikasi 2 langkah harus aktif. Namun, mengaktifkannya saja tidak selalu membuat menu sandi aplikasi muncul.

Google menyebut beberapa kemungkinan penyebab: verifikasi 2 langkah hanya menggunakan kunci keamanan, akun milik kantor atau sekolah, atau Advanced Protection aktif. Untuk Google Workspace, tanyakan kebijakan yang berlaku kepada administrator sebelum mengubah pengaturan keamanan.

Google menyarankan penggunaan “Sign in with Google” ketika aplikasi menyediakannya. Jalur koneksi Gmail di Mailera menggunakan sandi aplikasi; jangan menganggap setiap aplikasi menawarkan pilihan masuk yang sama.

iCloud Mail

Apple mensyaratkan autentikasi dua faktor pada Apple Account. Dalam petunjuk Apple, pengelolaan sandi aplikasi berada di “Sign-In and Security”, lalu “App-Specific Passwords”. Gunakan sandi khusus aplikasi tersebut untuk menghubungkan iCloud ke Mailera, bukan sandi utama Apple Account.

Yahoo Mail

Yahoo mendokumentasikan pilihan “Create app password” di bagian “External connections”. Namun, adanya fitur tersebut tidak berarti semua akun langsung memenuhi syarat membuatnya. Yahoo juga menyatakan bahwa layanan pelanggannya tidak dapat mengesampingkan proses penentuan kelayakan itu.

Jika kredensial sudah tersedia tetapi koneksi gagal, lanjutkan pemeriksaan melalui panduan pengaturan IMAP dan SMTP Yahoo. Pisahkan masalah pembuatan kredensial dari masalah konfigurasi server.

Zoho dan Fastmail

Untuk Zoho, pastikan akses IMAP sudah aktif. Jika verifikasi 2 langkah aktif, klien IMAP memerlukan sandi khusus aplikasi. Pengguna bisnis perlu memastikan bahwa kebijakan email organisasi mengizinkan akses IMAP.

Untuk Fastmail, periksa paket sebelum mencari menu sandi aplikasi. Paket Basic tidak mendukung klien email pihak ketiga, pembuatan sandi aplikasi, maupun akses IMAP/SMTP. Pada paket yang mendukung akses tersebut, buat sandi tersendiri untuk setiap aplikasi sesuai ketentuan Fastmail.

Outlook dan Microsoft 365

Di Mailera, keduanya menggunakan OAuth. Untuk Exchange Online, Microsoft telah menghapus Basic authentication pada IMAP dan menjelaskan dampaknya terhadap penggunaan sandi aplikasi. Kebijakan itu berlaku untuk Exchange Online; bukan berarti seluruh layanan Microsoft tidak pernah memiliki fitur sandi aplikasi.

Jika koneksi lama Anda berhenti bekerja, baca alasan sandi aplikasi Outlook gagal dan cara beralih ke OAuth. Mengganti sandi berulang kali tidak menyelesaikan ketidakcocokan metode autentikasi.

Bagaimana menghubungkan akun ke Mailera?

Mailera menghubungkan kotak surat yang sudah Anda miliki. Penambahan kotak surat memerlukan peran Admin atau Leader.

1. Buka Kotak surat, lalu pilih Tambah kotak surat.
2. Untuk penyedia sandi aplikasi, pilih Satu kotak surat dan isi Alamat email.
3. Periksa penyedia yang terdeteksi. Jika perlu, pilih penyedia yang benar melalui Atau pilih penyedia, lalu tekan Lanjutkan.
4. Baca Cara mendapatkan sandi aplikasi dan Yang perlu disiapkan. Pada Detail koneksi, isi kolom Sandi dengan sandi aplikasi, bukan sandi masuk utama.
5. Isi Nama tampilan jika diperlukan dan tentukan Grup kotak surat, lalu pilih Uji & hubungkan.

Untuk Outlook.com, Hotmail, atau Microsoft 365, pilih tab Masuk dengan Microsoft dan ikuti persetujuan OAuth di Microsoft. Jangan memasukkan sandi aplikasi ke jalur tersebut.

Pada pengujian koneksi IMAP/SMTP, perhatikan Login ke server masuk, Deteksi folder, dan Login ke server keluar. Jika tidak ada server keluar, tahap pengirimannya menampilkan Dilewati (tanpa server keluar).

Jika server masuk berhasil tetapi server keluar gagal, Mailera menyediakan Simpan khusus penerimaan. Pilihan itu berguna ketika Anda hanya perlu membaca pesan. Jika Anda membutuhkan fungsi kirim, pilih Edit detail, perbaiki konfigurasi, lalu Uji lagi.

Setelah koneksi berfungsi, Hooks dapat menjadi tahap berikutnya. Peristiwa message.received tersedia untuk pesan masuk, sedangkan mailbox.disconnected tersedia untuk koneksi yang terputus. Lihat integrasi pengembang Mailera untuk penggunaan lanjutan. Hooks tidak membuat sandi aplikasi atau menggantikan proses autentikasi.

Kesalahan umum: mengapa menu hilang atau koneksi gagal?

Gunakan gejala untuk menentukan pemeriksaan berikutnya, bukan langsung membuat ulang kredensial.

Simpan teks kegagalan yang benar-benar muncul, tetapi samarkan alamat akun dan rahasia. Bedakan kegagalan membuat sandi aplikasi dari kegagalan login: keduanya terjadi pada tahap yang berbeda dan membutuhkan tindakan yang berbeda pula.

Jika Anda membaca status melalui API untuk penyedia non-Microsoft, GET /mailboxes/{id}/status melaporkan status login berdasarkan sinkronisasi terakhir, bukan pemeriksaan login langsung. Perhatikan waktu sinkronisasi ketika menilai hasil setelah perubahan kredensial.

Bagaimana menjaga kredensial dan menangani pencabutan?

Jangan masukkan sandi aplikasi, token OAuth, kunci API, atau rahasia webhook ke tangkapan layar maupun catatan pengujian. Cabut kredensial uji ketika tidak lagi digunakan. Untuk koneksi yang tetap diperlukan, siapkan kredensial pengganti dan uji ulang autentikasinya.

Aturan pencabutan berbeda menurut penyedia:

• Google: perubahan sandi Google Account mencabut sandi aplikasi.
• Apple: perubahan atau reset sandi utama Apple Account mencabut semua sandi khusus aplikasi.
• Yahoo: perubahan sandi utama tidak membatalkan sandi aplikasi yang sudah ada. Hapus sandi aplikasi tersebut untuk membatalkannya.

Karena itu, mengganti sandi utama bukan prosedur pencabutan yang berlaku untuk semua penyedia. Ikuti pengelolaan kredensial pada akun masing-masing, dan lihat informasi keamanan Mailera saat meninjau akses integrasi Anda.

Jika kotak surat ini akan dibaca agen AI, gunakan kunci API dengan izin minimum. Perlakukan email masuk sebagai data yang tidak tepercaya, bukan instruksi. Agen tidak boleh mengikuti perintah di dalam email, dan tindakan mengirim perlu mendapat konfirmasi. Panduan sandi aplikasi untuk kotak surat agen membahas pemilihan akses untuk kebutuhan tersebut.

Batas Mailera yang perlu Anda ketahui

Mailera tidak membuat kotak surat atau alamat email baru, dan tidak dapat mengaktifkan sandi aplikasi yang dilarang penyedia atau administrator organisasi. Proton Mail dan Tuta tidak didukung. Pilih akun yang memenuhi syarat koneksi sebelum menyiapkan otomasi di atasnya.