3 namespace BookStack\Http\Controllers\Auth;
5 use BookStack\Auth\Access\LoginService;
6 use BookStack\Auth\Access\SocialAuthService;
7 use BookStack\Exceptions\LoginAttemptEmailNeededException;
8 use BookStack\Exceptions\LoginAttemptException;
9 use BookStack\Facades\Activity;
10 use BookStack\Http\Controllers\Controller;
11 use Illuminate\Foundation\Auth\AuthenticatesUsers;
12 use Illuminate\Http\Request;
13 use Illuminate\Validation\ValidationException;
15 class LoginController extends Controller
18 |--------------------------------------------------------------------------
20 |--------------------------------------------------------------------------
22 | This controller handles authenticating users for the application and
23 | redirecting them to your home screen. The controller uses a trait
24 | to conveniently provide its functionality to your applications.
28 use AuthenticatesUsers { logout as traitLogout; }
33 protected $redirectTo = '/';
34 protected $redirectPath = '/';
36 protected SocialAuthService $socialAuthService;
37 protected LoginService $loginService;
40 * Create a new controller instance.
42 public function __construct(SocialAuthService $socialAuthService, LoginService $loginService)
44 $this->middleware('guest', ['only' => ['getLogin', 'login']]);
45 $this->middleware('guard:standard,ldap', ['only' => ['login']]);
46 $this->middleware('guard:standard,ldap,oidc', ['only' => ['logout']]);
48 $this->socialAuthService = $socialAuthService;
49 $this->loginService = $loginService;
51 $this->redirectPath = url('/');
54 public function username()
56 return config('auth.method') === 'standard' ? 'email' : 'username';
60 * Get the needed authorization credentials from the request.
62 protected function credentials(Request $request)
64 return $request->only('username', 'email', 'password');
68 * Show the application login form.
70 public function getLogin(Request $request)
72 $socialDrivers = $this->socialAuthService->getActiveDrivers();
73 $authMethod = config('auth.method');
74 $preventInitiation = $request->get('prevent_auto_init') === 'true';
76 if ($request->has('email')) {
77 session()->flashInput([
78 'email' => $request->get('email'),
79 'password' => (config('app.env') === 'demo') ? $request->get('password', '') : '',
83 // Store the previous location for redirect after login
84 $this->updateIntendedFromPrevious();
86 if (!$preventInitiation && $this->shouldAutoInitiate()) {
87 return view('auth.login-initiate', [
88 'authMethod' => $authMethod,
92 return view('auth.login', [
93 'socialDrivers' => $socialDrivers,
94 'authMethod' => $authMethod,
99 * Handle a login request to the application.
101 * @param \Illuminate\Http\Request $request
103 * @throws \Illuminate\Validation\ValidationException
105 * @return \Illuminate\Http\RedirectResponse|\Illuminate\Http\Response|\Illuminate\Http\JsonResponse
107 public function login(Request $request)
109 $this->validateLogin($request);
110 $username = $request->get($this->username());
112 // If the class is using the ThrottlesLogins trait, we can automatically throttle
113 // the login attempts for this application. We'll key this by the username and
114 // the IP address of the client making these requests into this application.
115 if (method_exists($this, 'hasTooManyLoginAttempts') &&
116 $this->hasTooManyLoginAttempts($request)) {
117 $this->fireLockoutEvent($request);
119 Activity::logFailedLogin($username);
121 return $this->sendLockoutResponse($request);
125 if ($this->attemptLogin($request)) {
126 return $this->sendLoginResponse($request);
128 } catch (LoginAttemptException $exception) {
129 Activity::logFailedLogin($username);
131 return $this->sendLoginAttemptExceptionResponse($exception, $request);
134 // If the login attempt was unsuccessful we will increment the number of attempts
135 // to login and redirect the user back to the login form. Of course, when this
136 // user surpasses their maximum number of attempts they will get locked out.
137 $this->incrementLoginAttempts($request);
139 Activity::logFailedLogin($username);
141 return $this->sendFailedLoginResponse($request);
145 * Attempt to log the user into the application.
147 * @param \Illuminate\Http\Request $request
151 protected function attemptLogin(Request $request)
153 return $this->loginService->attempt(
154 $this->credentials($request),
155 auth()->getDefaultDriver(),
156 $request->filled('remember')
161 * The user has been authenticated.
163 * @param \Illuminate\Http\Request $request
168 protected function authenticated(Request $request, $user)
170 return redirect()->intended($this->redirectPath());
174 * Validate the user login request.
176 * @param \Illuminate\Http\Request $request
178 * @throws \Illuminate\Validation\ValidationException
182 protected function validateLogin(Request $request)
184 $rules = ['password' => ['required', 'string']];
185 $authMethod = config('auth.method');
187 if ($authMethod === 'standard') {
188 $rules['email'] = ['required', 'email'];
191 if ($authMethod === 'ldap') {
192 $rules['username'] = ['required', 'string'];
193 $rules['email'] = ['email'];
196 $request->validate($rules);
200 * Send a response when a login attempt exception occurs.
202 protected function sendLoginAttemptExceptionResponse(LoginAttemptException $exception, Request $request)
204 if ($exception instanceof LoginAttemptEmailNeededException) {
206 session()->flash('request-email', true);
209 if ($message = $exception->getMessage()) {
210 $this->showWarningNotification($message);
213 return redirect('/login');
217 * Get the failed login response instance.
219 * @param \Illuminate\Http\Request $request
221 * @throws \Illuminate\Validation\ValidationException
223 * @return \Symfony\Component\HttpFoundation\Response
225 protected function sendFailedLoginResponse(Request $request)
227 throw ValidationException::withMessages([
228 $this->username() => [trans('auth.failed')],
229 ])->redirectTo('/login');
233 * Update the intended URL location from their previous URL.
234 * Ignores if not from the current app instance or if from certain
235 * login or authentication routes.
237 protected function updateIntendedFromPrevious(): void
239 // Store the previous location for redirect after login
240 $previous = url()->previous('');
241 $isPreviousFromInstance = (strpos($previous, url('/')) === 0);
242 if (!$previous || !setting('app-public') || !$isPreviousFromInstance) {
246 $ignorePrefixList = [
251 foreach ($ignorePrefixList as $ignorePrefix) {
252 if (strpos($previous, url($ignorePrefix)) === 0) {
257 redirect()->setIntendedUrl($previous);
261 * Check if login auto-initiate should be valid based upon authentication config.
263 protected function shouldAutoInitiate(): bool
265 $socialDrivers = $this->socialAuthService->getActiveDrivers();
266 $authMethod = config('auth.method');
267 $autoRedirect = config('auth.auto_initiate');
269 return $autoRedirect && count($socialDrivers) === 0 && in_array($authMethod, ['oidc', 'saml2']);
273 * Logout user and perform subsequent redirect.
275 * @param \Illuminate\Http\Request $request
279 public function logout(Request $request)
281 $this->traitLogout($request);
283 $redirectUri = $this->shouldAutoInitiate() ? '/login?prevent_auto_init=true' : '/';
285 return redirect($redirectUri);