:djadmin:`django-admin.py startproject <startproject>` が生成するデフォルトの

:file:`settings.py` ファイルの :setting:`INSTALLED_APPS` には、簡便のため

``'django.contrib.auth'`` が最初から入っています。この場合は、単に

:djadmin:`manage.py syncdb` はその都度必要なものだけをインストールするので、

何度実行してもかまいません。

必須です。パスワードのメタデータであるハッシュ値です (Django では生

のパスワードを保存しません)。生のパスワードは任意の長さでよく、どん

な文字が入っていても構いません。詳しくは以下の「パスワード」の節を

.. attribute:: models.User.is_staff

:attr:`~django.contrib.auth.models.User.first_name` と

:attr:`~django.contrib.auth.models.User.last_name` をスペースでつな

.. method:: models.User.set_password(raw_password)

返します。

.. versionadded:: 1.2

もし ``obj`` が引数に渡されていれば、このメソッドはモデルに対する

パーミッションをチェックせず、引数のオブジェクトに対するものを

チェックしようとします。

.. method:: models.User.get_profile()

ユーザのサイト固有のプロファイル (site-specific profile) を返します。

:exc:`django.contrib.auth.models.SiteProfileNotAvailable` を送出し

ます。もしくはユーザがプロファイルを持っていなければ

:exc:`django.core.exceptions.ObjectDoesNotExtis` を送出します。

.. versionchanged:: 1.4

``email`` パラメータはオプションになりました。username パラメ

を上げるものをチェックするのに使われています。

ユーザを生成して保存し、生成された

:attr:`~django.contrib.auth.models.User.password` は指定した値にな

り、 ``is_active`` は ``True`` に設定されます。

:meth:`~django.contrib.auth.models.User.set_unusable_password()` を

呼び出します。

.. versionadded:: 1.2

``manage.py changepassword`` コマンドが追加されました。

はコマンドラインからユーザのパスワードを変更する手続きを提供していま

す。パスワードを変更するには、二度指定したユーザの変更後のパスワード

を入力しなくてはいけません。二つがマッチすると、ただちにパスワードが

PBKDF2 をデフォルトで使用しています。以前のバージョンの Django では

SHA1 が使われており、他のアルゴリズムを使用することは出来ませんでした。

:attr:`~django.contrib.auth.models.User.password` フィールドは、以下の形式::

algorithm$hash

* :meth:`~django.contrib.auth.models.User.is_authenticated()` は

``True`` でなく ``False`` を返します。

* :meth:`~django.contrib.auth.models.User.set_password()`,

:meth:`~django.contrib.auth.models.User.delete()`,

:meth:`~django.contrib.auth.models.User.set_groups()` および

:meth:`~django.contrib.auth.models.User.set_permissions()` は

トールします。詳しくは

:doc:`セッションのドキュメント </topics/http/sessions>` を参照してください。

:attr:`request.user <django.http.HttpRequest.user>` にアクセスできるように

なります。 :attr:`request.user <django.http.HttpRequest.user>` は現在ログイ

ンしているユーザの :class:`~django.contrib.auth.models.User` オブジェクトを

:attr:`request.user <django.http.HttpRequest.user>` は

:class:`~django.contrib.auth.models.AnonymousUser` のインスタンスになります

(前節を参照してください)。ログインユーザと匿名ユーザは、

ユーザをログインさせる

-----------------------

:func:`~django.contrib.auth.authenticate()` と

:func:`~django.contrib.auth.login()` という二つの関数を提供しています。

.. function:: login()

:func:`~django.contrib.auth.login()` を使ってください。この関数は

:class:`~django.http.HttpRequest` オブジェクトと

:class:`~django.contrib.auth.models.User` オブジェクトを引数にとります。

を呼び出してください。 :func:`~django.contrib.auth.authenticate()` は、

:class:`~django.contrib.auth.models.User` オブジェクトに、そのユーザが

認証バックエンドによって正しく認証されたことを示す属性を付加します。

この情報が後でログインの処理で必要だからです。

.. _backends documentation: #other-authentication-sources

ます::

from django.contrib.auth.decorators import login_required

@login_required

def my_view(request):

...

* もし、ユーザがログインしていなければ、クエリ文字列の現在の完全

パスを通って、 :setting:`settings.LOGIN_URL <LOGIN_URL>`

へとリダイレクトします。例えば: ``/accounts/login/?next=/polls/3/``

* もし、ユーザがログインしていれば、通常のビューを実行します。

ビューコードは、ユーザがログインしているかという仮定には縛られません。

``redirect_field_name`` からビューへの、

ログイン後のリダイレクト先を含むURLを設定してください。

通常では、このフィールドは ``next`` です。

編集の雛型にできるような :file:`registration/login.html` テンプレートの

例を以下に示します。このテンプレートは、 ``content`` ブロックの定義された

:file:`base.html` があるという前提で書かれています:

.. versionadded:: 1.2

もし、他の認証を使っているならば( :ref:`authentication-backends` を見て

パラメータを経てログインビューへと行きます。このフォームは ``request``

キーワード引数を自身の ``__init__`` メソッドの中で受け取らなくては

いけません。そして、 ``get_user`` メソッドは認証されたユーザーオブジェクト

.. function:: views.password_reset_done(request[, template_name])

ユーザがパスワードをリセットした後のページを表示するためのビューです。

の URL セットを所持していない時にデフォルトで呼ばれます。

**オプション引数:**

** URL name:** ``password_reset_complete``

* ``template_name``: ビューを表示するためのテンプレートのフルネームで

す。:file:`registration/password_reset_complete.html` がデフォルトの

特定のパーミッションやその他のテストの結果に応じたアクセスの制限には、前節

で説明したの本質的に同じことをします。

:attr:`request.user <django.http.HttpRequest.user>` に対するテストを実行す

``polls.can_vote`` というパーミッションを持っているかチェックします::

def my_view(request):

ルドがあります:

.. attribute:: Permission.name

必須です。50 文字以下です。例: ``'Can vote'``

.. attribute:: Permission.content_type

``django_content_type`` データベーステーブルへの参照です。

.. attribute:: Permission.codename

必須です。 100 文字以下です。例: ``'can_vote'``

メソッド

content_type=content_type)

パーミッションは自身のクラスの ``user_permissions`` アトリビュートか、

アトリビュートから

:class:`~django.contrib.auth.models.User` へと割り当てることができます。

上記の変数をテンプレートコンテキストの中で使えるようになります。詳しくは

:ref:`RequestContext のドキュメント <subclassing-context-requestcontext>`

を参照してください。

ユーザ

------

現在のログインユーザのパーミッションはテンプレート変数 ``{{ perms }}`` に入っ

ています。この変数はパーミッションオブジェクトをテンプレートで扱いやすくす

:class:`django.contrib.auth.context_processors.PermWrapper` のインスタンスです。

.. versionchanged:: 1.3

認証バックエンドがパーミッション照会のための関数

(:meth:`~django.contrib.auth.models.User.get_group_permissions()`,

:meth:`~django.contrib.auth.models.User.has_perm()`, および

:meth:`~django.contrib.auth.models.User.has_module_perms()`) をサポートして

いる場合、ユーザモデルはパーミッションの照会をバックエンドに移譲します。