{"title":"Otentikasi menggunakan REMOTE_USER","version":"2.1","locale":"id","docname":"howto/auth-remote-user","url":"/id/2.1/howto/auth-remote-user/","canonical":"https://djangodocs.dev/id/2.1/howto/auth-remote-user/","summary":"Dokumen ini menjelaskan bagaimana memanfaatkan sumber otentikasi eksternal (di mana server Web menetapkan variabel environment REMOTE_USER) dalam aplikasi…","html":"<h1>Otentikasi menggunakan <code class=\"docutils literal notranslate\">REMOTE_USER</code><a class=\"heading-anchor\" href=\"#authentication-using-remote-user\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Dokumen ini menjelaskan bagaimana memanfaatkan sumber otentikasi eksternal (di mana server Web menetapkan variabel environment <code class=\"docutils literal notranslate\">REMOTE_USER</code>) dalam aplikasi Django Anda. Jenis solusi otentikasi biasanya terlihat di situs intranet, dengan solusi single sign-on seperti IIS dan Integrated Windows Authentication atau Apache dan <a class=\"reference external\" href=\"https://httpd.apache.org/docs/2.2/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=\"http://weblogin.org\">Cosign</a>,` WebAuth`_, <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>mod_auth_sspi <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>_, dll</p>\n<p>Ketika peladen Jaringan mengurus pembuktian keaslian 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> adalah dibuat tersedia dalam atribut <a class=\"reference internal\" href=\"/id/2.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 dikonfigurasikan untuk  memanfaatkan nilai  <code class=\"docutils literal notranslate\">REMOTE_USER</code> menggunakan <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> atau``PersistentRemoteUserMiddleware``, dan kelas <a class=\"reference internal\" href=\"/id/2.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/2.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/2.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/2.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/2.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=\"s1\">&#39;...&#39;</span><span class=\"p\">,</span>\n    <span class=\"s1\">&#39;django.contrib.auth.middleware.AuthenticationMiddleware&#39;</span><span class=\"p\">,</span>\n    <span class=\"s1\">&#39;django.contrib.auth.middleware.RemoteUserMiddleware&#39;</span><span class=\"p\">,</span>\n    <span class=\"s1\">&#39;...&#39;</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/2.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/2.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/2.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=\"s1\">&#39;django.contrib.auth.backends.RemoteUserBackend&#39;</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/2.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/2.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/2.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/2.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>Jika mekanisme pembuktian keaslian anda menggunakan kepala HTTP penyesuaian dan bukan <code class=\"docutils literal notranslate\">REMOTE_USER</code>, anda dapat men subkelas kan <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> dan menyetel atribut <code class=\"docutils literal notranslate\">header</code> ke kunci <code class=\"docutils literal notranslate\">request.META</code> yang diinginkan. Sebagai contoh:</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><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.auth.middleware</span> <span class=\"kn\">import</span> RemoteUserMiddleware\n\n<span class=\"k\">class</span> <span class=\"nc\">CustomHeaderMiddleware</span><span class=\"p\">(</span>RemoteUserMiddleware<span class=\"p\">):</span>\n    header <span class=\"o\">=</span> <span class=\"s1\">&#39;HTTP_AUTHUSER&#39;</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/2.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>Pembuktian keaslian middleware <code class=\"docutils literal notranslate\">RemoteUserMiddleware</code> menganggap bahwa kepala permintaan HTTP <code class=\"docutils literal notranslate\">REMOTE_USER</code> mewakili dengan semua permintaan dibuktikan keaslian. Itu mungkin diharapkan dan secara praktiknya ketika Pembuktian Keaslian HTTP Dasar dengan <code class=\"docutils literal notranslate\">htpasswd</code> atau mekanisme sederhana lainnya digunakan, tetapi dengan Negotiate (GSSAPI/Kerberos) atau cara pembuktian keaslian intensif sumber daya lainnya, pembuktian keaslian dalam peladen HTTP depan biasanya hanya disetel untuk satu atau sedikit URL masuk, dan setelah berhasil dibuktikan keasliannya, aplikasi seharusnya menjaga sesi dibuktikan keasliannya sendiri.</p>\n<p><a class=\"reference internal\" href=\"/id/2.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/2.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":"authentication-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 \"Bagaimana\"","url":"/id/2.1/howto/"}],"prev":{"docname":"howto/index","title":"Panduan \"Bagaimana\"","url":"/id/2.1/howto/"},"next":{"docname":"howto/custom-management-commands","title":"Menulis perintah django-admin penyesuaian","url":"/id/2.1/howto/custom-management-commands/"},"formats":{"html":"/id/2.1/howto/auth-remote-user/","markdown":"/id/2.1/howto/auth-remote-user.md","json":"/id/2.1/howto/auth-remote-user.json"},"source":"https://github.com/django/django/blob/stable/2.1.x/docs/howto/auth-remote-user.txt","official":"https://docs.djangoproject.com/id/2.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","pt-br","ko","es","el","pl"]}