{"title":"Bagaimana mengotentikasi menggunakan REMOTE_USER","version":"5.1","locale":"id","docname":"howto/auth-remote-user","url":"/id/5.1/howto/auth-remote-user/","canonical":"https://djangodocs.dev/id/5.1/howto/auth-remote-user/","summary":"Dokumen menjelaskan cara memanfaatkan sumber autentifikasi luar (dimana peladen jaringan menyetel valriabel lingkungan REMOTE_USER) di apllikasi Django anda.","html":"<h1>Bagaimana mengotentikasi menggunakan <code class=\"docutils literal notranslate\">REMOTE_USER</code><a class=\"heading-anchor\" href=\"#how-to-authenticate-using-remote-user\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Dokumen menjelaskan cara memanfaatkan sumber autentifikasi luar (dimana peladen jaringan menyetel valriabel lingkungan <code class=\"docutils literal notranslate\">REMOTE_USER</code>) di apllikasi Django anda. Pemecahan jenis autentifikasi ini khususnya terlihat pada situs intranet, dengan pemecahan single sign-on seperti IIS dan Integrated Windows Authentication atau Apache dan <a class=\"reference external\" href=\"https://httpd.apache.org/docs/current/mod/mod_authnz_ldap.html\">mod_authnz_ldap</a>, <a class=\"reference external\" href=\"https://www.apereo.org/projects/cas\">CAS</a>, <a class=\"reference external\" href=\"https://uit.stanford.edu/service/authentication\">WebAuth</a>, <a class=\"reference external\" href=\"https://sourceforge.net/projects/mod-auth-sspi\">mod_auth_sspi</a>, dll.</p>\n<p>Ketika peladen jaringan mengurus autentifikasi dia khususnya menyetel variabel lingkungan <code class=\"docutils literal notranslate\">REMOTE_USER</code> untuk digunakan dalam aplikasi pokok.  Dalam Django, <code class=\"docutils literal notranslate\">REMOTE_USER</code> dibuat tersedia dalam atribut the <a class=\"reference internal\" href=\"/id/5.1/ref/request-response/#django.http.HttpRequest.META\" title=\"django.http.HttpRequest.META\"><code class=\"xref py py-attr docutils literal notranslate\">request.META</code></a> .  Django dapat dikonfigurasi untuk memanfaatkan nilai <code class=\"docutils literal notranslate\">REMOTE_USER</code> menggunakan <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> atau <code class=\"docutils literal notranslate\">PersistentRemoteUserMiddleware</code>, dan kelas-kelas <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend\" title=\"django.contrib.auth.backends.RemoteUserBackend\"><code class=\"xref py py-class docutils literal notranslate\">RemoteUserBackend</code></a> ditemukan dalam <a class=\"reference internal\" href=\"/id/5.1/topics/auth/#module-django.contrib.auth\" title=\"django.contrib.auth: Django's authentication framework.\"><code class=\"xref py py-mod docutils literal notranslate\">django.contrib.auth</code></a>.</p>\n<section id=\"configuration\">\n<h2>Pengaturan<a class=\"heading-anchor\" href=\"#configuration\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Pertama, andaharus menambahkan <a class=\"reference internal\" href=\"/id/5.1/ref/middleware/#django.contrib.auth.middleware.RemoteUserMiddleware\" title=\"django.contrib.auth.middleware.RemoteUserMiddleware\"><code class=\"xref py py-class docutils literal notranslate\">django.contrib.auth.middleware.RemoteUserMiddleware</code></a> pada pengaturan <a class=\"reference internal\" href=\"/id/5.1/ref/settings/#std-setting-MIDDLEWARE\"><code class=\"xref std std-setting docutils literal notranslate\">MIDDLEWARE</code></a> <strong>setelah</strong> <a class=\"reference internal\" href=\"/id/5.1/ref/middleware/#django.contrib.auth.middleware.AuthenticationMiddleware\" title=\"django.contrib.auth.middleware.AuthenticationMiddleware\"><code class=\"xref py py-class docutils literal notranslate\">django.contrib.auth.middleware.AuthenticationMiddleware</code></a>:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>MIDDLEWARE <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"s2\">&quot;...&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;django.contrib.auth.middleware.AuthenticationMiddleware&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;django.contrib.auth.middleware.RemoteUserMiddleware&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;...&quot;</span><span class=\"p\">,</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<p>Selanjutnya, anda harus mengganti <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.backends.ModelBackend\" title=\"django.contrib.auth.backends.ModelBackend\"><code class=\"xref py py-class docutils literal notranslate\">ModelBackend</code></a> dengan <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend\" title=\"django.contrib.auth.backends.RemoteUserBackend\"><code class=\"xref py py-class docutils literal notranslate\">RemoteUserBackend</code></a> di pengaturan <a class=\"reference internal\" href=\"/id/5.1/ref/settings/#std-setting-AUTHENTICATION_BACKENDS\"><code class=\"xref std std-setting docutils literal notranslate\">AUTHENTICATION_BACKENDS</code></a></p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>AUTHENTICATION_BACKENDS <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"s2\">&quot;django.contrib.auth.backends.RemoteUserBackend&quot;</span><span class=\"p\">,</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<p>Dengan pengaturan ini, <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> akan mengenali nama pengguna di <code class=\"docutils literal notranslate\">request.META['REMOTE_USER']</code> dan akan mengecek keasliannya dan masuk-otomatis bagi pengguna menggunakan <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend\" title=\"django.contrib.auth.backends.RemoteUserBackend\"><code class=\"xref py py-class docutils literal notranslate\">RemoteUserBackend</code></a>.</p>\n<p>Waspada bahwa setelan khusus ini meniadakan pembuktian keaslian dengan awal <code class=\"docutils literal notranslate\">ModelBackend</code>. Ini berarti bahwa jika nilai <code class=\"docutils literal notranslate\">REMOTE_USER</code> tidak disetel kemudian pengguna tidak dapat masuk, bahkan menggunakan antarmuka admin Django. Menambahkan <code class=\"docutils literal notranslate\">'django.contrib.auth.backends.ModelBackend'</code> pada daftar <code class=\"docutils literal notranslate\">AUTHENTICATION_BACKENDS</code> akan menggunakan <code class=\"docutils literal notranslate\">ModelBackend</code> sebagai alternatif jika <code class=\"docutils literal notranslate\">REMOTE_USER</code> tidak hadir, yang akan menyelesaikan masalah ini.</p>\n<p>Pengelola pengguna Django, seperti tampilan dalam perintah pengelola <code class=\"docutils literal notranslate\">contrib.admin</code> dan the <a class=\"reference internal\" href=\"/id/5.1/ref/django-admin/#django-admin-createsuperuser\"><code class=\"xref std std-djadmin docutils literal notranslate\">createsuperuser</code></a>, tidak dipadukan dengan pengguna kendali jauh. Antarmuka ini bekerja dengan pengguna disimpan dalam basisdata tanpa memperhatikan <code class=\"docutils literal notranslate\">AUTHENTICATION_BACKENDS</code>.</p>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Catatan</p>\n<p>Sejak <code class=\"docutils literal notranslate\">RemoteUserBackend</code> warisan dari <code class=\"docutils literal notranslate\">ModelBackend</code>, anda akan masih mempunyai semua pemeriksaan perizinan sama yang diterapkan dalam <code class=\"docutils literal notranslate\">ModelBackend</code>.</p>\n<p>Pengguna dengan <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.models.User.is_active\" title=\"django.contrib.auth.models.User.is_active\"><code class=\"xref py py-attr docutils literal notranslate\">is_active=False</code></a> tidak akan diizinkan mengotentifikasi. Gunakan <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersRemoteUserBackend\" title=\"django.contrib.auth.backends.AllowAllUsersRemoteUserBackend\"><code class=\"xref py py-class docutils literal notranslate\">AllowAllUsersRemoteUserBackend</code></a> jika anda ingin mengizinkan mereka.</p>\n</aside>\n<p>If your authentication mechanism uses a custom HTTP header and not\n<code class=\"docutils literal notranslate\">REMOTE_USER</code>, you can subclass <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> and set the\n<code class=\"docutils literal notranslate\">header</code> attribute to the desired <code class=\"docutils literal notranslate\">request.META</code> key.  For example:</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"python\"><figcaption class=\"code-block-caption\"><code class=\"docutils literal notranslate\">mysite/middleware.py</code></figcaption>\n<div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python code\"><code> <span class=\"kn\">from</span> <span class=\"nn\">django.contrib.auth.middleware</span> <span class=\"kn\">import</span> RemoteUserMiddleware\n\n\n <span class=\"k\">class</span> <span class=\"nc\">CustomHeaderRemoteUserMiddleware</span><span class=\"p\">(</span>RemoteUserMiddleware<span class=\"p\">):</span>\n     header <span class=\"o\">=</span> <span class=\"s2\">&quot;HTTP_AUTHUSER&quot;</span>\n</code></pre></figure>\n<p>This custom middleware is then used in the <a class=\"reference internal\" href=\"/id/5.1/ref/settings/#std-setting-MIDDLEWARE\"><code class=\"xref std std-setting docutils literal notranslate\">MIDDLEWARE</code></a> setting\ninstead of <a class=\"reference internal\" href=\"/id/5.1/ref/middleware/#django.contrib.auth.middleware.RemoteUserMiddleware\" title=\"django.contrib.auth.middleware.RemoteUserMiddleware\"><code class=\"xref py py-class docutils literal notranslate\">django.contrib.auth.middleware.RemoteUserMiddleware</code></a>:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code>MIDDLEWARE <span class=\"o\">=</span> <span class=\"p\">[</span>\n    <span class=\"s2\">&quot;...&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;django.contrib.auth.middleware.AuthenticationMiddleware&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;mysite.middleware.CustomHeaderRemoteUserMiddleware&quot;</span><span class=\"p\">,</span>\n    <span class=\"s2\">&quot;...&quot;</span><span class=\"p\">,</span>\n<span class=\"p\">]</span>\n</code></pre></div>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">Peringatan</p>\n<p>Sangat berhati-hatilah jika menggunakan subkelas <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> dengan kepala HTTP penyesuaian. Anda harus pastikan bahwa peladen jaringan paling depan anda selalu disetel atau memotong kepala itu berdasarkan pada pemeriksaan pembuktian keaslian yang sesuai, jangan pernah mengizinkan pengguna-akhir mengajukan nilai kepala tiruan (atau &quot;palse&quot;). Sejak kepala HTTP <code class=\"docutils literal notranslate\">X-Auth-User</code> dan <code class=\"docutils literal notranslate\">X-Auth_User</code> (sebagai contoh) keduanya menormalkan ke kunci <code class=\"docutils literal notranslate\">HTTP_X_AUTH_USER</code> dalam <code class=\"docutils literal notranslate\">request.META</code>, anda harus juga memeriksa bahwa peladen jaringan anda tidak mengizinkan kepala palsu menggunakan garis bawah di tempat atau strip.</p>\n<p>Peringatan ini tidak berlaku pada <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> dalam konfigurasi awalnya dengan <code class=\"docutils literal notranslate\">header = 'REMOTE_USER'</code>, sejak sebuah kunci tidak dimulai dengan <code class=\"docutils literal notranslate\">HTTP_</code> dalam <code class=\"docutils literal notranslate\">request.META</code> dapat hanya disetel dengan peladen WSGI anda, bukan secara langsung dari kepala meminta HTTP.</p>\n</aside>\n<p>Jika anda butuh lebih kendali, anda dapat membuat backend pembuktian keaslian sendiri yang mewarisi dari <a class=\"reference internal\" href=\"/id/5.1/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend\" title=\"django.contrib.auth.backends.RemoteUserBackend\"><code class=\"xref py py-class docutils literal notranslate\">RemoteUserBackend</code></a> dan menimpa satu atau lebih atribut dan metodenya.</p>\n</section>\n<section id=\"using-remote-user-on-login-pages-only\">\n<span id=\"persistent-remote-user-middleware-howto\"></span><h2>Menggunakan <code class=\"docutils literal notranslate\">REMOTE_USER</code> hanya pada halaman masuk<a class=\"heading-anchor\" href=\"#using-remote-user-on-login-pages-only\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Middleware autentifikasi <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> beranggapan bahwa kepala peminta HTTP <code class=\"docutils literal notranslate\">REMOTE_USE</code> hadir dengan semua permintaan terautentifikasi. Itu mungkin diharapkan dan praktis ketika Basic HTTP Auth dengan <code class=\"docutils literal notranslate\">htpasswd</code> atau mekanisme yang mirip digunakan, tetapi dengan Negotiate (GSSAPI/Kerberos) atau metode otentikasi sumber daya intensif lainnya, autentifikasi dalam peladen HTTP font-end biasanya hanya menyetel untuk satu atau sedikit URL masuk, dan setelah autentifikasi berhasil, aplikasi diharapkan merawat sesu autentifikasi itu sendiri.</p>\n<p><a class=\"reference internal\" href=\"/id/5.1/ref/middleware/#django.contrib.auth.middleware.PersistentRemoteUserMiddleware\" title=\"django.contrib.auth.middleware.PersistentRemoteUserMiddleware\"><code class=\"xref py py-class docutils literal notranslate\">PersistentRemoteUserMiddleware</code></a> menyediakan dukungan untuk penggunaan kasus ini. Dia akan menjaga sesi dibuktikan keasliannya sampai keluar oleh pengguna. Kelas dapat digunakan sebagai pengganti dari <a class=\"reference internal\" href=\"/id/5.1/ref/middleware/#django.contrib.auth.middleware.RemoteUserMiddleware\" title=\"django.contrib.auth.middleware.RemoteUserMiddleware\"><code class=\"xref py py-class docutils literal notranslate\">RemoteUserMiddleware</code></a> dalam dokumentasi diatas.</p>\n</section>","rootId":"how-to-authenticate-using-remote-user","toc":[{"title":"Pengaturan","anchor":"configuration","children":[]},{"title":"Menggunakan REMOTE_USER hanya pada halaman masuk","anchor":"using-remote-user-on-login-pages-only","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Panduan Cara-cara","url":"/id/5.1/howto/"}],"prev":{"docname":"howto/static-files/deployment","title":"Bagaimana menyebarkan berkas tetap","url":"/id/5.1/howto/static-files/deployment/"},"next":{"docname":"howto/csrf","title":"Bagaimana menggunakan perlindungan CSRF Django","url":"/id/5.1/howto/csrf/"},"formats":{"html":"/id/5.1/howto/auth-remote-user/","markdown":"/id/5.1/howto/auth-remote-user.md","json":"/id/5.1/howto/auth-remote-user.json"},"source":"https://github.com/django/django/blob/stable/5.1.x/docs/howto/auth-remote-user.txt","official":"https://docs.djangoproject.com/id/5.1/howto/auth-remote-user/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}