Dokumen ini menjelaskan penggunaan dari sistem otentifikasi Django di konfigurasi awalannya. Konfigurasi ini telah berkembang untuk melayani kebutuhan proyek paling umum, menangani jangkauan luas beralasan dari tugas, dan mempunyai penerapan cermat dari sandi dan perizinan. Untuk proyek dimana otentifikasi butuh berbeda dari awalan, Django mendukung extension and customization luas dari otentifikasi.
\nOtentifikasi Django menyediakan kedua otentifikasi dan otorisasi bersama-sama dan umumnya mengacu pada sebagai sistem otentifikasi, ketika fitur ini agak digabungkan.
\nUserLink to this heading#Obyek User adalah inti dari sistem autentifikasi. Mereka khususnya mewakili orang berinteraksi dengan situs anda dan digunakan untuk mengadakan hal-hal seperti membatasi akses, mendaftarkan profil pengguna, menyatukan isi dengan pembuat dll. Hanya satu kelas dari pengguna yang ada di otentifikasi kerangka kerja Django, yaitu, 'superusers' atau admin pengguna 'staff' hanya obyek user dengan sekumpulan atribut khusus, bukan kelas-kelas berbeda dari obyek user.
Atribut utama dari pengguna awal adalah:
\nSee the User API documentation for a\ncomplete reference. The documentation that follows is more task-oriented.
Cara paling langsung untuk membuat pengguna adalah dengan menggunakan fungsi pembantu create_user() yang disertakan:
>>> from django.contrib.auth.models import User\n>>> user = User.objects.create_user("john", "lennon@thebeatles.com", "johnpassword")\n\n# At this point, user is a User object that has already been saved\n# to the database. You can continue to change its attributes\n# if you want to change other fields.\n>>> user.last_name = "Lennon"\n>>> user.save()\nJika anda mempunai admin Django dipasang, anda dapat juga create users interactively.
\nBuat pengguna super menggunakan perintah createsuperuser:
Linux / macOS
$ python manage.py createsuperuser --username=joe --email=joe@example.com\nWindows
...\\> py manage.py createsuperuser --username=joe --email=joe@example.com\nAnda akan diminta untuk sandi. Setelah anda memasukkan satu, pengguna akan membuat dengan segera. Jika anda membiarkan mati pilihan --username atau --email, itu akan meminta anda untuk nilai-nilai tersebut.
Django tidak menyimpan sandi (teks bersih) mentah pada model user, tetapi hanya campuran (lihat documentation of how passwords are managed untuk rincian penuh). Karena dari ini, jangan mencoba untuk mengubah atribut sanddi dari pengguna secara langsung. Ini adalah mengapa fungsi pembantu digunakan ketika membuat pengguna.
\nUntuk merubah sandi pengguna, anda mempunyai beebrapa pilihan:
\nmanage.py changepassword *username* menawarkan metode dari merubah sandi pengguna dari baris perintah. Itu mendorong anda merubah sandi dari pengguna yang diberikan yang anda harus masukkan dua kali. Jika mereka kedua cocok, sandi baru akan berubah segera. Jika anda tidak memasok pengguna, perintah akan berusaha merubah sandi yang nama pengguna cocok dengan pengguna sistem saat ini.
You can also change a password programmatically, using\nset_password():
>>> from django.contrib.auth.models import User\n>>> u = User.objects.get(username="john")\n>>> u.set_password("new password")\n>>> u.save()\nJika anda mempunyai admin Django terpasang, anda dapat juga merubah sandi pengguna pada halaman admin sistem pembuktian keaslian.
\nDjango juga menyediakan views dan forms yang mungkin digunakan untuk mengizinkan pengguna merubah sandi mereka sendiri.
\nMerubah sandi pengguna akan keluar semua sesi mereka. Lihat Penghapusan sesi pada perubahan sandi untuk rincian.
\nVersi asinkron: aauthenticate()
Use authenticate() to verify a set of\ncredentials. It takes credentials as keyword arguments, username and\npassword for the default case, checks them against each\nauthentication backend, and returns a\nUser object if the credentials are\nvalid for a backend. If the credentials aren't valid for any backend or if\na backend raises PermissionDenied, it\nreturns None. For example:
from django.contrib.auth import authenticate\n\nuser = authenticate(username="john", password="secret")\nif user is not None:\n # A backend authenticated the credentials\n ...\nelse:\n # No backend authenticated the credentials\n ...\nrequest adalah sebuah pilihan HttpRequest yang dilewatkan pada metode authenticate() dari backend autentifikasi.
Django uses sessions and middleware to hook the\nauthentication system into HttpRequest objects.
Ini menyediakan atribut metode asinkron request.user dan request.auser pada setiap permintaan yang mewakili pengguna saat ini. Jika pengguna saat ini tidak masuk, atribut ini akan mensetel instance dari AnonymousUser, sebaliknya itu akan menjadi instance User.
Anda dapat memberitahu mereka selain dengan is_authenticated, seperti begitu
if request.user.is_authenticated:\n # Do something for authenticated users.\n ...\nelse:\n # Do something for anonymous users.\n ...\nAtau dalam tampilan asinkron:
\nuser = await request.auser()\nif user.is_authenticated:\n # Do something for authenticated users.\n ...\nelse:\n # Do something for anonymous users.\n ...\nJika anda mempunyai pengguna terotentifikasi anda ingin lampirkan ke sesi saat ini - ini dilakukan dengan fungsi login().
Versi asinkron: alogin()
To log a user in, from a view, use login(). It\ntakes an HttpRequest object and a\nUser object.\nlogin() saves the user's ID in the session,\nusing Django's session framework.
Catat bahwa tiap data disetel selama sesi anonim dipertahankan di sesi setelah pengguna masuk.
\nThis example shows how you might use both\nauthenticate() and\nlogin():
from django.contrib.auth import authenticate, login\n\n\ndef my_view(request):\n username = request.POST["username"]\n password = request.POST["password"]\n user = authenticate(request, username=username, password=password)\n if user is not None:\n login(request, user)\n # Redirect to a success page.\n ...\n else:\n # Return an 'invalid login' error message.\n ...\nKetika seorang pengguna masuk, ID pengguna dan backend yang telah digunakan untuk autentifikasi disimpan dalam sesi pengguna. Ini mengizinkan authentication backend sama untuk mengambil rincian pengguna pada permintaan akan datang. Backend autentifikasi untuk menyimpan sesi dipilih sebagai berikut:
\nGunakan nilai dai argumen backend pilihan, jika disediakan.
Use the value of the user.backend attribute, if present. This allows\npairing authenticate() and\nlogin():\nauthenticate()\nsets the user.backend attribute on the user object it returns.
Gunakan backend dalam AUTHENTICATION_BACKENDS, jika hanya ada satu.
Sebaliknya, munculkan sebuah pengecualian.
Di kasus 1 dan 2, nilai dari argumen backend atau atribut user.backend harus di impor bertitik jalur deretan karakter (seperti yang ditemukan di AUTHENTICATION_BACKENDS), bukan kelas backend sebenarnya.
Versi asinkron: alogout()
To log out a user who has been logged in via\ndjango.contrib.auth.login(), use\ndjango.contrib.auth.logout() within your view. It takes an\nHttpRequest object and has no return value.\nExample:
from django.contrib.auth import logout\n\n\ndef logout_view(request):\n logout(request)\n # Redirect to a success page.\nNote that logout() doesn't throw any errors if\nthe user wasn't logged in.
When you call logout(), the session data for\nthe current request is completely cleaned out. All existing data is\nremoved. This is to prevent another person from using the same web browser\nto log in and have access to the previous user's session data. If you want\nto put anything into the session that will be available to the user\nimmediately after logging out, do that after calling\ndjango.contrib.auth.logout().
Cara mentah untuk membatasi akses ke halaman adalah dengan memeriksa request.user.is_authenticated dan mengarahkan ulang ke halaman login:
from django.conf import settings\nfrom django.shortcuts import redirect\n\n\ndef my_view(request):\n if not request.user.is_authenticated:\n return redirect(f"{settings.LOGIN_URL}?next={request.path}")\n # ...\n...atau menampilkan pesan kesalahan:
\nfrom django.shortcuts import render\n\n\ndef my_view(request):\n if not request.user.is_authenticated:\n return render(request, "myapp/login_error.html")\n # ...\nlogin_requiredLink to this heading#Sebagai jalan pintas, anda dapat menggunakan penghias login_required() yang cocok.
from django.contrib.auth.decorators import login_required\n\n\n@login_required\ndef my_view(request): ...\nlogin_required() melakukan berikut:
Jika pengguna tidak masuk, alihkan ke settings.LOGIN_URL, melewati jalur mutlak saat ini di permintaan deretan karakter. Contoh: /accounts/login/?next=/polls/3/.
Jika pengguna masuk, jalankan tampilan secara biasa. Kode tampilan adalah bebas untuk menganggap pengguna adalah masuk.
Secara awalan, jalur yang pengguna harus dialihkan untuk atas keberhasilan otentifikasi adalah disimpan di permintaan parameter deretan karakter disebut "next". Jika anda akan memilih menggunakan nama berbeda untuk parameter ini, login_required() mengambil sebuah pilihan parameter redirect_field_name.
from django.contrib.auth.decorators import login_required\n\n\n@login_required(redirect_field_name="my_redirect_field")\ndef my_view(request): ...\nCatat bahwa jika anda menyediakan nilai pada redirect_field_name, anda akan paling disukai butuh menyesuaikan cetakan masuk anda juga, sejak cetakan varaibel konteks yang menyimpan jalur pengalihan akan menggunakan nilai dari redirect_field_name``sebagai kuncinya daripada ``"next" (awalan).
login_required() juga mengambil sebuah pilihan parameter login_url. Contoh:
from django.contrib.auth.decorators import login_required\n\n\n@login_required(login_url="/accounts/login/")\ndef my_view(request): ...\nCatat bahwa jika anda tidak menentukan parameter login_url, anda akan butuh memastikan bahwa settings.LOGIN_URL dan tampilan masuk anda benar terhubung. Sebagai contoh, menggunakan awalan, tambah baris berikut ke URLconf anda:
from django.contrib.auth import views as auth_views\n\npath("accounts/login/", auth_views.LoginView.as_view()),\nsettings.LOGIN_URL juga menerima nama-nama fungsi tampilan dan named URL patterns. Ini mengizinkan anda secara bebas memetakan kembali ke tampilan masuk anda dalam URLconf tanpa harus memperbaharui pengaturan.
LoginRequiredMixinLink to this heading#Ketika menggunakan class-based views, anda dapat mencapai kebiasaan lama seperti dengan login_required dengan menggunakan LoginRequiredMixin. Mixin harus di tempat paling kanan di daftar warisan.
Jika sebuah tampilan menggunakan mixin ini, semua permintaan oleh pengguna bukan-terotentifikasi akan dialihkan ke halaman masuk atau menampilkan kesalahan HTTP 403 Forbidden, tergantung pada parameter raise_exception.
Anda dapat menyetel tiap dari parameter dari AccessMixin untuk menyesuaikan menangani dari pengguna tidak sah:
from django.contrib.auth.mixins import LoginRequiredMixin\n\n\nclass MyView(LoginRequiredMixin, View):\n login_url = "/login/"\n redirect_field_name = "redirect_to"\nlogin_not_requiredLink to this heading#When LoginRequiredMiddleware is\ninstalled, all views require authentication by default. Some views, such as the\nlogin view, may need to disable this behavior.
Allows unauthenticated requests to this view when\nLoginRequiredMiddleware is\ninstalled.
Untuk membatasi akses berdasarkan pada perizinan tertentu atau beberapa percobaan lain, anda akan melakukan pada dasarnya hal sama seperti digambarkan di bagian sebelumnya.
\nAnda dapat menjalankan pengujian anda pada request.user di tampilan secara langsung. Misalnya, tampilan ini memeriksa untuk memastikan pengguna memiliki surel di domain yang diinginkan dan jika tidak, dialihkan ke halaman login
from django.shortcuts import redirect\n\n\ndef my_view(request):\n if not request.user.email.endswith("@example.com"):\n return redirect("/login/?next=%s" % request.path)\n # ...\nSebagai sebuah jalan pintas, anda dapat menggunakan penghias user_passes_test yang cocok yang melakukan sebuah pengalihan ketika callable mengembalikan False:
from django.contrib.auth.decorators import user_passes_test\n\n\ndef email_check(user):\n return user.email.endswith("@example.com")\n\n\n@user_passes_test(email_check)\ndef my_view(request): ...\nuser_passes_test() mengambil argumen wajib: sebuah callable yang mengambil obyek User dan mengembalikan True jika pengguna diizinkan melihat halaman. Catat bahwa user_passes_test() tidak secara otomatis memeriksa bahwa the User bukan anonim.
user_passes_test() mengambil dua argumen pilihan:
login_urlBiarkan anda menentukan URL yang pengguna tidak melewati percobaan akan dialihkan. Itu mungkin halaman masuk dan awalan ke settings.LOGIN_URL jika anda tidak menentukan satu.
redirect_field_nameSama seperti login_required(). Atur itu ke None memindahkannya dari URL, yang anda mungkin ingin melakukannya jika anda mengalihkan pengguna yang tidak melewati percobaan ke halaman bukan-masuk dimana tidak ada "next page".
Sebagai contoh:
\n@user_passes_test(email_check, login_url="/login/")\ndef my_view(request): ...\nKetika menggunakan class-based views, anda dapat menggunakan UserPassesTestMixin untuk melakukan ini.
Anda harus menimpa metode test_func() dari kelas untuk menyediakan percobaan yang dilakukan. Lebih lanjut, anda dapat menyetel tiap parameter dari AccessMixin untuk menyesuaikan penangangan dari pengguna tidak sah:
from django.contrib.auth.mixins import UserPassesTestMixin\n\n\nclass MyView(UserPassesTestMixin, View):\n def test_func(self):\n return self.request.user.email.endswith("@example.com")\nAnda dapat juga menimpa metode get_test_func() untuk memiliki penggunaan mixin fungsi bernama berbeda untuk pemeriksaannya (sebagai ganti test_func()).
permission_requiredLink to this heading#It's a relatively common task to check whether a user has a particular\npermission. For that reason, Django provides a shortcut for that case: the\npermission_required() decorator:
from django.contrib.auth.decorators import permission_required\n\n\n@permission_required("polls.add_choice")\ndef my_view(request): ...\nSama seperti metode has_perm(), nama izin mengambil bentuk "<app label>.<permission codename>" (yaitu polls.add_choice untuk izin pada model di aplikasi polls).
Penghias mungkin juga mengambil perizinan berulang, dalam hal ini pengguna harus memiliki semua perizinan untuk mengakses tampilan.
\nNote that permission_required()\nalso takes an optional login_url parameter:
from django.contrib.auth.decorators import permission_required\n\n\n@permission_required("polls.add_choice", login_url="/loginpage/")\ndef my_view(request): ...\nKetika di penghias login_required(), awalan login_url ke settings.LOGIN_URL.
Jika parameter raise_exception diberikan, penghias akan memunculkan PermissionDenied, mendorong the 403 (HTTP Forbidden) view daripada mengalihkan ke halaman masuk.
Jika anda ingin menggunakan raise_exception tetapi juga memberikan pengguna anda kesempatan untuk masuk terlebih dahulu, anda dapat menambahkan penghias login_required():
from django.contrib.auth.decorators import login_required, permission_required\n\n\n@login_required\n@permission_required("polls.add_choice", raise_exception=True)\ndef my_view(request): ...\nIni juga menghindari peralihan pengulangan ketika LoginView redirect_authenticated_user=True dan pengguna yang masuk tidak memiliki semua izin yang diperlukan.
PermissionRequiredMixinLink to this heading#Untuk memberlakukan pemeriksaan perizinan pada class-based views, anda dapat menggunakan PermissionRequiredMixin:
Mixin ini, seperti penghias permission_required, memeriksa apakah pengguna mengakses sebuah tampilan mempunyai semua perizinan yang diberikan. Anda harus menentukan perizinan (atau perulangan dari perizinan) menggunakan parameter permission_required:
from django.contrib.auth.mixins import PermissionRequiredMixin\n\n\nclass MyView(PermissionRequiredMixin, View):\n permission_required = "polls.add_choice"\n # Or multiple of permissions:\n permission_required = ["polls.view_choice", "polls.change_choice"]\nAnda dapat menyetel tiap dari parameter dari AccessMixin untuk menyesuaikan menangani dari pengguna tidak sah.
Anda dapat juga menimpa metode ini:
\nMengembalikan perulangan dari nama perizinan digunakan oleh mixin. Awalan pada atribut permission_required, dirubah ke sebuah tuple juka memungkinkan.
Returns a boolean denoting whether the current user has permission to\nexecute the decorated view. By default, this returns the result of\ncalling has_perms() with the\nlist of permissions returned by get_permission_required().
Django menyediakan beberapa tampilan yang anda dapat gunakan untuk menangani masuk, keluarm dan pengelolaan sandi. Ini menggunakan dari stock auth forms tetapi anda dapat melewatkan nya ke dalam formulir anda sendiri juga.
\nDjango menyediakan tidak ada awalan cetakan untuk tampilan otentifikasi. Anda harus membuat cetakan anda sendiri untuk tampilan anda ingin gunakan. Konteks cetakan adalah terdokumentasi di setiap tampilan, lihat Semua tempilan otentifikasi.
\nAda perbedaan metode untuk menerapkan tampilan ini di proyek anda. Cara termudah adalah menyertakan URLconf yang disediakan di django.contrib.auth.urls dalam URLConf anda sendiri, sebagai contoh:
urlpatterns = [\n path("accounts/", include("django.contrib.auth.urls")),\n]\nIni akan mencakup pola URL berikut:
\naccounts/login/ [name='login']\naccounts/logout/ [name='logout']\naccounts/password_change/ [name='password_change']\naccounts/password_change/done/ [name='password_change_done']\naccounts/password_reset/ [name='password_reset']\naccounts/password_reset/done/ [name='password_reset_done']\naccounts/reset/<uidb64>/<token>/ [name='password_reset_confirm']\naccounts/reset/done/ [name='password_reset_complete']\nTampilan menyediakan nama URL untuk acuan lebih mudah. Lihat the URL documentation untuk rincian pada menggunakan corak URL bernama.
\nJika anda ingin kendali lebih terhadap URL anda, anda dapat mengacu tampilan khusus di URLconf:
\nfrom django.contrib.auth import views as auth_views\n\nurlpatterns = [\n path("change-password/", auth_views.PasswordChangeView.as_view()),\n]\nTampilan mempunyai argumen pilihan anda dapat gunakan untuk merubah kebiasaan dari tampilan. Sebagai contoh, jika anda ingin merubah nama cetakan tampilan kegunaan, anda dapat menyediakan argumen template_name. Sebuah cara untuk melakukan ini adalah menyediakan argumen kata kunci dalam URLconf, ini akan dilewatkan ke tampilan. Sebagai contoh:
urlpatterns = [\n path(\n "change-password/",\n auth_views.PasswordChangeView.as_view(template_name="change-password.html"),\n ),\n]\nSemua tampilan adalah class-based, yang mengizinkan anda dengan mudah menyesuaikan mereka dengan mensubkelaskan.
\nIni adalah daftar dengan semua tamilan django.contrib.auth sediakan. Untuk penerapan rincian lihat Menggunakan tamplian.
Nama URL: masuk
Lihat the URL documentation untuk rincian pada menggunakan corak URL bernama.
\nCara dan Atribut
\nNama cetakan yang akan ditampilkan untuk tampilan yang digunakan untuk login pengguna. Awalannya adalah registration/login.html.
URL tujuan pengalihan setelah login. Awalan ke LOGIN_REDIRECT_URL.
Nama bidang GET berisi URL tujuan pengalihan setelah login. Awalan ke berikutnya. Mengganti URL get_default_redirect_url() jika parameter GET yang diberikan diteruskan.
Callable (biasanya kelas formulir) yang digunakan untuk autentikasi. Bawaan ke AuthenticationForm.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nBoolean yang mengontrol apakah pengguna terotentikasi mengakses halaman login atau tidak akan dialihkan seolah-olah mereka baru saja berhasil login. Awalan ke False.
Sebuah set dari host, selain request.get_host(), yang aman untuk dialihkan setelah login. Awalan ke set kosong.
Mengembalikan URL tujuan pengalihan setelah masuk. Penerapan awalan menyelesaikan dan mengembalikan next_page jika disetel, atau sebaliknya LOGIN_REDIRECT_URL.
Ini adalah apa LoginView lakukan:
Jika dipanggil melalui GET, itu menampilkan formulir masuk yang POST ke URL sama.Lebih dari ini dalam bit.
Jika dipanggil melalui POST dengan pengguna mengajukan surat kepercayaan, itu mencoba untuk masuk pengguna. Jika masuk berhasil, tampilan mengalihkan ke URL ditentukan di next tidak menyediakan, itu mengalihkan ke settings.LOGIN_REDIRECT_URL (yang awalan menjadi /accounts/profile/). Jika masuk tidak berhasil, itu menampilkan kembali formulir masuk.
Itu adalah tanggung jawab anda untuk menyediakan html untuk cetakan masuk, dipanggil registration/login.html secara awalan. Cetakan ini dilewatkan empat cetakan variabel konteks:
form: Sebuah obyek Form mewakili AuthenticationForm.
next: URL untuk dialihkan setelah berhasil masuk. Ini mungkin mengandung permintaan string, juga.
site: Site`saat ini, menurut pengaturan :setting:`SITE_ID. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke sebuah instance dari RequestSite, yang memperoleh nama situs dan ranah dari HttpRequest saat ini.
site_name: Sebuah nama lain untuk site.name. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke nilai dari request.META['SERVER_NAME']. Untuk lebih di situs, lihat Kerangka kerja "sites".
Jika anda memilih tidak memanggil cetakan registration/login.html, anda dapat melewatkan parameter template_name melalui argumen tambahan pada metode as_view dalam URLConf anda. Sebagai contoh, baris URLconf ini akan menggunakan myapp/login.html sebagai gantinya.
path("accounts/login/", auth_views.LoginView.as_view(template_name="myapp/login.html")),\nAnda dapat juga menentukan nama dari bidang GET yang mengandung URL untuk mengalihkan setelah masuk menggunakan redirect_field_name. Secara awalan, bidang dipanggil next.
Ini adalah sebuah contoh cetakan registration/login.html anda dapat gunakan sebagai titik awalan. Itu menganggap anda memiliki sebuah cetakan base.html yang menentukan sebuah blok content.
{% extends "base.html" %}\n\n{% block content %}\n\n{% if form.errors %}\n<p>Your username and password didn't match. Please try again.</p>\n{% endif %}\n\n{% if next %}\n {% if user.is_authenticated %}\n <p>Your account doesn't have access to this page. To proceed,\n please login with an account that has access.</p>\n {% else %}\n <p>Please login to see this page.</p>\n {% endif %}\n{% endif %}\n\n<form method="post" action="{% url 'login' %}">\n{% csrf_token %}\n<table>\n<tr>\n <td>{{ form.username.label_tag }}</td>\n <td>{{ form.username }}</td>\n</tr>\n<tr>\n <td>{{ form.password.label_tag }}</td>\n <td>{{ form.password }}</td>\n</tr>\n</table>\n\n<input type="submit" value="login">\n<input type="hidden" name="next" value="{{ next }}">\n</form>\n\n{# Assumes you set up the password_reset view in your URLconf #}\n<p><a href="{% url 'password_reset' %}">Lost password?</a></p>\n\n{% endblock %}\nJika anda telah menyesuaiakan autentifikasi (lihat Customizing Authentication 1) anda dapat menggunakan formulir autentifikasi penyesuaian dengan mengatur atribut authentication_form. Formulir ini harus menerima sebuah argumen katakunci request dalam metode __init__() nya dan menyediakan metode get_user() yang mengembalikan obyek pengguna terautentifikasi (metode ini hanya dipanggil setelah keberhasilan formulir pengesahan).
Membuat pengguna keluar dari permintaan POST.
Nama URL: logout
Atribut
\nURL tujuan pengalihan setelah keluar. Awalan ke LOGOUT_REDIRECT_URL.
Nama lengkap cetakan yang akan ditampilkan setelah pengguna keluar. Awalannya adalah registration/logged_out.html.
Nama bidang GET berisi URL tujuan pengalihan setelah keluar. Awalan ke 'berikutnya'. Mengganti URL next_page jika parameter GET yang diberikan diteruskan.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nSebuah set dari host, selain request.get_host(), yang aman untuk dialihkan setelah keluar. Awalan ke set kosong.
Kontek cetakan
\ntitle: String "Logged out", lokalisasi.
site: Site`saat ini, menurut pengaturan :setting:`SITE_ID. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke sebuah instance dari RequestSite, yang memperoleh nama situs dan ranah dari HttpRequest saat ini.
site_name: Sebuah nama lain untuk site.name. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke nilai dari request.META['SERVER_NAME']. Untuk lebih di situs, lihat Kerangka kerja "sites".
Keluarkan pengguna pada permintaan POST, lalu alihkan ke halaman login.
Nama URL: Tidak ada URL awal disediakan
\nArgumen pilihan
\nlogin_url: URL dari halaman masuk untuk mengalihkan. Awalan menjadi settings.LOGIN_URL jika tidak diberikan.
Nama URL: password_change
Izinkan pengguna merubah sandi mereka.
\nAtribut
\nNama lengkap cetakan yang akan digunakan untuk menampilkan formulir perubahan kata sandi. Awalan ke registration/password_change_form.html jika tidak disediakan.
URL tujuan pengalihan setelah perubahan sandi berhasil. Awalan ke 'password_change_done'.
Formulir penyesuaian "ubah kata sandi" yang harus menerima argumen kata kunci user. Formulir tersebut bertanggung jawab untuk benar-benar mengubah kata sandi pengguna. Awalan ke PasswordChangeForm.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nKontek cetakan
\nform: Formulir rubah sandi (lihat form_class diatas).
Nama URL: password_change_done
Halaman muncul setelah pengguna telah merubah sandi mereka.
\nAtribut
\nNama lengkap cetakan yang akan digunakan. Awalan ke registration/password_change_done.html jika tidak disediakan.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nNama URL: password_reset
Mengizinkan seorang pengguna menyetel kembali sandi dengan membangkitkan satu-kali penggunaan tautan yang dapat digunakan untuk menyetel kembali sandi, dan mengirim tautan itu ke alamat surel pengguna terdaftar.
\nTampilan ini akan mengirim surel jika kondisi berikut terpenuhi:
\nAlamat surel yang diberikan ada di sistem.
Pengguna yang diminta aktif (User.is_active adalah True).
Pengguna yang diminta memiliki kata sandi yang dapat digunakan. Pengguna ditandai dengan kata sandi yang tidak dapat digunakan (lihat set_unusable_password()) tidak diizinkan untuk meminta penyetelan ulang kata sandi untuk mencegah penyalahgunaan saat menggunakan sumber autentikasi eksternal seperti LDAP.
Jika salah satu dari ketentuan ini tidak terpenuhi, tidak ada surel yang akan dikirim, tetapi pengguna juga tidak akan menerima pesan kesalahan apa pun. Ini mencegah informasi bocor ke penyerang potensial. Jika anda ingin memberikan pesan kesalahan dalam kasus ini, Anda dapat membuat subkelas PasswordResetForm dan menggunakan atribut form_class.
Atribut
\nNama lengkap cetakan yang akan digunakan untuk menampilkan formulir pengaturan ulang kata sandi. Awalan ke registration/password_reset_form.html jika tidak disediakan.
Formulir yang akan digunakan untuk mendapatkan surel pengguna untuk mensetel kembali kata sandi. Awalan ke PasswordResetForm.
Nama lengkap cetakan yang akan digunakan untuk membuat surel dengan tautan atur ulang kata sandi. Awalan ke registration/password_reset_email.html jika tidak disediakan.
Nama lengkap cetakan yang akan digunakan untuk subjek surel dengan tautan atur ulang kata sandi. Awalan ke registration/password_reset_subject.txt jika tidak disediakan.
Instance dari kelas untuk memeriksa tautan satu kali. Ini akan awalan ke default_token_generator, ini adalah instance dari django.contrib.auth.tokens.PasswordResetTokenGenerator.
URL tujuan pengalihan setelah permintaan setel ulang sandi berhasil. Awalan ke 'password_reset_done'.
Alamat surel yang sah. Secara awalan Django menggunakan DEFAULT_FROM_EMAIL.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nNama lengkap cetakan yang akan digunakan untuk membuat surel banyak bagian text/html dengan tautan setel ulang sandi. Secara awalan, email HTML tidak dikirim.
\nKamus data kontek yang akan tersedia di cetakan surel. Ini dapat digunakan untuk mengganti nilai konteks cetakan awalan yang tercantum di bawah ini, mis. domain.
Kontek cetakan
\nform: Formulir (lihat form_class diatas) untuk mengatur kembali sandi pengguna.
Konteks cetakan surel:
\nemail: Sebuah nama lain untuk user.email
user: User saat ini, menurut pada bidang formulir email. Hanya pengguna aktif yang dapa menyetel kembali sandi mereka (User.is_active adalah True).
site_name: Sebuah nama lain untuk site.name. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke nilai dari request.META['SERVER_NAME']. Untuk lebih di situs, lihat Kerangka kerja "sites".
domain: Sebuah nama lain untuk site.domain. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke nilai dari request.get_host().
protocol: http atau https
uid: Primary key pengguna disandikan dalam base 64.
token: Token untuk memeriksa bahwa tautan menyetel kembali adalah sah.
Contoh registration/password_reset_email.html (cetakan badan email):
Someone asked for password reset for email {{ email }}. Follow the link below:\n{{ protocol}}://{{ domain }}{% url 'password_reset_confirm' uidb64=uid token=token %}\nKonteks cetakan sama digunakan untuk cetakan subyek. Subyek harus berupa strng teks polosbaris tunggal.
\nNama URL: password_reset_done
Halaman muncul setelah pengguna telah disurelkan sebuah tautan untuk menyetel kembali sandi mereka. Tampilan ini dipanggil sebagai awalan jika PasswordResetView tidak mempunyai kumpulan URL success_url yang jelas.
Atribut
\nNama lengkap cetakan yang akan digunakan. Awalan ke registration/password_reset_done.html jika tidak disediakan.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nNama URL: password_reset_confirm
Mengajukan sebuah formulir untuk memasukkan sebuah sandi baru.
\nArgumen katakunci dari URL:
\nuidb64: id pengguna disandikan dalam base 64.
token: Token untuk memeriksa bahwa sandi adalah sah.
Atribut
\nNama lengkap cetakan untuk menampilkan tampilan konfirmasi kata sandi. Nilai awalannya adalah registration/password_reset_confirm.html.
Contoh kelas untuk memeriksa kata sandi. Ini akan awalan ke default_token_generator, ini adalah instance dari django.contrib.auth.tokens.PasswordResetTokenGenerator.
Boolean yang menunjukkan apakah pengguna harus diautentikasi secara otomatis setelah setel ulang kata sandi berhasil. Awalan ke False.
Jalur bertitik ke backend autentikasi untuk digunakan saat mengautentikasi pengguna jika post_reset_login adalah True. Diperlukan hanya jika anda memiliki beberapa konfigurasi AUTHENTICATION_BACKENDS. Awalan ke Tidak Ada.
Form yang akan digunakan untuk mengatur password. Awalan ke SetPasswordForm.
URL untuk dialihkan setelah setel ulang kata sandi selesai. Awalan ke 'password_reset_complete'.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nParameter token ditampilkan sebagai komponen URL setel ulang kata sandi. Awalan ke 'set-password'.
Kontek cetakan
\nform: Formulir (lihat form_class above) untuk pengaturan san pengguna baru.
validlink: Boolean, True jika tautan (perpaduan dari uidb64 dan token) adalah sah atau tidak digunakan.
Nama URL: password_reset_complete
Menghadirkan sebuah tampilan yang menginformasikan pengguna bahwa sandi telah berhasil dirubah.
\nAtribut
\nNama lengkap cetakan untuk menampilkan tampilan. Awalannya adalah registration/password_reset_complete.html.
Kamus data kontek yang akan ditambahkan ke data kontek awalan yang diteruskan ke cetakan.
\nDialihkan ke halaman masuk, dan kemudian kembali ke URL lain setelah berhasil masuk.
\nArgumen diwajibkan:
\nnext: URL untuk mengalihkan setelah berhasil masuk.
Argumen pilihan
\nlogin_url: URL dari halaman masuk untuk mengalihkan. Awalan menjadi settings.LOGIN_URL jika tidak diberikan.
redirect_field_name: Nama bidang GET mengandung URL untuk pengalihan setelah masukj. Menimpa next jika parameter GET dilewatkan.
Jika anda tidak ingin menggunakan tampilan siap-pakai, tetapi ingin dengan meyakinkan tidak menulis formulir untuk kegunaan ini, sistem autentifikasi menyediakan beberapa formulir siap-pakai ditempatkan di django.contrib.auth.forms:
A form used in the admin interface to change a user's password, including\nthe ability to set an unusable password (via\nset_unusable_password()), which\nblocks the user from logging in with password-based authentication.
Mengambil argumen user sebagai argumen penempatan pertama.
A form used in the admin interface to create a new user. Inherits from\nUserCreationForm.
It includes an additional usable_password field, enabled by default. If\nusable_password is enabled, it verifies that password1 and\npassword2 are non empty and match, validates the password using\nvalidate_password(), and\nsets the user's password using\nset_password().\nIf usable_password is disabled, no password validation is done, and\npassword-based authentication is disabled for the user by calling\nset_unusable_password().
Sebuah formulir untuk pengguna masuk.
\nMengambil request sebagai argumen penempatan pertama, yang disimpan pada instance formulir untuk digunakan oleh sub-kelas.
Secara awalan, AuthenticationForm menolak pengguna yang bendera is_active disetel menjadi False. Anda mungkin menimpa kebiasaan ini dengan kebijakan penyesuaian untuk menentukan pengguna mana dapat masuk. Lakukan ini dengan formulir penyesuaian yang mensubkelas AuthenticationForm dan menimpa metode confirm_login_allowed(). Metode ini harus memunculkan ValidationError jika pengguna yang diberikan tidak masuk.
Sebagai contoh, untuk mengizinkan semua pengguna masuk tanpa memperhatikan keadaan "active":
\nfrom django.contrib.auth.forms import AuthenticationForm\n\n\nclass AuthenticationFormWithInactiveUsersOkay(AuthenticationForm):\n def confirm_login_allowed(self, user):\n pass\n(Dalam kasus ini, anda akan butuh menggunakan sebuah backend autentifikasi yang megnzinkan pengguna tidak aktif, seperti AllowAllUsersModelBackend.)
Atau mengizinkan hanya beberapa pengguna aktif untuk masuk:
\nclass PickyAuthenticationForm(AuthenticationForm):\n def confirm_login_allowed(self, user):\n if not user.is_active:\n raise ValidationError(\n _("This account is inactive."),\n code="inactive",\n )\n if user.username.startswith("b"):\n raise ValidationError(\n _("Sorry, accounts starting with 'b' aren't welcome here."),\n code="no_b_users",\n )\nSebuah ModelForm untuk membuat pengguna baru. Ini adalah kelas dasar yang disarankan jika anda perlu menyesuaikan formulir pembuatan pengguna.
It has three fields: username (from the user model), password1,\nand password2. It verifies that password1 and password2 match,\nvalidates the password using\nvalidate_password(), and\nsets the user's password using\nset_password().
Sebuah formulir untuk mengizinkan seorang pengguna merubah sandi mereka.
\nSebuah formulir untuk membangkitkan dan mensurelkan tautan penggunaan satu-kali untuk menyetel kembali sandi pengguna.
\nUses the arguments to send an EmailMultiAlternatives.\nCan be overridden to customize how the email is sent to the user. If\nyou choose to override this method, be mindful of handling potential\nexceptions raised due to email sending failures.
subject_template_name -- cetakan untuk subyek.
email_template_name -- cetakan untuk badan surel.
context -- konteks dilewatkan ke subject_template, email_template, dan html_email_template (jika itu bukan None).
from_email -- surel pengirim
to_email -- surel dari peminta.
html_email_template_name -- cetakan untuk badan HTML; awalan menjadi None, dimana kasus sebuah surel teks polos dikirim.
Secara awalan, save() mengumpulkan context dengan variabel sama yang PasswordResetView melewatkan ke konteks surelnya.
Formulir yang membiarkan pengguma merubah sandi mereka tanpa memasukkan sandi lama.
\nSebuah formulir digunakan di antarmuka admin untuk merubah infromasi dan perizinan pengguna.
\nMewarisi dari BaseUserCreationForm. Untuk membantu mencegah kebingungan dengan nama pengguna yang mirip, formulir tidak mengizinkan nama pengguna yang berbeda hanya untuk berjaga-jaga.
Pengguna masuk saat ini dan perizinan mereka dibuat tersedia di template context ketika anda menggunakan RequestContext.
Ketika membangun sebuah cetakan RequestContext, pengguna masuk saat ini, antara instance User atau instance AnonymousUser, disimpan di variabel cetakan {{ user }}:
{% if user.is_authenticated %}\n <p>Welcome, {{ user.username }}. Thanks for logging in.</p>\n{% else %}\n <p>Welcome, new user. Please log in.</p>\n{% endif %}\nVariabel konteks cetakan ini tidak tersedia jika sebuah RequestContext tidak sedang digunakan.
Perizinan pengguna masuk saat ini disimpan di variabel cetakan {{ perms }}. Ini adalah sebuah instance dari django.contrib.auth.context_processors.PermWrapper, yaitu sebuah proxy cetakan-ramah dari perizinan.
Mengevaluasi pencarian atribut tunggal dari {{ perms }} sebagai boolean adalah proksi untuk User.has_module_perms(). Misalnya, untuk memeriksa apakah pengguna yang masuk memiliki izin di aplikasi foo:
{% if perms.foo %}\nMengevaluasi pencarian atribut dua-tingkat sebagai boolean adalah proksi ke User.has_perm(). Misalnya, untuk memeriksa apakah pengguna yang masuk memiliki izin foo.add_vote:
{% if perms.foo.add_vote %}\nIni adalah beberapa contoh lengkap dari perizinan pemeriksaan dalam sebuah cetakan:
\n{% if perms.foo %}\n <p>You have permission to do something in the foo app.</p>\n {% if perms.foo.add_vote %}\n <p>You can vote!</p>\n {% endif %}\n {% if perms.foo.add_driving %}\n <p>You can drive!</p>\n {% endif %}\n{% else %}\n <p>You don't have permission to do anything in the foo app.</p>\n{% endif %}\nItu memungkinkan juga mencari perizinan dengan pernyataan {% if in %}. Sebagai contoh:
{% if 'foo' in perms %}\n {% if 'foo.add_vote' in perms %}\n <p>In lookup works, too.</p>\n {% endif %}\n{% endif %}\nKetika anda mempunyai kedua django.contrib.admin dan django.contrib.auth terpasang, admin menyediakan cara yang nyaman untuk menampilkan dan mengelola pengguna, kelompok, dan perizinan. Pengguna dapat dibuat dan dihapus seperti model Django apapun. Kelompok dapat dibuat, dan perizinan dapat diberikan ke pengguna atau kelompok. Sebuah catatan dari pengguna menyunting model dibuat dalam admin juga disimpan dan ditampilkan.
You should see a link to "Users" in the "Auth"\nsection of the main admin index page. The "Add user" admin page is different\nthan standard admin pages in that it requires you to choose a username and\npassword before allowing you to edit the rest of the user's fields.\nAlternatively, on this page, you can choose a username and disable\npassword-based authentication for the user.
\nJuga catat: jika anda ingin seorang akun pengguna dapat membuat pengguna menggunakan situs admin Django, anda akan butuh memberikan mereka perizinan untuk menambahkan pengguna dan merubah pengguna (yaitu, perizinan "Add user" dan "Change user"). Jika sebuah akun mempunyai perizinan untuk menambah pengguna tetapi tidak merubah mereka, yang akun tidak dapat menambah pengguna. Kenapa, Karena jika anda mempunyai perizinan menambahkan pengguna, anda mempunyai kekuasaan membuat superuser, yang dapat kemudian, di gilirannya, rubah pengguna lain. Sehingga Django membuatuhkan tambah dan merubah perizinan sebagai ukuran keamanan sedikit.
\nBijaksanalah tentang bagaimana anda mengizinkan pengguna mengelola perizinan. Jika anda memberikan bukan-superuser kemampuan menyunting pengguna, ini adalah akhirnya sama seperti memberikan mereka keadaan superuser karena mereka akan dapat memperbaiki perizinan dari pengguna menyertakan mereka sendiri!
\nUser passwords are not displayed in the admin (nor stored in the database), but\nthe password storage details are displayed.\nIncluded in the display of this information is a link to\na password change form that allows admins to change or unset user passwords.
\n