Panduan Antarmuka Pemrograman Aplikasi (API) Intel® Endpoint Management Assistant (Intel® EMA)

Panduan API Intel® EMA memberikan garis besar bagi administrator dan pengembang TI tentang Antarmuka Pemrograman Aplikasi (API) Intel® Endpoint Management Assistant (Intel® EMA).

Dokumen PDF memberikan informasi umum bagi pengembang tentang Intel® EMA Application Programming Interface (API). Informasi terperinci tentang URI API individual (seperti deskripsi dan parameter) terdapat dalam dua file HTML berikut. Latestswagger.html berisi jalur API yang selalu mengarah ke versi API terbaru yang dirilis. Selain itu, file detail URI API versi 9, V9swagger.html, juga disediakan. Untuk melihat informasi URI API terperinci ini, unduh file HTML yang diinginkan dan buka di browser (Chrome berfungsi paling baik).

Detail API Intel EMA Tambahan:
API Intel® Endpoint Management Assistant (Intel® EMA) adalah seperangkat antarmuka terprogram yang dirancang untuk memungkinkan pengembang dan administrator TI berinteraksi dengan Intel® EMA. API ini memfasilitasi pengelolaan dan pemantauan perangkat endpoint, mengotomatiskan tugas administratif, dan mengintegrasikan kemampuan Intel® EMA ke dalam solusi perangkat lunak lainnya.

Lingkungan yang Diperlukan:
Intel® EMA server harus diinstal dan dijalankan.
Izin akses dan kredensial API yang sesuai diperlukan.

Fitur dan Kemampuan Utama:

Manajemen Perangkat:
Mengelola dan memantau perangkat endpoint dari jarak jauh.
Otomatisasi: Mengotomatiskan tugas administratif seperti pembaruan perangkat lunak, reboot perangkat, dan perubahan konfigurasi.
Integrasi: Mengintegrasikan fungsi Intel® EMA ke dalam solusi perangkat lunak dan alur kerja lainnya.
Keamanan: Kelola perangkat secara aman dengan mekanisme autentikasi dan otorisasi.

Kasus Penggunaan:
Provisi Perangkat Otomatis: Menyediakan dan mengonfigurasi perangkat baru secara otomatis.
Pemecahan Masalah Jarak Jauh: Mendiagnosis dan menyelesaikan masalah pada perangkat endpoint dari jarak jauh.
Penyebaran Perangkat Lunak: Mengotomatiskan penyebaran pembaruan dan tambalan perangkat lunak.
Pemantauan Kepatuhan: Pastikan perangkat mematuhi kebijakan dan standar organisasi.

Persiapan:

Persyaratan Perangkat Lunak:
Intel® EMA server harus diinstal dan dijalankan.
Izin Akses: Izin akses dan kredensial API yang sesuai diperlukan. Izin ini diuraikan secara rinci dalam file JSON Swagger.
Pembuatan Kunci API: Buat kunci API dari konsol Intel® EMA.
Konfigurasi: Konfigurasikan pengaturan jaringan dan pastikan server Intel® EMA dapat diakses.

Autentikasi dan Keamanan:

Autentikasi Token:
Menggunakan nama pengguna dan kata sandi terkait untuk akun server Intel® EMA.
Autentikasi Active Directory: Menggunakan kredensial dari Active Directory. Ini hanya dapat digunakan ketika Intel® EMA diinstal dengan mode Otentikasi Domain Windows*, dan server Intel® EMA bergabung ke domain Active Directory.
Autentikasi Kredensial Klien: Dirancang untuk akses API ke server Intel® EMA. Anda perlu membuat akun kredensial klien dan rahasia klien di server Intel® EMA.
Autentikasi Microsoft* Entra: Diperkenalkan pada Intel® EMA 1.9.0, ini memungkinkan autentikasi untuk antarmuka web Intel® EMA menggunakan Azure Active Directory, yang dikenal sebagai Microsoft Entra.

Praktik Terbaik Keamanan:
Gunakan HTTPS: Selalu gunakan HTTPS untuk mengenkripsi data saat transit.
Hak Istimewa Paling Sedikit: Berikan izin minimum yang diperlukan kepada pengguna API.
Password Hashing: Jangan menyimpan password dalam file clear-text.

Penanganan Kesalahan dan Pemecahan Masalah:

Kode Kesalahan Umum:
400 Permintaan Buruk: Parameter input tidak valid.
401 Tidak Sah: Kredensial autentikasi tidak valid atau hilang.
404 Tidak Ditemukan: Sumber daya tidak ditemukan.
500 Internal Server Error: Server mengalami kondisi yang tidak terduga.

Tips Pemecahan Masalah:
Periksa Kunci API: Pastikan kunci API valid dan memiliki izin yang diperlukan.
Validasi Input: Verifikasi bahwa parameter input sudah benar dan diformat dengan benar.
Masalah Jaringan: Pastikan tidak ada masalah konektivitas jaringan antara klien dan server Intel® EMA.