Tips Keamanan Hermes Agent: API Key, Akses Server, dan Privasi

AI agent dapat membantu menjalankan berbagai tugas melalui terminal, tools, integrasi, dan layanan eksternal. Namun, kemampuan tersebut juga membawa risiko keamanan jika akses sistem dan kredensial tidak dikelola dengan benar.

Hermes Agent menyediakan sejumlah mekanisme keamanan, tetapi konfigurasi yang tepat tetap menjadi tanggung jawab pengguna atau administrator yang mengelola lingkungan deployment.

Dalam panduan ini, kita akan membahas cara mengamankan API key, membatasi akses pengguna, melindungi server Linux, dan mengurangi risiko ketika Hermes Agent digunakan pada VPS atau lingkungan produksi.

1. Mengapa Keamanan AI Agent Penting?

AI agent berbeda dari chatbot biasa karena dapat menggunakan tools untuk melakukan tindakan di luar percakapan, bergantung pada konfigurasi dan izin yang tersedia.

Risiko yang perlu diperhatikan meliputi:

1. Kebocoran API key atau token autentikasi.
2. Eksekusi perintah yang tidak diinginkan.
3. Akses ke file atau direktori sensitif.
4. Penggunaan bot oleh pengguna yang tidak berwenang.
5. Biaya model AI akibat penggunaan yang tidak terkendali.
6. Risiko dari konten eksternal yang mengandung instruksi berbahaya atau prompt injection.

Karena itu, keamanan AI agent harus mencakup aplikasi, akun sistem operasi, jaringan, kredensial, dan proses operasional.

2. Lindungi API Key dan Kredensial

API key dapat memberikan akses ke layanan AI atau integrasi eksternal. Jika kredensial bocor, pihak lain berpotensi menyalahgunakannya sesuai izin yang dimiliki.

Hermes Agent menggunakan direktori konfigurasi pengguna untuk menyimpan pengaturan dan kredensial tertentu. Pada instalasi standar, file lingkungan dapat berada di ~/.hermes/.env.

Pada Linux, periksa permission file tersebut:

chmod 600 ~/.hermes/.env

Perintah ini membatasi akses baca dan tulis file kepada pemiliknya. Pastikan pemilik file juga merupakan akun yang benar-benar digunakan untuk menjalankan Hermes Agent.

Terapkan praktik berikut:

1. Jangan mengunggah .env ke repositori Git publik.
2. Jangan menampilkan API key dalam screenshot atau dokumentasi.
3. Gunakan kredensial terpisah untuk lingkungan pengujian dan produksi.
4. Rotasi kredensial jika terindikasi bocor.
5. Gunakan pembatasan kuota atau pengeluaran jika provider menyediakannya.

Hermes Agent juga mendukung mekanisme redaksi secret pada output tools dan log. Namun, redaksi bukan pengganti penyimpanan kredensial yang aman.

3. Jangan Menjalankan Gateway sebagai Root

Menjalankan agent dengan akun root dapat memperbesar dampak kesalahan konfigurasi atau tindakan yang tidak diinginkan.

Untuk deployment gateway, gunakan akun Linux khusus dengan hak akses minimum yang diperlukan.

Periksa akun yang sedang digunakan:

whoami

Jika hasilnya root, evaluasi apakah proses tersebut memang membutuhkan hak istimewa. Untuk penggunaan rutin, jalankan Hermes Agent sebagai pengguna non-root dan berikan izin hanya pada direktori serta layanan yang diperlukan.

Prinsip ini membantu membatasi dampak ketika agent atau salah satu tools mengalami masalah keamanan.

4. Batasi Pengguna yang Dapat Mengakses Bot

Jika Hermes Agent dihubungkan dengan Telegram, Discord, WhatsApp, atau platform pesan lain yang didukung, jangan menganggap bot aman hanya karena berjalan di server pribadi.

Pengaturan otorisasi sangat penting, terutama jika agent dapat menjalankan perintah atau mengakses data.

Hermes Agent menyediakan mekanisme seperti pairing pengguna dan allowlist, bergantung pada platform yang digunakan.

Untuk deployment produksi:

1. Izinkan hanya pengguna yang memang membutuhkan akses.
2. Periksa konfigurasi otorisasi untuk setiap platform.
3. Tinjau pengguna yang telah disetujui secara berkala.
4. Cabut akses yang tidak lagi diperlukan.
5. Hindari mengaktifkan mode akses terbuka tanpa kontrol tambahan.

Jangan menggunakan GATEWAY_ALLOW_ALL_USERS=true pada lingkungan produksi yang sensitif. Pilih mekanisme pairing atau allowlist yang sesuai dengan kebutuhan Anda.

Dokumentasi resmi: https://hermes-agent.nousresearch.com/docs/user-guide/security/

5. Gunakan Isolasi untuk Eksekusi Perintah

Salah satu pertimbangan terpenting adalah lingkungan tempat agent menjalankan perintah.

Jika backend terminal menggunakan host secara langsung, proses yang dijalankan dapat memiliki akses sesuai izin akun Linux tersebut. Karena itu, pembatasan pada tingkat aplikasi saja belum tentu cukup.

Untuk workload yang lebih berisiko, pertimbangkan backend terisolasi yang didukung Hermes Agent, seperti Docker atau sandbox lain yang sesuai dengan kebutuhan.

Jika memilih Docker, periksa:

1. Hak akses container.
2. Direktori host yang di-mount.
3. Port yang diekspos.
4. Resource CPU, RAM, dan storage.
5. Environment variable yang diteruskan ke container.
6. Persistensi data dan prosedur pembaruan.

Isolasi membantu mengurangi risiko, tetapi bukan jaminan keamanan mutlak. Container yang memperoleh akses host terlalu luas tetap dapat menimbulkan risiko.

Dokumentasi resmi: https://hermes-agent.nousresearch.com/docs/user-guide/security/

6. Batasi Akses File dan Direktori

AI agent yang memiliki akses filesystem perlu dijalankan dengan batasan yang sesuai.

Jangan memberikan akses ke seluruh direktori server jika hanya satu direktori kerja yang diperlukan.

Langkah yang dapat diterapkan:

1. Buat direktori khusus untuk pekerjaan agent.
2. Atur kepemilikan dan permission direktori.
3. Pisahkan file proyek dari file kredensial.
4. Hindari menyimpan database produksi atau backup sensitif dalam direktori kerja yang dapat diakses agent.
5. Tinjau tools yang dapat membaca, menulis, atau menghapus file.

Hermes Agent memiliki perlindungan penulisan file untuk sejumlah lokasi sensitif dan mendukung pengaturan safe root. Namun, perlindungan tersebut tidak menggantikan permission sistem operasi atau isolasi eksekusi yang benar.

Jika agent mengakses direktori proyek, pastikan aksesnya memang diperlukan untuk tugas yang diberikan.

7. Waspadai Prompt Injection

Prompt injection terjadi ketika konten yang diproses oleh AI berisi instruksi yang mencoba memengaruhi perilaku agent, misalnya meminta agent mengabaikan instruksi sebelumnya atau mengungkap informasi sensitif.

Konten semacam ini dapat ditemukan pada halaman web, dokumen, file proyek, dan sumber eksternal lainnya.

Beberapa langkah mitigasi:

1. Jangan menganggap semua konten eksternal dapat dipercaya.
2. Batasi akses agent ke file dan layanan sensitif.
3. Hindari memberikan kredensial yang tidak dibutuhkan.
4. Tinjau instruksi dari skills atau integrasi pihak ketiga.
5. Gunakan pembatasan akses jaringan jika workload membutuhkan perlindungan tambahan.
6. Minta persetujuan manusia untuk tindakan yang berisiko tinggi.

Hermes Agent mendokumentasikan pemeriksaan terhadap pola prompt injection pada konteks file tertentu. Mekanisme tersebut membantu mendeteksi sebagian ancaman, tetapi tidak menjamin semua bentuk serangan dapat dikenali.

8. Amankan Akses Jaringan dan Gateway

Jika Hermes Agent berjalan di VPS, pastikan hanya layanan yang diperlukan yang dapat diakses dari luar.

Periksa port yang terbuka, aturan firewall, serta kebutuhan akses jarak jauh.

Prinsip yang dapat diterapkan:

1. Jangan mengekspos antarmuka administratif tanpa autentikasi.
2. Batasi koneksi ke alamat atau jaringan yang diperlukan.
3. Gunakan koneksi terenkripsi untuk layanan yang mendukungnya.
4. Hindari menonaktifkan verifikasi sertifikat TLS hanya untuk mengatasi error koneksi.
5. Pisahkan layanan agent dari sistem produksi yang sensitif jika memungkinkan.

Jika agent perlu menjalankan perintah pada server lain, pertimbangkan pemisahan lingkungan eksekusi menggunakan akun khusus dan akses SSH yang terbatas.

9. Aktifkan Monitoring dan Audit

Keamanan bukan hanya tentang pencegahan, tetapi juga kemampuan mendeteksi aktivitas yang tidak biasa.

Pantau aspek berikut:

1. Status gateway dan proses.
2. Penggunaan CPU, RAM, dan storage.
3. Log aplikasi dan sistem.
4. Kegagalan autentikasi.
5. Perubahan konfigurasi.
6. Penggunaan API dan biaya provider.
7. Perubahan allowlist dan izin akses.

Hindari menyimpan secret mentah dalam log. Batasi akses ke log dan tentukan masa retensi yang sesuai dengan kebutuhan operasional.

Jika menemukan aktivitas mencurigakan, pertimbangkan untuk menonaktifkan integrasi yang terdampak, mencabut kredensial, memeriksa akses pengguna, dan memulihkan sistem dari kondisi yang diketahui aman.

10. Perbarui Hermes Agent Secara Teratur

Pembaruan dapat membawa perbaikan bug, kompatibilitas, dan keamanan. Namun, pembaruan pada lingkungan produksi sebaiknya dilakukan secara terencana.

Sebelum memperbarui:

1. Periksa catatan rilis dan perubahan yang relevan.
2. Cadangkan konfigurasi serta data yang diperlukan.
3. Uji pembaruan pada lingkungan non-produksi jika memungkinkan.
4. Pastikan prosedur pemulihan tersedia.
5. Verifikasi fungsi utama setelah pembaruan.

Gunakan dokumentasi resmi untuk memastikan metode pembaruan sesuai dengan cara instalasi yang digunakan.

11. Checklist Keamanan Hermes Agent

Gunakan checklist berikut sebelum agent digunakan untuk tugas yang lebih sensitif.

1. API key disimpan secara aman.
2. File kredensial memiliki permission yang sesuai.
3. Hermes Agent tidak berjalan sebagai root tanpa alasan yang kuat.
4. Akses bot dibatasi dengan pairing atau allowlist.
5. Mode akses terbuka tidak digunakan tanpa kontrol yang memadai.
6. Backend eksekusi dipilih berdasarkan tingkat risiko.
7. Akses file dan direktori dibatasi.
8. Integrasi serta skills pihak ketiga telah ditinjau.
9. Firewall dan port jaringan telah diperiksa.
10. Log, penggunaan API, dan status proses dipantau.
11. Prosedur backup dan pemulihan tersedia.
12. Pembaruan keamanan dilakukan secara terencana.

Kesimpulan

Mengamankan Hermes Agent membutuhkan pendekatan berlapis. Perlindungan API key, pembatasan akses pengguna, isolasi eksekusi, keamanan jaringan, dan monitoring perlu diterapkan sesuai risiko serta kebutuhan penggunaan.

Untuk eksperimen lokal, konfigurasi sederhana mungkin memadai. Namun, untuk deployment pada VPS, integrasi pesan, atau proses bisnis perusahaan, lakukan penilaian risiko sebelum memberikan akses ke data dan sistem penting.

Artikel terkait:

1. Cara Install Hermes Agent di Ubuntu
2. Cara Menjalankan Hermes Agent di VPS Linux
3. Cara Konfigurasi Hermes Agent dan Model AI
4. Cara Menghubungkan Hermes Agent dengan Platform Pesan

Artikel ini disusun untuk edukasi teknis dan bukan pengganti penilaian keamanan lingkungan produksi. Periksa dokumentasi resmi Hermes Agent untuk detail fitur dan konfigurasi sesuai versi yang Anda gunakan.