{"title":"Menggunakan sistem pembuktian keaslian Django","version":"1.11","locale":"id","docname":"topics/auth/default","url":"/id/1.11/topics/auth/default/","canonical":"https://djangodocs.dev/id/1.11/topics/auth/default/","summary":"Dokumen ini menjelaskan penggunaan dari sistem otentifikasi Django di konfigurasi awalannya. Konfigurasi ini telah berkembang untuk melayani kebutuhan proyek paling…","html":"

Menggunakan sistem pembuktian keaslian DjangoLink to this heading#

\n

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.

\n

Otentifikasi Django menyediakan kedua otentifikasi dan otorisasi bersama-sama dan umumnya mengacu pada sebagai sistem otentifikasi, ketika fitur ini agak digabungkan.

\n
\n

Obyek UserLink to this heading#

\n

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.

\n

Atribut utama dari pengguna awal adalah:

\n\n

Lihat :class:`full API documentation <django.contrib.auth.models.User>`untuk acuan penuh, dokumentasi yang mengikuti lebih berorientasi tugas.

\n
\n

Membuat penggunaLink to this heading#

\n

Cara paling langsung untuk membuat pengguna adalah menggunakan fungsi pembantu create_user() yang disertakan:

\n
Code
>>> 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()\n
\n

Jika anda mempunai admin Django dipasang, anda dapat juga create users interactively.

\n
\n
\n

Membuat pengguna hebatLink to this heading#

\n

Membuat pengguna hebat menggunakan perintah createsuperuser:

\n
Code
$ python manage.py createsuperuser --username=joe --email=joe@example.com\n
\n

Anda 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.

\n
\n
\n

Merubah sandiLink to this heading#

\n

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.

\n

Untuk merubah sandi pengguna, anda mempunyai beebrapa pilihan:

\n

manage.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.

\n

Anda dapat juga merubah sandi secara program, menggunakan set_password():

\n
Python console
>>> from django.contrib.auth.models import User\n>>> u = User.objects.get(username='john')\n>>> u.set_password('new password')\n>>> u.save()\n
\n

Jika anda mempunyai admin Django terpasang, anda dapat juga merubah sandi pengguna pada halaman admin sistem pembuktian keaslian.

\n

Django juga menyediakan views dan forms yang mungkin digunakan untuk mengizinkan pengguna merubah sandi mereka sendiri.

\n

Merubah sandi pengguna akan keluar semua sesi mereka. Lihat Penghapusan sesi pada perubahan sandi untuk rincian.

\n
\n
\n

Pembuktian keaslian penggunaLink to this heading#

\n
\n
\nauthenticate(request=None, \\**credentials)Link to this definition#
\n

Gunakan authenticate() untuk memeriksa kumpulan dari mandat. Itu mengambil mandat sebagai argumen kata kunci, username dan password untuk kasus awal, periksa mereka kembali setiap authentication backend, dan kembalikan obyek User jika mandat sah untuk backend. Jika mandat tidak sah untuk setiap backend atau jika backend menampilkan PermissionDenied, itu mengembalikan None. Sebagai contoh:

\n
Code
from django.contrib.auth import authenticate\nuser = authenticate(username='john', password='secret')\nif user is not None:\n    # A backend authenticated the credentials\nelse:\n    # No backend authenticated the credentials\n
\n

request adalah sebuah pilihan HttpRequest yang dilewatkan pada metode authenticate() dari backend autentifikasi.

\n\n\n
\n\n
\n
\n
\n

Perizinan dan Pembuktian keaslianLink to this heading#

\n

Django datang dengan sistem perizinan sederhana. Dia menyediakan jalan memberikan perizinan ke pengguna dan kelompok khusus dari pengguna.

\n

Digunakan oleh situs admin Django, tetapi anda dipersilahkan menggunakannya di kode anda sendiri.

\n

Situs admin Django menggunakan perizinan sebagai berikut:

\n\n

Perizinan dapat disetel tidak hanya per jenis dari obyek, tetapi juga per instance obyek tertentu. Dengan menggunakan cara has_add_permission(), has_change_permission() and has_delete_permission() disediakan oleh kelas ModelAdmin, itu memungkinkan menyesuaikan perizinan untuk instance obyek berbeda dari jenis sama.

\n

Obyek User mempunyai dua bidang many-to-many: groups dan user_permissions. Obyek User dapat mengakses obyek terkait mereka di cara yang sama seperti yang Django model lain:

\n
Code
myuser.groups.set([group_list])\nmyuser.groups.add(group, group, ...)\nmyuser.groups.remove(group, group, ...)\nmyuser.groups.clear()\nmyuser.user_permissions.set([permission_list])\nmyuser.user_permissions.add(permission, permission, ...)\nmyuser.user_permissions.remove(permission, permission, ...)\nmyuser.user_permissions.clear()\n
\n
\n

Perizinan pertamaLink to this heading#

\n

Ketika django.contrib.auth terdaftar di pengaturan INSTALLED_APPS anda, itu akan memastikan bahwa tiga awalan perizinan -- menambah, merubah dan menghapus -- adalah dibuat untuk setiap model Django ditentukan di satu dari aplikasi terpasang anda.

\n

Perizinan ini akan dibuat ketika anda menjalankan manage.py migrate; pertama kali anda menjalankan migrate setelah menambahkan django.contrib.auth pada INSTALLED_APPS, perizinan awalan akan dibuat untuk semua model sebelumnya-terpasang, sama halnya untuk tiap model baru sedang dipasang pada waktu itu. Kemudian, itu akan membuat perizinan awalan untuk model baru setiap kali anda menjalankan manage.py migrate (fungsi yang membuat perizinan adalah terhubung ke sinyal post_migrate).

\n

Menganggap anda memiliki sebuah aplikasi dengan app_label foo dan model bernama Bar, pada percobaan untuk perizinan dasar anda harus gunakan:

\n\n

Model Permission jarang diakses secara langsung.

\n
\n
\n

KelompokLink to this heading#

\n

Model django.contrib.auth.models.Group adalah cara umum dari mengkategorikan pengguna sehingga anda dapat memberlakukan perizinan, atau beberapa label lain, ke penggun tersebut. Seorang pengguna dapat milik ke tiap sejumlah kelompok.

\n

Seorang pengguna di kelompok secara otomatis mempunyai perizinan diberikan ke kelompok itu. Sebagai contoh, jika kelompok Site editors mempunyai perizinan can_edit_home_page, tiap pengguna di kelompok itu akan mempunyai perizinan itu.

\n

Diluar perizinan, kelompok adalah cara nyaman untuk mengkategorikan pengguna untuk memberikan mereka beberapa label, atau memperpanjang kegunaan. Sebagai contoh, anda dapat membuat kelompok 'Special users', dan anda dapat menulis kode yang dapat, katakan, memberikan mereka akses ke bagian hanya-anggota dari situs anda, atau mengirim mereka pesan surel hanya-pesan.

\n
\n
\n

Pemrograman membuat perizinanLink to this heading#

\n

Selagi custom permissions dapat ditentukan dalam kelas Meta model, anda dapat juga membuat perizinan secara langsung. Sebagai contoh, anda dapat membuat perizinan can_publish untuk model BlogPost di myapp:

\n
Code
from myapp.models import BlogPost\nfrom django.contrib.auth.models import Permission\nfrom django.contrib.contenttypes.models import ContentType\n\ncontent_type = ContentType.objects.get_for_model(BlogPost)\npermission = Permission.objects.create(\n    codename='can_publish',\n    name='Can Publish Posts',\n    content_type=content_type,\n)\n
\n

Perizinan dapat kemudian diberikan pada User melalui atribut user_permissions nya atau ke Group melalui atribut permissions nya.

\n
\n
\n

Perizinan penyimpanan sementaraLink to this heading#

\n

Perizinan tembolok ModelBackend pada obyek user setelah pertama kali mereka butuh diambil untuk pemeriksaan perizinan. Ini adalah khususnya baik untuk siklus tanggapan-permintaan sejak perizinan tidak secara khusus memeriksa segera setelah mereka sitambahkan (dalam admin, sebagai contoh). Jika anda menambahkan perizinan dan memeriksa mereka segera setelahnya, dalam percobaan atau tampilan sebagai contoh, pemecahan termudah adalah mengambil kembali dari basisdata. Sebagai contoh:

\n
Code
from django.contrib.auth.models import Permission, User\nfrom django.contrib.contenttypes.models import ContentType\nfrom django.shortcuts import get_object_or_404\n\nfrom myapp.models import BlogPost\n\ndef user_gains_perms(request, user_id):\n    user = get_object_or_404(User, pk=user_id)\n    # any permission check will cache the current set of permissions\n    user.has_perm('myapp.change_blogpost')\n\n    content_type = ContentType.objects.get_for_model(BlogPost)\n    permission = Permission.objects.get(\n        codename='change_blogpost',\n        content_type=content_type,\n    )\n    user.user_permissions.add(permission)\n\n    # Checking the cached permission set\n    user.has_perm('myapp.change_blogpost')  # False\n\n    # Request new instance of User\n    # Be aware that user.refresh_from_db() won't clear the cache.\n    user = get_object_or_404(User, pk=user_id)\n\n    # Permission cache is repopulated from the database\n    user.has_perm('myapp.change_blogpost')  # True\n\n    ...\n
\n
\n
\n
\n

Pembuktian keaslian di permintaan JaringanLink to this heading#

\n

Django menggunakan sessions dan middleware untuk menghubungkan sitem otentifikasi kedalam request objects.

\n

Ini menyediakan sebuah atribut request.user pada setiap permintaan yang mewakili pengguna saat ini. Jika pengguna saat ini belum masuk, atribut ini akan disetel ke sebuah instance dari AnonymousUser, sebaliknya itu akan berupa sebuah instance dari User.

\n

Anda dapat memberitahu mereka selain dengan is_authenticated, seperti begitu

\n
Code
if request.user.is_authenticated:\n    # Do something for authenticated users.\n    ...\nelse:\n    # Do something for anonymous users.\n    ...\n
\n
\n

Bagaimana cara masuk penggunaLink to this heading#

\n

Jika anda mempunyai pengguna terotentifikasi anda ingin lampirkan ke sesi saat ini - ini dilakukan dengan fungsi login().

\n
\n
\nlogin(request, user, backend=None)Link to this definition#
\n

Untuk pengguna masuk, dari tampilan, gunakan login(). Itu mengambil sebuah obyek HttpRequest dan sebuah obyek User. login() menyimpan ID pengguna di sesi, menggunakan kerangka kerja sesi Django.

\n

Catat bahwa tiap data disetel selama sesi anonim dipertahankan di sesi setelah pengguna masuk.

\n

Contoh ini menunjukkan bagaimana anda mungkin menggunakan kedua authenticate() dan login():

\n
Code
from django.contrib.auth import authenticate, login\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        ...\n
\n\n
\n\n
\n

Memilih backend otentifikasiLink to this heading#

\n

Ketika 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:

\n
    \n

  1. Gunakan nilai dai argumen backend pilihan, jika disediakan.

    2. \n

  2. Gunakan nilai dari atribut user.backend, jika hadir. Ini mengizinkan memasangkan authenticate() dan login(): authenticate() menyetel atribut user.backend pada obyek user dia kembalikan.

    3. \n

  3. Gunakan backend dalam AUTHENTICATION_BACKENDS, jika hanya ada satu.

    4. \n

  4. Sebaliknya, munculkan sebuah pengecualian.

    5. \n
\n

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.

\n
\n
\n
\n

Bagaimana cara pengguna keluarLink to this heading#

\n
\n
\nlogout(request)Link to this definition#
\n

Untuk keluar pengguna yang telah masuk melalui django.contrib.auth.login(), gunakan django.contrib.auth.logout() dalam tampilan anda. Itu mengambil sebuah obyek HttpRequest dan tidak nilai mempunyai kembalian. Contoh:

\n
Code
from django.contrib.auth import logout\n\ndef logout_view(request):\n    logout(request)\n    # Redirect to a success page.\n
\n

Catat bahwa logout() tidak melempar kesalahan apapun jika pengguna tidak masuk.

\n

Ketika anda memanggil logout(), data sesi untuk permintaan saat ini sepenuhnya dibersihkan. Semua data yang ada dipindahkan. Ini adalah untuk mencegah orang lain dari menggunakan peramban Jaringan sama untuk masuk dan memiliki akses ke data sesi pengguna sebelumnya. Jika anda ingin menaruh apapun kedalam sesi yang akan tersedia ke pengguna segera setelah keluar, lakukan itu setelah memanggil django.contrib.auth.logout().

\n
\n\n
\n
\n

Membatasi akses ke pengguna masukLink to this heading#

\n
\n

Cara mentahLink to this heading#

\n

Sederhana, cara mentah untuk membatasi akses ke halaman adalah memeriksa request.user.is_authenticated dan antara mengalihkan ke halaman masuk:

\n
Code
from django.conf import settings\nfrom django.shortcuts import redirect\n\ndef my_view(request):\n    if not request.user.is_authenticated:\n        return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))\n    # ...\n
\n

...atau menampilkan pesan kesalahan:

\n
Code
from django.shortcuts import render\n\ndef my_view(request):\n    if not request.user.is_authenticated:\n        return render(request, 'myapp/login_error.html')\n    # ...\n
\n
\n
\n

Penghias login_requiredLink to this heading#

\n
\n
\nlogin_required(redirect_field_name='next', login_url=None)Link to this definition#
\n

Sebagai jalan pintas, anda dapat menggunakan penghias login_required() yang cocok.

\n
Code
from django.contrib.auth.decorators import login_required\n\n@login_required\ndef my_view(request):\n    ...\n
\n

login_required() melakukan berikut:

\n
    \n

  • Jika pengguna tidak masuk, alihkan ke settings.LOGIN_URL, melewati jalur mutlak saat ini di permintaan deretan karakter. Contoh: /accounts/login/?next=/polls/3/.

    • \n

  • Jika pengguna masuk, jalankan tampilan secara biasa. Kode tampilan adalah bebas untuk menganggap pengguna adalah masuk.

    • \n
\n

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.

\n
Code
from django.contrib.auth.decorators import login_required\n\n@login_required(redirect_field_name='my_redirect_field')\ndef my_view(request):\n    ...\n
\n

Catat 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).

\n

login_required() juga mengambil sebuah pilihan parameter login_url. Contoh:

\n
Code
from django.contrib.auth.decorators import login_required\n\n@login_required(login_url='/accounts/login/')\ndef my_view(request):\n    ...\n
\n

Catat 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:

\n
Code
from django.contrib.auth import views as auth_views\n\nurl(r'^accounts/login/$', auth_views.LoginView.as_view()),\n
\n

settings.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.

\n
\n\n\n\n
\n
\n

Mixin LoginRequiredLink to this heading#

\n

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.

\n
\n
\nclass LoginRequiredMixinLink to this definition#
\n

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.

\n

Anda dapat menyetel tiap dari parameter dari AccessMixin untuk menyesuaikan menangani dari pengguna tidak sah:

\n
Code
from django.contrib.auth.mixins import LoginRequiredMixin\n\nclass MyView(LoginRequiredMixin, View):\n    login_url = '/login/'\n    redirect_field_name = 'redirect_to'\n
\n
\n\n\n
\n
\n

Membatasi akses ke pengguna masuk yang melewatkan percobaanLink to this heading#

\n

Untuk membatasi akses berdasarkan pada perizinan tertentu atau beberapa percobaan lain, anda akan melakukan pada dasarnya hal sama seperti digambarkan di bagian sebelumnya.

\n

Cara termudah untuk menjalankan percobaan anda pada request.user di tampilan secara langsung. Sebagai contoh, tampilan ini memeriksa untuk memastikan pengguna mempunyai sebuah surel di ranah yang diinginkan dan jika tidak, dialihkan ke halaman masuk:

\n
Code
from django.shortcuts import redirect\n\ndef my_view(request):\n    if not request.user.email.endswith('@example.com'):\n        return redirect('/login/?next=%s' % request.path)\n    # ...\n
\n
\n
\nuser_passes_test(test_func, login_url=None, redirect_field_name='next')Link to this definition#
\n

Sebagai sebuah jalan pintas, anda dapat menggunakan penghias user_passes_test yang cocok yang melakukan sebuah pengalihan ketika callable mengembalikan False:

\n
Code
from django.contrib.auth.decorators import user_passes_test\n\ndef email_check(user):\n    return user.email.endswith('@example.com')\n\n@user_passes_test(email_check)\ndef my_view(request):\n    ...\n
\n

user_passes_test() mengambil argumen wajib: sebuah callable yang mengambil obyek User dan mengembalika True jika pengguna diizinkan melihat halaman. Catat bahwa user_passes_test() tidak secara otomatis memeriksa bahwa the User bukan anonim.

\n

user_passes_test() mengambil dua argumen pilihan:

\n
\n
login_url

Biarkan 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.

\n
\n
redirect_field_name

Sama 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".

\n
\n
\n

Sebagai contoh:

\n
Code
@user_passes_test(email_check, login_url='/login/')\ndef my_view(request):\n    ...\n
\n
\n\n
\n
\nclass UserPassesTestMixinLink to this definition#
\n

Ketika menggunakan class-based views, anda dapat menggunakan UserPassesTestMixin untuk melakukan ini.

\n
\n
\ntest_func()Link to this definition#
\n

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:

\n
Code
from django.contrib.auth.mixins import UserPassesTestMixin\n\nclass MyView(UserPassesTestMixin, View):\n\n    def test_func(self):\n        return self.request.user.email.endswith('@example.com')\n
\n
\n\n
\n
\nget_test_func()Link to this definition#
\n

Anda dapat juga menimpa metode get_test_func() untuk memiliki penggunaan mixin fungsi bernama berbeda untuk pemeriksaannya (sebagai ganti test_func()).

\n
\n\n\n
\n\n
\n
\n

Penghias permission_requiredLink to this heading#

\n
\n
\npermission_required(perm, login_url=None, raise_exception=False)Link to this definition#
\n

Itu adalah cara lain tugas umum untuk memeriksa apakah seorang pengguna mempunyai perizinan khusus. Untuk alasan tersebut, Django menyediakan jalan pintas untuk kasus itu: penghias the permission_required().:

\n
Code
from django.contrib.auth.decorators import permission_required\n\n@permission_required('polls.can_vote')\ndef my_view(request):\n    ...\n
\n

Sama seperti metode has_perm(), nama-nama perizinan mengambil formulir "<app label>.<permission codename>" (yaitu polls.can_vote untuk perizinan pada model di apliaksi polls).

\n

Penghias mungkin juga mengambil perizinan berulang, dalam hal ini pengguna harus memiliki semua perizinan untuk mengakses tampilan.

\n

Catat bahwa permission_required() juga mengambil sebuah pilihan parameter login_url:

\n
Code
from django.contrib.auth.decorators import permission_required\n\n@permission_required('polls.can_vote', login_url='/loginpage/')\ndef my_view(request):\n    ...\n
\n

Ketika di penghias login_required(), awalan login_url ke settings.LOGIN_URL.

\n

Jika parameter raise_exception diberikan, penghias akan memunculkan PermissionDenied, mendorong the 403 (HTTP Forbidden) view daripada mengalihkan ke halaman masuk.

\n

Jika anda ingin menggunakan raise_exception tetapi juga memberikan pengguna anda kesempatan untuk masuk terlebih dahulu, anda dapat menambahkan penghias login_required():

\n
Code
from django.contrib.auth.decorators import login_required, permission_required\n\n@login_required\n@permission_required('polls.can_vote', raise_exception=True)\ndef my_view(request):\n    ...\n
\n
\n\n
\n
\n

Mixin PermissionRequiredMixinLink to this heading#

\n

Untuk memberlakukan pemeriksaan perizinan pada class-based views, anda dapat menggunakan PermissionRequiredMixin:

\n
\n
\nclass PermissionRequiredMixinLink to this definition#
\n

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:

\n
Code
from django.contrib.auth.mixins import PermissionRequiredMixin\n\nclass MyView(PermissionRequiredMixin, View):\n    permission_required = 'polls.can_vote'\n    # Or multiple of permissions:\n    permission_required = ('polls.can_open', 'polls.can_edit')\n
\n

Anda dapat menyetel tiap dari parameter dari AccessMixin untuk menyesuaikan menangani dari pengguna tidak sah.

\n

Anda dapat juga menimpa metode ini:

\n
\n
\nget_permission_required()Link to this definition#
\n

Mengembalikan perulangan dari nama perizinan digunakan oleh mixin. Awalan pada atribut permission_required, dirubah ke sebuah tuple juka memungkinkan.

\n
\n\n
\n
\nhas_permission()Link to this definition#
\n

Mengembalikan sebuah boolean menunjukkan apakah pengguna saat ini mempunyai perizinan untuk menjalankan tampilan dihiasi. Secara awalan, ini mengembalikan hasil dari memanggil has_perms() dengan daftar perizinan dikembalikan oleh get_permission_required().

\n
\n\n
\n\n
\n
\n
\n

Mengalihkan permintaan tidak sah di tampilan berdasarkan-kelasLink to this heading#

\n

Untuk memudahkan penanganan dari pembatasan akses di class-based views, AccessMixin dapat digunakan untuk mengalihkan pengguna ke halaman masuk atau menampilkan sebuah tanggapan HTTP 403 Forbidden.

\n
\n
\nclass AccessMixinLink to this definition#
\n
\n
\nlogin_urlLink to this definition#
\n

Nilai balik awalan untuk get_login_url(). Awalan pada None dalam hal ini get_login_url() jatuh kebelakang untuk settings.LOGIN_URL.

\n
\n\n
\n
\npermission_denied_messageLink to this definition#
\n

Nilai balik awalan untuk get_permission_denied_message(). Awalan pada sebuah deretan karakter kosong.

\n
\n\n
\n
\nredirect_field_nameLink to this definition#
\n

Nilai balikan awalan untuk get_redirect_field_name(). Awalan ke "next".

\n
\n\n
\n
\nraise_exceptionLink to this definition#
\n

Atribut ini disetel ke``True``, sebuah pengecualian PermissionDenied akan dimunculkan daripada mengalihkan. Awalan ke False.

\n
\n\n
\n
\nget_login_url()Link to this definition#
\n

Mengembalikan URL yang pengguna tidak melewati percobaan akan dialihkan. Mengembalikan login_url jika disetel, atau sebaliknya settings.LOGIN_URL.

\n
\n\n
\n
\nget_permission_denied_message()Link to this definition#
\n

Ketika raise_exception adalah True, metode ini dapat digunakan untuk mengendalikan pesan kesalahan dilewatkan ke penangan kesalahan untuk menampilkan ke pengguna. Mengembalikan atribut permission_denied_message secara awalan.

\n
\n\n
\n
\nget_redirect_field_name()Link to this definition#
\n

Mengembalikan nama dari permintaan parameter yang akan mengandung URL pengguna harus dialihkan setelah berhasil masuk. Jika anda menyetel ini ke None, sebuah permintaan parameter tidak akan ditambahkan. Mengembalikan atribut redirect_field_name secara awalan.

\n
\n\n
\n
\nhandle_no_permission()Link to this definition#
\n

Tergantung pada nilai dari raise_exception, metode antara memunculkan pengecualian PermissionDenied atau mengalihkan pengguna ke login_url, secara pilihan menyertakan redirect_field_name jika itu disetel.

\n
\n\n
\n\n
\n

Penghapusan sesi pada perubahan sandiLink to this heading#

\n\n

Jika AUTH_USER_MODEL anda warisan dari AbstractBaseUser atau menerapkan metode get_session_auth_hash() miliknya, sesi terotentifikasi akan menyertakan campuran dikembalikan oleh fungsi ini. Di kasus AbstractBaseUser, ini adalah HMAC dari bidang sandi. Django memeriksa bahwa campuran di sesi untuk setiap permintaan cocok satu yang dihitung selama permintaan. Ini mengizinkan pengguna untuk keluar dari sesi mereka dengan merubah sandi mereka.

\n

Tampilan rubah sandi awalan disertakan dengan Django, tampilan PasswordChangeView dan the user_change_password dalam admin django.contrib.auth, perbaharui sesi dengan campuran sandi baru sehingga pengguna merubah sandi mereka sendiri tidak keluar. Jika anda mempunyai tampilan rubah sandi penyesuaian dan berharap memiliki perilaku sama, gunakan fungsi update_session_auth_hash().

\n
\n
\nupdate_session_auth_hash(request, user)Link to this definition#
\n

Fungsi ini mengambil permintaan saat ini dan memperbaharui obyek user dari dimana campuran sesi baru akan berasal dan memperbaharui campuran sesi dengan benar. Itu juga memutar kunci sesi sehingga kue sesi tercuri akan menjadi tidak sah.

\n

Contoh penggunaan:

\n
Code
from django.contrib.auth import update_session_auth_hash\n\ndef password_change(request):\n    if request.method == 'POST':\n        form = PasswordChangeForm(user=request.user, data=request.POST)\n        if form.is_valid():\n            form.save()\n            update_session_auth_hash(request, form.user)\n    else:\n        ...\n
\n\n
\n\n\n
\n
\n
\n

Tampilan OtentifikasiLink to this heading#

\n

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.

\n

Django 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.

\n
\n

Menggunakan tamplianLink to this heading#

\n

Ada 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:

\n
Code
urlpatterns = [\n    url('^', include('django.contrib.auth.urls')),\n]\n
\n

Ini akan menyertakan pola URL berikut:

\n
Code
^login/$ [name='login']\n^logout/$ [name='logout']\n^password_change/$ [name='password_change']\n^password_change/done/$ [name='password_change_done']\n^password_reset/$ [name='password_reset']\n^password_reset/done/$ [name='password_reset_done']\n^reset/(?P<uidb64>[0-9A-Za-z_\\-]+)/(?P<token>[0-9A-Za-z]{1,13}-[0-9A-Za-z]{1,20})/$ [name='password_reset_confirm']\n^reset/done/$ [name='password_reset_complete']\n
\n

Tampilan menyediakan nama URL untuk acuan lebih mudah. Lihat the URL documentation untuk rincian pada menggunakan corak URL bernama.

\n

Jika anda ingin kendali lebih terhadap URL anda, anda dapat mengacu tampilan khusus di URLconf:

\n
Code
from django.contrib.auth import views as auth_views\n\nurlpatterns = [\n    url('^change-password/$', auth_views.PasswordChangeView.as_view()),\n]\n
\n

Tampilan 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:

\n
Code
urlpatterns = [\n    url(\n        '^change-password/$',\n        auth_views.PasswordChangeView.as_view(template_name='change-password.html'),\n    ),\n]\n
\n

Semua tampilan adalah class-based, yang mengizinkan anda dengan mudah menyesuaikan mereka dengan mensubkelaskan.

\n
\n
\n

Semua tempilan otentifikasiLink to this heading#

\n

Ini adalah daftar dengan semua tamilan django.contrib.auth sediakan. Untuk penerapan rincian lihat Menggunakan tamplian.

\n
\n
\nlogin(request, template_name=`registration/login.html`, redirect_field_name='next', authentication_form=AuthenticationForm, current_app=None, extra_context=None, redirect_authenticated_user=False)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini adalah mirip pada atribut berdasarkan-kelas LoginView. Sebagai tambahan, itu mempunyai:

\n\n\n\n
\n\n
\n
\nclass LoginViewLink to this definition#
\n
\n

Nama URL: masuk

\n

Lihat the URL documentation untuk rincian pada menggunakan corak URL bernama.

\n

Atribut

\n
    \n

  • template_name: Nama dari cetakan untuk ditampilkan untuk tampilan digunakan untuk pengguna masuk. Awalan ke registration/login.html.

    • \n

  • redirect_field_name: Nama dari bidang GET mengandung URL untuk mengalihkan setelah masuk. Awalan ke next.

    • \n

  • authentication_form:Sebuah callable (khususnya hanya kelas formulir) untuk menggunakan otentifikasi. Awalan pada AuthenticationForm.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n

  • redirect_authenticated_user: Sebuah boolean yang mengendalikan apakah atau tidak pengguna terotentifikasi mengakses halaman login akan dialihkan ketika mereka telah berhasil masuk. Awalan ke False.

    \n\n
    • \n

  • success_url_allowed_hosts`: set dari rumah, sebagai tambahan pada request.get_host(), yang aman untuk pengalihan setelah masuk. Awalan ke set kosong.

    • \n
\n

Ini adalah apa LoginView lakukan:

\n
    \n

  • Jika dipanggil melalui GET, itu menampilkan formulir masuk yang POST ke URL sama.Lebih dari ini dalam bit.

    • \n

  • 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.

    • \n
\n

Itu adalah tanggung jawab anda untuk menyediakan html untuk cetakan masuk, dipanggil registration/login.html secara awalan. Cetakan ini dilewatkan empat cetakan variabel konteks:

\n
    \n

  • form: Sebuah obyek Form mewakili AuthenticationForm.

    • \n

  • next: URL untuk dialihkan setelah berhasil masuk. Ini mungkin mengandung permintaan string, juga.

    • \n

  • 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.

    • \n

  • 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 The "sites" framework.

    • \n
\n

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.

\n
Code
url(r'^accounts/login/$', auth_views.LoginView.as_view(template_name='myapp/login.html')),\n
\n

Anda dapat juga menentukan nama dari bidang GET yang mengandung URL untuk mengalihkan setelah masuk menggunakan redirect_field_name. Secara awalan, bidang dipanggil next.

\n

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.

\n
Django template
{% 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 setup the password_reset view in your URLconf #}\n<p><a href="{% url 'password_reset' %}">Lost password?</a></p>\n\n{% endblock %}\n
\n

Jika 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).

\n
\n\n
\n
\nlogout(request, next_page=None, template_name='registration/logged_out.html', redirect_field_name='next', current_app=None, extra_context=None)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini adalah mirip pada atribut berdasarkan-kelas LogoutView. Sebagai tambahan, itu mempunyai:

\n\n\n
\n\n
\n
\nclass LogoutViewLink to this definition#
\n
\n

Pengguna keluar

\n

Nama URL: logout

\n

Atribut

\n
    \n

  • next_page: URL untuk mengalihkan setelah keluar. Awalan menjadi settings.LOGOUT_REDIRECT_URL.

    • \n

  • template_name: Nama penuh dari sebuah cetakan setelah pengguna keluar. Awalan menjadi registration/logged_out.html.

    • \n

  • redirect_field_name: Nama dari bidang GET mengandung URL untuk mengalihkan ke setelah keluar. Awalan pada next. Menimpa URL next_page jika parameter GET yang diberikan lolos.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n

  • success_url_allowed_hosts: set dari rumah, sebagai tambahan pada request.get_host(), yang aman untuk pengelihan setelah keluar. Awalan pada set kosong.

    • \n
\n

Kontek cetakan

\n
    \n

  • title: String "Logged out", lokalisasi.

    • \n

  • 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.

    • \n

  • 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 The "sites" framework.

    • \n
\n
\n\n
\n
\nlogout_then_login(request, login_url=None, current_app=None, extra_context=None)Link to this definition#
\n

Pengguna keluar, kemudian mengalihkan ke halaman masuk.

\n

Nama URL: Tidak ada URL awal disediakan

\n

Argumen pilihan

\n
    \n

  • login_url: URL dari halaman masuk untuk mengalihkan. Awalan menjadi settings.LOGIN_URL jika tidak diberikan.

    • \n

  • current_app: Sebuah petunjuk mengindikasikan aplikasi mana mengandung tampilaan saat ini. Lihat namespaced URL resolution strategy untuk informasi lebih.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n
\n\n\n
\n\n
\n
\npassword_change(request, template_name='registration/password_change_form.html', post_change_redirect=None, password_change_form=PasswordChangeForm, current_app=None, extra_context=None)Link to this definition#
\n
\n

Argumen-argumen pilihan dari tampilan ini pada atribut-atribut PasswordChangeView berdasarkan-kelas, kecuali argumen post_change_redirect dan password_change_form yang memetakan pada atribut success_url dan``form_class`` dari tampilan berdasarkan-kelas. Sebagai tambahan, itu memiliki:

\n\n\n
\n\n
\n
\nclass PasswordChangeViewLink to this definition#
\n
\n

Nama URL: password_change

\n

Izinkan pengguna merubah sandi mereka.

\n

Atribut

\n
    \n

  • template_name: Nama penuh dari cetakan untuk digunakan untuk menampilkan formulir rubah sandi. Awalan menjadi registration/password_change_form.html jika tidak diberikan.

    • \n

  • success_url: URL untuk mengalihkan setelah perubahan sandi berhasil.

    • \n

  • form_class`: Formulir "rubah sandi" penyesuaian yang harus menerima sebuah argumen katakunci. Formulir bertanggungjawab untuk sebenarnya merubah sandi pengguna. Awalan pada PasswordChangeForm.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n
\n

Kontek cetakan

\n
    \n

  • form: Formulir rubah sandi (lihat form_class diatas).

    • \n
\n
\n\n
\n
\npassword_change_done(request, template_name='registration/password_change_done.html', current_app=None, extra_context=None)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini adalah mirip pada atribut berdasarkan-kelas PasswordChangeDoneView. Sebagai tambahan, itu mempunyai:

\n\n\n
\n\n
\n
\nclass PasswordChangeDoneViewLink to this definition#
\n
\n

Nama URL: password_change_done

\n

Halaman muncul setelah pengguna telah merubah sandi mereka.

\n

Atribut

\n
    \n

  • template_name: Nama penuh dari cetakan untuk digunakan. Awalan menjadi registration/password_change_done.html jika tidak diberikan.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n
\n
\n\n
\n
\npassword_reset(request, template_name='registration/password_reset_form.html', email_template_name='registration/password_reset_email.html', subject_template_name='registration/password_reset_subject.txt', password_reset_form=PasswordResetForm, token_generator=default_token_generator, post_reset_redirect=None, from_email=None, current_app=None, extra_context=None, html_email_template_name=None, extra_email_context=None)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini mirip pada atribut PasswordResetView berdasarkan-kelas, kecuali argumen post_reset_redirect dan password_reset_form yang memetakan ke atribut success_url dan form_class dari tampilan berdasarkan-kelas. Sebagai tambahan, itu mempunyai:

\n\n\n
\n\n
\n
\nclass PasswordResetViewLink to this definition#
\n
\n

Nama URL: password_reset

\n

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.

\n

Jika alamat sandi disediakan tidak ada dalam sistem, tampilan ini tidak akan mengirim sebuah surel, tetapi pengguna tidak akan menerima pesan kesalahan apapun juga. Ini mencegah kebocoran informasi pada penyerang potensial. Jika anda ingin menyediakan sebuah pesan kesalahan dalam kasus ini, anda dapat mensubkelaskan PasswordResetForm dan menggunakan atribut form_class.

\n

Pengguna ditandai dengan sandi tidak digunakan (lihat set_unusable_password() tidak diizinkan untuk meminta menyetel kembali sandi untuk mencegah penyalahgunaan ketika menggunakan sumber autentifikasi luar seperti LDAP. Catat bahwa mereka tidak akan menerima pesan kesalahan apapun sejak ini akan membuat wujud akun mereka tetapi tidak ada surat akan dikirim juga.

\n

Atribut

\n
    \n

  • template_name: Nama penuh dari cetakan untuk digunakan untuk menampilkan formulir setel kembali sandi. Awalan menjadi registration/password_reset_form.html jika tidak diberikan.

    • \n

  • form_class: Formulir yang akan digunakan mendapatkan surel dari pengguna untuk menyetel kembali sandi. Awalan pada PasswordResetForm.

    • \n

  • email_template_name: Nama penuh dari cetakan untuk digunakan untuk membangkitkan surel dengan tautan sandi setel kembali. Awalan menjadi registration/password_reset_email.html jika tidak diberikan.

    • \n

  • subject_template_name: Nama penuh dari cetakan untuk digunakan untuk subyek dari surel dengan tautan sandi setel kembali. Awalan menjadi registration/password_reset_subject.txt jika tidak diberikan.

    • \n

  • token_generator: Instance dari kelas untuk memeriksa tautan satu waktu. Ini akan awalan menjadi default_token_generator, itu adalah sebuah instance dari django.contrib.auth.tokens.PasswordResetTokenGenerator.

    • \n

  • success_url: URL dialihkan setelah berhasil permintaan setel kembali sandi.

    • \n

  • from_email: Sebuah alamat surel sah. Secara awalan Django menggunakan DEFAULT_FROM_EMAIL.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n

  • html_email_template_name: Nama penuh dari cetakan untuk digunakan untuk membangkitkan sebuah surel banyak bagian text/html dengan tautan menyetel kembali sandi. Secara awalan, surel HTML tidak dikirim.

    • \n

  • extra_email_context: Sebuah kamus dari data konteks yang akan tersedia di cetakan surel.

    • \n
\n

Kontek cetakan

\n
    \n

  • form: Formulir (lihat form_class diatas) untuk mengatur kembali sandi pengguna.

    • \n
\n

Konteks cetakan surel:

\n
    \n

  • email: Sebuah nama lain untuk user.email

    • \n

  • user: User saat ini, menurut pada bidang formulir email. Hanya pengguna aktif yang dapa menyetel kembali sandi mereka (User.is_active adalah True).

    • \n

  • 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 The "sites" framework.

    • \n

  • domain: Sebuah nama lain untuk site.domain. Jika anda tidak mempunyai kerangka kerja situs terpasang, ini akan disetel ke nilai dari request.get_host().

    • \n

  • protocol: http atau https

    • \n

  • uid: Primary key pengguna disandikan dalam base 64.

    • \n

  • token: Token untuk memeriksa bahwa tautan menyetel kembali adalah sah.

    • \n
\n

Contoh registration/password_reset_email.html (cetakan badan email):

\n
Django template
Someone asked for password reset for email {{ email }}. Follow the link below:\n{{ protocol}}://{{ domain }}{% url 'password_reset_confirm' uidb64=uid token=token %}\n
\n

Konteks cetakan sama digunakan untuk cetakan subyek. Subyek harus berupa strng teks polosbaris tunggal.

\n
\n\n
\n
\npassword_reset_done(request, template_name='registration/password_reset_done.html', current_app=None, extra_context=None)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini mirip pada atribut PasswordResetDoneView  berdasarkan-kelas. Sebagai tambahan, itu mempunyai:

\n\n\n
\n\n
\n
\nclass PasswordResetDoneViewLink to this definition#
\n
\n

Nama URL: password_reset_done

\n

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.

\n\n

Atribut

\n
    \n

  • template_name: Nama penuh dari cetakan untuk digunakan. Awalan menjadi registration/password_reset_done.html jika tidak diberikan.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n
\n
\n\n
\n
\npassword_reset_confirm(request, uidb64=None, token=None, template_name='registration/password_reset_confirm.html', token_generator=default_token_generator, set_password_form=SetPasswordForm, post_reset_redirect=None, current_app=None, extra_context=None)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini mirip pada atribut PasswordResetConfirmView berdasarkan-kelas, kecuali argumen post_reset_redirect dan set_password_form yang memetakan ke atribut success_url and form_class dari tampilan berdasarkan-kelas. Sebagai tambahan, itu mempunyai:

\n\n\n
\n\n
\n
\nclass PasswordResetConfirmViewLink to this definition#
\n
\n

Nama URL: password_reset_confirm

\n

Mengajukan sebuah formulir untuk memasukkan sebuah sandi baru.

\n

Argumen katakunci dari URL:

\n
    \n

  • uidb64: id pengguna disandikan dalam base 64.

    • \n

  • token: Token untuk memeriksa bahwa sandi adalah sah.

    • \n
\n

Atribut

\n
    \n

  • template_name: Nama penuh dari cetakan untuk memperlihatkan penegasan tampilan sandi. Nilai awalan adalah registration/password_reset_confirm.html.

    • \n

  • token_generator: Instance dari kelas untuk memeriksa sandi. Ini akan awalan menjadi default_token_generator, itu adalah sebuah instance dari django.contrib.auth.tokens.PasswordResetTokenGenerator.

    • \n

  • post_reset_login: Boolean menunjukkan jika pengguna harus otomatis diatutentifikasi setelah setel kembali sandi berhasil. Awalan pada False.

    • \n

  • post_reset_login_backend: Jalur bertitik pada backend autentifikasi untuk menggunakan ketika mengautentifikasi pengguna jika post_reset_login adalah True. Dibutuhkan hanya jika anda mempunyai banyak AUTHENTICATION_BACKENDS dikonfigurasi. Awalan pada None.

    • \n

  • form_class: Formulir yang akan digunakan menyetel sandi. Awalan pada SetPasswordForm.

    • \n

  • success_url: URL untuk mengalihkan setelah penyetelan kembali sandi selesai. Awalan pada 'password_reset_complete'.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n
\n

Kontek cetakan

\n
    \n

  • form: Formulir (lihat set_password_form diatas) untuk mengatur sandi pengguna baru

    • \n

  • validlink: Boolean, True jika tautan (perpaduan dari uidb64 dan token) adalah sah atau tidak digunakan.

    • \n
\n
\n\n
\n
\npassword_reset_complete(request, template_name='registration/password_reset_complete.html', current_app=None, extra_context=None)Link to this definition#
\n
\n

Argumen pilihan dari tampilan ini mirip pada atribut PasswordResetCompleteView berdasarkan-kelas. Sebagai tambahan, itu mempunyai:

\n\n\n
\n\n
\n
\nclass PasswordResetCompleteViewLink to this definition#
\n
\n

Nama URL: password_reset_complete

\n

Menghadirkan sebuah tampilan yang menginformasikan pengguna bahwa sandi telah berhasil dirubah.

\n

Atribut

\n
    \n

  • template_name: Nama penuh dari cetakan untuk memperlihatkan tampilan. Nilai awalan menjadi registration/password_reset_complete.html.

    • \n

  • extra_context: Sebuah kamus dari data konteks yang akan ditambahkan ke data konteks awalan dilewatkan ke cetakan.

    • \n
\n
\n\n
\n
\n
\n

Fungsi pembantuLink to this heading#

\n
\n
\nredirect_to_login(next, login_url=None, redirect_field_name='next')Link to this definition#
\n

Dialihkan ke halaman masuk, dan kemudian kembali ke URL lain setelah berhasil masuk.

\n

Argumen diwajibkan:

\n
    \n

  • next: URL untuk mengalihkan setelah berhasil masuk.

    • \n
\n

Argumen pilihan

\n
    \n

  • login_url: URL dari halaman masuk untuk mengalihkan. Awalan menjadi settings.LOGIN_URL jika tidak diberikan.

    • \n

  • redirect_field_name: Nama dari bidang GET mengandung URL untuk mengalihkan ke setelah keluar. Menimpa next jika parameter GET yang diberikan lolos.

    • \n
\n
\n\n
\n
\n

Formulir siap pakaiLink to this heading#

\n

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:

\n\n
\n
\nclass AdminPasswordChangeFormLink to this definition#
\n

Sebuah formulir digunakan di antarmuka admin untuk merubah sandi pengguna.

\n

Mengambil argumen user sebagai argumen penempatan pertama.

\n
\n\n
\n
\nclass AuthenticationFormLink to this definition#
\n

Sebuah formulir untuk pengguna masuk.

\n

Mengambil request sebagai argumen penempatan pertama, yang disimpan pada instance formulir untuk digunakan oleh sub-kelas.

\n
\n
\nconfirm_login_allowed(user)Link to this definition#
\n

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.

\n

Sebagai contoh, untuk mengizinkan semua pengguna masuk tanpa memperhatikan keadaan "active":

\n
Code
from django.contrib.auth.forms import AuthenticationForm\n\nclass AuthenticationFormWithInactiveUsersOkay(AuthenticationForm):\n    def confirm_login_allowed(self, user):\n        pass\n
\n

(Di kasus ini, anda akan juga butuh menggunakan sebuah backend autentifikasi yang mengizinkan pengguna tidak aktif, seperti AllowAllUsersModelBackend.)

\n

Atau mengizinkan hanya beberapa pengguna aktif untuk masuk:

\n
Code
class PickyAuthenticationForm(AuthenticationForm):\n    def confirm_login_allowed(self, user):\n        if not user.is_active:\n            raise forms.ValidationError(\n                _("This account is inactive."),\n                code='inactive',\n            )\n        if user.username.startswith('b'):\n            raise forms.ValidationError(\n                _("Sorry, accounts starting with 'b' aren't welcome here."),\n                code='no_b_users',\n            )\n
\n
\n\n
\n\n
\n
\nclass PasswordChangeFormLink to this definition#
\n

Sebuah formulir untuk mengizinkan seorang pengguna merubah sandi mereka.

\n
\n\n
\n
\nclass PasswordResetFormLink to this definition#
\n

Sebuah formulir untuk membangkitkan dan mensurelkan tautan penggunaan satu-kali untuk menyetel kembali sandi pengguna.

\n
\n
\nsend_mail(subject_template_name, email_template_name, context, from_email, to_email, html_email_template_name=None)Link to this definition#
\n

Menggunakan argumen untuk mengirimkan sebuah EmailMultiAlternatives. Dapat ditimpa untuk menyesuaikan bagaimana surel dikirim ke pengguna.

\n
\n
Parameter:
\n
    \n

  • subject_template_name -- cetakan untuk subyek.

    • \n

  • email_template_name -- cetakan untuk badan surel.

    • \n

  • context -- konteks dilewatkan ke subject_template, email_template, dan html_email_template (jika itu bukan None).

    • \n

  • from_email -- surel pengirim

    • \n

  • to_email -- surel dari peminta.

    • \n

  • html_email_template_name -- cetakan untuk badan HTML; awalan menjadi None, dimana kasus sebuah surel teks polos dikirim.

    • \n
\n
\n
\n

Secara awalan, save() mengumpulkan context dengan variabel sama yang PasswordResetView melewatkan ke konteks surelnya.

\n
\n\n
\n\n
\n
\nclass SetPasswordFormLink to this definition#
\n

Formulir yang membiarkan pengguma merubah sandi mereka tanpa memasukkan sandi lama.

\n
\n\n
\n
\nclass UserChangeFormLink to this definition#
\n

Sebuah formulir digunakan di antarmuka admin untuk merubah infromasi dan perizinan pengguna.

\n
\n\n
\n
\nclass UserCreationFormLink to this definition#
\n

Sebuah ModelForm untuk membuat pengguna baru.

\n

Itu mempunyai tiga bidang: username (dari model user), password1, dan password2. Itu memeriksa bahwa password1 dan password2 cocok, mensahkan sandi menggunakan validate_password(), dan menyetel sandi pengguna menggunakan set_password().

\n
\n\n
\n
\n

Pembuktian keaslian data di cetakanLink to this heading#

\n

Pengguna masuk saat ini dan perizinan mereka dibuat tersedia di template context ketika anda menggunakan RequestContext.

\n\n
\n

PenggunaLink to this heading#

\n

Ketika membangun sebuah cetakan RequestContext, pengguna masuk saat ini, antara instance User atau instance AnonymousUser, disimpan di variabel cetakan {{ user }}:

\n
Django template
{% 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 %}\n
\n

Variabel konteks cetakan ini tidak tersedia jika sebuah RequestContext tidak sedang digunakan.

\n
\n
\n

Hak aksesLink to this heading#

\n

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.

\n

Di obyek {{ perms }}, pencarian atribut-tunggal adalah sebuah proxy pada User.has_module_perms. Contoh ini akan menampilkan True jika pengguna masuk mempunyai perizinan apapun di aplikasi foo:

\n
Code
{{ perms.foo }}\n
\n

Pencarian atribut-tingkat-dua adalah sebuah proxy pada User.has_perm. Contoh ini akan menampilkan True jika pengguna masuk mempunyai perizinan foo.can_vote:

\n
Code
{{ perms.foo.can_vote }}\n
\n

Demikian, anda dapat memeriksa perizinan di cetakan pernyataan {% if %}:

\n
Django template
{% if perms.foo %}\n    <p>You have permission to do something in the foo app.</p>\n    {% if perms.foo.can_vote %}\n        <p>You can vote!</p>\n    {% endif %}\n    {% if perms.foo.can_drive %}\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 %}\n
\n

Itu memungkinkan juga mencari perizinan dengan pernyataan {% if in %}. Sebagai contoh:

\n
Django template
{% if 'foo' in perms %}\n    {% if 'foo.can_vote' in perms %}\n        <p>In lookup works, too.</p>\n    {% endif %}\n{% endif %}\n
\n
\n
\n
\n
\n

Mengelola pengguna di adminLink to this heading#

\n

Ketika 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.

\n
\n

Membuat penggunaLink to this heading#

\n

Anda harus melihat sebuah tautan pada "Users" di bagian "Auth" dari halaman indeks admin utama. Halaman admin "Add user" adalah berbeda dari halaman admin standar karena itu membutuhkan anda memilis sebuah nama pengguna dan sandi sebelum mengizinkan anda menyunting sisa dari bidang pengguna.

\n

Juga 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.

\n

Bijaksanalah 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!

\n
\n
\n

Merubah sandiLink to this heading#

\n

Sandi pengguna tidak diperlihatkan di admin (maupun disimpan di basisdata), tetapi password storage details diperlihatkan. Disertakan di layar dari informasi ini adalah sebuah tautan pada sebuah formulir rubah sandi yang mengizinkan admin merubah sandi pengguna.

\n
\n
","rootId":"using-the-django-authentication-system","toc":[{"title":"Obyek User","anchor":"user-objects","children":[{"title":"Membuat pengguna","anchor":"creating-users","children":[]},{"title":"Membuat pengguna hebat","anchor":"creating-superusers","children":[]},{"title":"Merubah sandi","anchor":"changing-passwords","children":[]},{"title":"Pembuktian keaslian pengguna","anchor":"authenticating-users","children":[]}]},{"title":"Perizinan dan Pembuktian keaslian","anchor":"permissions-and-authorization","children":[{"title":"Perizinan pertama","anchor":"default-permissions","children":[]},{"title":"Kelompok","anchor":"groups","children":[]},{"title":"Pemrograman membuat perizinan","anchor":"programmatically-creating-permissions","children":[]},{"title":"Perizinan penyimpanan sementara","anchor":"permission-caching","children":[]}]},{"title":"Pembuktian keaslian di permintaan Jaringan","anchor":"authentication-in-web-requests","children":[{"title":"Bagaimana cara masuk pengguna","anchor":"how-to-log-a-user-in","children":[{"title":"Memilih backend otentifikasi","anchor":"selecting-the-authentication-backend","children":[]}]},{"title":"Bagaimana cara pengguna keluar","anchor":"how-to-log-a-user-out","children":[]},{"title":"Membatasi akses ke pengguna masuk","anchor":"limiting-access-to-logged-in-users","children":[{"title":"Cara mentah","anchor":"the-raw-way","children":[]},{"title":"Penghias login_required","anchor":"the-login-required-decorator","children":[]},{"title":"Mixin LoginRequired","anchor":"the-loginrequired-mixin","children":[]},{"title":"Membatasi akses ke pengguna masuk yang melewatkan percobaan","anchor":"limiting-access-to-logged-in-users-that-pass-a-test","children":[]},{"title":"Penghias permission_required","anchor":"the-permission-required-decorator","children":[]},{"title":"Mixin PermissionRequiredMixin","anchor":"the-permissionrequiredmixin-mixin","children":[]}]},{"title":"Mengalihkan permintaan tidak sah di tampilan berdasarkan-kelas","anchor":"redirecting-unauthorized-requests-in-class-based-views","children":[{"title":"Penghapusan sesi pada perubahan sandi","anchor":"session-invalidation-on-password-change","children":[]}]},{"title":"Tampilan Otentifikasi","anchor":"module-django.contrib.auth.views","children":[{"title":"Menggunakan tamplian","anchor":"using-the-views","children":[]},{"title":"Semua tempilan otentifikasi","anchor":"all-authentication-views","children":[]}]},{"title":"Fungsi pembantu","anchor":"helper-functions","children":[]},{"title":"Formulir siap pakai","anchor":"module-django.contrib.auth.forms","children":[]},{"title":"Pembuktian keaslian data di cetakan","anchor":"authentication-data-in-templates","children":[{"title":"Pengguna","anchor":"users","children":[]},{"title":"Hak akses","anchor":"permissions","children":[]}]}]},{"title":"Mengelola pengguna di admin","anchor":"managing-users-in-the-admin","children":[{"title":"Membuat pengguna","anchor":"id6","children":[]},{"title":"Merubah sandi","anchor":"id7","children":[]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Menggunakan Django","url":"/id/1.11/topics/"},{"docname":"topics/auth/index","title":"Otentifikasi pengguna di Django","url":"/id/1.11/topics/auth/"}],"prev":{"docname":"topics/auth/index","title":"Otentifikasi pengguna di Django","url":"/id/1.11/topics/auth/"},"next":{"docname":"topics/auth/passwords","title":"Pengelolaan sandi di Django","url":"/id/1.11/topics/auth/passwords/"},"formats":{"html":"/id/1.11/topics/auth/default/","markdown":"/id/1.11/topics/auth/default.md","json":"/id/1.11/topics/auth/default.json"},"source":"https://github.com/django/django/blob/stable/1.11.x/docs/topics/auth/default.txt","official":"https://docs.djangoproject.com/id/1.11/topics/auth/default/","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","fr","ja","id","pt-br","ko","es","el","pl"]}