{"title":"“REMOTE_USER”를 이용해 인증하는 방법","version":"6.1","locale":"ko","docname":"howto/auth-remote-user","url":"/ko/6.1/howto/auth-remote-user/","canonical":"https://djangodocs.dev/ko/6.1/howto/auth-remote-user/","summary":"This document describes how to make use of external authentication sources in your Django applications. This type of authentication solution is typically seen on…","html":"

“REMOTE_USER”를 이용해 인증하는 방법Link to this heading#

\n

This document describes how to make use of external authentication sources in\nyour Django applications. This type of authentication solution is typically\nseen on intranet sites, with single sign-on solutions such as IIS and\nIntegrated Windows Authentication or Apache and mod_authnz_ldap, CAS,\nWebAuth, mod_auth_sspi, etc.

\n

When the web server takes care of authentication it typically provides the\nauthenticated user as REMOTE_USER. In Django, this value is made available\nin request.META (as REMOTE_USER when\nsupplied as an environment variable, as in WSGI, or HTTP_REMOTE_USER when\nsupplied via an HTTP header, as in ASGI). Django can be configured to make use\nof the REMOTE_USER value using the RemoteUserMiddleware or\nPersistentRemoteUserMiddleware, and\nRemoteUserBackend classes found in\ndjango.contrib.auth.

\n
\n

설정Link to this heading#

\n

우선, django.contrib.auth.middleware.AuthenticationMiddleware를 설정하기 전에 MIDDLEWARE에 django.contrib.auth.middleware.RemoteUserMiddleware를 추가해야 합니다.

\n
Code
MIDDLEWARE = [\n    "...",\n    "django.contrib.auth.middleware.AuthenticationMiddleware",\n    "django.contrib.auth.middleware.RemoteUserMiddleware",\n    "...",\n]\n
\n

그 다음 , AUTHENTICATION_BACKENDS 세팅에 있는 ModelBackend를 RemoteUserBackend로 바꿔야 합니다.

\n
Code
AUTHENTICATION_BACKENDS = [\n    "django.contrib.auth.backends.RemoteUserBackend",\n]\n
\n

With this setup, RemoteUserMiddleware will detect the username in\nrequest.META['REMOTE_USER'] (or request.META['HTTP_REMOTE_USER'] under\nASGI) and will authenticate and auto-login that user\nusing the RemoteUserBackend.

\n

이 설정은 인증을 기본 ModelBackend로 사용하지 못하게 합니다. 그 말은 만약 REMOTE_USER 값이 설정되어 있지 않으면 Django의 관리 인터페이스를 사용한다 하더라도 사용자는 로그인할 수 없다는 것입니다. django.contrib.auth.backends.ModelBackend를 AUTHENTICATION_BACKENDS 리스트에 추가하면 REMOTE_USER가 없을 경우``ModelBackend``로 대체하여 이 문제를 해결할 수 있습니다.

\n

contrib.admin의 뷰와 createsuperuser 관리 명령과 같은 Django의 사용자 관리는 원격 사용자와 통합할 수 없습니다. 이 인터페이스들은 AUTHENTICATION_BACKENDS와 상관없이 데이터페이스에 저장된 사용자와만 작동합니다.

\n\n

인증 메커니즘이 REMOTE_USER 대신 맞춤 HTTP 헤더를 사용하는 경우 RemoteUserMiddleware``의 하위 클래스를 만들고 ``header 속성을 원하는 request.META 키로 설정할 수 있습니다. 예시는 다음과 같습니다.

\n
mysite/middleware.py
\n
Python
 from django.contrib.auth.middleware import RemoteUserMiddleware\n\n\n class CustomHeaderRemoteUserMiddleware(RemoteUserMiddleware):\n     header = "HTTP_AUTHUSER"\n
\n

이렇게 만든 맞춤 미들웨어는 MIDDLEWARE 설정에서 django.contrib.auth.middleware.RemoteUserMiddleware 대신 사용됩니다:

\n
Code
MIDDLEWARE = [\n    "...",\n    "django.contrib.auth.middleware.AuthenticationMiddleware",\n    "mysite.middleware.CustomHeaderRemoteUserMiddleware",\n    "...",\n]\n
\n\n

만약 독자가 더 많은 제어를 필요로 할 경우, RemoteUserBackend를 상속하는 인증 백엔드를 스스로 만들어 하나 이상의 속성과 메소드를 오버라이드할 수 있습니다.

\n
\n
\n

REMOTE_USER는 로그인 페이지에서만 사용할 수 있습니다.Link to this heading#

\n

인증 미들웨어인 RemoteUserMiddleware는 HTTP 요청 헤더인 REMOTE_USER가 모든 인증된 요청과 함께 존재한다는 것을 가정합니다. 이것은 Basic HTTP Auth가 htpasswd 또는 기타 간단한 메커니즘들과 함께일 때 기대거나 실용적이지만, Negotiate(GSSAPI / Kerberos) 또는 기타 자원 집약적인 인증 방법과 함께 일 때는, 프런트엔드 HTTP 서버에서의 인증은 일반적으로 하나 또는 몇 개의 로그인 URL을 설정해야하고, 인증이 성공하면 응용 프로그램은 인증된 세션 자체가 유지 관리된다라는 조건이여야합니다.

\n

PersistentRemoteUserMiddleware는 사용 사례에 대한 지원을 제공합니다. 이것은 사용자에 의하여 명시적으로 로그아웃할 때까지 인증된 세션을 유지 관리할 것 입니다. 이 클래스는 위의 문서에서 RemoteUserMiddleware 일시 대체품으로 사용되어질 수 있습니다.

\n
","rootId":"how-to-authenticate-using-remote-user","toc":[{"title":"설정","anchor":"configuration","children":[]},{"title":"REMOTE_USER는 로그인 페이지에서만 사용할 수 있습니다.","anchor":"using-remote-user-on-login-pages-only","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"How-to 가이드","url":"/ko/6.1/howto/"}],"prev":{"docname":"howto/static-files/deployment","title":"정적 파일을 배포하는 방법","url":"/ko/6.1/howto/static-files/deployment/"},"next":{"docname":"howto/csp","title":"Django의 콘텐츠 보안 정책을 사용하는 방법","url":"/ko/6.1/howto/csp/"},"formats":{"html":"/ko/6.1/howto/auth-remote-user/","markdown":"/ko/6.1/howto/auth-remote-user.md","json":"/ko/6.1/howto/auth-remote-user.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/howto/auth-remote-user.txt","official":"https://docs.djangoproject.com/ko/6.1/howto/auth-remote-user/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}