< django - 16 >

16. django.contrib.auth 앱 + 로그인과 로그아웃 + common 앱 + 로그인 뷰 + 로그인 템플릿

# django.contrib.auth 앱

: 장고의 로그인, 아웃을 도와주는 앱으로, 장고 프로젝트가 생성될 때 자동으로 추가됨

# common 앱

: 공통 기능을 가진 앱으로, 로그인과 로그아웃을 구현하는 데 사용

1. 명령 프롬포트에 common 앱을 새로 생성한다.

+ common 앱 생성 시 pybo 앱과 같은 구조의 디렉터리, 파일들이 자동으로 만들어짐.

2. projects\mysite\config\settings.py 파일에 새로 생성한 common 앱을 등록한다.

3. common 앱의 urls.py 파일을 사용하기 위해 config/urls.py 파일을 다음과 같이 수정한다.

+ 이제 http://localhost:8000/common/ 으로 시작하는 URL은 모두 common/urls.py 파일을 참조하게 됨

4. common/urls.py 파일을 아래처럼 새로 작성한다.

아직 common 앱에 어떤 기능도 구현하지 않았으므로 urlpatterns은 공백으로 남기기

# 로그인과 로그인 뷰, 로그인 템플릿

1. 로그인 화면으로의 진입을 위해 projects\mysite\templates\navbar.html 파일의 로그링 링크를 아래처럼 수정한다.

2. projects\mysite\common\urls.py 파일에 아래와 같은 매핑 규칙 추가 <-- navbar.html 파일에서 템플릿 태그로 {% url 'common:login' %}를 사용했기 때문

+ 로그인 뷰는 따로 만들지 않고 위의 코드처럼 django.contrib.auth 앱의 LoginView를 사용하도록 설정

3. http:/localhost:8000/pybo/ 를 불러온 뒤 네비게이션 바의 로그인 링크 클릭 --> 아래와 같은 오류 페이지 출력

+ LoginView는 registration이라는 템플릿 디렉터리에서 login.html 파일을 찾는데, 위 오류는 registration 디렉터리에 login.html 파일이 없을 때 나타남 --> registration/login.html 템플릿 파일을 작성함으로써 문제 해결 가능

4. LoginView가 common 디렉터리의 템플릿을 참조할 수 있도록 common/urls.py 파일을 아래와 같이 수정

+ registration 디렉터리가 아닌 common 디렉터리에서 login.html 파일을 참조하게 설정함 <-- 로그인은 common 앱에 구현할 것이므로 위의 오류 메시지에서 표시한 것처럼 registration 디렉터리에 템플릿 파일을 생성하기보다는 common 디렉터리에 템플릿을 생성하는 것이 더 나음

5. 다시 http:/localhost:8000/pybo/ 페이지를 불러오고 로그인 링크 클릭 --> 다른 오류 메세지 & 창 출력

registration/login.html 이 아닌  common/login.html 이 없다는 오류로 변경

6. 5번의 오류 해결을 위해 common/login.html 파일을 생성하기 위한 common 템플릿 디렉터리를 다음과 같이 생성

7. common 템플릿 디렉터리에 login.html 템플릿을 다음과 같이 새로 작성

파일명은 projects\mysite\templates\common\login.html

+ 사용자의 비밀번호와 아이디를 입력받아 로그인이 가능하게 하는 템플릿

+ django.contrib.auth 앱이 요구하는 하는 필수항목

--> 로그인에 쓰이는 사용자 아이디(사용자명)를 의미하는 항목 username, 비밀번호를 의미하는 password 항목

8. {% csrf_token %} 바로 밑에 include 태그로 포함된 form_errors.html 템플릿 파일을 아래와 같이 새로 작성한다.

파일명은 projects\mysite\templates\form_errors.html

+ 위 템플릿은 로그인 실패 시 로그인 실패 이유를 알려주는 역할을 하며, 필드 오류와 넌필드 오류를 모두 표시하기 위해 삽입됨

+ 폼 오류의 종류

필드 오류 (field.errors)	넌필드 오류 (form.non_field_errors)
사용자가 입력한 필드 값에 대한 오류로 값이 누락되었거나 필드의 형식이 일치하지 않는 경우에 발생하는 오류	필드의 값과는 상관없이 다른 이유로 발생하는 오류

# 로그인 수행

1. http:/localhost:8000/pybo/ 페이지를 호출 후 네비게이션바의 로그인 링크 클릭 --> 아무 내용도 입력하지 않고 로그인 버튼 클릭해보기

2. 현재 유일하게 로그인할 수 있는 슈퍼유저 alim을 사용자 아이디에, kprpm359을 비밀번호에 입력하여 로그인 수행해보기

+ 로그인이 성공하면 django.contrib.auth 패키지는 디폴트로 /accounts/profile/ 이라는 URL로 이동시키기 때문에 오류 발생

3. 2번의 오류 해결을 위해 로그인 성공 시 / 페이지로 이동할 수 있도록 config/settings.py 파일의 마지막 줄에 LOGIN_REDIRECT_URL 추가

파일명은 projects\mysite\config\settings.py, Line 131 추가

+ / 페이지 --> 기본 URL인 http://localhost:8000/ 페이지

4. 다시 http://localhost:8000/ 페이지 요청 후 로그인 수행 --> /를 의미하는 http://localhost:8000/ 페이지에 대한 URL 매핑 규칙을 작성하지 않았기에 에러 발생

5. 4번의 오류를 수정하기 위해 C:\projects\mysite\config\urls.py 파일에 / 페이지에 대응하는 URL 매핑 규칙 추가

+ / 페이지 요청 시 path('', views.index, name='index')가 작동하여 pybo/views.py 파일의 index 함수가 실행되게 설정함

# 로그아웃

1. http://localhost:8000/ 페이지 요청 --> 로그인이 성공적으로 완료되었음에도 로그아웃이 아닌 로그인 버튼이 보임

2. projects\mysite\templates\navbar.html 파일에서 로그인 링크 부분을 아래와 같이 수정

+ << Line 16 >>

: {% if user.is_authenticated %} --> 현재 사용자가 로그인 되었는지 여부를 판별하여 로그인이 되어있다면 로그아웃 링크를, 반대의 경우에는 로그인 링크를 표시

+ << Line 17 >>

: 로그인이 되어있는 경우 로그아웃 링크에 사용자명도 추가로 표시하도록 설정

+ 템플릿에서의 User 사용

: 뷰함수에서 템플릿에 User 객체를 전달하지 않더라도 템플릿에서는 django.contrib.auth 기능으로 인해 User 객체를 사용할 수 있음

user.is_authenticated	현재 사용자가 인증되었는지에 대한 여부 (로그인 상태에서는 true, 로그아웃 상태에서는 false)
user.is_anonymous	is_authenticated의 반대되는 경우 (로그인된 경우에는 false, 로그아웃 상태의 경우 true)
user.username	사용자명 = 사용자 ID
user.is_superuser	사용자가 슈퍼유저인지에 대한 여부