TYPO3 v12中自定义ADFS认证服务authUser方法未调用问题

TYPO3 v12 对认证服务的执行逻辑和方法签名做了多处调整，你的自定义ADFS认证服务出现authUser未被调用、登录失败的问题，主要和以下几点有关：

1. 修正getUser方法的返回值与签名 #

TYPO3 v12 要求AbstractAuthenticationService的getUser方法必须返回?array类型（用户数组或null），且只有当该方法返回非空的用户数组时，后续的authUser方法才会被触发。

你的当前getUser方法仅处理跳转，未在ADFS认证返回后返回对应的TYPO3用户数据，导致流程中断。修改如下：

namespace Vendor\Extension\Authentication;

use TYPO3\CMS\Core\Authentication\AbstractAuthenticationService;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Database\ConnectionPool;

class MyAuthService extends AbstractAuthenticationService
{
    // 修正方法签名，符合v12的类型要求
    public function getUser(): ?array
    {
        // 处理ADFS回调的逻辑：提取返回的认证数据（比如email、用户名）
        $adfsResponse = GeneralUtility::_GET('adfs_response'); // 替换为实际的参数名
        if ($adfsResponse) {
            // 从ADFS数据中获取唯一标识（比如邮箱）
            $userEmail = $this->extractEmailFromAdfsResponse($adfsResponse);
            
            // 查询TYPO3中对应的用户（前端/后端用户，根据当前上下文判断）
            $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
                ->getQueryBuilderForTable($this->authInfo['db_user']['table']);
            
            $user = $queryBuilder
                ->select('*')
                ->from($this->authInfo['db_user']['table'])
                ->where(
                    $queryBuilder->expr()->eq(
                        'email',
                        $queryBuilder->createNamedParameter($userEmail)
                    )
                )
                ->executeQuery()
                ->fetchAssociative();
            
            // 返回用户数组，触发后续authUser调用
            return $user ?: null;
        }

        // 未触发回调时，跳转至ADFS认证页面
        $this->redirectToAdfs();
        exit;
    }

    public function authUser(array $user): int
    {
        // 验证ADFS返回的认证数据与TYPO3用户的匹配性
        $adfsToken = GeneralUtility::_GET('adfs_token'); // 替换为实际的验证参数
        if ($this->validateAdfsToken($adfsToken, $user['email'])) {
            // 认证成功，返回100（表示完全信任该认证）
            return 100;
        }

        // 认证失败，返回0
        return 0;
    }

    // 辅助方法：提取ADFS返回的邮箱
    private function extractEmailFromAdfsResponse($response): string
    {
        // 实现你的ADFS响应解析逻辑
        return $response['email'];
    }

    // 辅助方法：验证ADFS令牌有效性
    private function validateAdfsToken(string $token, string $userEmail): bool
    {
        // 实现你的ADFS令牌验证逻辑（比如签名校验、有效期检查）
        return true;
    }

    // 辅助方法：跳转至ADFS认证页面
    private function redirectToAdfs(): void
    {
        $adfsAuthUrl = 'https://your-adfs-server/adfs/ls/idpinitiatedsignon.aspx'; // 替换为实际ADFS地址
        $callbackUrl = GeneralUtility::getIndpEnv('TYPO3_REQUEST_URL');
        $redirectUrl = $adfsAuthUrl . '?redirect_uri=' . urlencode($callbackUrl);
        header('Location: ' . $redirectUrl);
    }
}

2. 检查服务注册的兼容性 #

TYPO3 v12 对服务注册的subtype参数仍支持authUserFE,getUserFE,authUserBE,getUserBE，但需确保：

• 服务的priority（优先级）高于默认认证服务（默认服务优先级通常为50），你的80设置合理，但如果有其他自定义服务优先级更高，可能会抢占执行
• 确认className参数与实际类路径完全一致（当前代码中配置正确，但需检查命名空间是否和实际文件结构匹配）

3. 验证认证上下文的一致性 #

• 如果是前端认证，需确保前端登录插件（felogin）或自定义登录流程正确触发认证服务
• 如果是后端认证，需确保TYPO3后端的认证配置（$GLOBALS['TYPO3_CONF_VARS']['BE']['authServices']）未覆盖你的服务

4. 调试与日志排查 #

• 在getUser和authUser方法中添加日志记录（使用TYPO3的日志API），确认执行流程：

  use TYPO3\CMS\Core\Log\LogManager;
  
  // 在方法内添加
  $logger = GeneralUtility::makeInstance(LogManager::class)->getLogger(__CLASS__);
  $logger->info('getUser method executed', ['adfs_response' => $adfsResponse]);
  

• 查看TYPO3系统日志（typo3temp/var/logs/目录下的日志文件），排查是否有认证相关的错误提示

内容的提问来源于stack exchange，提问作者chris