Izin

Ringkasan

Sebagai administrator sistem Workplace, Anda dapat mengontrol kemampuan yang ditawarkan untuk setiap integrasi dengan membuat aplikasi dan memberikan izin spesifik ke aplikasi tersebut. Setiap aplikasi dapat diberi nama untuk mencerminkan layanan yang diaktifkan. Aplikasi dilengkapi dengan token akses unik dan izin untuk mengontrol informasi apa yang boleh dibaca atau ditulis oleh aplikasi tersebut.

Panduan ini menjelaskan aplikasi dan model izin secara lebih mendetail.

Izin mengontrol saat mengedit aplikasi integrasi khusus

Izin yang Tersedia

Setiap aplikasi Workplace dapat diberikan set izinnya sendiri untuk mengontrol level fungsi yang tersedia pada aplikasi di Graph API dan Account Management API.

Saat Anda membuat aplikasi dan memberikan izin, izin tersebut diterapkan ke setiap akun di komunitas Anda. Pemegang akun tidak perlu memberikan izin tambahan ke aplikasi untuk mendapatkan manfaat fungsinya. Ini berbeda dari model izin di Facebook, dengan setiap pengguna secara individu memberikan izin ke aplikasi saat masuk.

Di bawah ini adalah daftar lengkap izin aplikasi yang tersedia untuk integrasi, bersama dengan ringkasan cara penggunaannya.

Izin Level Grup

Untuk beberapa izin, membatasi integrasi untuk diaktifkan pada grup tertentu dapat dilakukan. Hal ini memungkinkan Anda untuk mencakup akses integrasi hanya ke konten yang ingin Anda ekspos.

Contoh: Anda dapat mengizinkan integrasi posting pemberitahuan untuk memposting hanya di grup tim sendiri, atau mengaktifkan integrasi aplikasi karyawan untuk membaca konten hanya di grup terbuka tertentu.

Untuk menentukan izin level grup guna integrasi khusus, gunakan panel Akses Grup dalam dialog Edit Integrasi.

Mengaktifkan izin level grup untuk integrasi ini.

Izin tingkat grup berlaku untuk izin berikut:

• Baca konten grup - Membaca postingan, komentar, dan profil anggota di grup yang dipilih
• Kelola konten grup - Mengelola postingan, komentar, dan profil anggota di grup yang dipilih
• Kelola grup - Mengedit atau menghapus grup yang dipilih dan anggota mereka

Anda dapat mengonfigurasi integrasi sehingga izin level grup dapat diterapkan ke Semua grup, Grup spesifik seperti yang dipilih oleh administrator sistem, atau Biarkan admin grup mengaktifkan grup mereka.

Alur Instal Admin

Ketika Biarkan admin grup mengaktifkan grup mereka diaktifkan, admin grup akan melihat tab Integrasi baru di bawah layar Kelola Grup, yang memungkinkan mereka untuk mengaktifkan integrasi di grup mereka.

Contoh aplikasi yang sekarang dapat diaktifkan oleh admin grup.

Token & Penggunaan Aplikasi

Saat Anda membuat aplikasi baru untuk Workplace, token akses akan dibuat untuk digunakan dengan Graph API, Account Management API, atau Webhooks.

Token akses ini hanya akan ditampilkan satu kali, jadi penting untuk menyimpan token dengan aman untuk penggunaan nanti dalam kode.

Alur reset token untuk aplikasi integrasi khusus

Token aplikasi Workplace tidak pernah kedaluwarsa, dan tidak perlu dimuat ulang kecuali sudah direset secara manual. Jika Anda mengedit izin yang tersedia untuk aplikasi tertentu, token yang ada akan tetap berfungsi, dan Anda tidak perlu membuat token baru.

Jika Anda perlu membuat token tidak valid, Anda dapat mereset token melalui tombol Reset Token Akses di dialog Edit Aplikasi. Token baru akan dibuat dan ditampilkan, dan token yang ada akan segera dibuat tidak valid.

Keamanan Token

Token akses sangat kuat. Mereka memberikan akses ke data perusahaan Anda di Workplace. Saat membuat aplikasi, pertimbangkan izin minimal yang diperlukan untuk melengkapi fitur integrasi, dan jangan memberikan izin yang tidak diperlukan.

Saat menyimpan token atau menambahkannya ke repositori kode, berhati-hatilah untuk memastikan bahwa token itu tidak dibagikan dengan orang yang salah.

Untuk menambahkan layer keamanan tambahan untuk integrasi, Anda harus menambahkan daftar putih IP, yang akan membatasi penggunaan token ke server hanya pada daftar putih alamat IP.

Menambahkan daftar putih IP untuk membatasi penggunaan token ke server tertentu dan memerlukan Bukti Rahasia Aplikasi

Penghapusan otomatis izin yang tidak digunakan

Jika integrasi khusus tidak melakukan panggilan menggunakan izin tertentu selama 30 hari, izin itu akan dihapus. Setelah ini terjadi sekali untuk integrasi khusus, opsi akan tersedia untuk menghentikan proses penghapusan ini.

Jika langganan Webhooks yang valid telah disiapkan, Webhooks yang dikirim dengan ini dihitung sebagai penggunaan izin yang relevan.

Kontrol untuk penghapusan izin otomatis

Bukti Rahasia Aplikasi

Token akses untuk Workplace tidak kedaluwarsa. Integrasi khusus dapat membutuhkan bukti rahasia aplikasi untuk menambahkan layer keamanan tambahan. Mengaktifkan opsi 'Minta Bukti Rahasia Aplikasi' memastikan bahwa panggilan API hanya dibuat dari kode sisi server, bukti rahasia aplikasi yang segera kedaluwarsa akan diperlukan bersama dengan token akses saat melakukan panggilan API.

Untuk membuat bukti rahasia aplikasi yang segera kedaluwarsa, Anda akan perlu menggabungkan token dengan cap waktu UNIX, dipisahkan oleh simbol pipa |, lalu buat hash SHA-256 dari string gabungan, menggunakan rahasia aplikasi Anda sebagai kodenya. Berikut ini adalah contoh dalam PHP:

$appsecret_proof = hash_hmac('sha256', $access_token.'|'.time(), $app_secret); 

Untuk melakukan panggilan API dengan bukti rahasia aplikasi Anda, teruskan hash yang dibuat melalui parameter appsecret_proof, bersama dengan appsecret_time yang diatur ke cap waktu yang Anda gunakan saat meng-hash rahasia aplikasi, bersama dengan token akses Anda.

GET https://graph.facebook.com/v2.9/community/groups?
&access_token={access-token}
&appsecret_proof={appsecret_proof}
&appsecret_time={appsecret_time}

Menjelajahi Fungsi API dengan Postman

Postman adalah fitur yang banyak digunakan untuk bekerja dengan API web. Anda mungkin merasa nyaman untuk menjelajahi Workplace API menggunakan Postman, tetapi parameter $appsecret_proof menyajikan komplikasi - karena nilai ini harus dihitung dan kedaluwarsa setelah lima menit, masalah akan jadi lebih sederhana jika Postman dapat membuat nilai pada waktu yang diminta. Bahkan Postman dapat melakukannya menggunakan fitur Skrip Sebelum Permintaan & Parameter. Skrip ini dapat digunakan sebagai titik awal:

// Add to Postman's Pre-request Script Tab
var access_token = "replace-me";
var app_secret = "replace-me";
var time = (new Date().getTime()/1000|0);
postman.setEnvironmentVariable("access_token", access_token)
postman.setEnvironmentVariable("appsecret_time", time);
postman.setEnvironmentVariable("appsecret_proof", CryptoJS.HmacSHA256(access_token + '|' + time, app_secret));

1) Buat lingkungan aktif (tidak ada secara default), kemudian 2) tambahkan tiga parameter ini, yang dihitung dengan skrip sebelum permintaan Anda.