--- title: "django.contrib.auth" version: 6.1 locale: ga source: https://docs.djangoproject.com/ga/6.1/ref/contrib/auth/ canonical: https://djangodocs.dev/ga/6.1/ref/contrib/auth/ --- # `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' \. ## Samhail Úsáideoir \`\` #### `class models.User` ### Réimsí #### `class models.User` [`User`](#django.contrib.auth.models.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](/ga/6.1/topics/auth/customizing/#specifying-custom-user-model). #### `first_name` Roghnach (:attr: Blank = True \). 150 carachtar nó níos lú. #### `last_name` Roghnach (:attr: Blank = True \). 150 carachtar nó níos lú. #### `email` \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 \. #### `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. When the `raw_password` is `None`, the password will be set to an unusable password, as if [`set_unusable_password()`](#django.contrib.auth.models.User.set_unusable_password) were used. #### `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()` Marks the user as having no password set by updating the metadata in the [`password`](#django.contrib.auth.models.User.password) field. This isn't the same as having a blank string for a password. [`check_password()`](#django.contrib.auth.models.User.check_password) for this user will never return `True`. Doesn't save the [`User`](#django.contrib.auth.models.User) object. 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. > **Srian athshocraithe pasfhocal** > > Ní bheidh úsáideoirí a bhfuil pasfhocal neamhúsáidte acu in ann ríomhphost athshocraithe pasfhocal a iarraidh trí:class: ~django.contrib.auth.views.passwordResetView. #### `has_usable_password()` Returns `False` if [`set_unusable_password()`](#django.contrib.auth.models.User.set_unusable_password) has been called for this user. #### `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()` \Tugann sé ar ais `True` má tá an cead sonraithe ag an úsáideoir, áit a bhfuil perm sa fhormáid `”. “`. \(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()` \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 `”. “`. 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`](/ga/6.1/ref/settings/#std-setting-DEFAULT_FROM_EMAIL). Any `**kwargs` are passed to the underlying [`send_mail()`](/ga/6.1/topics/email/#django.core.mail.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\`. If no password is provided, [`set_unusable_password()`](#django.contrib.auth.models.User.set_unusable_password) will be called. If no email is provided, [`email`](#django.contrib.auth.models.User.email) will be set to an empty string. \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ú \\`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)` \Tugann sé ar ais úsáideoirí a bhfuil an cead tugtha `perm` acu sa ```”. “``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`](#django.contrib.auth.models.AnonymousUser) is a class that implements the [`django.contrib.auth.models.User`](#django.contrib.auth.models.User) interface, with these differences: - [id](/ga/6.1/topics/db/models/#automatic-primary-key-fields) is always `None`. - [`username`](#django.contrib.auth.models.User.username) is always the empty string. - [`get_username()`](#django.contrib.auth.models.User.get_username) always returns the empty string. - [`is_anonymous`](#django.contrib.auth.models.User.is_anonymous) is `True` instead of `False`. - [`is_authenticated`](#django.contrib.auth.models.User.is_authenticated) is `False` instead of `True`. - [`is_staff`](#django.contrib.auth.models.User.is_staff) and [`is_superuser`](#django.contrib.auth.models.User.is_superuser) are always `False`. - [`is_active`](#django.contrib.auth.models.User.is_active) is always `False`. - [`groups`](#django.contrib.auth.models.User.groups) and [`user_permissions`](#django.contrib.auth.models.User.user_permissions) are always empty. - [`set_password()`](#django.contrib.auth.models.User.set_password), [`check_password()`](#django.contrib.auth.models.User.check_password), [`save()`](/ga/6.1/ref/models/instances/#django.db.models.Model.save) and [`delete()`](/ga/6.1/ref/models/instances/#django.db.models.Model.delete) raise [`NotImplementedError`](https://docs.python.org/3/library/exceptions.html#NotImplementedError). 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`](#django.contrib.auth.models.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`](/ga/6.1/ref/contrib/contenttypes/#django.contrib.contenttypes.models.ContentType) model. #### `codename` Riachtanach. 100 carachtar nó níos lú. Sampla: `` `'can_vote' ``. ### Modhanna [`Permission`](#django.contrib.auth.models.Permission) objects have the standard data-access methods like any other [Django model](/ga/6.1/ref/models/instances/). #### `class models.Permission` #### `user_perm_str` > **New in Django 6.1** Returns the string representation for use in [`has_perm`](#django.contrib.auth.models.User.has_perm). ## Samhail `Grúpa` #### `class models.Group` ### Réimsí [`Group`](#django.contrib.auth.models.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: ``` 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ó\ 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`** A dictionary of keyword arguments containing the user credentials that were passed to [`authenticate()`](/ga/6.1/topics/auth/default/#django.contrib.auth.authenticate) or your own custom authentication backend. Credentials matching a set of 'sensitive' patterns (including password) will not be sent in the clear as part of the signal. **`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 \ \\`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` This is the default authentication backend used by Django. It authenticates using credentials consisting of a user identifier and password. For Django's default user model, the user identifier is the username, for custom user models it is the field specified by USERNAME\_FIELD (see [Customizing Users and authentication](/ga/6.1/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()`](#django.contrib.auth.backends.ModelBackend.has_perm), [`get_all_permissions()`](#django.contrib.auth.backends.ModelBackend.get_all_permissions), [`get_user_permissions()`](#django.contrib.auth.backends.ModelBackend.get_user_permissions), and [`get_group_permissions()`](#django.contrib.auth.backends.ModelBackend.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()`](#django.contrib.auth.backends.ModelBackend.with_perm) also allows an object to be passed as a parameter, but unlike other 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()` \Déanann iarracht ``` `ainm úsáideora ``a fhíordheimhniú le ``pasfhocal ``` trí ghlaoch a ghlao:meth: User.Check\_Password \`. \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()` Returns whether the user is allowed to authenticate. To match the behavior of [`AuthenticationForm.confirm_login_allowed()`](/ga/6.1/topics/auth/default/#django.contrib.auth.forms.AuthenticationForm.confirm_login_allowed), this method returns `False` for users with [`is_active=False`](#django.contrib.auth.models.User.is_active). Custom user models that don't have an [`is_active`](/ga/6.1/topics/auth/customizing/#django.contrib.auth.models.CustomUser.is_active) field are allowed. #### `with_perm(perm, is_active=True, include_superusers=True, obj=None)` \Tugann sé ar ais gach úsáideoir gníomhach a bhfuil cead acu `perm` i bhfoirm ```”. “``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` Use this backend to take advantage of external-to-Django-handled authentication. It authenticates using usernames passed in [`request.META['REMOTE_USER']`](/ga/6.1/ref/request-response/#django.http.HttpRequest.META). See the [Authenticating against REMOTE\_USER](/ga/6.1/howto/auth-remote-user/) documentation. 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ú. \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.