Córas fíordheimhnithe Django a úsáidLink to this heading#

An cúltaca fíordheimhnithe a roghnúLink to this heading#

Nuair a logálann úsáideoir isteach, sábhálfar aitheantas an úsáideora agus an cúltaca a úsáideadh le haghaidh fíordheimhnithe i seisiún an úsáideora. Ligeann sé seo an chéanna: ref: `backend fíordheimhniúcháin <authentication-backends>`sonraí an úsáideora a fháil ar iarratas amach anseo. Roghnaítear an cúltaca fíordheimhnithe le sábháil sa seisiún mar seo a leanas:

1. Úsáid luach an argóint roghnach ``backend`, má chuirtear ar fáil.

2. Úsáid luach an tréith user.backend, má tá sé ann. Ceadaíonn sé seo péireáil: func: ~django.contrib.auth.autenticate () `agus:func: `~django.contrib.auth.login (): :func: ~django.contrib.auth.auth.autenticate () `socraíonn an tréith ``user.backend` ar an réad úsáideora a fhilleann sé.

3. Úsáid an backend in:setting: AUTHENTICATION_BACKENDS, mura bhfuil ach ceann amháin ann.

4. Seachas sin, ardaigh eisceacht.

I gcásanna 1 agus 2, ba chóir go mbeadh luach an argóint backend nó an tréith user.backend ina shreang cosán allmhairiúcháin poncaí (cosúil leis sin a fhaightear in:setting: AUTHENTICATION_BACKENDS), ní an aicme cúltaca iarbhír.

An bealach amhLink to this heading#

<django.contrib.auth.models.User.is_authenticated>Is é an bealach amh chun rochtain ar leathanaigh a theorannú ná seiceál:attr: `request.user.is_authorated `agus ceachtar acu a atreorú chuig leathanach logála isteach:

from django.conf import settings
from django.shortcuts import redirect


def my_view(request):
    if not request.user.is_authenticated:
        return redirect(f"{settings.LOGIN_URL}?next={request.path}")
    # ...

... nó teachtaireacht earráide a thaispeáint:

from django.shortcuts import render


def my_view(request):
    if not request.user.is_authenticated:
        return render(request, "myapp/login_error.html")
    # ...

An maisitheoir login_requiredLink to this heading#

login_required(redirect_field_name='next', login_url=None)Link to this definition#

Mar aicearra, is féidir leat an maisitheoir áisiúil: func: ~django.contrib.auth.decorators.login_required a úsáid:

Code

from django.contrib.auth.decorators import login_required


@login_required
def my_view(request): ...

login_required() does the following:

• Mura bhfuil an t-úsáideoir logáilte isteach, atreoraigh chuig:setting: settings.login_url <LOGIN_URL>, ag dul ar an gcosán iomlán reatha sa sreangán fiosrúcháin. Sampla: /cuntais/logáil isteach/? next =/polls/3/.

• Má tá an t-úsáideoir logáilte isteach, déan an radharc a dhéanamh de ghnáth. Tá an cód amharc saor in aisce glacadh leis go bhfuil an t-úsáideoir logáilte isteach.

De réir réamhshocraithe, stóráiltear an cosán ar chóir an t-úsáideoir a atreorú chuig nuair a fhíordheimhniú rathúil i bparaiméadar teaghrán ceisteanna ar a dtugtar "next” `. Más fearr leat ainm difriúil a úsáid don pharaiméadar seo, glacann: :func: `~django.contrib.auth.decorators.login_required` paraiméadar roghnach ``redirect_field_name:

Code

from django.contrib.auth.decorators import login_required


@login_required(redirect_field_name="my_redirect_field")
def my_view(request): ...

Tabhair faoi deara má sholáthraíonn tú luach do redirect_field_name`, is dócha go mbeidh ort do theimpléad logála isteach a shaincheapadh freisin, ós rud é go n-úsáidfidh an athróg comhthéacs teimpléid a stóráilíonn an cosán atreoraithe luach redirect_field_name mar eochair seachas ``"next” `(an réamhshocraithe).

login_required() also takes an optional login_url parameter. Example:

Code

from django.contrib.auth.decorators import login_required


@login_required(login_url="/accounts/login/")
def my_view(request): ...

<LOGIN_URL>Tabhair faoi deara mura sonraíonn tú an paraiméadar ``login_url ``, beidh ort a chinntiú go bhfuil baint i gceart la:setting: `settings.login_URL `agus d'amharc logála isteach. Mar shampla, ag baint úsáide as na réamhshocruithe, cuir na línte seo a leanas le do URLConf:

Code

from django.contrib.auth import views as auth_views

path("accounts/login/", auth_views.LoginView.as_view()),

<naming-url-patterns>Glacann an: setting: settings.login_URL <LOGIN_URL>`le hainmneacha feidhm amharc agus:ref: `patrúin URL ainmnithe. Ligeann sé seo duit do radharc logála isteach a athmhapáil go saor laistigh de do URLConf gan an socrú a nuashonrú.

An meascán LoginRequiredMixinLink to this heading#

Nuair a úsáideann tú: doc: tuairimí rang-bhunaithe ', is féidir leat an t-iompar céanna a bhaint amach agus le ``login_required` </topics/class-based-views/index> tríd an LoginRequiredMixin` a úsáid. Ba chóir go mbeadh an meascán seo ag an suíomh is clé sa liosta oidhreachta.

class LoginRequiredMixinLink to this definition#

Má tá an mixin seo á úsáid ag amharc, atreorófar gach iarratas ó úsáideoirí neamh-fhíordheimhnithe chuig an leathanach logála isteach nó taispeánfar earráid toirmiscthe HTTP 403, ag brath ar an bparaiméadar: attr: ~django.contrib.auth.mixins.accessmixin.raise_exception.

Is féidir leat aon cheann de na paraiméadair de:class: ~django.contrib.auth.mixins.accessMixin a shocrú chun láimhseáil úsáideoirí neamhúdaraithe a shaincheapadh:

Code

from django.contrib.auth.mixins import LoginRequiredMixin


class MyView(LoginRequiredMixin, View):
    login_url = "/login/"
    redirect_field_name = "redirect_to"

An maisitheoir login_not_requiredLink to this heading#

Nuair a bhíonn: Class: ~django.contrib.auth.middleware.loginrequiredMiddleware suiteáilte, teastaíonn fíordheimhniú de réir réamhshocraithe ó gach radharc. B'fhéidir go mbeidh ar roinnt tuairimí, mar shampla an radharc logála isteach, an t-iompar seo a dhíchumas

login_not_required()Link to this definition#

Ceadaíonn sé iarratais neamhfhíordheimhnithe chuig an radharc seo nuai:class: ~django.contrib.auth.middleware.loginrequiredMiddleware suiteáilte.

Rochtain a theorannú ar úsáideoirí logáilte isteach a rachaidh tástáilLink to this heading#

Chun rochtain a theorannú bunaithe ar cheadanna áirithe nó ar thástáil éigin eile, déanfá an rud céanna go bunúsach mar a thuairiscítear sa chuid roimhe seo.

<django.http.HttpRequest.user>Is féidir leat do thástáil a reáchtáil ar:attr: `request.user `sa radharc go díreach. Mar shampla, seiceálann an radharc seo chun a chinntiú go bhfuil ríomhphost ag an úsáideoir sa réimse atá ag teastáil agus mura bhfuil, atreoraíonn sé chuig an leathanach logála isteach:

from django.shortcuts import redirect


def my_view(request):
    if not request.user.email.endswith("@example.com"):
        return redirect("/login/?next=%s" % request.path)
    # ...

user_passes_test(test_func, login_url=None, redirect_field_name='next')Link to this definition#

Mar aicearra, is féidir leat an maisitheoir áisiúil user_passes_test a úsáid a dhéanann atreorú nuair a fhilleann an t-inghlaoch False:

Code

from django.contrib.auth.decorators import user_passes_test


def email_check(user):
    return user.email.endswith("@example.com")


@user_passes_test(email_check)
def my_view(request): ...

user_passes_test() takes a required argument: a callable that takes a User object and returns True if the user is allowed to view the page. Note that user_passes_test() does not automatically check that the User is not anonymous.

user_passes_test() takes two optional arguments:

log_url

Ligeann duit an URL a shonrú a atreorófar úsáideoirí nach rachaidh an tástáil chuig. <LOGIN_URL>D'fhéadfadh go mbeadh sé ina leathanach logála isteach agus réamhshocraithe to:setting: `settings.login_url `mura sonraíonn tú ceann amháin.

ainm_redirect_field

Mar an gcéanna le haghaidh: func: ~django.contrib.auth.decorators.login_required. Ag socrú é go ``None ``baintear é as an URL, rud a d'fhéadfá a dhéanamh má tá tú ag atreorú úsáideoirí nach dtéann an tástáil chuig leathanach neamh-logála isteach nach bhfuil “an chéad leathanach eile” ann.

Mar shampla:

Code

@user_passes_test(email_check, login_url="/login/")
def my_view(request): ...

class UserPassesTestMixinLink to this definition#

Nuair a úsáideann tú: doc: tuairimí rang-bhunaithe ', is féidir leat an ``UserPassestestMixin` a úsáid chun </topics/class-based-views/index> é seo a dhéanamh.

test_func()Link to this definition#

Caithfidh tú an modh test_func () ``den rang a shárú chun an tástáil a dhéantar a sholáthar. Ina theannta sin, is féidir leat aon cheann de na paraiméadair de:class: `~django.contrib.auth.mixins.accessMixin a shocrú chun láimhseáil úsáideoirí neamhúdaraithe a shaincheapadh:

Code

from django.contrib.auth.mixins import UserPassesTestMixin


class MyView(UserPassesTestMixin, View):
    def test_func(self):
        return self.request.user.email.endswith("@example.com")

get_test_func()Link to this definition#

Is féidir leat an modh ``get_test_func () ``a shárú freisin chun feidhm ainmnithe difriúil a úsáideann an mixin dá sheiceálacha (in ionad:meth: test_func).

An maisitheoir ceadú_riachtanaLink to this heading#

permission_required(perm, login_url=None, raise_exception=False)Link to this definition#

Is tasc réasúnta coitianta é a sheiceáil an bhfuil cead áirithe ag úsáideoir. Ar an gcúis sin, soláthraíonn Django aicearra don chás sin: the:func: `~django.contrib.auth.decorators.permission_required () `decorator:

Code

from django.contrib.auth.decorators import permission_required


@permission_required("polls.add_choice")
def my_view(request): ...

<app label>Díreach cosúil leis an modh:meth: ~django.contrib.auth.models.user.has_perm, glacann ainmneacha ceada an fhoirm ”. <permission codename>“``(ie ``polls.add_choice le haghaidh cead ar mhúnla san iarratas polls).

Féadfaidh an maisitheoir ceadanna in-athraithe a ghlacadh freisin, agus sa chás sin caithfidh na ceadanna go léir a bheith ag an úsáideoir chun rochtain a fháil ar an radharc.

Tabhair faoi deara go dtógann: func: `~django.contrib.auth.decorators.permission_required () `paraiméadar roghnach ``login_url ``freisin:

Code

from django.contrib.auth.decorators import permission_required


@permission_required("polls.add_choice", login_url="/loginpage/")
def my_view(request): ...

<LOGIN_URL>Mar atá sa maisitheoir: func: ~django.contrib.auth.decorators.login_required, réamhshocraithe ``login_url ``: socrú: `Settings.login_url `.

<http_forbidden_view>Má thugtar an paraiméadar raise_exception, ardóidh an maisitheoir:exc: ~django.core.exceptions.permissiondenied, ag iarraidh:ref: `an amharc 403 (HTTP Forbidden) `in ionad atreorú chuig an leathanach logála isteach.

Más mian leat raise_exception a úsáid ach deis a thabhairt d'úsáideoirí logáil isteach ar dtús, is féidir leat an maisitheoir: func: ~django.contrib.auth.decorators.login_required a chur leis:

Code

from django.contrib.auth.decorators import login_required, permission_required


@login_required
@permission_required("polls.add_choice", raise_exception=True)
def my_view(request): ...

Seachnaíonn sé seo lúb atreoraithe freisin nuai:class: .loginView Redirect_Authenticated_user=True agus níl na ceadanna riachtanacha go léir ag an úsáideoir logáilte isteach.

An meascán Ceadúnas RequiredMixinLink to this heading#

Chun seiceálacha ceada a chur i bhfeidhm chuig:doc: tuairimí rang-bhunaithe ', is féidir leat an ``PermissionRequiredMixin` </ref/class-based-views/index> a úsáid:

class PermissionRequiredMixinLink to this definition#

Seiceálann an meascán seo, díreach cosúil leis an maisitheoir permission_required, an bhfuil gach cead tugtha ag an úsáideoir a rochtain ar radharc. Ba chóir duit an cead a shonrú (nó ceadanna inathraithe) ag baint úsáide as an paraiméadar permission_required:

Code

from django.contrib.auth.mixins import PermissionRequiredMixin


class MyView(PermissionRequiredMixin, View):
    permission_required = "polls.add_choice"
    # Or multiple of permissions:
    permission_required = ["polls.view_choice", "polls.change_choice"]

Is féidir leat aon cheann de na paraiméadair de:class: ~django.contrib.auth.mixins.accessMixin a shocrú chun láimhseáil úsáideoirí neamhúdaraithe a shaincheapadh.

Féadfaidh tú na modhanna seo a shárú freisin:

get_permission_required()Link to this definition#

Tugann sé ainmneacha ceada a úsáideann an mixin ar ais. Réamhshocraithe go dtí an tréith permission_required, a thiontú go tuple más gá.

has_permission()Link to this definition#

Filleann boolean a thugann le fios an bhfuil cead ag an úsáideoir reatha an radharc maisithe a fhorghníomhú. De réir réamhshocraithe, filleann sé seo toradh glaoi:meth: ~django.contrib.auth.models.user.has_perms () `leis an liosta ceadanna ar ais ar:meth: `get_permission_required ().

Neamhbhailí seisiúin ar athrú pasfhocalLink to this heading#

Má tá do: setting: AUTH_USER_MODEL oidhreacht ó:class: ~django.contrib.auth.models.abstractBaseUser nó má chuireann sé a modh féin: meth: ~django.contrib.auth.models.abstractBaseUser.get_session_auth_hash () `san áireamh seisiúin fhíordheimhnithe an hash ar ais ag an bhfeidhm seo. Sa chás: class: `~django.contrib.auth.Models.AbstractBaseUser, is HMAC é seo den réimse pasfhocal. Fíoraíonn Django go n-oireann an hash sa seisiún do gach iarratas leis an gceann a ríomhtar le linn na hiarratais. Ligeann sé seo d'úsáideoir a gcuid seisiúin go léir a logáil amach trína bhfocal faire a athrú.

Na tuairimí athraithe pasfhocal réamhshocraithe san áireamh le Django, :class: ~django.contrib.auth.views.passwordChangeView agus an radharc user_change_password in:mod: django.contrib.auth admin, nuashonraigh an seisiún leis an hash pasfhocal nua ionas nach logálfaidh úsáideoir a phasfhocal féin. Má tá amharc saincheaptha athraithe pasfhocal agat agus má theastaíonn uait iompar den chineál céanna a bheith agat, bain úsáid as an bhfeidhm:func: update_session_auth_hash.

update_session_auth_hash(request, user)Link to this definition#

aupdate_session_auth_hash(request, user)Link to this definition#

Leagan asincrón: ``aupdate_session_auth_hash () ``

Tógann an fheidhm seo an t-iarratas reatha agus an réad úsáideora nuashonraithe as a ndíorthófar an hash seisiúin nua agus nuashonraíonn sé an hash seisiúin go cuí. Rothlaíonn sé an eochair seisiúin freisin ionas go ndéanfar fianán seisiúin goidte a chur ar bhailí.

Úsáid sampla:

Code

from django.contrib.auth import update_session_auth_hash


def password_change(request):
    if request.method == "POST":
        form = PasswordChangeForm(user=request.user, data=request.POST)
        if form.is_valid():
            form.save()
            update_session_auth_hash(request, form.user)
    else:
        ...

Úsáid na tuairimíLink to this heading#

Tá modhanna difriúla ann chun na tuairimí seo a chur i bhfeidhm i do thionscadal Is é an bealach is éasca ná an URLConf a chuirtear ar fáil a áireamh in django.contrib.auth.urls i do URLConf féin, mar shampla:

urlpatterns = [
    path("accounts/", include("django.contrib.auth.urls")),
]

Áireofar seo na patrúin URL seo a leanas:

accounts/login/ [name='login']
accounts/logout/ [name='logout']
accounts/password_change/ [name='password_change']
accounts/password_change/done/ [name='password_change_done']
accounts/password_reset/ [name='password_reset']
accounts/password_reset/done/ [name='password_reset_done']
accounts/reset/<uidb64>/<token>/ [name='password_reset_confirm']
accounts/reset/done/ [name='password_reset_complete']

Soláthraíonn na tuairimí ainm URL le haghaidh tagartha níos éasca. Féach: doc: an doiciméadú URL le haghaidh sonraí maidir le patrúin URL </topics/http/urls> ainmnithe a úsáid.

Más mian leat níos mó smachta ar do URLanna, is féidir leat tagairt a dhéanamh do radharc ar leith i do URLConf:

from django.contrib.auth import views as auth_views

urlpatterns = [
    path("change-password/", auth_views.PasswordChangeView.as_view()),
]

Tá argóintí roghnacha ag na tuairimí is féidir leat a úsáid chun iompar an radharc a athrú. Mar shampla, más mian leat an t-ainm teimpléid a úsáideann amharc a athrú, is féidir leat an argóint template_name a sholáthar. Bealach chun é seo a dhéanamh ná argóintí eochairfhocal a sholáthar sa URLConf, cuirfear iad seo ar aghaidh chuig an dearcadh. Mar shampla:

urlpatterns = [
    path(
        "change-password/",
        auth_views.PasswordChangeView.as_view(template_name="change-password.html"),
    ),
]

Is iad na tuairimí go léir:doc: class-based </topics/class-based-views/index>, rud a ligeann duit iad a shaincheapadh go héasca trí fho-aicmiú.

Gach tuairim fíordheimhniLink to this heading#

Seo liosta leis na tuairimí go léir a sholáthraíonn django.contrib.auth. Le haghaidh sonraí cur chun feidhme féach:ref: using-the-views.

class LoginViewLink to this definition#

**Ainm URL: ** ``logáil isteach ``

Féach: doc: an doiciméadú URL le haghaidh sonraí maidir le patrúin URL </topics/http/urls> ainmnithe a úsáid.

**Modhanna agus Gnéithe **

template_nameLink to this definition#

Ainm teimpléad le taispeáint don amharc a úsáidtear chun an t-úsáideoir a logáil isteach. Réamhshocraithe chuig: file: clárúcháin/logain.html.

next_pageLink to this definition#

An URL le atreorú chuig tar éis logáil isteach. Réamhshocraithe chuig: socrú: LOGIN_REDIRECT_URL.

redirect_field_nameLink to this definition#

Ainm réimse GET ina bhfuil an URL le atreorú chuig tar éis logáil isteach. Réamhshocraithe go `next ``. Sáraíonn an URL:meth: `get_default_redirect_url` má chuirtear an paraiméadar ``GET a thugtar.

authentication_formLink to this definition#

Is féidir glaoch (rang foirme de ghnáth) le húsáid le haghaidh fíordheimhnithe. Réamhshocraithe chuig: aicme: ~django.contrib.auth.forms.AuthenticationForm.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

redirect_authenticated_userLink to this definition#

Déanfar boolean a rialaíonn cibé acu úsáideoirí fíordheimhnithe a rochtann rochtain ar an leathanach logála isteach a atreorú amhail is dá ndearna siad logáil isteach go rathúil. Réamhshocraithe go False.

success_url_allowed_hostsLink to this definition#

<django.http.HttpRequest.get_host>A: aicme: tac óstach, i dteann:meth: request.get_host () `, atá sábháilte le hathreorú tar éis logáil isteach. Réamhshocraithe go folamh: class: `set.

get_default_redirect_url()Link to this definition#

Filleann sé an URL le atreorú chuig tar éis logáil isteach. Réiteann agus filleann an cur i bhfeidhm réamhshocraithe: attr: next_page má tá sé socraithe, nó:setting: LOGIN_REDIRECT_URL ar shlí eile.

Seo cad a dhéanann ``LoginView ``:

• Má thugtar air trí GET`, taispeánann sé foirm logála isteach a Postálann chuig an URL céanna. Níos mó faoi seo i mbeagán.

• Má ghlaonn sé trí POST ``le dintiúir a chuirtear isteach ag an úsáideoir, déanann sé iarracht an t-úsáideoir a logáil isteach. Má éiríonn logáil isteach, atreoraíonn an radharc chuig an URL a shonraítear in ``next `. <LOGIN_REDIRECT_URL>Mura gcuirtear next ``ar fáil, atreoraíonn sé chuig:setting: `settings.login_redirect_url `(a dhéanann réamhshocraithe go ``/cuntas/próifíl/). Mura n-éiríonn le logáil isteach, athaispeánann sé an fhoirm logála isteach.

Tá sé de fhreagracht ort an html a sholáthar don teimpléad logála isteach, ar a dtugtar registration/login.html de réir réamhshocraithe. Rinne an teimpléad seo ceithre athróg comhthéacs teimplé

• ``foirm ``: A:Class: ~Django.Forms.Form réad a léiríonn an: aicme: ~django.contrib.auth.forms.AuthenticationForm.

• next: An URL le atreorú chuig tar éis logáil isteach rathúil. D'fhéadfadh go mbeadh teaghrán ceisteanna ann freisin.

• site: An reatha: aicme: ~django.contrib.sites.models.site, de réir an socrú: socrú: SITE_ID. Mura bhfuil creat an láithreáin suiteáilte agat, socraítear é seo go sampla de:class: ~django.contrib.sites.requests.requestsite, a fhaigheann ainm an láithreáin agus an fearainn ón reatha:class: ~django.http.httpRequest.

• site_name: Ailias le haghaidh site.name. <django.http.HttpRequest.META>Mura bhfuil creat an láithreáin suiteáilte agat, socraítear é seo go luach de:attr: request.meta ['SERVER_NAME'] `. Le haghaidh tuilleadh eolais ar shuíomhanna, féach:doc: `/ref/contrib/sites.

Más fearr leat gan glaoch ar an teimpléad:file: registration/login.html, is féidir leat an paraiméadar template_name a chur ar aghaidh trí na hargóintí breise chuig an modh as_view` i do URLConf. Mar shampla, úsáidfeadh an líne URLConf seo:file: myapp/login.html ina ionad:

Code

path("accounts/login/", auth_views.LoginView.as_view(template_name="myapp/login.html")),

Is féidir leat ainm an réimse GET a shonrú ina bhfuil an URL le atreorú chuig tar éis logáil isteach ag baint úsáide as redirect_field_name. De réir réamhshocraithe, tugtar “next” ar an réimse.

Seo teimpléad sampla:file: registration/login.html is féidir leat a úsáid mar phointe tosaigh. Glacann sé leis go bhfuil teimpléad a:file: base.html agat a shainmhíníonn bloc content:

Django template

{% extends "base.html" %}

{% block content %}

{% if form.errors %}
<p>Your username and password didn't match. Please try again.</p>
{% endif %}

{% if next %}
    {% if user.is_authenticated %}
    <p>Your account doesn't have access to this page. To proceed,
    please login with an account that has access.</p>
    {% else %}
    <p>Please login to see this page.</p>
    {% endif %}
{% endif %}

<form method="post" action="{% url 'login' %}">
{% csrf_token %}
<table>
<tr>
    <td>{{ form.username.label_tag }}</td>
    <td>{{ form.username }}</td>
</tr>
<tr>
    <td>{{ form.password.label_tag }}</td>
    <td>{{ form.password }}</td>
</tr>
</table>

<input type="submit" value="login">
<input type="hidden" name="next" value="{{ next }}">
</form>

{# Assumes you set up the password_reset view in your URLconf #}
<p><a href="{% url 'password_reset' %}">Lost password?</a></p>

{% endblock %}

Má tá fíordheimhniú saincheaptha agat (féach: doc: Fíordheimhniú Saincheapach') is féidir leat foirm fíordheimhnithe saincheaptha a úsáid tríd an tréith ``foirm autentication_form` </topics/auth/customizing> a shocrú. Ní mór don fhoirm seo glacadh le hargóint eochairfhocal iarraidh` ina modh ``__init__ () ``agus modh ``get_user () a sholáthar a thugann an réad úsáideora fíordheimhnithe ar ais (ní ghlaofar an modh seo ach amháin tar éis bailíochtú foirme rathúil).

class LogoutViewLink to this definition#

Logáil úsáideoir amach ar iarratais ``POST ``.

**Ainm URL: ** ``logáil isteach ``

**Tréithe: **

next_pageLink to this definition#

An URL le atreorú chuig tar éis logáil amach. Réamhshocraithe chuig: socrú: LOGOUT_REDIRECT_URL.

template_nameLink to this definition#

Ainm iomlán teimpléid le taispeáint tar éis an t-úsáideoir a logáil amach. Réamhshocraithe chuig: file: clárúcháin/logged_out.html.

redirect_field_nameLink to this definition#

Ainm réimse GET ina bhfuil an URL le atreorú chuig tar éis logáil amach. Réamhshocraithe go 'next t'. Sáraíonn an URL:attr: next_page má chuirtear an paraiméadar GET a thugtar.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

success_url_allowed_hostsLink to this definition#

<django.http.HttpRequest.get_host>A: aicme: tac óstach, i dteann:meth: request.get_host () `, atá sábháilte le hathreorú tar éis logáil amach. Réamhshocraithe go folamh: class: `set.

** Comhthéacs teimpléad: **

• title: An teaghrán “Logáilte amach”, logánaithe.

• site: An reatha: aicme: ~django.contrib.sites.models.site, de réir an socrú: socrú: SITE_ID. Mura bhfuil creat an láithreáin suiteáilte agat, socraítear é seo go sampla de:class: ~django.contrib.sites.requests.requestsite, a fhaigheann ainm an láithreáin agus an fearainn ón reatha:class: ~django.http.httpRequest.

• site_name: Ailias le haghaidh site.name. <django.http.HttpRequest.META>Mura bhfuil creat an láithreáin suiteáilte agat, socraítear é seo go luach de:attr: request.meta ['SERVER_NAME'] `. Le haghaidh tuilleadh eolais ar shuíomhanna, féach:doc: `/ref/contrib/sites.

logout_then_login(request, login_url=None)Link to this definition#

Logáil úsáideoir amach ar iarratais ``POST ``, ansin atreoraíonn sé chuig an leathanach logála isteach.

**Ainm URL: ** Níl URL réamhshocraithe ar fáil

** Argóintí roghnacha: **

• login_url: URL an leathanaigh logála isteach le atreorú chuig. <LOGIN_URL>Réamhshocraithe to:setting: `settings.login_url `mura gcuirtear ar fáil.

class PasswordChangeViewLink to this definition#

**Ainm URL: ** password_change

Ligeann sé d'úsáideoir a phasfhocal a athrú.

**Tréithe: **

template_nameLink to this definition#

Ainm iomlán teimpléid le húsáid chun an fhoirm athraithe pasfhocal a thaispeáint. Réamhshocraithe to:file: clárúcháin/password_change_form.html mura gcuirtear ar fáil.

success_urlLink to this definition#

An URL le atreorú chuig tar éis athrú pasfhocal rathúil. Réamhshocraithe go `'password_change_done'.

form_classLink to this definition#

Foirm saincheaptha “athraigh pasfhocal” a chaithfidh glacadh le hargóint eochairfhocal ``úsáideoir ``. Tá an fhoirm freagrach as pasfhocal an úsáideora a athrú i ndáiríre. Réamhshocraithe chuig: aicme: ~django.contrib.auth.forms.PasswordChangeForm.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

** Comhthéacs teimpléad: **

• foirm: An fhoirm athraithe pasfhocal (féach form_class thuas).

class PasswordChangeDoneViewLink to this definition#

**Ainm URL: ** `password_change_done

An leathanach a thaispeántar tar éis d'úsáideoir a phasfhocal a athrú.

**Tréithe: **

template_nameLink to this definition#

Ainm iomlán teimpléad le húsáid. Réamhshocraithe to:file: clárúcháin/password_change_done.html mura gcuirtear ar fáil.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

class PasswordResetViewLink to this definition#

**Ainm URL: ** `password_reset

Ligeann sé d'úsáideoir a bhfocal faire a athshocrú trí nasc úsáide aonuaire a ghiniúint is féidir a úsáid chun an pasfhocal a athshocrú, agus an nasc sin a sheoladh chuig seoladh ríomhphoist cláraithe an úsáideora.

Seolfaidh an dearcadh seo ríomhphost má chomhlíontar na coinníollacha seo a leanas:

• Tá an seoladh ríomhphoist a chuirtear ar fáil sa chóras.

• Tá an t-úsáideoir iarrtha gníomhach (User.is_Active is True).

• Tá pasfhocal inúsáidte ag an úsáideoir iarrtha. Ní cheadaítear d'úsáideoirí a bhfuil pasfhocal neamhúsáidte orthu (féach: ~django.contrib.auth.models.user.set_unusable_password) athshocrú pasfhocal a iarraidh chun mí-úsáid a chosc agus foinse fíordheimhnithe seachtrach cosúil le LDAP á úsáid acu.

Mura gcomhlíontar aon cheann de na coinníollacha seo níl, ní sheolfar aon ríomhphost, ach ní gheobhaidh an t-úsáideoir aon teachtaireacht earráide ach an oiread. Coscann sé seo faisnéis a sceitheadh chuig ionsaitheoirí ionchasacha Más mian leat teachtaireacht earráide a sholáthar sa chás seo, is féidir leat subclass:class: ~django.contrib.auth.forms.passwordResetForm agus an tréith ``form_class ``a úsáid.

**Tréithe: **

template_nameLink to this definition#

Ainm iomlán teimpléid le húsáid chun an fhoirm athshocraithe pasfhocal a thaispeáint. Réamhshocraithe to:file: clárúcháin/password_reset_form.html mura gcuirtear ar fáil.

form_classLink to this definition#

Foirm a úsáidfear chun ríomhphost an úsáideora a fháil chun an pasfhocal a athshocrú dó. Réamhshocraithe chuig: aicme: ~django.contrib.auth.forms.PasswordResetForm.

email_template_nameLink to this definition#

Ainm iomlán teimpléid le húsáid chun an ríomhphost a ghiniúint leis an nasc pasfhocal athshocraithe. Réamhshocraithe to:file: registration/password_reset_email.html mura gcuirtear ar fáil.

subject_template_nameLink to this definition#

Ainm iomlán teimpléid le húsáid le haghaidh ábhar an ríomhphoist leis an nasc pasfhocal athshocraithe. Réamhshocraithe to:file: clárúcháin/password_reset_subject.txt mura gcuirtear ar fáil.

token_generatorLink to this definition#

Sampla den rang chun an nasc aonuaire a sheiceáil. Beidh sé seo réamhshocraithe go default_token_generator, is sampla é de django.contrib.auth.tokens.passwordResetTokenGenerator.

success_urlLink to this definition#

An URL le atreorú chuig tar éis iarratas rathúil athshocraithe pasfhocal. Réamhshocraithe go `'password_reset_done'.

from_emailLink to this definition#

Seoladh ríomhphoist bailí. De réir réamhshocraithe úsáideann Django an:setting: DEFAULT_FROM_EMAIL.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

html_email_template_nameLink to this definition#

Ainm iomlán teimpléid le húsáid chun ríomhphost ilpháirteach a: mimetype: text/html a ghiniúint leis an nasc athshocraithe pasfhocal. De réir réamhshocraithe, ní sheoltar ríomhphost HTML.

extra_email_contextLink to this definition#

Foclóir sonraí comhthéacs a bheidh ar fáil sa teimpléad ríomhphoist. Is féidir é a úsáid chun luachanna comhthéacs teimpléad réamhshocraithe atá liostaithe thíos a shárú m.sh. réimse.

** Comhthéacs teimpléad: **

• foirm ``: An fhoirm (féach ``form_class thuas) chun pasfhocal an úsáideora a athshocrú.

** comhthéacs teimpléad ríomhphoist: **

• email: Ainm le haghaidh user.email

• user: An reatha: aicme: ~django.contrib.auth.models.user, de réir réimse foirme ríomhphost. Níl ach úsáideoirí gníomhacha in ann a gcuid pasfhocail a athshocrú (User.is_Active is True).

• site_name: Ailias le haghaidh site.name. <django.http.HttpRequest.META>Mura bhfuil creat an láithreáin suiteáilte agat, socraítear é seo go luach de:attr: request.meta ['SERVER_NAME'] `. Le haghaidh tuilleadh eolais ar shuíomhanna, féach:doc: `/ref/contrib/sites.

• domain: Ainm le haghaidh site.domain. Mura bhfuil creat an láithreáin suiteáilte agat, socraítear é seo go luach ``request.get_host () ``.

• “prótacal”: http nó https

• uid: Príomh-eochair an úsáideora ionchódaithe i mbonn 64.

• token: Comhartha chun a sheiceáil go bhfuil an nasc athshocraithe bailí.

Sampla clárúcháin/password_reset_email.html (teimpléad comhlacht ríomhphoist):

Django template

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

Úsáidtear an comhthéacs teimpléid céanna do theimpléad ábhair. Caithfidh an t-ábhar a bheith ina sreang téacs simplí líne aonair.

class PasswordResetDoneViewLink to this definition#

**Ainm URL: ** `password_reset_done

An leathanach a thaispeántar tar éis nasc a sheoladh chuig úsáideoir chun a bhfocal faire a athshocrú. Tugtar an radharc seo de réir réamhshocraithe mura bhfuil socrú URL sainráite success_url ag an:class: PasswordResetView.

**Tréithe: **

template_nameLink to this definition#

Ainm iomlán teimpléad le húsáid. Réamhshocraithe to:file: clárúcháin/password_reset_done.html mura gcuirtear ar fáil.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

class PasswordResetConfirmViewLink to this definition#

**Ainm URL: ** `password_reset_confirm

Cuireann sé foirm i láthair chun pasfhocal nua a iontráil.

**Argóintí eochairfhocal ón URL: **

• uidb64: Aitheantas an úsáideora ionchódaithe i mbonn 64.

• token: Comhartha chun a sheiceáil go bhfuil an pasfhocal bailí.

**Tréithe: **

template_nameLink to this definition#

Ainm iomlán teimpléad chun an dearcadh pasfhocal deimhnithe a thaispeáint. Is é an luach réamhshocraithe:file: clárúcháin/password_reset_confirm.html.

token_generatorLink to this definition#

Sampla den rang chun an pasfhocal a sheiceáil. Beidh sé seo réamhshocraithe go default_token_generator, is sampla é de django.contrib.auth.tokens.passwordResetTokenGenerator.

post_reset_loginLink to this definition#

Boolean a léiríonn an chóir an t-úsáideoir a fhíordheimhniú go huathoibríoch tar éis athshocrú pasfhocal rathúil. Réamhshocraithe go False.

post_reset_login_backendLink to this definition#

Conair poncaí chuig an gcúltaca fíordheimhnithe le húsáid agus úsáideoir á fhíordheimhniú má tá post_reset_login True. Ní gá ach amháin má tá iolr:setting: AUTHENTICATION_BACKENDS cumraithe agat. Réamhshocraithe go None.

form_classLink to this definition#

Foirm a úsáidfear chun an pasfhocal a shocrú. Réamhshocraithe chuig: aicme: ~django.contrib.auth.forms.setPasswordForm.

success_urlLink to this definition#

URL chun a atreorú tar éis an athshocrú pasfhocal a dhéanamh. Réamhshocraithe go 'password_reset_complete'.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

reset_url_tokenLink to this definition#

Paraiméadar comhartha a thaispeántar mar chomhpháirt d'URLanna athshocraithe pas Réamhshocraithe go ```'pasfhocal a shocraí'.

** Comhthéacs teimpléad: **

• foirm ``: An fhoirm (féach ``form_class thuas) chun pasfhocal an úsáideora nua a shocrú.

• validlink: Boolean, Fíor má tá an nasc (teaglaim de uidb64 agus token`) bailí nó neamhúsáidte fós.

class PasswordResetCompleteViewLink to this definition#

**Ainm URL: ** `password_reset_complete

Cuireann sé dearcadh i láthair a chuireann in iúl don úsáideoir go bhfuil an pasfhocal athraithe go rathúil.

**Tréithe: **

template_nameLink to this definition#

Ainm iomlán teimpléad chun an radharc a thaispeáint. Réamhshocraithe chuig: file: clárúcháin/password_reset_complete.html.

extra_contextLink to this definition#

Foclóir sonraí comhthéacs a chuirfear leis na sonraí comhthéacs réamhshocraithe a chuirtear chuig an teimpléad.

ÚsáideoiríLink to this heading#

Agus teimpléad:class: ~django.template.requestContext á rindreáil, stóráiltear an t-úsáideoir logáilte isteach faoi láthair, a:class: ~django.contrib.auth.models.user nó sampla: :class: ~django.contrib.auth.models.anonymousUser, san athróg teimpléad {{user}}:

{% if user.is_authenticated %}
    <p>Welcome, {{ user.username }}. Thanks for logging in.</p>
{% else %}
    <p>Welcome, new user. Please log in.</p>
{% endif %}

Níl an athróg comhthéacs teimpléad seo ar fáil mura bhfuil RequestContext á úsáid.

CeadaLink to this heading#

Stóráiltear ceadanna an úsáideora logáilte isteach faoi láthair san athróg teimpléad {{perms}}. Seo sampla de django.contrib.auth.context_processors.permWrapper, seachfhreastalaí ceadanna atá cairdiúil don teimpléad é.

<django.contrib.auth.models.User.has_module_perms>Is seachfhreastalaí é cuardach aontréithe de {{perms}} a mheas mar boolean seachfhreastalaí:meth: `User.has_module_perms () `. Mar shampla, chun seiceáil an bhfuil aon cheadanna ag an úsáideoir logáilte isteach san aip `foo':

{% if perms.foo %}

<django.contrib.auth.models.User.has_perm>Is seachfhreastalaí é cuardach tréithe dhá leibhéal a mheas mar boolean chun: meth: User.has_perm () `. Mar shampla, chun seiceáil an bhfuil an cead ``foo.add_vote` ag an úsáideoir logáilte isteach:

{% if perms.foo.add_vote %}

Seo sampla níos iomláine de cheadanna a sheiceáil i dteimpléad:

{% if perms.foo %}
    <p>You have permission to do something in the foo app.</p>
    {% if perms.foo.add_vote %}
        <p>You can vote!</p>
    {% endif %}
    {% if perms.foo.add_driving %}
        <p>You can drive!</p>
    {% endif %}
{% else %}
    <p>You don't have permission to do anything in the foo app.</p>
{% endif %}

Is féidir ceadanna a lorg suas freisin le ráitis {% má tá i%}. Mar shampla:

{% if 'foo' in perms %}
    {% if 'foo.add_vote' in perms %}
        <p>In lookup works, too.</p>
    {% endif %}
{% endif %}