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. Use the value of the user.backend attribute, if present. This allows pairing authenticate() and login(): authenticate() sets the user.backend attribute on the user object it returns.

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#

It's a relatively common task to check whether a user has a particular permission. For that reason, Django provides a shortcut for that case: the 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.

Note that permission_required() also takes an optional login_url parameter:

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#

Returns a boolean denoting whether the current user has permission to execute the decorated view. By default, this returns the result of calling has_perms() with the list of permissions returned by get_permission_required().

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

If your AUTH_USER_MODEL inherits from AbstractBaseUser or implements its own get_session_auth_hash() method, authenticated sessions will include the hash returned by this function. In the AbstractBaseUser case, this is an HMAC of the password field. Django verifies that the hash in the session for each request matches the one that's computed during the request. This allows a user to log out all of their sessions by changing their password.

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 %}