defmodule BeetRoundServerWeb.AdminAuth do use BeetRoundServerWeb, :verified_routes import Plug.Conn import Phoenix.Controller alias BeetRoundServer.Admins alias BeetRoundServer.Admins.Scope # Make the remember me cookie valid for 14 days. This should match # the session validity setting in AdminToken. @max_cookie_age_in_days 14 @remember_me_cookie "_beet_round_server_web_admin_remember_me" @remember_me_options [ sign: true, max_age: @max_cookie_age_in_days * 24 * 60 * 60, same_site: "Lax" ] # How old the session token should be before a new one is issued. When a request is made # with a session token older than this value, then a new session token will be created # and the session and remember-me cookies (if set) will be updated with the new token. # Lowering this value will result in more tokens being created by active users. Increasing # it will result in less time before a session token expires for a user to get issued a new # token. This can be set to a value greater than `@max_cookie_age_in_days` to disable # the reissuing of tokens completely. @session_reissue_age_in_days 7 @doc """ Logs the admin in. Redirects to the session's `:admin_return_to` path or falls back to the `signed_in_path/1`. """ def log_in_admin(conn, admin, params \\ %{}) do admin_return_to = get_session(conn, :admin_return_to) conn |> create_or_extend_session(admin, params) |> redirect(to: admin_return_to || signed_in_path(conn)) end @doc """ Logs the admin out. It clears all session data for safety. See renew_session. """ def log_out_admin(conn) do admin_token = get_session(conn, :admin_token) admin_token && Admins.delete_admin_session_token(admin_token) if live_socket_id = get_session(conn, :live_socket_id) do BeetRoundServerWeb.Endpoint.broadcast(live_socket_id, "disconnect", %{}) end conn |> renew_session(nil) |> delete_resp_cookie(@remember_me_cookie) |> redirect(to: ~p"/") end @doc """ Authenticates the admin by looking into the session and remember me token. Will reissue the session token if it is older than the configured age. """ def fetch_current_scope_for_admin(conn, _opts) do with {token, conn} <- ensure_admin_token(conn), {admin, token_inserted_at} <- Admins.get_admin_by_session_token(token) do conn |> assign(:current_scope, Scope.for_admin(admin)) |> maybe_reissue_admin_session_token(admin, token_inserted_at) else nil -> assign(conn, :current_scope, Scope.for_admin(nil)) end end defp ensure_admin_token(conn) do if token = get_session(conn, :admin_token) do {token, conn} else conn = fetch_cookies(conn, signed: [@remember_me_cookie]) if token = conn.cookies[@remember_me_cookie] do {token, conn |> put_token_in_session(token) |> put_session(:admin_remember_me, true)} else nil end end end # Reissue the session token if it is older than the configured reissue age. defp maybe_reissue_admin_session_token(conn, admin, token_inserted_at) do token_age = DateTime.diff(DateTime.utc_now(:second), token_inserted_at, :day) if token_age >= @session_reissue_age_in_days do create_or_extend_session(conn, admin, %{}) else conn end end # This function is the one responsible for creating session tokens # and storing them safely in the session and cookies. It may be called # either when logging in, during sudo mode, or to renew a session which # will soon expire. # # When the session is created, rather than extended, the renew_session # function will clear the session to avoid fixation attacks. See the # renew_session function to customize this behaviour. defp create_or_extend_session(conn, admin, params) do token = Admins.generate_admin_session_token(admin) remember_me = get_session(conn, :admin_remember_me) conn |> renew_session(admin) |> put_token_in_session(token) |> maybe_write_remember_me_cookie(token, params, remember_me) end # Do not renew session if the admin is already logged in # to prevent CSRF errors or data being lost in tabs that are still open defp renew_session(conn, admin) when conn.assigns.current_scope.admin.id == admin.id do conn end # This function renews the session ID and erases the whole # session to avoid fixation attacks. If there is any data # in the session you may want to preserve after log in/log out, # you must explicitly fetch the session data before clearing # and then immediately set it after clearing, for example: # # defp renew_session(conn, _admin) do # delete_csrf_token() # preferred_locale = get_session(conn, :preferred_locale) # # conn # |> configure_session(renew: true) # |> clear_session() # |> put_session(:preferred_locale, preferred_locale) # end # defp renew_session(conn, _admin) do delete_csrf_token() conn |> configure_session(renew: true) |> clear_session() end defp maybe_write_remember_me_cookie(conn, token, %{"remember_me" => "true"}, _), do: write_remember_me_cookie(conn, token) defp maybe_write_remember_me_cookie(conn, token, _params, true), do: write_remember_me_cookie(conn, token) defp maybe_write_remember_me_cookie(conn, _token, _params, _), do: conn defp write_remember_me_cookie(conn, token) do conn |> put_session(:admin_remember_me, true) |> put_resp_cookie(@remember_me_cookie, token, @remember_me_options) end defp put_token_in_session(conn, token) do put_session(conn, :admin_token, token) end @doc """ Plug for routes that require sudo mode. """ def require_sudo_mode(conn, _opts) do if Admins.sudo_mode?(conn.assigns.current_scope.admin, -10) do conn else conn |> put_flash(:error, "You must re-authenticate to access this page.") |> maybe_store_return_to() |> redirect(to: ~p"/admins/log-in") |> halt() end end @doc """ Plug for routes that require the admin to not be authenticated. """ def redirect_if_admin_is_authenticated(conn, _opts) do if conn.assigns.current_scope do conn |> redirect(to: signed_in_path(conn)) |> halt() else conn end end defp signed_in_path(_conn), do: ~p"/" @doc """ Plug for routes that require the admin to be authenticated. """ def require_authenticated_admin(conn, _opts) do if conn.assigns.current_scope && conn.assigns.current_scope.admin do conn else conn |> put_flash(:error, "You must log in to access this page.") |> maybe_store_return_to() |> redirect(to: ~p"/admins/log-in") |> halt() end end defp maybe_store_return_to(%{method: "GET"} = conn) do put_session(conn, :admin_return_to, current_path(conn)) end defp maybe_store_return_to(conn), do: conn end