Integrasi Layanan SMTP Email

Informasi Layanan

Layanan ini disediakan oleh Dinas Komunikasi, Informatika, dan Statistik Kota Denpasar untuk memfasilitasi pengiriman email transaksional dari aplikasi Perangkat Daerah menggunakan domain resmi @denpasarkota.go.id.

1. Pengantar

Layanan SMTP (Simple Mail Transfer Protocol) ini ditujukan untuk aplikasi yang membutuhkan fitur pengiriman notifikasi otomatis, seperti:

• Kode OTP (One Time Password).
• Link Reset Password.
• Notifikasi Status Layanan/Pendaftaran.
• Bukti Transaksi Digital.

Keuntungan Menggunakan SMTP Resmi:

1. Trust: Email dikirim dari domain pemerintah, meningkatkan kepercayaan warga.
2. Deliverability: Reputasi server dijaga agar tidak masuk folder spam.
3. Audit: Sentralisasi log pengiriman untuk keamanan data.

---

2. Alur Permintaan Akses

Sebelum melakukan integrasi, ikuti langkah administratif berikut:

1. Surat Permohonan: OPD terkait mengirim surat ke Dinas Kominfo berisi Nama Aplikasi, Tujuan Penggunaan, dan Estimasi Volume Email.
2. Verifikasi: Tim Infrastruktur melakukan pengecekan keamanan aplikasi.
3. Serah Terima: Kredensial akan dikirimkan secara privat kepada Technical Contact (Pengembang/IT Internal).

Formulir Permohonan

Untuk mempercepat proses, silakan unduh dan lengkapi template formulir permohonan melalui tautan berikut: Download Template Form Permohonan STMP User

Keamanan Kredensial

Kredensial SMTP bersifat RAHASIA. Jangan pernah membagikannya di grup chat terbuka atau menyimpannya di repositori publik (seperti GitHub Public).

---

3. Konfigurasi Teknis

Gunakan parameter berikut untuk menghubungkan aplikasi Anda ke Mail Server Denpasar Kota.

Parameter Server

Parameter	Nilai (Value)	Keterangan
SMTP Host	webmail.denpasarkota.go.id	Server utama.
SMTP Port	465	Port direkomendasikan (SSL).
Encryption	SSL	Wajib diaktifkan.
Auth	True	Membutuhkan autentikasi user/pass.
Username	akun@denpasarkota.go.id	Diberikan oleh Admin Kominfo.
Password	******	Password khusus aplikasi.

Contoh Konfigurasi (.env)

Berikut adalah contoh implementasi pada file environment variables:

Laravel / PHP

.env

MAIL_MAILER=smtp
MAIL_HOST=webmail.denpasarkota.go.id
MAIL_PORT=465
MAIL_USERNAME=nama_aplikasi@denpasarkota.go.id
MAIL_PASSWORD=PasswordRahasiaAnda
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=nama_aplikasi@denpasarkota.go.id
MAIL_FROM_NAME="Layanan Denpasar - Pemkot Denpasar"

Node.js / Umum

SMTP_HOST=webmail.denpasarkota.go.id
SMTP_PORT=465
SMTP_SECURE=true
SMTP_USER=nama_aplikasi@denpasarkota.go.id
SMTP_PASS=PasswordRahasiaAnda

Troubleshooting 550 Error

Pastikan MAIL_FROM_ADDRESS (pengirim) sama persis dengan MAIL_USERNAME. Server akan menolak (reject) jika Anda mencoba mengirim email mengatasnamakan alamat lain (spoofing protection).

4. Ketentuan Penggunaan (SOP)

Agar layanan tetap stabil dan IP server tidak terkena blacklist, harap patuhi aturan berikut

danger

DILARANG KERAS Menggunakan akun SMTP ini untuk Broadcast Marketing, Newsletter, atau Pengumuman Massal ke ribuan email sekaligus. Pelanggaran akan menyebabkan akun dibekukan secara otomatis.

• Transactional Only: Hanya gunakan untuk email yang dipicu oleh aksi pengguna (user triggered).
• Queue System: Aplikasi wajib menggunakan mekanisme antrean (Job Queue seperti Redis/Database) agar user tidak menunggu loading saat email dikirim.
• Exception Handling: Aplikasi harus bisa menangani kondisi jika server SMTP sedang maintenance (tidak boleh crash).

5. Bantuan Teknis

Jika mengalami kendala koneksi atau autentikasi, silakan cek tabel berikut sebelum menghubungi admin

Masalah	Solusi Mandiri
Connection Timeout	Cek firewall server aplikasi Anda, pastikan outgoing port 465 dibuka.
Auth Failed	Pastikan tidak ada spasi di akhir password saat copy-paste.
Certificate Error	Pada localhost, pastikan konfigurasi SSL/CA Root sudah benar.

Jika masalah berlanjut, hubungi Tim Infrastruktur Jaringan melalui tiket aduan internal.