Daftar Isi
Error 401 pada Dify Self‑Hosted: Mengapa Terjadi dan Cara Mengatasinya
Dalam lingkungan self-hosted, error 401 Unauthorized sering muncul pada Dify 1.4.1 Docker. Masalah ini biasanya terjadi saat Agent ReAct memanggil workflow tool di dalam ChatFlow. Padahal, workflow tersebut sudah dikonfigurasi dan dipublikasikan dengan benar.
Secara ideal, node Agent harus bisa menjalankan tool tanpa kendala otorisasi internal. Namun, kegagalan autentikasi sering mengganggu stabilitas sistem pada versi ini. Sistem akan mengembalikan pesan “Invalid Authorization token” saat Agent mencoba memanggil tool.
Implementasi platform AI yang andal memerlukan konfigurasi keamanan yang tepat agar integrasi antar layanan berjalan mulus. Error 401 menunjukkan bahwa token otorisasi internal tidak valid atau tidak konsisten. Anda perlu meninjau konfigurasi lingkungan dan sinkronisasi kunci internal secara sistematis.
Memeriksa Variabel Lingkungan dan Konsistensi Kunci
Langkah awal yang krusial adalah memverifikasi berkas .env. Pastikan semua variabel autentikasi sudah diatur secara konsisten. Periksa kembali variabel seperti SECRET_KEY dan DIFY_INNER_API_KEY.
Kunci API internal wajib identik di seluruh layanan yang saling berkomunikasi. Perbedaan satu karakter saja akan menggagalkan pemanggilan API internal. Pastikan juga tidak ada salinan berkas .env yang saling bertentangan. Selaraskan seluruh nilai kunci untuk memudahkan pemeliharaan di kemudian hari.
Sinkronisasi plugin_daemon dengan DIFY_INNER_API_KEY
Layanan plugin_daemon sering menjadi sumber masalah yang terlewatkan. Banyak kasus error 401 terjadi karena layanan ini tidak menggunakan kunci internal yang sama. Anda wajib memperbarui konfigurasi plugin_daemon jika mengubah DIFY_INNER_API_KEY utama.
Tinjau berkas docker-compose.yaml untuk menghindari penggunaan nilai kunci yang usang. Setelah memperbarui nilai tersebut, lakukan restart pada seluruh kontainer Docker. Hal ini memastikan variabel lingkungan baru benar-benar diterapkan pada sistem.
Mengelola Masa Berlaku Token
Masa berlaku access token diatur melalui variabel ACCESS_TOKEN_EXPIRE_MINUTES. Nilai standarnya adalah 60 menit, namun bisa disesuaikan dengan kebutuhan. Token yang kedaluwarsa akan memicu proteksi standar berupa error 401 Unauthorized.
Periksa kembali nilai tersebut di berkas .env Anda. Jika Anda meregenerasi kunci, segera perbarui semua layanan yang bergantung pada token tersebut. Pastikan tidak ada data lama yang tersimpan di dalam cache kontainer. Restart penuh sering kali diperlukan untuk membersihkan konfigurasi lama.
Bug Backend pada Dify 1.4.1
Selain persoalan konfigurasi, bug backend pada versi 1.4.1 juga bisa menjadi penyebab. Bug ini memengaruhi Agent ReAct saat memanggil workflow tool dalam ChatFlow kompleks. Menariknya, tool yang sama biasanya berfungsi normal jika dipanggil secara mandiri.
Masalah ini berkaitan dengan cara sistem menangani token internal secara otomatis. Perbaikan untuk bug ini sudah tersedia pada rilis setelah versi 1.4.1. Jika konfigurasi Anda sudah benar namun error tetap muncul, Anda mungkin terdampak bug ini. Solusi paling efektif adalah melakukan upgrade ke versi terbaru.
Pemeriksaan Konfigurasi Tambahan
Verifikasi format header Authorization pada setiap pemanggilan internal. Format yang benar adalah Authorization: Bearer KEY. Hindari penggunaan kurung kurawal atau spasi berlebih pada format tersebut.
Kesalahan kecil seperti penambahan karakter asing sering kali luput dari perhatian. Hal ini cukup untuk menggagalkan proses autentikasi sistem. Selain itu, pastikan format kunci API sudah sesuai dengan standar dokumentasi teknis Dify.
Saatnya Mempertimbangkan Upgrade
Jika semua langkah konfigurasi gagal, saatnya mempertimbangkan untuk melakukan upgrade. Terkadang, bug pada versi 1.4.1 sulit diatasi hanya melalui perubahan variabel lingkungan. Versi terbaru Dify telah menyertakan perbaikan penanganan token yang lebih stabil.
Menghabiskan waktu terlalu lama pada konfigurasi usang sering kali tidak sebanding dengan hasilnya. Melakukan upgrade akan memulihkan keandalan pemanggilan tool oleh node Agent. Langkah strategis ini akan menjamin stabilitas jangka panjang lingkungan Docker Anda.
