> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrasi Microsoft Teams
> Hubungkan Living Security ke Microsoft Teams untuk mengirim notifikasi pelatihan, peringatan keamanan, dan pengumuman saluran.
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
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.
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.
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](#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.
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.
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.
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.
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.
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](/id/features/communications/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 file ZIP. File ini berisi tepat tiga file di root
arsip: `manifest.json`, `color.png`, dan `outline.png`.
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 |
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.
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.
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 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:
```text theme={null}
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](#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](#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
* 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
-
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.
-
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.
Kategori kesalahan `TEAMS_ADMIN_CONSENT_REQUIRED`, atau kesalahan Microsoft `AADSTS7000229`, berarti pencarian penerima email/UPN mencoba fallback Microsoft Graph opsional, tetapi aplikasi Living Security Teams regional tidak memiliki service principal (aplikasi enterprise) di tenant Microsoft Entra yang terhubung. Jalur ID tepercaya dan percakapan tersimpan yang default tidak memerlukan persetujuan ini. Ini bukan masalah secret Living Security yang kedaluwarsa.
1. Buka **Pengaturan → Komunikasi → Saluran → Microsoft Teams**. Anda juga dapat menggunakan **Open Microsoft Teams setup** dari kesalahan Communication Log.
2. Pastikan ID tenant Microsoft Entra yang benar telah terhubung.
3. Jika fallback email/UPN diperlukan, minta administrator Microsoft Entra untuk mengklik **Grant optional User.Read.All consent** dan menyetujui `User.Read.All` untuk **Bot app ID** yang ditampilkan. Jika tidak, pastikan penerima telah membuka aplikasi personal dan Living Security memiliki object ID Entra tepercaya mereka.
4. Setelah Microsoft selesai memproses persetujuan, kirim pengujian email/UPN tertarget tingkat lanjut dari pengaturan Microsoft Teams. Communication Log menampilkan riwayat dan diagnostik pengiriman; log ini tidak mengirim ulang pesan yang gagal.
Mengonfigurasi ulang **Microsoft Entra ID (Client Credentials)** tidak menyelesaikan kesalahan ini karena integrasi tersebut tidak digunakan oleh pengiriman notifikasi Teams.
* 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:
```json theme={null}
{
"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
Konfigurasikan email sebagai saluran pengiriman.
Konfigurasikan Slack sebagai saluran pengiriman.
Lacak status dan riwayat pengiriman Teams.
Konfigurasi Microsoft Entra ID dan SSO.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.