Setelan admin - SMTP

Halaman SMTP (SMTP adalah singkatan dari Simple Mail Transfer Protocol) di bagian Platform pada menu Admin memungkinkan Anda mengonfigurasi setelan email. Instance Looker mengirim email dalam banyak situasi, termasuk notifikasi pengguna baru, reset sandi, dan notifikasi administratif, serta saat pengguna mengirimkan konten seperti dasbor dan Look.

Catatan: Jika Anda memiliki izin yang hanya memberikan akses ke halaman tertentu di panel Admin, seperti manage_schedules, manage_themes, atau see_admin, tetapi Anda tidak memiliki peran Admin, halaman yang dijelaskan di sini mungkin tidak terlihat oleh Anda di panel Admin.

Setelan email

Tidak digunakan lagi: Untuk instance Looker yang dihosting pelanggan, layanan email Looker default tidak tersedia dan Opsi SMTP tidak akan terlihat. Anda harus mengonfigurasi layanan email yang berbeda untuk semua instance yang dihosting pelanggan baru.

Di panel Admin Looker, pilih SMTP untuk melihat dan mengubah setelan SMTP instance Anda. Anda dapat menggunakan setelan email default untuk memanfaatkan layanan email Looker, tanpa memerlukan konfigurasi tambahan.

Untuk menggunakan layanan email lain, pilih Gunakan setelan email kustom. Looker mendukung dua metode autentikasi untuk SMTP kustom: Autentikasi Dasar (nama pengguna dan sandi) dan OAuth 2.0.

Setelan email kustom dapat dikonfigurasi untuk server SMTP yang mendukung protokol autentikasi PLAIN dan LOGIN atau OAuth 2.0.

Setelan email kustom

Masukkan nilai yang sesuai untuk setelan SMTP layanan email Anda:

• Server Email: URL server SMTP Anda. Setiap perubahan pada setelan ini mengharuskan admin Looker juga mengubah sandi server SMTP.
• Dari: Nama yang akan ditampilkan sebagai pengirim email Looker Anda (lihat Menguji Setelan Email Kustom untuk melihat contohnya). Anda dapat memasukkan string nama dan alamat email yang diapit tanda kurung siku (misalnya, Nama Tampilan <[e-mail]>) atau alamat email tanpa tanda kurung siku (misalnya, [e-mail]). Karakter khusus, selain simbol @ dalam alamat email dan tanda kurung sudut di sekitarnya, jika ada, tidak didukung.
• Nama Pengguna: Nama pengguna yang diperlukan untuk mendapatkan akses ke server SMTP Anda.
• Sandi: Sandi yang diperlukan untuk mendapatkan akses ke server SMTP Anda.

• Port: Port yang akan digunakan untuk server SMTP Anda. Setiap perubahan pada setelan ini mengharuskan admin Looker juga mengubah sandi server SMTP.

  Catatan: Instance Looker yang dihosting di Google Cloud tidak dapat menggunakan port 25 untuk SMTP. Google Cloud memblokir semua traffic di port 25. Untuk mengetahui informasi selengkapnya, lihat halaman Mengirim email dari instance dalam dokumentasi Google Cloud . Menggunakan port 25 untuk SMTP di instance Looker yang dihosting di Microsoft Azure tidak direkomendasikan dan dapat menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat halaman Memecahkan masalah konektivitas SMTP keluar dalam dokumentasi Azure.

• TLS/SSL: Jika server SMTP Anda menggunakan protokol TLS atau SSL untuk email yang lebih aman, pilih opsi ini. Looker menampilkan menu drop-down versi TLS dan SSL yang didukung. Pilih versi protokol Anda. Untuk TLS, TLS 1.2 direkomendasikan.

• Jenis autentikasi: Pilih Autentikasi Dasar untuk mengonfigurasi nama pengguna dan sandi guna mengautentikasi ke server SMTP Anda, atau pilih OAuth untuk mengonfigurasi autentikasi OAuth 2.0.

  Catatan: Anda dapat beralih antar-jenis autentikasi tanpa mengganggu layanan email.

Autentikasi dasar

Masukkan Nama Pengguna dan Sandi yang diperlukan untuk mengautentikasi ke server SMTP Anda.

Autentikasi OAuth 2.0

Pilih opsi ini jika penyedia SMTP Anda menggunakan OAuth 2.0 untuk mengautentikasi. Metode ini diperlukan untuk layanan seperti Microsoft Office 365, yang menghentikan penggunaan autentikasi dasar.

Masukkan informasi berikut dari penyedia email Anda:

• Client ID: Client ID aplikasi yang Anda buat di konsol admin penyedia email Anda.
• Rahasia Klien: Rahasia klien untuk aplikasi.
• URL token: URL tempat Looker akan menukar kredensial dengan token akses.
• Cakupan: URL cakupan yang diperlukan penyedia email Anda. Misalnya, untuk menetapkan cakupan .default platform identitas Microsoft, masukkan https://outlook.office365.com/.default.

Membuat kredensial OAuth

Anda harus membuat aplikasi dalam platform penyedia email untuk membuat client ID, rahasia klien, dan URL token. Untuk mengetahui informasi selengkapnya tentang cara membuat aplikasi, lihat halaman berikut:

• Menggunakan OAuth 2.0 untuk Mengakses Google API
• Jenis aplikasi untuk platform identitas Microsoft

Menyimpan setelan SMTP

Setelah Anda memasukkan setelan SMTP, klik tombol Simpan untuk menyimpan konfigurasi Anda. Anda juga dapat menguji setelan, atau memuat ulang halaman untuk melihat apakah konfigurasi Anda memiliki error.

Catatan: Jika Anda menggunakan setelan email kustom untuk SMTP, tambahkan alamat IP Looker ke daftar IP yang diizinkan server SMTP Anda agar server SMTP Anda mengizinkan traffic masuk dari Looker.

Looker membatasi frekuensi admin Looker dapat menyimpan atau menguji setelan SMTP untuk mencegah penggunaan fitur ini guna memindai port terbuka.

Menguji setelan email khusus

Untuk menguji penyiapan email kustom, gunakan tombol Kirim Email Uji Coba. Pengujian ini berfungsi untuk setelan Autentikasi Dasar dan OAuth 2.0. Looker akan mencoba mengirim email pengujian kepada pengguna yang menekan tombol. Email pengujian memiliki atribut berikut:

• Pengirimnya adalah [e-mail].
• Subjeknya adalah Looker Mail Test.
• Teks isi email adalah Looker mail is working!

Untuk mencegah agen berbahaya memindai port terbuka, Looker membatasi frekuensi pengujian setelan SMTP oleh admin Looker.

Pesan error SMTP

Jika ada masalah dengan konfigurasi SMTP Anda, Looker akan memberi tahu semua admin di lokasi berikut:

• Pesan peringatan di halaman SMTP
• Ikon peringatan di samping listingan SMTP di sidebar Admin

Error ini dapat dilihat oleh semua admin di instance Looker Anda. Anda dapat segera memeriksa error dengan memuat ulang halaman setelah menyimpan setelan email kustom.

Error terkait pengujian setelan email kustom muncul di bawah tombol Simpan dan Kirim Email Uji Coba di bagian bawah halaman SMTP.