Latest / M365.FM – Podcast Microsoft 365, Copilot & AI Bahasa Indonesia / Webhook Microsoft Graph Dijelaskan: Notifikasi Real-Time sebagai Pengganti Polling Terus-Menerus (Sulih Suara AI)

Transcript

Webhook Microsoft Graph Dijelaskan: Notifikasi Real-Time sebagai Pengganti Polling Terus-Menerus (Sulih Suara AI) · M365.FM – Podcast Microsoft 365, Copilot & AI Bahasa Indonesia

0:00
Siap untuk 10 hari pembahasan Microsoft 365, Copilot, AI, Azure, dan para tokoh pembentuk masa depan kerja.
0:07
Januari ini, M365 con kembali dan kami hadir. Lebih besar.
0:12
Bergabunglah dengan kami untuk sesi langsung demo nyata dan pengetahuan praktis dari MVP dan pakar industri global.
0:18
Tanpa celet umum, tanpa jargon yang bertele-tele.
0:21
Kami membahas tantangan nyata.
0:23
Copilot Studio, agen AI, Fabrik, Keamanan, Tata Kelola, dan Otomatisasi.
0:28
Baik Anda seorang profesional TI, pengembang, atau pemimpin bisnis, ada sesi yang dirancang untuk Anda.
0:35
Selama 10 hari penuh, Anda dapat menjelajahi berbagai teknologi dan terhubung dengan komunitas global.
0:40
Tonton langsung, dan bawa pulang wawasan praktis untuk organisasi Anda.
0:45
Januari 2027, 10 hari, satu komunitas Microsoft.
0:49
Pendaftaran sudah dibuka sekarang.
0:51
Kunjungi M365 con.net dan amankan tempat Anda hari ini.
0:55
Itu M365 con.net net.
1:00
Bergabunglah sekarang di M365 con.net dan sampai jumpa secara langsung di bulan Januari.
1:04
Halo semuanya, dan selamat datang di episode lain Microsoft Knowledge Nuggets di M365 FM.
1:10
Saya membawa acara Anda melalui kapital.
1:11
Topik hari ini adalah sesuatu yang hampir semua orang yang membangun dengan Microsoft 365 pernah dengar,
1:15
tapi sangat sedikit yang bisa menjelaskannya dengan jelas.
1:18
Apa sebenarnya Bapu Grab itu?
1:19
Mengapa Anda harus memedulikannya alih-alih melakukan cara lama?
1:22
Bayangkan Anda sedang menunggu surat penting.
1:23
Anda berjalan ke kota surat, ternyata kosong.
1:25
Anda berjalan kemulia.
1:26
10 menit kemudian, Anda meriksa lagi.
1:28
Masih tidak ada apa-apa.
1:28
Anda melakukan ini sepanjang hari membuang waktu dan yang lain.
1:30
Belapoling.
1:31
Terang bayangkan dunia yang berbeda.
1:33
Tukang pos membunyikan bel pintu Anda saat surat tiba.
1:35
Anda tidak perlu meriksa.
1:36
Anda menunggu bel berbual.
1:37
Lalu webhook.
1:38
Di akhir episode ini, Anda akan memahami apa itu webhook graph,
1:41
mengapa itu menggantikan pengecekan konstan,
1:43
dan bagaimana bagian-bagiannya saling berkaitan.
1:45
Masalah polling.
1:46
Mari kita berakhir.
1:47
Untuk memahami mengapa webhook itu penting,
1:49
Anda perlu memahami mengapa polling itu merugikan.
1:51
Beginilah cara sebagian besar aplikasi bekerja saat itu.
1:53
Aplikasi Anda menurunkan jawab.
1:54
Ia bertanya kepada Microsoft Graph,
1:56
Hei, ada pengguna baru?
1:57
Graph menjawab tidak ada.
1:59
Jadi aplikasi Anda menunggu sebentar,
2:00
lalu bertanya lagi,
2:01
ada pengguna baru sekarang?
2:02
Pasti tidak ada.
2:03
Berulang-ulang, proses ini disebut polling.
2:05
Bayangkan seperti terus-menerus menelpon teman untuk bertanya,
2:07
apakah mereka punya apa?
2:08
Anda menelpon, mereka mengangkat,
2:09
Anda bertanya, mereka bilang tidak, Anda menutup-tutup.
2:11
Lalu Anda menelpon lagi 5 menit kemudian, dan seterus.
2:14
Anda membuang waktu mereka dan waktu Anda sendiri.
2:15
Anda mungkin mengganggu mereka.
2:16
Sekarang bayangkan ribuan aplikasi melakukan ini
2:18
ke Microsoft Graph secara besar.
2:19
Setiap aplikasi melakukan polling setiap beberapa menit,
2:22
menanyakan hal yang sama,
2:23
mendapatkan jawaban yang sama.
2:24
Itu menghasilkan banyak sekali kemudian.
2:25
Microsoft memiliki istilah saat Anda melakukan polling terlalu agresif,
2:28
yaitu throttling,
2:29
atau yang sering disebut pengembang sebagai graph jail.
2:32
Saat Anda mengirim terlalu banyak permintaan,
2:33
Microsoft berkata,
2:34
oke, Anda berhenti dulu untuk sementara.
2:35
Mereka membatasi berapa banyak panggilan untuk aplikasi.
2:37
Setelah Anda terkena throttling, semuanya melambat.
2:39
Permintaan yang saja jadi menelpon.
2:40
Aplikasi Anda berkungsi dengan benar.
2:42
Anda tidak tahu kapan Anda akan dibebaskan.
2:44
Berapa banyak permintaan yang kita bicarakan?
2:45
Katakanlah aplikasi Anda melakukan polling setiap 5 menit untuk berumur.
2:48
Itu berarti 12 permintaan per jam.
2:50
Dalam 1 hari penuh, itu adalah 28 permintaan,
2:52
dan itu hanya untuk 1 sumber daya.
2:54
Jika Anda juga melakukan polling untuk grup, file, pesan, dan acara kalender,
2:57
Anda akan mengumpulkan ribuan permintaan tidak perlu per hari.
3:00
Sebagian besar tidak menghasilkan apa-apa,
3:01
nol perubahan, tetapi Anda tetap melakukan panggilan.
3:03
Dan masalahnya, meskipun Anda melakukan polling setiap 5 menit,
3:06
Anda tetap tidak mendapatkan pembaruan waktu nyata.
3:08
Sebuah perubahan bisa terjadi 1 menit setelah polling terakhiran.
3:11
Anda baru akan mengetahuinya 4 menit kemudian.
3:12
Anda membuang-buang sumber daya dan tetap melewatkan waktu yang terakhir.
3:16
Sekarang bandingkan itu dengan berkatan berbasis peristi.
3:18
Alih-alih memanggil Microsoft Grab setiap beberapa menit,
3:20
Anda menunggu Microsoft Grab memanggilan.
3:22
Anda menyiapkan pendengar.
3:23
Saat ada yang berubah, Grab mengirimkan Anda pemberitahuan.
3:25
Nah, tidak perlu, Anda mengangkat telepon saat berikut.
3:28
Apa itu webhook?
3:29
Jadi, apa sebenarnya webhook itu?
3:31
Berikut adalah definisi paling sederhana.
3:32
Webhook adalah permintaan HTTP yang dikirim secara otomatis saat sesuatu terjadi.
3:36
Anda tidak memintanya, server langsung mengirimkannya kepada Anda.
3:39
Anggap saja seperti bell pintu.
3:40
Anda tidak perlu berdiri di luar dan meriksa sebeberapa menit.
3:43
Anda memasang bell pintu.
3:44
Saat seorang datang, mereka membunyikannya.
3:46
Anda mendengar bunyinya lalu membuka.
3:47
Bell pintu melakukan pengawasan untuk Anda.
3:49
Webhook terkadang disebut sebagai API terbalik.
3:52
Dengan API normal, aplikasi Anda membuat permintaan dan server merespon.
3:55
Aplikasi Anda menggendali.
3:56
Dengan webhook, server mengirimkan permintaan ke aplikasi Anda.
3:59
Server yang memegang kendali, tetapi mendorong data alih-alih menunggu Anda bertanya.
4:02
Microsoft Grab juga menggunakan webhook,
4:04
tetapi Microsoft menyebutnya sebagai pemberitahuan perubahan.
4:07
Itu hal yang sama, hanya namanya saja yang berbeda.
4:08
Saat ada perubahan di Microsoft 365,
4:11
Graph mengirimkan HTTP post ke URL yang Anda sediakan.
4:15
Post tersebut berisi informasi tentang apa yang berubah.
4:17
Ada banyak hal yang bisa Anda dapatkan pemberitahuan.
4:20
Pengguna baru dibuat di penyewa Anda.
4:22
File diperbarui di SharePoint.
4:23
Pesan dikirim di Teams, acara kalender yang berubah,
4:26
atau grup yang mendapatkan anggota baru.
4:29
Semua ini dapat memicu pemberitahuan.
4:30
Berikut adalah contoh nyata.
4:32
Katakanlah Anda menjalankan perusahaan dengan sistem perjakan otak.
4:34
Saat karyawan baru bergabung, Anda ingin membuat akun secara otomatis.
4:37
Tanpa webhook, Anda melakukan polling ke endpoint pengguna setiap beberapa menit
4:40
untuk memilih seorang baru.
4:41
Dengan webhook, Anda berlangganan ke acara pembuatan pengguna.
4:44
Saat seseorang bergabung, Graph mengirimkan pemberitahuan ke aplikasi Anda.
4:47
Aplikasi Anda menerimanya, memvalidasinya, dan membuat akun.
4:50
Semuanya dalam hitungan detik.
4:51
Tidak ada polling, tidak ada permintaan yang sia-sia.
4:54
Contoh lain, Anda memiliki pustaka dokumen SharePoint tempat Anda terima diunggah.
4:57
Tanpa webhook, Anda terus-menerus melakukan polling ke pustaka.
5:00
Dengan webhook, Graph memberitahu Anda saat file ditambahkan.
5:03
Aplikasi Anda mengambilnya,
5:04
meriksa apakah itu tanda terima, dan memprosesnya secara otomatis.
5:07
Itulah kekuatan webhook.
5:08
Alih-alih aplikasi Anda terus-menerus bertanya ada yang baru.
5:11
Anda membiarkan sistem memberitahu Anda saat satu.
5:13
Ini lebih efisien, lebih andal, dan jauh lebih cepat.
5:16
Cara kerja webhook Microsoft Graph
5:18
Sekarang Anda tahu apa itu webhook, dan mengapa polling menjadi masalahnya.
5:21
Mari kita lihat cara kerja webhook Microsoft Graph,
5:23
yang sebenarnya karena alurnya lebih sederhana dari yang Anda kira.
5:26
Ini bergantung pada tiga hal,
5:27
langganan, pemberitahuan, dan endpoint Anda.
5:31
Pertama, Anda membuat langgan.
5:32
Anda memberitahu Microsoft Graph.
5:34
Hei, saya ingin tahu kapan hal khusus ini berubah.
5:36
Anda memberikan detail kepada Graph tentang apa yang harus dipantau,
5:38
dan kemana harus mengirimkan.
5:39
Anggap saja seperti mendaftar untuk mendapatkan peringatan.
5:41
Anda memberitahu sistem apa yang Anda perlulikan,
5:43
dan memberikan informasi kontak.
5:44
Kedua, Microsoft Graph memantau sumber daya tersebut.
5:46
Sistem ini memantau perubahan.
5:48
Saat sesuatu terjadi, seperti pengguna dipuat,
5:50
file diperbarui, atau pesan tiba,
5:51
Graph menyadarinya.
5:52
Ketiga, Graph mengirimkan pemberitah.
5:54
Graph mengirimkan HTTP post ke URL yang Anda berikan.
5:57
Post tersebut berisi informasi tentang apa yang berubah.
6:00
Endpoint Anda menerimanya,
6:01
dan aplikasi Anda memprosesnya.
6:02
Jadi, alur tingkat tinggi itu sederhana.
6:04
Anda berlangganan, Graph memantau,
6:05
Graph mengirimkan post saat sesuatu berubah.
6:08
Mari kita bahas ketiga blok penyusun tersebut sedikit lebih benar.
6:10
Langganan adalah permintaan Anda untuk mendapatkan peringatan.
6:13
Ini seperti mengatakan,
6:14
saya ingin tahu kapan pengguna baru ditambahkan ke penyewa saya.
6:17
Anda mengirimkan permintaan itu ke Microsoft Graph dan Graphnya.
6:19
Sejak saat itu, Graph memantau atas nama Anda.
6:22
Notifikasi adalah peringatan itu sendiri,
6:24
sebuah HTTP post yang Graph kirim ke endpoint Anda.
6:26
Isi post memuat detail tentang perubahan,
6:28
seperti sumber daya apa yang berubah,
6:29
jenis perubahan, dan kapan itu terjadi,
6:31
dan kapan itu terjadi.
6:32
Endpoint Anda adalah pintu yang Anda builkan terbuka.
6:34
Ini adalah URL di server Anda,
6:35
yang dikonfigurasi untuk menerima permintaan post.
6:37
Endpoint hanya perlu mendengarkan dan berespon cepat.
6:39
Hanya itu saja.
6:40
Tidak diperlukan logika rumit di sisi penerima.
6:42
Cukup tangkap notifikasinya,
6:43
beri konfirmasi, dan proses.
6:45
Perang bandingkan polling.
6:46
Dengan polling, Anda mengirim ratusan permintaan KET.
6:49
Masing-masing bertanya,
6:49
ada yang baru?
6:51
Seringkali jawabannya adalah tidak.
6:52
Dengan webhook, hanya ada satu post,
6:54
yaitu notifikasi itu.
6:55
Selesai.
6:56
Satu pesan alih ratusan.
6:57
Perbedaan efisiensinya sangat besar,
6:59
dan endpoint Anda tidak perlu rumit.
7:01
Ia hanya perlu dapat diakses publik menggunakan HTTPS
7:04
dan merespons dengan cepat.
7:05
Kita akan membahas apa arti cepat nanti.
7:07
Namun ide dasarnya sederhana.
7:09
Endpoint Anda mendengarkan.
7:10
Graph memanggil.
7:11
Anda merespons dan selesai.
7:14
Membuat langgan.
7:15
Jadi bagaimana cara Anda mengaturnya?
7:17
Mari kita bahas cara membuat langganan langkah demi langkah.
7:20
Anda mulai dengan mengirim permintaan HTTP Post
7:22
ke URL tertentu di Microsoft Graph.
7:24
URL tersebut adalah
7:25
HTTPS,
7:26
selgrab,
7:26
dan microsoft.com,
7:27
selvej 1.0 per subscription.
7:29
Anda memposting langsung ke endpoint langganan.
7:31
Di dalam isi permintaan tersebut,
7:33
Anda menyatakan detail tentang apa yang ingin Anda langgani.
7:35
Ada empat kolom utama yang perlu Anda sediakan.
7:37
Pertama adalah URL notifikasi.
7:39
Ini adalah URL endpoint Anda,
7:40
tempat di mana Microsoft Graph akan mengirimkan notifikasi.
7:43
Harus HTTPS dan harus dapat diakses publik
7:45
karena graph perlu menjangkaunya dari internet.
7:47
Kedua adalah sumber daya.
7:49
Ini memberitahu graph apa yang ingin Anda pantau.
7:51
Anda menentukan jalur sumber daya Microsoft Graph.
7:53
Misalnya,
7:53
users jika Anda ingin memantau perubahan pengguna
7:55
atau memberi folder
7:56
space inbox space messages
7:57
jika Anda ingin memantau email baru di kotak masuk Anda.
8:00
Sumber daya memberitahu graph dengan tepat apa yang Anda peduli.
8:02
Ketiga adalah jenis perubahan.
8:04
Ini memberitahu graph jenis perubahan
8:05
apa yang perlu diberitakan kepada Anda.
8:07
Anda dapat menentukan created, updated,
8:09
delighted,
8:09
atau kombinasi apapun.
8:10
Jadi, jika Anda hanya peduli dengan pembuatan pengguna baru,
8:13
Anda mengatur jenis perubahan ke create.
8:14
Jika Anda juga peduli dengan pembaruan,
8:16
Anda mengaturnya ke created, updated.
8:17
Keempat adalah waktu kedaluarsa.
8:19
Ini adalah saat langgan berakhir
8:21
karena langganan tidak berlangsung selamanya.
8:23
Anda menetapkan tanggal,
8:24
dan waktu dan graph berhenti
8:25
mengirim notifikasi setelah titik resum.
8:27
Durasi maksimum bergantung pada sumber daya yang Anda pantau.
8:29
Untuk pengguna dan grup,
8:30
batas maksimalnya ada sekitar tiga hari.
8:32
Untuk item drive di sharepoint atau one drive,
8:34
bisa mencapai 30 hari.
8:35
Anda perlu memperiksa dokumentasi
8:37
untuk setiap tipe sumber daya.
8:38
Ada juga kolom opsional yang perlu disebutkan,
8:40
yaitu client state.
8:42
Ini adalah string resi yang Anda buat sendiri.
8:43
Isinya bisa apa saja,
8:44
saya keinginan.
8:45
String acak, kuit,
8:46
atau apapun yang Anda pilih.
8:47
Microsoft Graph menyertakan nilai ini
8:49
di setiap notifikasi ke endpoint Anda,
8:50
dan Anda menggunakannya
8:51
untuk meverifikasi bahwa notifikasi itu benar
8:53
dari langganan Anda.
8:55
Jika ada yang mencoba mengirim notifikasi palsu
8:57
ke endpoint Anda,
8:58
client state tidak akan cocok,
8:59
dan Anda bisa langsung menolaknya.
9:00
Ini adalah langkah keamanan sederhana,
9:02
namun penting.
9:03
Membuat langganan itu seperti
9:04
mendaftar pengiriman koran.
9:07
Anda memberikan alamat Anda ke pihak koran.
9:08
Itu adalah URL notifikasian.
9:10
Anda memberitahu bagaimana yang diinginkan
9:12
itu adalah sumber daya dan jenis perubahan Anda,
9:14
lalu berapa lama pengiriman harus berlanjur.
9:16
Itu adalah waktu kedaluarsaan.
9:17
Pihak koran yang akan menangani sisanya.
9:19
Namun ingat,
9:20
langganan akan kedaluarsa.
9:21
Anda tidak bisa membuatnya,
9:22
lalu merupakannya begitu.
9:24
Setelah waktu kedaluarsa berlalu,
9:25
Graph berhenti mengirim notifikasi
9:27
dan langganan Anda berakhir.
9:28
Jika ingin terus menerima notifikasi,
9:30
Anda harus memperbarui langganan sebelum kedaluarsa
9:32
dengan mengirim permintaan patch ke endpoint
9:34
dan langgan patch ke endpoint langganan
9:35
dengan waktu kedaluarsa baru.
9:37
Jadi membuat langganan adalah langkah pertama,
9:38
tapi bukan yang terakhir.
9:39
Anda perlu mengolah siklus hidupnya.
9:41
Kita akan membahasnya lebih lanjut nanti.
9:43
Jabat Tangan Validasi
9:43
Sebelum langganan Anda aktif,
9:45
ada satu langkah yang tidak boleh dilewat.
9:47
Microsoft Graph tidak langsung menerima
9:49
permintaan langganan
9:50
dan mulai mengirim notifikasi.
9:52
Ia perlu memastikan endpoint Anda nyata
9:53
dan siap menerimanya terlebih dahulu.
9:55
Begini cara kerja.
9:56
Saat Anda mengirim permintaan pos
9:57
untuk membuat langganan,
9:59
Microsoft Graph segera mengirim pos uji coba
10:00
ke URL notifikasi Anda.
10:02
Pos uji coba itu menyertakan parameter query
10:05
bernama Validation Talk.
10:06
Itu hanyalah string acak.
10:07
Endpoint Anda harus mengambil token itu
10:09
dan mengirimkannya kembali sebagai respons teks biasa
10:11
dan Anda harus melakukannya dalam waktu 10 detik.
10:13
Bayangkan seperti kurir mengantar paket.
10:15
Mereka muncul di depan pintu dan bertanya,
10:16
apakah ini alamat yang benar?
10:17
Bisa ada konfirmasi?
10:18
Anda harus menandatangani.
10:20
Jika tidak, mereka akan pergi.
10:21
Kurir tidak akan meninggalkan paket.
10:23
Mereka pergi begitu saja.
10:24
Itulah tepatnya yang terjadi di sini.
10:25
Microsoft Graph mengatakan,
10:26
saya akan mengirimkan notifikasi penting kepada Anda.
10:28
Buktikan bahwa Anda orang yang tepat di alamat yang benar.
10:33
Endpoint Anda merespons dengan mengemakan token validasi
10:35
yang beritahu Graph,
10:37
ya, saya di sini.
10:38
Saya mendengarkan.
10:39
Kirimkan notifikasinya kepada saya.
10:41
Nah, di sinilah banyak pengembang sering melakukan kesalahan.
10:43
Token validasi harus dikembalikan sebagai teks biasa.
10:45
Bukan JSON, bukan HTML,
10:46
memiliki teks biasa.
10:48
Dan responsnya harus memiliki header tipe konten
10:50
yang diatur ke teks per plan.
10:51
Jika Anda mengirimnya kembali dalam bungkus JSON
10:53
atau di-encode dengan cara apapun,
10:54
validasi akankan.
10:55
Langganan Anda tidak akan dibuat.
10:57
Microsoft Graph akan mengembalikan kesalahan
10:58
dan Anda akan kebingungan mencari tahu apa yang sudah.
11:00
Ada detail teknis lain yang perlu diketahui.
11:02
Layanan validasi Microsoft Graph
11:03
tidak mendukung TLS 1.3 secara andal.
11:06
Layanan ini menegosiasikan TLS 1.3.
11:08
Jadi, jika endpoint Anda hanya menerima koneksi TLS 1.3,
11:11
jabat tangan validasi akan gagal
11:12
sebelum kode aplikasi Anda sempat berjalan.
11:14
Anda harus memastikan endpoint Anda mendukung TLS 1.2
11:17
setidaknya untuk langkah validasi.
11:18
Setelah itu, Anda bisa menerapkan versi TLS
11:21
apapun yang Anda inginkan untuk notifikasi yang sebenarnya.
11:23
Kabar baiknya adalah
11:24
jabat tangan validasi ini hanya terjadi sekali perlangganan.
11:27
Ini bukan sesuatu yang harus ditangani endpoint Anda
11:28
setiap kali notifikasi tiba hanya pada saat pertama kali.
11:31
Setelah Graph mengonfirmasi bahwa endpoint Anda nyata,
11:33
Graph akan mempercayainya selama masa langganan tersebut.
11:36
Jadi, Anda hanya perlu melakukan ini dengan benar-benar satu.
11:39
Menangani notifikasi dan keamanan.
11:40
Setelah jabat tangan validasi berhasil
11:42
dan langganan Anda aktif,
11:43
Microsoft Graph mulai mengirimkan notifikasi tersebut.
11:46
Jadi, seperti apa bentuk notifikasi tersebut dan beraktif?
11:48
Saat ada perubahan,
11:50
Graph mengirimkan HTTP POS ke endpoint Anda
11:52
dengan objek JSON di bagian body.
11:54
Objek tersebut berisi sumber daya yang berubah,
11:56
jenis perubahan yang terjadi,
11:57
dibuat, diperbarui, atau dihapus, dan stempel waktu.
12:00
Objek tersebut juga menyertakan nilai status klien
12:02
yang Anda tetapkan saat membuat langganan.
12:04
Itu adalah string rahasia Anda,
12:05
cara Anda untuk mengetahui bahwa pesan tersebut.
12:07
Jadi, inilah hal pertama yang harus dilakukan saat notifikasi tiba.
12:10
Validasi status klien tersebut.
12:11
Bandingkan nilai dalam notifikasi dengan rahasia
12:13
yang Anda simpan saat membuat langganan.
12:14
Jika tidak cocok,
12:16
segera abaikan karena bisa jadi itu palsu
12:18
seseorang yang mencoba menipu sistem Anda
12:19
agar memproses data yang buruk.
12:21
Hal ini penting karena endpoint Anda berada di internet topik.
12:24
Siapapun yang mengetahui URL Anda bisa mengirim POS ke sana.
12:27
Tanpa validasi status klien,
12:28
Anda tidak akan punya cara untuk membedakan
12:30
notifikasi Microsoft Graph yang asli dan yang palsu.
12:33
Ini ada pemiksa sederhana,
12:34
tetapi merupakan garis pertanian.
12:35
Setelah Anda mengonfirmasi bahwa notifikasi tersebut sah,
12:38
Anda harus merespons dengan cepat.
12:39
Microsoft Graph mengharapkan respons HTTP level 200 dalam waktu 3 detik.
12:43
Jika Anda lebih lambat,
12:44
Graph akan mengetahui.
12:45
Dan jika itu terlalu sering terjadi,
12:46
Graph mulai memperlakukan Anda dengan berbeda.
12:48
Beginilah cara kerja pembatasan.
12:50
Jika lebih dari 10 persen respons Anda
12:51
melebihi jendela waktu 3 detik dalam periode 10 menit apapun,
12:54
Microsoft Graph menandai titik akhir Anda sebagai lambat.
12:57
Saat itu terjadi,
12:57
notifikasi baru akan tertunda selama 10 menit.
13:00
Notifikasi tersebut berakhirnya tetap akan tiba,
13:01
tetapi Anda kehilangan pengiliran waktunya.
13:03
Dan jika kondisinya memburuk dengan lebih dari 15 persen respons Anda
13:06
dan melebihi 10 detik, Graph menandai titik akhir Anda sebagai terputus doping.
13:09
Dalam kondisi tersebut,
13:10
notifikasi akan dihentikan sepenuhnya selama 10 menit.
13:12
Inilah bagian yang menakutkan.
13:13
Notifikasi yang terputus tidak dapat dipulihkan.
13:15
Notifikasi itu hilang dan Anda tidak akan pernah memperkenalkan.
13:17
Anggapnya ini seperti saluran teleponnya simp.
13:19
Jika Anda tidak mengangkat dengan cepat,
13:20
penelpon akan mencoba lagi.
13:21
Namun jika Anda tidak pernah mengangkat,
13:23
akhirnya penelpon akan menyerah.
13:24
Microsoft Graph adalah penelponnya
13:26
dan titik akhir Anda adalah teleponnya.
13:27
Angkat dengan cepat atau Anda berisiko kehilangan pesan.
13:30
Jadi apa praktik terbaiknya di sini?
13:36
Menerima notifikasi dan mengembalikan respons 200 atau 202 secepat mungkin.
13:41
Kemudian masukkan notifikasi ke dalam antrean untuk diproses di latar belakang.
13:44
Antrean Azure, bus layanan, bahkan tabel basi data yang sederhana.
13:47
Intinya adalah keluar dari siklus respons dengan cepat
13:49
dan biarkan pekerja latar belakang Anda menangani beban kerja beratnya.
13:52
Dan satu pengingat keamanan lagi,
13:54
titik akhir Anda harus HTTPS tanpa pengecualian.
13:56
Microsoft Graph tidak akan mengirim notifikasi ke titik akhir HTTP.
14:00
Dan titik akhir Anda harus dapat diakses publik.
14:02
Jika berada dibalik firewall atau VPN, Graph tidak pernah menjaga.
14:04
Untuk pengembangan, Anda dapat menggunakan alat seperti ngerok
14:07
untuk membuat terowongan publik ke musim lokal.
14:09
Namun untuk produksi, titik akhir Anda harus berada di tempat yang dapat ditemukan oleh Graph.
14:13
Jaga siklus hidup notifikasi tetap aktif.
14:16
Jadi Anda telah menyiapkan langganan, notifikasi mengalir, dan semuanya tampak baik.
14:20
Tetapi ada sesuatu yang membuat banyak orang mengat.
14:22
Langganan Anda memiliki tanggal kedaluan.
14:24
Langganan itu tidak bertansel.
14:25
Tergantung pada sumber daya Anda pantal,
14:27
durasi langganan maksimum biasanya antara 3 hingga 7 hari.
14:30
Untuk beberapa sumber daya seperti item drive di SharePoint,
14:32
Anda bisa mendapatkan hingga 30 hari.
14:34
Namun intinya, ini tidak permanen.
14:35
Anda tidak bisa membuat langganan lalu melupakannya begitu saja.
14:38
Anggaplah ini seperti langganan menjal.
14:40
Anda mendaftar, Anda mulai melambang edisi, dan semuanya berjalan lancar.
14:43
Namun jika Anda tidak memperbaruinya sebelum langganan habis, edisinya berhenti datang.
14:46
Hal yang sama juga berlaku.
14:47
Jika langganan Anda berakhir, Microsoft Group berhenti mengirimkan notifikasi.
14:50
Dan Anda mungkin tidak menyadarinya sampai Anda bertanya-tanya mengapa tidak ada yang terjadi.
14:53
Jadi Anda memerlukan strategi perpandang.
14:55
Cara berbarunya cukup sederhana.
14:56
Kirim permintaan patch ke endpoint langganan menggunakan ID langganan,
14:59
dan perbarui tanggal serta waktu kedaluarsa ke tanggal baru di masa mendatang.
15:02
Hal itu akan memperpanjang masa aktif langganan.
15:04
Anda dapat melakukannya sesering mungkin selama Anda melakukannya sebelum waktu kedaluarsa saat ini berakhir.
15:09
Kini, Microsoft Graph sebenarnya membantu Anda dengan sesuatu yang disebut notifikasi siklus hidup.
15:12
Saat membuat langganan, Anda dapat memberikan URL terpisah yang disebut URL notifikasi siklus hidup.
15:18
Microsoft Graph mengirimkan peringatan ke URL tersebut ketika hal-hal tertentu terjadi.
15:22
Seperti saat langganan Anda akan kedaluarsa, token akses Anda akan habis, atau izin aplikasi Anda berubah.
15:28
Notifikasi siklus hidup ini memberi Anda pemberitahuan.
15:30
Anda tidak perlu menebak kapan langganan Anda akan berakhir.
15:32
Graph memberitahu Anda, hey, langgan Anda berakhir dalam beberapa jam lagi.
15:35
Anda mungkin ini memperbarui.
15:37
Ini seperti menerima pengingat dari penerbit majalah bahwa langganan Anda akan segera berakhir.
15:41
Sangat membantu jika Anda memperhatikan ini.
15:43
Namun apa yang terjadi jika ada masalah?
15:45
Mungkin endpoint Anda tidak aktif untuk sementara, atau notifikasi terlewat karena Anda terlalu lambat.
15:49
Lalu bagaimana?
15:50
Disitulah Delta Query berperan.
15:51
Delta Query adalah fitur terpisah dari Microsoft Graph yang mengungkinkan Anda bertanya,
15:54
apa yang berubah sejak terakhir kali saya memeriksa?
15:57
Dan ia hanya mengembalikan perubahannya saja tidak yang lain.
15:59
Gini cara kejangan.
16:00
Pertama kali Anda menjalankan Delta Query pada sumber daya,
16:02
misalnya pengguna Graph mengembalikan semua pengguna di tainan Anda.
16:04
Namun ia juga mengembalikan sesuatu yang ekstra, sebuah tautan khusus yang disebut Delta.
16:08
Anda menyimpan tahu sebut.
16:09
Lain kali saat Anda menjalankan query yang sama, Anda menggunakan Delta Leaders.
16:12
Dan alih-alih mendapatkan semua pengguna lagi, Anda hanya mendapatkan mereka yang berubah sejak permintaan terakhir Anda.
16:16
Pengguna baru, pengguna yang diperbarui, pengguna yang dihapus.
16:19
Hanya itu.
16:20
Anggap saja seperti membaca daftar apa yang baru,
16:22
alih-alih membaca seluruh ensiklopedia setiap saat.
16:25
Jauh lebih cepat, jauh lebih sedikit.
16:26
Nah ini adalah pola yang cerdas.
16:27
Kombinasikan Webhook dengan Delta Query.
16:29
Gunakan Webhook untuk memberitahu Anda saat ada perubahan,
16:32
lalu gunakan Delta Query untuk mengetahui apa tepatnya yang berubah.
16:34
Disini saya menjelaskan mengapa.
16:39
Dan bisa ke dalawarsa dan endpoint Anda bisa tidak aktif.
16:41
Namun Delta Query sangat anak.
16:42
Anda dapat menjalankannya kapan saja,
16:44
dan ini akan memberikan daftar lengkap perubahan sejak pemeriksaan terakhir.
16:46
Jadi meskipun Anda melewatkan notifikasi, Anda tetap bisa mengejarnya.
16:49
Berikut adalah alur yang umum.
16:51
Siapkan langganan Webhook untuk perubahan pengguna.
16:53
Jalankan query Delta awal untuk mendapatkan status dasar dan disimpan tautan Deltanya.
16:57
Saat Webhook masuk yang memberitahu Anda ada perubahan pengguna,
16:59
jalankan query Delta menggunakan tautan Delta yang telah disimpan.
17:01
Hal itu akan memberikan perubahan yang tepat.
17:03
Proses perubahan tersebut melalui simpan tautan Delta baru dari SMS.
17:06
Lain kali saat ada Webhook masuk, ulangi proses tersebut.
17:08
Dan jika Anda melewatkan notifikasi,
17:10
atau jika langganan Anda ke dalawarsa,
17:12
jalankan saja kembali query Delta tersebut.
17:14
Anda akan langsung yang terawatkan.
17:15
Berjaring pengamal.
17:16
Webhook memberikan kecepatan dan query Delta memberikan keandalan.
17:19
Bersama-sama keduanya menjadi kombinasi yang hebat.
17:22
Contoh dunia nyata dan langkah selanjutnya.
17:24
Bayangkan seorang karyawan baru bergabung dengan perusahaan Anda besok.
17:26
Seseorang di HR membuat akun mereka di Microsoft Enter ID
17:29
dan tindakan tunggal itu memicu reaksi berantai.
17:33
Jika Anda telah menyiapkan pelangganan Webhook untuk perubahan pengguna,
17:35
Microsoft Graph akan langsung mengetahuinya
17:37
dan mengirimkan push di endpoint Anda.
17:39
Ini yang terjadi selanjutnya.
17:40
Endpoint Anda menerima notifikasi,
17:42
memvalidasi status klien,
17:43
dan jika cocok dengan rahasia Anda,
17:45
Anda tahu itu valid.
17:46
Anda memberikan respons 2-2,
17:48
accepted dalam 3 detik,
17:49
mengakui notifikasi tersebut,
17:50
lalu pekerja latar belakang Anda akan mengambilnya.
17:53
Pekerja melihat pengguna telah dibuat,
17:54
namun notifikasi tidak mencakup semua detail
17:56
jadi ia menjalankan query data
17:57
menggunakan tautan data yang tersimpan.
17:59
Itu akan mengembalikan informasi lengkap pengguna baru,
18:01
nama, email, departemen, jepatan, manajer,
18:03
semua yang Anda perlukan.
18:05
Sekarang pekerja Anda mengambil informasi tersebut
18:07
dan membuat akun untuk karyawan baru
18:08
di sistem pelajakan waktu pihak ketiga Anda.
18:10
Sistem mengirimkan email selama datang.
18:12
Sistem menambahkan mereka ke daftar distribusi yang sesuai.
18:14
Semua ini terjadi dalam hitungan detik
18:16
setelah HR membuat akun di Enter ID
18:17
tanpa polling,
18:19
tanpa langkah manual,
18:20
tanpa kemungkinan.
18:21
Pikirkan tentang tipnya.
18:23
Tanpa Webhook,
18:23
Anda harus melakukan polling ke endpoint pengguna setiap beberapa menit,
18:26
ratusan permintaan per hari,
18:27
dan bahkan saat itu Anda mungkin baru mengetahui
18:29
pengguna baru tersebut setelah beberapa menit.
18:30
Dengan Webhook, semuanya instan.
18:32
Satu notifikasi, satu query delta selesai.
18:34
Itulah nilai sebenarnya.
18:35
Sistem Anda menjadi lebih cepat,
18:36
lebih efisien,
18:37
dan lebih kecil kemungkinannya untuk mencapai batas token.
18:39
Alih-alih terus-menerus meminta pembaruan ke Grab,
18:40
Anda membiarkan Grab memberitahu Anda saat sesuatu terjadi.
18:43
Ini adalah perubahan mendasar dalam cara Anda membangun integrasi.
18:45
Jadi inilah yang saya minta untuk Anda, Jok.
18:47
Pikirkan suatu proses yang saat ini Anda gunakan dengan cara polling.
18:49
Mungkin Anda sedang meriksa email baru di kotak surat bersama.
18:52
Mungkin Anda sedang memantau perubahan file di pustaka SharePoint.
18:55
Mungkin Anda sedang memantau pembaruan pengguna untuk sistem HRA.
18:57
Bisa kakak Webhook menggantikan polling tersebut?
18:59
Dalam kebanyakan kasus, jawabannya ya.
19:00
Dan Anda tidak perlu membangun semuanya.
19:02
Terima kasih telah menonton!