Integrasi Microsoft Teams

Integrasi Microsoft Teams mengirimkan notifikasi Living Security kepada pengguna dan saluran melalui aplikasi Living Security Teams. Gunakan integrasi ini untuk penugasan pelatihan, peringatan risiko manusia, pesan peluncuran, dan pengumuman tim keamanan. Integrasi ini hanya untuk notifikasi. Pengguna tidak mengirim perintah ke bot di Microsoft Teams. Saat aplikasi dipasang, bot menyimpan referensi percakapan Teams untuk notifikasi proaktif di masa mendatang. Pesan pemasangan bersifat satu arah dan dapat disesuaikan atau dinonaktifkan sesuai kebutuhan peluncuran di perusahaan.

Administrator Microsoft Teams tetap harus mengunggah, menyetujui, dan mendistribusikan aplikasi Living Security Teams. Persetujuan admin Microsoft Entra User.Read.All bersifat opsional dan hanya mengaktifkan fallback pencarian berdasarkan email atau user principal name (UPN).

Untuk pengaturan pengiriman Dorongan dan Buku Pedoman, mulailah dari Pengaturan → Komunikasi → Saluran lalu klik kartu Microsoft Teams. Halaman ini membahas konfigurasi dasar aplikasi Teams.

Prasyarat

Sebelum mengonfigurasi Microsoft Teams, pastikan Anda memiliki:

Administrator Microsoft Teams yang dapat mengunggah dan menyetujui aplikasi organisasi. Satu orang yang sama dapat memegang kedua peran administrator tersebut.
Administrator Microsoft Entra, hanya jika Anda ingin mengaktifkan fallback pencarian email/UPN opsional dengan persetujuan aplikasi User.Read.All di seluruh tenant
Hak akses administrator Living Security
Organisasi Living Security yang aktif
Nama tim dan saluran tempat pengumuman keamanan akan dikirim, jika pengumuman saluran diaktifkan
ID tenant Microsoft Entra Anda, yang tersedia di Microsoft Entra admin center → Identitas → Ikhtisar

Pembagian Peran

Peran	Tanggung Jawab
Administrator Living Security	Menghubungkan tenant Microsoft, mengunduh paket regional, mengonfigurasi pesan pemasangan, memvalidasi pengaturan, dan mengirim pengujian
Administrator Microsoft Teams	Mengunggah dan mengizinkan aplikasi, mendistribusikannya kepada pengguna atau grup yang dituju, dan menetapkan kebijakan penyiapan aplikasi
Administrator Microsoft Entra, opsional	Memberikan persetujuan aplikasi `User.Read.All` kepada ID aplikasi Bot regional ketika fallback pencarian email/UPN diperlukan
Pemilik Teams, ketika pengiriman saluran digunakan	Memasang atau menyetujui aplikasi untuk tim dan saluran yang dituju

Peran-peran ini dapat dipegang oleh orang yang berbeda. Bagikan checksum paket, ID aplikasi Teams, Bot app ID, dan populasi peluncuran yang dituju kepada administrator Microsoft Teams. Bagikan URL persetujuan yang dihasilkan kepada administrator Microsoft Entra hanya ketika mengaktifkan fallback pencarian email/UPN opsional. Jangan bagikan kredensial Living Security yang tidak terkait.

Pengaturan

Buka panel pengaturan Microsoft Teams

Di Living Security, buka Pengaturan → Komunikasi → Saluran lalu pilih Microsoft Teams.Panel ini menampilkan region organisasi Anda, nama file paket, ID aplikasi Teams, ID aplikasi bot, checksum SHA256, status konfigurasi tenant Microsoft, petunjuk pemasangan, kontrol pesan pemasangan, serta alat validasi dan notifikasi pengujian.

Region yang ditampilkan di Living Security sesuai dengan region tempat organisasi Anda dihosting.

Hubungkan tenant Microsoft Anda

Di Connect your tenant, masukkan ID tenant Microsoft Entra yang memiliki pengguna dan saluran Teams penerima notifikasi, lalu klik Save Microsoft tenant. Satu tenant Microsoft hanya dapat dimiliki oleh satu organisasi Living Security.Jika kontrol tenant tidak tersedia, hubungi pemilik implementasi Living Security atau kontak dukungan Anda untuk menghubungkan atau mengubah tenant sebelum memasang aplikasi.

Living Security menampilkan Microsoft tenant connected sebelum Anda melanjutkan.

Jika memungkinkan, hubungkan tenant sebelum memasang aplikasi Teams. Jika aplikasi sudah terpasang, simpan tenant lalu pilih Validate install terlebih dahulu. Living Security akan mencoba mengaitkan pemasangan yang ada secara otomatis; lakukan pemasangan ulang hanya jika validasi tidak dapat mendeteksinya.

Unduh paket Teams regional

Klik Download Teams package. Living Security menyediakan paket ZIP khusus region untuk organisasi Anda.Verifikasi file yang diunduh terhadap checksum SHA256 yang ditampilkan di Living Security sebelum Anda mengubah apa pun. Untuk memberi aplikasi nama dan ikon Anda sendiri, ikuti Rebrand the Regional Package setelah pemeriksaan ini dan sebelum Anda mengunggah paket.

Checksum file yang diunduh sesuai dengan checksum SHA256 yang ditampilkan di Living Security.

Unggah dan pasang paket di Teams admin center

Di Microsoft Teams admin center, buka Teams apps → Manage apps → Actions → Upload new app, lalu unggah file ZIP yang diunduh dari Living Security.Pastikan:

ID aplikasi Teams dan ID aplikasi bot sesuai dengan nilai yang ditampilkan di Living Security
Nama aplikasi adalah nama Living Security regional, atau nama yang Anda tetapkan jika Anda melakukan rebranding paket
Penerbitnya adalah Living Security. Rebranding paket tidak mengubah penerbit
Aplikasi tidak diblokir
Aplikasi tersedia bagi pengguna atau grup yang dituju
Aplikasi dipasang melalui kebijakan penyiapan aplikasi atau pemasangan tertarget bagi pengguna serta tim/saluran yang harus menerima notifikasi

Microsoft memerlukan waktu untuk menyebarkan ketersediaan aplikasi dan perubahan kebijakan penyiapan.

Jika validasi atau pengujian gagal segera setelah perubahan kebijakan aplikasi, pastikan penetapan kebijakan di Microsoft Teams admin center, lalu coba lagi setelah Microsoft selesai menyebarkannya.

Pasang atau buka aplikasi

Distribusikan aplikasi personal kepada pengguna yang dituju. Sebelum Living Security dapat mengirim pengujian personal ke pemasangan yang terdeteksi, setidaknya satu pengguna harus memasang atau membuka aplikasi personal Living Security di Microsoft Teams. Hal ini memungkinkan bot menangkap identitas tepercaya pengguna dan referensi percakapan personalnya. Pemasangan pada saluran saja tidak dapat digunakan untuk pengujian pemasangan terdeteksi yang bersifat personal.Untuk pengiriman ke saluran, pasang aplikasi di tim dan saluran yang dituju agar bot dapat menangkap referensi percakapan saluran tersebut.

Pengguna target telah memasang atau membuka aplikasi personal, atau aplikasi telah dipasang di saluran yang dituju.

Konfigurasikan pesan pemasangan

Di bagian Install message controls, pilih apakah pesan pemasangan Teams dikirim dan sesuaikan teks satu arahnya untuk organisasi Anda.Kontrol yang tersedia:

Send install messages
Send personal install messages
Send channel install messages
Default message
Personal message
Channel message

Kolom pesan mendukung {{installerName}}, yang akan diganti dengan nama tampilan pengguna yang memasang aplikasi. Biarkan pesan personal atau saluran kosong untuk menggunakan pesan default yang telah Anda konfigurasikan. Jika pesan default juga kosong, Living Security menggunakan pesan bawaan untuk cakupan tersebut.

Validasi pengaturan

Klik Validate install di Living Security. Validasi memeriksa bahwa paket regional tersedia, konfigurasi tenant Microsoft ada dan unik untuk organisasi Living Security ini, kredensial bot regional telah dikonfigurasi, dan pemasangan aplikasi aktif telah terdeteksi untuk tenant yang terhubung.

Validasi menampilkan Validation passed sebelum Anda mengirim notifikasi langsung.

Kirim notifikasi pengujian

Untuk pengujian personal default, klik Send test to detected installation. Living Security memilih pemasangan personal aktif yang terdeteksi dan menggunakan identitas tepercaya serta referensi percakapan yang tersimpan. Pengujian ini tidak memanggil Microsoft Graph dan tidak memerlukan persetujuan User.Read.All.Jika tidak ada pemasangan personal yang terdeteksi, minta pengguna memasang atau membuka aplikasi personal Living Security, pilih Validate install lagi, lalu kirim ulang pengujian. Gunakan pengujian email/UPN tertarget tingkat lanjut hanya ketika fallback pencarian opsional diaktifkan.

Notifikasi pengujian satu arah muncul di Microsoft Teams.

Tinjau upaya yang sesuai di Communication Log ketika diagnostik pengiriman diperlukan.

Rebrand the Regional Package

Paket regional adalah arsip ZIP berisi tiga file: manifest.json, color.png, dan outline.png. Anda dapat menetapkan nama dan ikon aplikasi Anda sendiri dalam paket tersebut sebelum mengunggahnya. Living Security mendukung jalur ini untuk paket regional yang diunggah langsung oleh administrator Teams. Lakukan langkah ini setelah Anda mengunduh dan memverifikasi paket, serta sebelum Anda mengunggahnya di Teams admin center.

Ekstrak paket

Ekstrak file ZIP. File ini berisi tepat tiga file di root arsip: manifest.json, color.png, dan outline.png.

Ganti ikon

Ganti color.png dan outline.png dengan ikon Anda sendiri. Pertahankan kedua nama file yang sama.

File	Persyaratan
`color.png`	PNG berwarna penuh, 192 × 192 piksel, tanpa transparansi
`outline.png`	PNG transparan, 32 × 32 piksel

Tetapkan nama aplikasi Anda

Di manifest.json, ubah kedua kolom berikut:

name.short — nama yang ditampilkan pada header aplikasi Teams dan area lain yang terbatas ruangnya. Maksimum 30 karakter.
name.full — nama yang ditampilkan di katalog aplikasi dan detail aplikasi. Maksimum 100 karakter.
Jika aplikasi Living Security sudah diunggah di Teams admin center, tetapkan version lebih tinggi daripada versi yang terpasang di sana. Microsoft Teams menolak pembaruan yang tidak menaikkan versi, dan unduhan baru dapat membawa versi yang sama dengan, atau lebih rendah daripada, paket yang sudah Anda pasang.Lihat versi yang terpasang di Teams admin center pada Teams apps → Manage apps, di halaman detail aplikasi. Bandingkan dengan nilai version di manifest.json yang baru Anda unduh, lalu tetapkan nilai yang lebih tinggi daripada keduanya. Pertahankan format tiga angka MAJOR.MINOR.PATCH.Misalnya, jika aplikasi yang terpasang adalah 1.1.1 dan unduhan baru Anda adalah 1.1.0, tetapkan 1.1.2. Menaikkan 1.1.0 hasil unduhan menjadi 1.1.1 akan mengulang versi yang terpasang, dan Teams akan menolak unggahan tersebut.

Biarkan kolom identitas tidak berubah

Jangan ubah kolom-kolom ini. Masing-masing membawa identitas aplikasi, bot, atau single sign-on:

id
botId di bots
webApplicationInfo
validDomains
contentUrl dan websiteUrl di staticTabs
Perubahan pada kolom identitas dapat membuat aplikasi tetap dapat dipasang tetapi tidak dapat mengirim notifikasi atau menyelesaikan single sign-on. Validate install memeriksa tenant, kredensial bot, dan pemasangan yang terdeteksi. Fitur ini tidak membandingkan manifes Anda dengan paket yang dibuat oleh Living Security.

Kompres ulang ketiga file

Buat arsip ZIP baru dari ketiga file tersebut. Letakkan di root arsip, tanpa folder pembungkus. Microsoft Teams menolak paket yang manifest.json-nya berada di dalam folder.

Unggah dan verifikasi

Unggah file ZIP hasil rebranding di Teams admin center, lalu kembali ke Living Security dan klik Validate install. Kirim notifikasi pengujian.

Validasi menampilkan Validation passed, dan notifikasi pengujian tiba di Microsoft Teams dengan nama dan ikon aplikasi Anda.

Publisher and Checksum

Rebranding menetapkan nama dan ikon aplikasi. Hal ini tidak mengubah dua hal berikut:

Penerbit tetap Living Security. Kolom developer pada manifes menyebutkan Living Security dan menautkan ke situs web, kebijakan privasi, dan ketentuan layanan Living Security. Secara keseluruhan, kolom-kolom ini mengidentifikasi perusahaan yang mengoperasikan layanan, sehingga Teams tetap menampilkan Living Security sebagai penerbit di halaman detail aplikasi, dalam dialog persetujuan izin, dan dalam laporan penggunaan aplikasi. Nama dan ikon Anda adalah yang dilihat pengguna di header aplikasi, katalog aplikasi, dan notifikasi.
Checksum SHA256 tidak lagi cocok. Checksum yang ditampilkan di Living Security menggambarkan paket sebagaimana diunduh. Verifikasi checksum tersebut sebelum Anda mengedit file, lalu catat checksum paket hasil rebranding Anda untuk arsip peluncuran Anda.

Opsional: Aktifkan Fallback Pencarian Email/UPN

Pengiriman personal normal menggunakan object ID Microsoft Entra tepercaya yang sudah diketahui oleh Living Security beserta referensi percakapan bot yang ditangkap saat pengguna memasang atau membuka aplikasi. Pengiriman ke saluran menggunakan referensi percakapan saluran yang tersimpan. Tidak satu pun dari kedua jalur ini memerlukan Microsoft Graph. Jika penerima tidak memiliki object ID Entra tepercaya, Living Security dapat secara opsional menggunakan Microsoft Graph untuk menemukan penerima berdasarkan alamat email atau UPN. Untuk mengaktifkan fallback tersebut, minta administrator Microsoft Entra untuk mengklik Grant optional User.Read.All consent di panel pengaturan Teams dan menyetujui izin aplikasi Microsoft Graph User.Read.All untuk aplikasi Living Security Teams regional. Alur persetujuan admin mengikuti pola Microsoft Entra berikut:

https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={bot-app-id}

Living Security menghasilkan URL ini dari ID tenant yang terhubung dan Bot app ID yang ditampilkan di panel pengaturan. Kedua ID tersebut memiliki tujuan yang berbeda:

Teams app ID mengidentifikasi paket aplikasi yang dapat dipasang di Microsoft Teams admin center.
Bot app ID mengidentifikasi aplikasi Microsoft Entra milik bot regional dan merupakan client ID yang digunakan untuk alur persetujuan admin opsional.

Jangan mengganti Teams app ID pada URL persetujuan. Integrasi Microsoft Entra ID (Client Credentials) di bawah Connected Integrations adalah integrasi generik yang terpisah. Kredensial atau persetujuannya tidak dapat digunakan ulang oleh bot Teams regional, dan persetujuan yang diberikan kepada aplikasi Entra yang tidak terkait tidak mengaktifkan fallback ini.

Menjadikan persetujuan opsional tidak menghapus User.Read.All dari registrasi aplikasi Living Security regional yang sudah ada. Pelanggan yang sudah memberikan persetujuan dapat terus menggunakan fallback email/UPN tanpa konfigurasi ulang.

Jenis Notifikasi

Bergantung pada hak akses organisasi Anda dan Buku Pedoman yang dikonfigurasi, Living Security dapat mengirim:

Notifikasi	Deskripsi
Penugasan pelatihan	Memberi tahu pengguna ketika pelatihan ditugaskan, jatuh tempo, atau siap diselesaikan
Pengingat pelatihan	Mengingatkan pengguna tentang tenggat waktu yang akan datang
Peringatan risiko manusia	Mengirim pembaruan Indeks Risiko Manusia yang dipersonalisasi dan langkah berikutnya yang direkomendasikan
Pesan peluncuran	Mengirim notifikasi orientasi atau peluncuran satu arah selama penerapan
Pengumuman saluran	Memposting komunikasi program keamanan ke saluran Teams yang dikonfigurasi

Kustomisasi

Notifikasi Teams menggunakan konfigurasi organisasi Living Security Anda. Kolom yang didukung mencakup nama tampilan pelanggan, logo dan kolom merek yang didukung, teks pesan, ajakan bertindak, tautan tujuan, teks peluncuran, dan teks dukungan/kontak. Pesan pemasangan dapat dikonfigurasi dari Pengaturan → Komunikasi → Saluran → Microsoft Teams → Install message controls. Anda dapat menonaktifkan seluruh pesan pemasangan, menonaktifkan hanya pesan pemasangan personal atau saluran, serta mengonfigurasi teks default, personal, atau khusus saluran. Nama dan ikon aplikasi Teams berasal dari paket regional. Untuk menetapkan milik Anda sendiri, lihat Rebrand the Regional Package.

Memperbarui atau Menghapus Aplikasi

Ketika Living Security menyediakan paket regional yang diperbarui, unduh dari panel saluran Microsoft Teams dan unggah paket tersebut melalui Teams admin center. Verifikasi ID aplikasi, ID bot, dan checksum yang ditampilkan sebelum peluncuran.
Perubahan branding tidak bertahan setelah pembaruan paket. Setiap paket regional baru kembali membawa nama dan ikon aplikasi Living Security. Terapkan kembali perubahan Anda dengan Rebrand the Regional Package sebelum Anda mengunggah paket baru. Simpan ikon Anda, kedua nilai nama Anda, dan versi yang terakhir Anda unggah di tempat yang mudah ditemukan, sehingga setiap peningkatan versi hanyalah pengulangan singkat dari langkah yang sama. Paket baru tidak selalu membawa versi yang lebih tinggi daripada yang Anda pasang, jadi tetapkan versi berdasarkan apa yang ditampilkan Teams sebagai versi terpasang.
Jalankan ulang Validate install dan kirim pengujian lagi setelah pembaruan aplikasi atau kebijakan.
Menghapus atau memblokir aplikasi mencegah notifikasi proaktif ke pengguna atau saluran tersebut. Pasang ulang aplikasi dan kirim pengujian baru agar Living Security menerima peristiwa pemasangan Teams yang terkini.
Jika Anda menghentikan pengiriman melalui Teams, hapus Teams dari Buku Pedoman terkait sebelum menghapus aplikasi dari Microsoft Teams.

Pemecahan Masalah

Pengguna tidak menerima notifikasi personal

Pastikan aplikasi personal Living Security Teams terpasang dan pengguna telah membukanya sehingga Living Security memiliki referensi percakapan terkini
Pastikan ID tenant Microsoft yang dikonfigurasi adalah tenant tempat pengguna berada
Jika diagnostik menunjukkan bahwa fallback email/UPN dicoba, pastikan persetujuan admin User.Read.All diberikan kepada Bot app ID yang ditampilkan untuk tenant yang benar
Ketika fallback email/UPN digunakan, verifikasi bahwa email atau UPN pengguna di Living Security sesuai dengan Microsoft Entra ID
Minta pengguna membuka blokir atau memasang ulang aplikasi jika sebelumnya mereka menghapus atau memblokirnya

Pengumuman saluran tidak muncul

Pastikan aplikasi Living Security Teams terpasang di tim atau saluran target.
Pastikan pemetaan saluran di Living Security menggunakan tim dan saluran yang benar.
Periksa apakah saluran telah dihapus, diganti namanya, diarsipkan, atau dibatasi.
Pasang ulang aplikasi di tim atau saluran target dan kirim notifikasi pengujian lagi.

Pencarian email/UPN opsional atau persetujuan gagal

Pastikan administrator Microsoft Entra telah memberikan persetujuan di seluruh tenant untuk Microsoft Graph User.Read.All kepada Bot app ID yang ditampilkan.
Pastikan ID tenant yang dikonfigurasi adalah tenant tempat pengguna dan Teams berada.
Verifikasi bahwa pengguna ada di Microsoft Entra ID dan bukan tamu dari tenant lain.

Aplikasi terpasang tetapi notifikasi gagal

Periksa apakah bot diblokir, dihapus, atau dicopot
Jika aplikasi dipasang sebelum tenant dihubungkan di Living Security, simpan tenant dan pilih Validate install agar Living Security dapat mengaitkan pemasangan yang ada
Lakukan pemasangan ulang hanya jika validasi tidak dapat mendeteksi pemasangan yang ada
Pastikan pengguna atau saluran target telah menerima peristiwa pemasangan aplikasi terbaru
Kirim notifikasi pengujian baru setelah memasang ulang aplikasi

Contoh kolom peristiwa pemasangan yang digunakan untuk pemecahan masalah:

{
  "type": "installationUpdate",
  "action": "add",
  "channelData": {
    "tenant": { "id": "278750d2-8df7-4262-a34d-08d79ad671d8" },
    "team": { "id": "19:team-id@thread.tacv2" },
    "channel": { "id": "19:channel-id@thread.tacv2" }
  },
  "conversation": {
    "id": "19:channel-id@thread.tacv2",
    "conversationType": "channel",
    "tenantId": "278750d2-8df7-4262-a34d-08d79ad671d8"
  }
}

Keamanan

Living Security menggunakan Microsoft Graph User.Read.All hanya untuk fallback pencarian penerima email/UPN opsional. Secara default, perutean notifikasi personal menggunakan object ID Entra tepercaya dari data entitas Living Security dan referensi percakapan bot yang ditangkap dari Microsoft Teams. Object ID dan referensi percakapan yang disediakan oleh pemanggil bukan data perutean tepercaya. Pesan Microsoft Teams dikirim melalui bot Teams Living Security yang khusus notifikasi menggunakan pesan proaktif Microsoft Teams. Living Security tidak mengharuskan pelanggan membuat registrasi aplikasi Microsoft Entra sendiri atau membagikan client secret milik pelanggan untuk pengaturan aplikasi Teams standar. Paket Teams khusus region menjaga ID aplikasi, ID bot, dan endpoint pesan tetap selaras dengan region Living Security tempat organisasi Anda dihosting.

Terkait

Integrasi Email

Konfigurasikan email sebagai saluran pengiriman.

Integrasi Slack

Konfigurasikan Slack sebagai saluran pengiriman.

Communication Log

Lacak status dan riwayat pengiriman Teams.

Autentikasi

Konfigurasi Microsoft Entra ID dan SSO.

Integrasi

Penyiapan integrasi

Katalog

Saluran Keluar

Prasyarat

Pembagian Peran

Pengaturan

Rebrand the Regional Package

Publisher and Checksum

Opsional: Aktifkan Fallback Pencarian Email/UPN

Jenis Notifikasi

Kustomisasi

Memperbarui atau Menghapus Aplikasi

Pemecahan Masalah

Keamanan

Terkait

Integrasi Email

Integrasi Slack

Communication Log

Autentikasi

Integrasi

Penyiapan integrasi

Katalog

Saluran Keluar

​Prasyarat

​Pembagian Peran

​Pengaturan

​Rebrand the Regional Package

​Publisher and Checksum

​Opsional: Aktifkan Fallback Pencarian Email/UPN

​Jenis Notifikasi

​Kustomisasi

​Memperbarui atau Menghapus Aplikasi

​Pemecahan Masalah

​Keamanan

​Terkait

Integrasi Email

Integrasi Slack

Communication Log

Autentikasi

Prasyarat

Pembagian Peran

Pengaturan

Rebrand the Regional Package

Publisher and Checksum

Opsional: Aktifkan Fallback Pencarian Email/UPN

Jenis Notifikasi

Kustomisasi

Memperbarui atau Menghapus Aplikasi

Pemecahan Masalah

Keamanan

Terkait