From cbebfcaae62b93cb78b46ace4076a7685e3a2074 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marc=20W=C3=BCrth?= <ravage@bluewin.ch>
Date: Mon, 28 Apr 2025 18:58:59 +0200
Subject: [PATCH] Link to impersonation cookbook article

---
 src/Controller/Component/AuthenticationComponent.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Controller/Component/AuthenticationComponent.php b/src/Controller/Component/AuthenticationComponent.php
index d1a0b8b6..ad5c1e7b 100644
--- a/src/Controller/Component/AuthenticationComponent.php
+++ b/src/Controller/Component/AuthenticationComponent.php
@@ -377,6 +377,7 @@ public function implementedEvents(): array
      * @param \ArrayAccess $impersonated User impersonated
      * @return $this
      * @throws \Exception
+     * @see https://book.cakephp.org/authentication/3/en/impersonation.html
      */
     public function impersonate(ArrayAccess $impersonated)
     {
@@ -414,6 +415,7 @@ public function impersonate(ArrayAccess $impersonated)
      *
      * @return $this
      * @throws \Exception
+     * @see https://book.cakephp.org/authentication/3/en/impersonation.html
      */
     public function stopImpersonating()
     {
@@ -442,6 +444,7 @@ public function stopImpersonating()
      *
      * @return bool
      * @throws \Exception
+     * @see https://book.cakephp.org/authentication/3/en/impersonation.html
      */
     public function isImpersonating(): bool
     {
@@ -462,6 +465,7 @@ public function isImpersonating(): bool
      *
      * @return \Authentication\Authenticator\ImpersonationInterface
      * @throws \Exception
+     * @see https://book.cakephp.org/authentication/3/en/impersonation.html
      */
     protected function getImpersonationAuthenticationService(): ImpersonationInterface
     {