/django-loginas

"Log in as user" for the Django admin.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

django-loginas

About

"Login as user" for the Django admin.

Build Status

Installing django-loginas

  • Add loginas to your Python path, or install using pip: pip install django-loginas

  • Add the loginas app to your INSTALLED_APPS:

# settings.py
INSTALLED_APPS = (... 'loginas', ...)
  • Add the loginas URL to your urls.py:
# urls.py
urlpatterns += patterns('loginas.views',
    url(r"^login/user/(?P<user_id>.+)/$", "user_login", name="loginas-user-login"),
)
  • At this point, the only users who will be able to log in as other users are those with the is_superuser permission. If you use custom User models, and haven't specified that permission, or if you want to change which users are authorized to log in as others, you can define the CAN_LOGIN_AS setting, like so:
# settings.py

# This will allow authenticated users with listed ids log in as other users:
CAN_LOGIN_AS_USER_IDS = [1, 2]

# This will allow authenticated users with listed emails log in as other users:
CAN_LOGIN_AS_USER_EMAILS = ['admin@domain.com']

# This will only allow admins to log in as other users:
CAN_LOGIN_AS = lambda request, target_user: request.user.is_admin

# This will only allow admins to log in as other users, as long as
# those users are not admins themselves:
CAN_LOGIN_AS = lambda request, target_user: request.user.is_admin and not target_user.is_admin

# You can also define a string path to a module:
CAN_LOGIN_AS = "utils.helpers.custom_loginas"

If you what to extend default CAN_LOGIN_AS function you can do it in next way:

# helpers.py
from loginas.views import check_can_login_as

def custom_loginas(request, target_user):
    if target_user.is_admin:
        return False
    return check_can_login_as(request, target_user)

If you're using a custom User model, you'll need to add the template to it so the button shows up:

# admin.py
class YourUserAdmin(ModelAdmin):
    change_form_template = 'loginas/change_form.html'

At this point, you should be good to go. Just visit the Django admin, navigate to a user and you should see the "Log in as user" button at the top right of the screen.

License

This software is distributed under the BSD license.