djangodocs

Django 5.2
Gaeilge
Documentation contents

django.contrib.auth

Soláthraíonn an doiciméad seo ábhar tagartha API do chomhpháirteanna córas fíordheimhnithe Django. Le haghaidh tuilleadh sonraí maidir le húsáid na gcomhpháirteanna seo nó conas fíordheimhniú agus údarú a shaincheapadh féach an:doc: `treoir ábhar fíordheimhniúcháin' </topics/auth/index>.

Samhail ``Úsáideoir ``

class models.User

Réimsí

class models.User

User objects have the following fields:

username

Riachtanach. 150 carachtar nó níos lú. D'fhéadfadh carachtair alfauméireacha, _, @, +, . agus - a bheith san ainmneacha úsáideora.

The max_length should be sufficient for many use cases. If you need a longer length, please use a custom user model.

first_name

Roghnach (:attr: Blank = True <django.db.models.Field.blank>). 150 carachtar nó níos lú.

last_name

Roghnach (:attr: Blank = True <django.db.models.Field.blank>). 150 carachtar nó níos lú.

email

<django.db.models.Field.blank>Roghnach (:attr: `Blank = True `). Seoladh ríomhphoist.

password

Riachtanach. Hash den phasfhocal, agus meiteashonraí faoin bhfocal faire. (Ní stóráilíonn Django an pasfhocal amh.) Is féidir le pasfhocail amh a bheith fada go treallach agus is féidir aon charachtar a bheith iontu. Féadfaidh na meiteashonraí sa réimse seo an pasfhocal a mharcáil mar neamhúsáid Féach na:doc: doiciméadú pasfhocal </topics/auth/passwords>.

groups

Caidreamh go leor le go leor le:aicme: ~django.contrib.auth.models.group

user_permissions

Caidreamh go leor le go leor le:aicme: ~django.contrib.auth.models.permission

is_staff

Boolean. Ligeann an úsáideoir seo rochtain a fháil ar an suíomh riaracháin.

is_active

Boolean. Marcálann an cuntas úsáideora seo mar ghníomhach. Molaimid duit an bratach seo a shocrú go False in ionad cuntais a scriosadh. Ar an mbealach sin, má tá aon eochracha eachtracha ag d'iarratais d'úsáideoirí, ní bhrisefaidh na heochracha eachtracha

Ní gá go rialaíonn sé seo cibé an féidir leis an úsáideoir logáil isteach nó nach féidir. Ní gá cúltaca fíordheimhnithe chun an bhratach is_active a sheiceáil ach déanann an backend réamhshocraithe (:class: ~django.contrib.auth.backends.modelBackend) agus an:class: ~django.contrib.auth.backends.remoteUserBackend. Is féidir leat úsáid:class: ~django.contrib.auth.backends.allowAllUsersModelBackend nó:class: ~django.contrib.auth.backends.allowAllUsersRemoteUserBackend más mian leat ligean d'úsáideoirí neamhghníomhacha logáil isteach. Sa chás seo, beidh tú ag iarraidh an: class: ~django.contrib.auth.forms.AuthenticationForm a úsáideann an:class: ~django.contrib.auth.views.loginView a shaincheapadh toisc go ndiúltaíonn sé úsáideoirí neamhghníomhacha. Bí ar an eolas go bhfilleann na modhanna seiceála ceadanna mar: meth: ~django.contrib.auth.models.user.has_perm agus an fíordheimhniú i riarachán Django go léir False d'úsáideoirí neamhghníomhacha.

is_superuser

Boolean. Déileálann leis an úsáideoir seo mar a bhfuil gach cead aige gan aon chead a shannadh dó go háirithe.

last_login

Dáta logála isteach deireanach an úsáideora.

date_joined

An dát/am nuair a cruthaíodh an cuntas.

tréithe

class models.User
is_authenticated

Tréith léite amháin atá True i gcónaí (seachas AnonymousUser.is_Authenticated atá False i gcónaí). Is bealach é seo chun a rá an bhfuil an t-úsáideoir fíordheimhnithe. Ní thugann sé seo le tuiscint ar aon cheadanna agus ní sheiceálann sé an bhfuil an t-úsáideoir gníomhach nó an bhfuil seisiún bailí aige. Cé go seiceálfaidh tú an tréith seo de ghnáth ar request.user` chun a fháil amach an bhfuil sé áitithe ag an:class: ~django.contrib.auth.middleware.AuthenticationMiddleware (a léiríonn an t-úsáideoir logáilte isteach faoi láthair), ba chóir go mbeadh a fhios agat gurb é an tréith seo True` d'aon shampla: ~Models.User.

is_anonymous

Tréith léitheoireachta amháin atá i gcónaí False. Is bealach é seo chun rudaí: class: ~Models.User agus:class: ~Models.anonymousUser a idirdhealú. Go ginearálta, ba cheart duit úsáid a bhaint as: attr: ~django.contrib.auth.models.user.is_Authenticated don tréith seo.

Modhanna

class models.User
get_username()

Tugann an t-ainm úsáideora ar ais don úsáideoir. Ós rud é gur féidir an tsamhail ``Úsáideoir ``a mhalartú amach, ba cheart duit an modh seo a úsáid in ionad tagairt a dhéanamh go díreach don tréith ainm úsáideora.

get_full_name()

Tugann sé ar ais an:attr: ~django.contrib.auth.models.user.first_name móide an:attr: ~django.contrib.auth.models.user.last_name, le spás eatarthu.

get_short_name()

Tugann sé ar ais an:attr: ~django.contrib.auth.models.user.first_name.

set_password(raw_password)

Socraíonn pasfhocal an úsáideora chuig an sreang amh a thugtar, ag tabhairt aire don hashing pasfhocal. Ní shábhálann sé an réad:class: ~django.contrib.auth.models.user.

Nuair is é raw_password None, socraítear an pasfhocal go pasfhocal neamhúsáidte, mar a úsáideadh: meth: `~django.contrib.auth.models.user.set_unusable_password () `.

check_password(raw_password)
acheck_password(raw_password)

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

Tugann sé ar ais True más é an teaghrán amh a thugtar an focal faire ceart don úsáideoir. (Tugann sé seo aire don hashing pasfhocal agus an comparáid a dhéanamh.)

set_unusable_password()

Marcaíonn sé an t-úsáideoir nach bhfuil aon phasfhocal socraithe aige trí na meiteashonraí a nuashonrú sa réimsin:attr: ~django.contrib.auth.models.user.password. Níl sé seo mar an gcéanna le sreang bán a bheith agat le haghaidh pasfhocal. :meth: ~django.contrib.auth.models.user.check_password () `ní thabharfaidh an t-úsáideoir seo ``True` ar ais riamh. Ní shábhálann sé an réad:class: ~django.contrib.auth.models.user.

B'fhéidir go mbeidh sé seo ag teastáil uait má tharlaíonn fíordheimhniú d'iarratas i gcoinne foinse sheachtrach atá ann cheana mar eolaire LDAP.

has_usable_password()

Tuairisceáin False ife:meth: `~django.contrib.auth.models.user.set_unusable_password () `a ghlaoadh don úsáideoir seo.

get_user_permissions(obj=None)
aget_user_permissions(obj=None)

Asynchronous version: aget_user_permissions()

Filleann sé tacar teaghráin ceadanna atá ag an úsáideoir go díreach.

Má chuirtear obj isteach, ní thugann sé ach ceadanna úsáideora don réad sonrach seo ar ais.

get_group_permissions(obj=None)
aget_group_permissions(obj=None)

Asynchronous version: aget_group_permissions()

Tugann sé tacar teaghráin ceada atá ag an úsáideoir ar ais, trína ngrúpaí.

Má chuirtear obj isteach, ní thugann sé ach ceadanna grúpa don réad sonrach seo ar ais.

get_all_permissions(obj=None)
aget_all_permissions(obj=None)

Asynchronous version: aget_all_permissions()

Tugann sé tacar teaghráin ceada atá ag an úsáideoir ar ais, trí cheadanna grúpa agus úsáideora araon.

Má chuirtear obj isteach, ní thugann sé ach na ceadanna don réad sonrach seo ar ais.

has_perm(perm, obj=None)
ahas_perm(perm, obj=None)

Asynchronous version: ahas_perm()

<app label>Tugann sé ar ais True má tá an cead sonraithe ag an úsáideoir, áit a bhfuil perm sa fhormáid ”. <permission codename>“. <topic-authorization>(féach doiciméadú ar:ref: ceadanna `). Má tá an t-úsáideoir neamhghníomhach, cuirfidh an modh seo ``False` ar ais i gcónaí. Maidir le sárúsáideoir gníomhach, fillfidh an modh seo True i gcónaí.

Má chuirtear obj isteach, ní sheiceálfaidh an modh seo cead don tsamhail, ach don réad sonrach seo.

has_perms(perm_list, obj=None)
ahas_perms(perm_list, obj=None)

Asynchronous version: ahas_perms()

<app label>Tugann sé “True” ar ais má tá gach ceann de na ceadanna sonraithe ag an úsáideoir, áit a bhfuil gach perm sa fhormáid ”. <permission codename>“. Má tá an t-úsáideoir neamhghníomhach, cuirfidh an modh seo False ar ais i gcónaí. Maidir le sárúsáideoir gníomhach, fillfidh an modh seo True i gcónaí.

Má chuirtear obj isteach, ní sheiceálfaidh an modh seo ceadanna don tsamhail, ach don réad ar leith.

has_module_perms(package_name)
ahas_module_perms(package_name)

Asynchronous version: ahas_module_perms()

Tugann sé ar ais True má tá aon cheadanna ag an úsáideoir sa phacáiste tugtha (lipéad an aip Django). Má tá an t-úsáideoir neamhghníomhach, cuirfidh an modh seo False ar ais i gcónaí. Maidir le sárúsáideoir gníomhach, fillfidh an modh seo True i gcónaí.

email_user(subject, message, from_email=None, **kwargs)

Sends an email to the user. If from_email is None, Django uses the DEFAULT_FROM_EMAIL. Any **kwargs are passed to the underlying send_mail() call.

Modhanna bainisteora

class models.UserManager

Tá bainisteoir saincheaptha ag an tsamhail:Class: ~django.contrib.auth.models.user a bhfuil na modhanna cúntóra seo a leanas aige (i dteannta leis na modhanna a sholáthraí:class: ~django.contrib.auth.models.baseUserManager):

create_user(username, email=None, password=None, **extra_fields)
acreate_user(username, email=None, password=None, **extra_fields)

Asynchronous version: acreate_user()

Cruthaíonn, sábhálann agus tugann sé ar ais a:class: ~django.contrib.auth.models.user.

Socraítear an:attr: ~django.contrib.auth.models.user.userName agus:attr: ~django.contrib.auth.models.user.password mar a thugtar. Déantar an chuid fearainn de:attr: ~django.contrib.auth.models.user.email a thiontú go huathoibríoch go litreacha beaga, agus beidh an réad ar ais: ~django.contrib.auth.models.user socraí:attr: ~django.contrib.auth.models.user.is_active socraithe go True`.

Mura gcuirtear aon phasfhocal ar fáil, glaofar ar :meth: `~django.contrib.auth.models.user.set_unusable_password () `.

If no email is provided, email will be set to an empty string.

<auth-custom-user>Cuirtear na hargóintí eochairfhocal extra_fields tríd chuig an modh __init__: class: `~django.contrib.auth.models.user chun réimsí treallacha a shocrú ar a:ref: samhail úsáideora saincheaptaí.

Féach: tagairt: `Úsáideoirí a chruthú <topics-auth-creating-users>`mar shampla úsáid.

create_superuser(username, email=None, password=None, **extra_fields)
acreate_superuser(username, email=None, password=None, **extra_fields)

Asynchronous version: acreate_superuser()

Mar an gcéanna len:meth: create_user, ach socraíonn: attr: ~Models.User.is_Staff agus:attr: ~Models.User.is_SuperUser go True.

with_perm(perm, is_active=True, include_superusers=True, backend=None, obj=None)

<app label>Tugann sé ar ais úsáideoirí a bhfuil an cead tugtha perm acu sa ”. <permission codename>“``formáid nó mar a: class: `~django.contrib.auth.models.permission` sampla. Tugann sé tacar ceisteanna folamh ar ais mura bhfuarthas aon úsáideoirí a bhfuil an `perm acu.

Más é is_active True (réamhshocraithe), ní fhaigheann sé ach úsáideoirí gníomhacha, nó má fhaigheann False, ach úsáideoirí neamhghníomhacha. Úsáid None chun gach úsáideoir a thabhairt ar ais beag beann ar staid ghníomhach.

Más é include_superusers True (réamhshocraithe), beidh sárúsáideoirí san áireamh sa toradh.

Má chuirtear backend isteach agus má shainmhínítear é in:setting: AUTHENTICATION_BACKENDS, ansin úsáidfidh an modh seo é. Seachas sin, úsáidfidh sé an backend` in:setting: AUTHENTICATION_BACKENDS, mura bhfuil ach ceann amháin ann, nó ardóidh sé eisceacht.

`AnonymousUser réad

class models.AnonymousUser

django.contrib.auth.models.AnonymousUser is a class that implements the django.contrib.auth.models.User interface, with these differences:

Go praiticiúil, is dócha nach mbeidh ort rudaí:class: ~django.contrib.auth.models.anonymousUser a úsáid leat féin, ach úsáidtear iad ag iarratais gréasáin, mar a mhínítear sa chéad chuid eile.

Samhail Ceadúna

class models.Permission

Réimsí

Permission objects have the following fields:

class models.Permission
name

Riachtanach. 255 carachtar nó níos lú. Sampla: ``'Is féidir vótáil' `.

content_type

Required. A foreign key to the ContentType model.

codename

Riachtanach. 100 carachtar nó níos lú. Sampla: `'can_vote'.

Modhanna

Permission objects have the standard data-access methods like any other Django model.

Samhail Grúpa

class models.Group

Réimsí

Group objects have the following fields:

class models.Group
name

Riachtanach. 150 carachtar nó níos lú. Ceadaítear aon charachtair. Sampla: ``Úsáideoirí uamhnóis.

permissions

Réimse go leor to:class: ~django.contrib.auth.models.permission:

Code
group.permissions.set([permission_list])
group.permissions.add(permission, permission, ...)
group.permissions.remove(permission, permission, ...)
group.permissions.clear()

Bailíochtóirí

class validators.ASCIIUsernameValidator

Bailíochtóir réimse nach gceadaíonn ach litreacha agus uimhreacha ASCII, i dteannta le @, ., +`, -, agus _.

class validators.UnicodeUsernameValidator

Bailíochtóir réimse a cheadaíonn carachtair Unicode, chomh maith le @, .`, , `+, -, agus _. An bailíochtóir réamhshocraithe le haghaidh User.UserName.

Comharthaí logála isteach agus logála amach

Úsáideann an creat auth an méid seo a leanas: doc: `comharthaí 'is féidir a úsáid le haghaidh fó</topics/signals> gra nuair a logálann úsáideoir isteach nó amach.

user_logged_in

Seoltar nuair a logálann úsáideoir isteach go rathúil.

Argóintí a sheoltar leis an comhartha seo:

``Seoltóir ``

Aicme an úsáideora a logáil isteach díreach.

Iarrata

An sampla reatha: class: ~django.http.httpRequest.

``Úsáideoir ``

An tsampla úsáideora a logáil isteach díreach.

user_logged_out

Seoltar nuair a ghlaofar an modh logála amach.

``Seoltóir ``

Mar atá thuas: aicme an úsáideora a logáil isteach díreach nó None mura ndearnadh an t-úsáideoir fíordheimhnithe.

Iarrata

An sampla reatha: class: ~django.http.httpRequest.

``Úsáideoir ``

An tsampla úsáideora a logáil isteach díreach nó None mura ndearnadh an t-úsáideoir fíordheimhnithe.

user_login_failed

Seoladh nuair a theip ar an úsáideoir logáil isteach go rathúil

``Seoltóir ``

Ainm an mhodúil a úsáidtear le haghaidh fíordheimhnithe.

creidiúnaitheach

Foclóir argóintí eochairfhocal ina bhfuil na dintiúir úsáideora a cuireadh chuig: func: `~django.contrib.auth.autentifikate () `nó do chúltaca fíordheimhnithe saincheaptha féin. Ní sheolfar dhintiúir a mheaitseálann sraith patrúin 'íogair', (lena n-áirítear pasfhocal) san soiléir mar chuid den chomhartha.

Iarrata

An réad: Class: ~django.http.httpRequest, má cuireadh ceann ar fáil chuig: func: ~django.contrib.auth.autenticate.

Cúltaca fíordheimhnithe

Sonraíonn an chuid seo ar na cúltaca fíordheimhnithe a thagann le Django. Le haghaidh faisnéise maidir le conas iad a úsáid agus conas do chúltaca fíordheimhnithe féin a scríobh, féach an ranna:ref: `Foinsí fíordheimhnithe eile </topics/auth/index> <authentication-backends>`den :doc: `Treoir fíordheimhnithe úsáideoraithe'.

cúltaca fíordheimhnithe atá ar fáil

Tá na cúltaca seo a leanas ar fáil in:mod: django.contrib.auth.backends:

class BaseBackend

Aicme bonn a sholáthraíonn cur i bhfeidhm réamhshocraithe do gach modh riachtanach. De réir réamhshocraithe, diúltóidh sé aon úsáideoir agus ní sholáthróidh sé aon cheadanna.

get_user_permissions(user_obj, obj=None)
aget_user_permissions(user_obj, obj=None)

Asynchronous version: aget_user_permissions()

Tugann sé tacar folamh ar ais.

get_group_permissions(user_obj, obj=None)
aget_group_permissions(user_obj, obj=None)

Asynchronous version: aget_group_permissions()

Tugann sé tacar folamh ar ais.

get_all_permissions(user_obj, obj=None)
aget_all_permissions(user_obj, obj=None)

Asynchronous version: aget_all_permissions()

Úsáid:Meth: get_user_permissions agus:meth: get_group_permissions chun an tacar teaghráin ceada atá ag ``user_obj ``a fháil.

has_perm(user_obj, perm, obj=None)
ahas_perm(user_obj, perm, obj=None)

Asynchronous version: ahas_perm()

Úsáid:Meth: get_all_permissions chun a sheiceáil an bhfuil an teaghrán ceada perm ag user_obj`.

class ModelBackend

Is é seo an cúltaca fíordheimhnithe réamhshocraithe a úsáideann Django. Fíordheimhnigh sé trí dhintiúir a bhfuil aitheantóir úsáideora agus pasfhocal. Maidir le samhail úsáideora réamhshocraithe Django, is é an t-ainaitheoir úsáideora an t-ainm úsáideora, i gcás samhlacha úsáideora saincheaptha is é an réimse a shonraíonn USERNAME_FIELD é (féach: 'Úsáideoirí a shaincheapadh agus fíordheimhniú</topics/auth/customizing> ').

Láimhseálann sé freisin an tsamhail ceadanna réamhshocraithe mar a shainmhínítear dó:class: ~django.contrib.auth.models.user agus:class: ~django.contrib.auth.models.permissionsMixin.

has_perm(), get_all_permissions(), get_user_permissions(), and get_group_permissions() allow an object to be passed as a parameter for object-specific permissions, but this backend does not implement them other than returning an empty set of permissions if obj is not None.

with_perm() also allows an object to be passed as a parameter, but unlike others methods it returns an empty queryset if obj is not None.

authenticate(request, username=None, password=None, **kwargs)
aauthenticate(request, username=None, password=None, **kwargs)

Asynchronous version: aauthenticate()

<django.contrib.auth.models.User.check_password>Déanann iarracht `ainm úsáideora ``a fhíordheimhniú le ``pasfhocal trí ghlaoch a ghlao:meth: User.Check_Password `. <django.contrib.auth.models.CustomUser.USERNAME_FIELD>Mura gcuirtear ``ainm úsáideora ``ar fáil, déanann sé iarracht ainm úsáideora a fháil ó `kwargs` ag baint úsáide as an eochair:attr: CustomUser.UserName_Field `. Tugann sé úsáideoir fíordheimhnithe nó ``None` ar ais.

Is é request an:class: ~django.http.httpRequest agus d'fhéadfadh sé a bheith None mura gcuirfí ar fáil é chuig:func: ~django.contrib.auth.auth.autenticate (a chuireann ar aghaidh chuig an gcúltaca é).

get_user_permissions(user_obj, obj=None)
aget_user_permissions(user_obj, obj=None)

Asynchronous version: aget_user_permissions()

Tugann sé an tacar teaghráin ceada atá ag user_obj óna gceadanna úsáideora féin ar ais. Tugann sé tacar folamh ar ais más: attr: ~django.contrib.auth.models.abstractBaseUser.is_anonymous nó:attr: ~django.contrib.auth.models.customUser.is_active False.

get_group_permissions(user_obj, obj=None)
aget_group_permissions(user_obj, obj=None)

Asynchronous version: aget_group_permissions()

Tugann sé an tacar teaghráin ceadanna atá ag an user_obj ó cheadanna na ngrúpaí a bhaineann leo. Tugann sé tacar folamh ar ais más: attr: ~django.contrib.auth.models.abstractBaseUser.is_anonymous nó:attr: ~django.contrib.auth.models.customUser.is_active False.

get_all_permissions(user_obj, obj=None)
aget_all_permissions(user_obj, obj=None)

Asynchronous version: aget_all_permissions()

Tugann sé an tacar teaghráin ceada atá ag user_obj ``, lena n-áirítear ceadanna úsáideora agus ceadanna grúpa araon. Tugann sé tacar folamh ar ais más: attr: `~django.contrib.auth.models.abstractBaseUser.is_anonymous` nó:attr: `~django.contrib.auth.models.customUser.is_active` ``False.

has_perm(user_obj, perm, obj=None)
ahas_perm(user_obj, perm, obj=None)

Asynchronous version: ahas_perm()

Úsáid:Meth: get_all_permissions chun a sheiceáil an bhfuil an teaghrán ceada perm ag user_obj`. Filleann False mura bhfuil an t-úsáideoir: attr: ~django.contrib.auth.models.customUser.is_active.

has_module_perms(user_obj, app_label)
ahas_module_perms(user_obj, app_label)

Asynchronous version: ahas_module_perms()

Tugann sé ar ais cibé an bhfuil aon cheadanna ag an user_obj ar an aip app_label`.

user_can_authenticate()

Tugann sé ar ais cibé an gceadaítear don úsáideoir fíordheimhniú. <django.contrib.auth.forms.AuthenticationForm.confirm_login_allowed><django.contrib.auth.models.User.is_active>Chun iompraíocht de:class: ~django.contrib.auth.forms.AuthenticationForm a mheaitseálann: meth: cosc ar úsáideoirí neamhghníomhacha logáil isteach `, filleann an modh seo ``False` d'úsáideoirí la:attr: is_active=false. Ceadaítear samhlacha úsáideora saincheaptha nach bhfuil réimse: attr: ~django.contrib.auth.models.customUser.is_active acu.

with_perm(perm, is_active=True, include_superusers=True, obj=None)

<app label>Tugann sé ar ais gach úsáideoir gníomhach a bhfuil cead acu perm i bhfoirm ”. <permission codename>“``nó a:class: `~django.contrib.auth.models.permission` sampla. Tugann sé tacar ceisteanna folamh ar ais mura bhfaightear aon úsáideoirí a bhfuil an `perm acu.

Más é is_active True (réamhshocraithe), ní fhaigheann sé ach úsáideoirí gníomhacha, nó má fhaigheann False, ach úsáideoirí neamhghníomhacha. Úsáid None chun gach úsáideoir a thabhairt ar ais beag beann ar staid ghníomhach.

Más é include_superusers True (réamhshocraithe), beidh sárúsáideoirí san áireamh sa toradh.

class AllowAllUsersModelBackend

Mar an gcéanna len:class: ModelBackend ach amháin nach ndéanann sé diúltú úsáideoirí neamhghníomhacha toisc go bhfilleann: meth: ~ModelBackend.User_can_Authenticate True i gcónaí.

Agus an cúltaca seo á úsáid agat, is dócha go mbeidh tú ag iarraidh an:class: ~django.contrib.auth.forms.AuthenticationForm a úsáideann an:class: ~django.contrib.auth.auth.views.loginView a shárú tríd an modh: meth: ~django.contrib.auth.forms.AuthenticationForm.confirm_login_allowed a shárú mar a dhiúltaíonn sé úsáideoirí neamhghníomhacha.

class RemoteUserBackend

Úsáid an cúltaca seo chun leas a bhaint as fíordheimhniú seachtrach go django láimhseáilte. <django.http.HttpRequest.META>Déanann sé fíordheimhniú ag baint úsáide as ainmneacha úsáideora a rith in:attr: request.meta ['REMOTE_USER'] `. Féach an doiciméad:doc: `Fíordheimhniú i gcoinne REMOTE_USER. </howto/auth-remote-user>

Má theastaíonn níos mó smachta uait, is féidir leat do chúltaca fíordheimhnithe féin a chruthú a fhaigheann oidhreacht ón rang seo agus na tréithe nó na modhanna seo a shárú:

create_unknown_user

Fíor nó Bréag. Cinneann sé an gcruthaítear réad úsáideora nó nach bhfuil sa bhunachar sonraí Réamhshocraithe go True cheana féin.

authenticate(request, remote_user)
aauthenticate(request, remote_user)

Asynchronous version: aauthenticate()

Meastar go bhfuil an t-ainm úsáideora a rith mar remote_user` iontaofa. Tugann an modh seo an réad úsáideora ar ais leis an ainm úsáideora a thugtar, ag cruthú réad úsáideora nua má tá: attr: ~RemoteUserBackend.create_unknown_user True.

Tugann None ife:attr: ~RemoteUserBackend.create_unknown_user False agus ní aimsítear réad `Úsáideor leis an ainm úsáideora tugtha sa bhunachar sonraí.

Is é request an:class: ~django.http.httpRequest agus d'fhéadfadh sé a bheith None mura gcuirfí ar fáil é chuig:func: ~django.contrib.auth.auth.autenticate (a chuireann ar aghaidh chuig an gcúltaca é).

clean_username(username)

Déanann sé aon ghlanadh ar an ``ainm úsáideora ``(m.sh. faisnéis LDAP DN a scriosadh) sula n-úsáidtear é chun réad úsáideora a fháil nó a chruthú. Tugann an t-ainm úsáideora glan ar ais.

configure_user(request, user, created=True)
aconfigure_user(request, user, created=True)

Asynchronous version: aconfigure_user()

Configures the user on each authentication attempt. This method is called immediately after fetching or creating the user being authenticated, and can be used to perform custom setup actions, such as setting the user's groups based on attributes in an LDAP directory. Returns the user object. When fetching or creating an user is called from a synchronous context, configure_user is called, aconfigure_user is called from async contexts.

Is féidir an socrú a dhéanamh uair amháin nuair a chruthaítear an t-úsáideoir (“cruthaithe” is é True) nó ar úsáideoirí atá ann cheana (cruthaithe ná False`) mar bhealach chun tréithe a shioncronú idir na córais iargúlta agus na córais áitiúla.

Is é request an:class: ~django.http.httpRequest agus d'fhéadfadh sé a bheith None mura gcuirfí ar fáil é chuig:func: ~django.contrib.auth.auth.autenticate (a chuireann ar aghaidh chuig an gcúltaca é).

user_can_authenticate()

Tugann sé ar ais cibé an gceadaítear don úsáideoir fíordheimhniú. <django.contrib.auth.models.User.is_active>Tugann an modh seo False ar ais d'úsáideoirí le:attr: is_active=false `. Ceadaítear samhlacha úsáideora saincheaptha nach bhfuil réimse: attr: `~django.contrib.auth.models.customUser.is_active acu.

class AllowAllUsersRemoteUserBackend

Mar an gcéanna len:class: RemoteUserBackend ach amháin nach ndéanann sé diúltú úsáideoirí neamhghníomhacha toisc go bhfilleann: attr: ~RemoteUserBackend.User_can_Authenticate True i gcónaí.

feidhmeanna fóntais

get_user(request)
aget_user(request)

Asynchronous version: aget_user()

Filleann sé an tsamhail úsáideora a bhaineann le seisiún an iarrata a thugtar.

Seiceálann sé an bhfuil an cúltaca fíordheimhnithe atá stóráilte sa seisiún i láthair in:setting: AUTHENTICATION_BACKENDS. Más ea, úsáideann sé modh ``get_user () ``an chúltaca chun sampla an úsáideora a aisghabháil agus ansin fíoraíonn sé an seisiún trí ghlaoch ar an msamhail úsáideora 's:meth: ~django.contrib.auth.models.abstractbaseUser.get_session_auth_hash. Má theipeann ar an bhfíorú agus:setting: SECRET_KEY_FALLBACKS ar fáil, fíoraíonn sé an seisiún i gcoinne gach eochair fallback ag baint úsáid:meth: ~django.contrib.auth.models.abstractBaseUser.get_session_auth_fallback_hash.

Tugann sé sampla de:class: ~django.contrib.auth.models.anonymousUser mura bhfuil an cúltaca fíordheimhnithe a stóráiltear sa seisiún a thuilleadh in:setting: AUTHENTICATION_BACKENDS, mura gcuirtear úsáideoir ar ais ag modh `get_user () `, nó mura mbailíonn hash auth an seisiún.

View as Markdown Edit this page on GitHub Official version