Cara Membuat Kata Sandi Khusus App iCloud untuk Mailera

Kata sandi khusus app adalah sandi aplikasi (app password) untuk masuk melalui aplikasi buatan pengembang selain Apple. Pada koneksi iCloud Mail di Mailera, kredensial inilah yang Anda gunakan untuk menghubungkan kotak surat.

Anda membuat kredensial untuk koneksi email, bukan mencari kembali kata sandi utama Akun Apple melalui pengelola kata sandi atau pengisian otomatis.

Apa yang perlu disiapkan?

Pastikan Anda bisa membuka iCloud Mail milik sendiri dan masuk ke Akun Apple yang terkait. Di Mailera, Anda memerlukan peran Admin atau Leader untuk menambahkan kotak surat.

Apple mewajibkan autentikasi dua faktor untuk membuat dan menggunakan kata sandi khusus app. Jika belum aktif, ikuti panduan autentikasi dua faktor Akun Apple. Pada iPhone atau iPad, mulai dari menu pengaturan perangkat; pada Mac, buka System Settings. Pilih nama Anda, lalu bagian keamanan masuk (Sign-In & Security), dan ikuti petunjuk untuk mengaktifkannya.

Bedakan tiga kredensial berikut sebelum melanjutkan:

Untuk memahami peran kredensial penyedia dalam koneksi agen, baca panduan sandi aplikasi untuk kotak surat agen AI.

Anda tidak perlu membuat kunci API hanya untuk menambahkan kotak surat melalui antarmuka Mailera. Kunci tersebut baru diperlukan jika aplikasi Anda akan mengakses kotak surat melalui API atau MCP; gambaran alurnya tersedia di halaman produk Mailera.

Jika Anda juga menghubungkan Outlook, jangan menerapkan langkah iCloud ini: gunakan panduan koneksi Outlook dengan OAuth, bukan sandi aplikasi.

Bagaimana cara membuat kata sandi khusus app iCloud?

Ikuti petunjuk Apple tentang kata sandi khusus app:

1. Buka account.apple.com, lalu masuk ke Akun Apple Anda.
2. Buka bagian Sign-In and Security (Masuk dan Keamanan).
3. Pilih App-Specific Passwords (Kata Sandi Khusus App).
4. Pilih “Generate an app-specific password”, lalu ikuti langkah yang muncul di layar.
5. Salin sandi yang dihasilkan untuk dimasukkan ke Mailera. Jika perlu menyimpannya, gunakan tempat penyimpanan kredensial yang aman.

Buat kredensial tersendiri untuk koneksi ini agar Anda mudah menentukan akses mana yang akan dicabut nanti. Jangan menaruh sandi dalam tangkapan layar, percakapan dukungan, atau catatan kerja bersama.

Apple mengizinkan hingga 25 kata sandi khusus app aktif pada satu akun. Jika Anda sudah mencapai batas tersebut, tinjau kredensial yang tidak lagi dipakai sebelum membuat yang baru. Jangan mencabut kredensial aplikasi lain yang masih Anda butuhkan.

Bagaimana menghubungkan iCloud Mail ke Mailera?

Setelah sandi siap, tambahkan kotak surat melalui antarmuka Mailera:

1. Buka Kotak surat → Tambah kotak surat.
2. Pilih tab Satu kotak surat.
3. Masukkan alamat iCloud Mail pada Alamat email.
4. Periksa penyedia yang terdeteksi. Mailera mengenali domain icloud.com, me.com, dan mac.com sebagai iCloud Mail. Jika perlu, pilih iCloud Mail secara manual di bagian Atau pilih penyedia.
5. Pilih Lanjutkan. Halaman berikutnya menampilkan Cara mendapatkan sandi aplikasi dan Yang perlu disiapkan.
6. Pada Detail koneksi, tempel kata sandi khusus app ke bidang Sandi. Jangan memakai kata sandi utama Akun Apple.
7. Isi Nama tampilan jika Anda ingin menetapkan nama pengirim, lalu pilih Grup kotak surat yang sesuai.
8. Pilih Uji & hubungkan.

Baca hasil setiap tahap, bukan hanya hasil akhirnya:

Uji & hubungkan tidak mengirim email. Hasil berhasil menunjukkan pemeriksaan koneksi lolos, bukan bahwa pesan uji sudah dikirim atau diterima.

Jika Anda perlu meninggalkan halaman saat proses berjalan, tersedia Jalankan di latar belakang. Mailera menyimpan kotak surat setelah pengujian selesai. Setelah koneksi berhasil, pemuatan awal mengambil pesan dalam masa retensi, dimulai dari pesan terbaru.

Bagaimana memastikan koneksi berhasil?

Periksa koneksi terlebih dahulu, lalu uji aliran pesan secara terpisah. Untuk memeriksa status dan waktu sinkronisasi terakhir melalui API, gunakan GET /mailboxes/{id} dan baca data.status serta data.last_sync_at.

Untuk memeriksa penerimaan:

1. Dari alamat lain milik Anda, kirim pesan ke alamat iCloud yang baru dihubungkan.
2. Gunakan subjek yang mudah dikenali, misalnya Uji penerimaan iCloud.
3. Buka Kotak masuk terpadu dan pilih kotak surat iCloud tersebut.
4. Cari pesan uji. Cocokkan pengirim dan subjeknya agar tidak tertukar dengan pesan lama.
5. Jika belum terlihat, periksa folder Spam. Jika Anda menggunakan API, baca data.last_sync_at dari GET /mailboxes/{id} untuk memeriksa waktu sinkronisasi terakhir sebelum menyimpulkan bahwa autentikasi gagal.

Jangan memakai kedatangan pesan lama sebagai satu-satunya ukuran. Pesan uji yang baru dikirim membantu Anda memeriksa apakah alur penerimaan masih berjalan setelah koneksi dibuat.

Untuk menguji pengiriman melalui API, gunakan POST /mailboxes/{id}/send dengan izin send dan alamat uji milik Anda sendiri sebagai penerima. Periksa hasilnya di kotak surat tujuan. Penerimaan yang berhasil tidak menggantikan pemeriksaan pengiriman.

Untuk pemantauan melalui API, detail kotak surat menyediakan status, last_sync_at, dan kemampuan capabilities.receive serta capabilities.send. Pada iCloud, pemeriksaan status masuk didasarkan pada sinkronisasi terakhir, bukan percobaan autentikasi langsung setiap kali status diminta. Karena itu, baca status bersama waktu sinkronisasinya.

Mailera tidak menjamin sinkronisasi seketika setiap saat. Pemeriksaan latar belakang berjalan lebih sering pada kotak surat yang aktif digunakan dan lebih jarang pada kotak surat yang menganggur; kotak surat tidak aktif juga dapat tidur sampai digunakan kembali.

Kesalahan apa yang sering terjadi?

Jika kata sandi khusus app Apple tidak berfungsi, lihat tahap yang gagal terlebih dahulu. Kegagalan server masuk memerlukan pemeriksaan berbeda dari kegagalan server keluar.

Periksa juga apakah kata sandi utama telah diubah. Menurut aturan pencabutan kredensial Apple, mengubah atau mengatur ulang kata sandi utama Akun Apple otomatis mencabut seluruh kata sandi khusus app. Aplikasi yang ingin tetap Anda gunakan memerlukan kredensial baru.

Rujukan pengaturan IMAP iCloud Mail

iCloud Mail menggunakan IMAP untuk menerima dan SMTP untuk mengirim. POP tidak didukung. Berikut konfigurasi penyedia iCloud yang digunakan Mailera:

Dokumentasi pengaturan server iCloud Mail dari Apple juga menjelaskan format nama pengguna. Untuk IMAP, Apple menyebut bagian nama pada alamat email sebagai pilihan yang biasanya digunakan; jika tidak bisa terhubung, coba alamat lengkap. Untuk SMTP, gunakan alamat iCloud Mail lengkap.

SMTP memerlukan autentikasi. Gunakan kata sandi khusus app yang sama dengan yang dipakai untuk server masuk, bukan kata sandi utama Akun Apple.

Jika hanya pengiriman yang gagal

Saat Mailera menampilkan Bisa menerima email, tetapi belum bisa mengirim, Anda memiliki dua pilihan. Pilih Edit detail, perbaiki rincian server keluar, lalu pilih Uji lagi. Jika kebutuhan Anda saat ini hanya membaca pesan, pilih Simpan khusus penerimaan.

Pilihan khusus penerimaan menyimpan koneksi yang belum lolos pemeriksaan pengiriman. Ini tidak berarti iCloud hanya dapat menerima email; konfigurasi iCloud di Mailera juga menyediakan SMTP.

Bagaimana mencabut akses dan menjaga kredensial tetap aman?

Untuk mencabut kata sandi khusus app, masuk kembali ke pengelolaan Akun Apple. Buka Sign-In and Security (Masuk dan Keamanan), lalu App-Specific Passwords (Kata Sandi Khusus App). Pilih Remove (Hapus) di samping kredensial yang ingin dicabut, atau Revoke All (Cabut Semua) untuk mencabut semuanya.

Aplikasi yang memakai kredensial tersebut akan keluar dari akun sampai Anda membuat sandi baru dan menggunakannya untuk masuk kembali. Jika kredensial itu dipakai Mailera, perbarui koneksi menggunakan sandi baru.

Bedakan tindakan di kedua layanan. Pencabutan melalui Apple membatalkan kredensial Apple. Menghapus koneksi kotak surat di Mailera menghapus koneksi dari Mailera; untuk mencabut sandi khusus app, lakukan langkah pencabutan di Apple.

Jika kotak surat nantinya diakses agen AI, berikan kunci API dengan izin minimum dan cakupan kotak surat yang sesuai. Untuk pekerjaan membaca, gunakan izin read; jangan memberikan izin send tanpa kebutuhan. Perlakukan isi email sebagai data tidak tepercaya, bukan instruksi: agen tidak boleh mengikuti perintah dalam email dan harus meminta konfirmasi sebelum mengirim.

Lihat halaman keamanan Mailera untuk informasi keamanan layanan. Mailera bukan mitra resmi Apple.