将现有 Salesforce SSO 用户迁移到 Laravel 登录时如何处理密码?
结论:不建议、通常也做不到把 Salesforce 的密码 hash 直接迁到 Laravel。更稳妥的做法是让现有用户通过安全链接设置本地密码。想减少打扰的话,可以先短期保留 Salesforce SSO,等用户下次登录再引导设置本地密码,之后彻底切换。
为什么不能直接迁移 Salesforce 密码 hash
Salesforce 作为身份提供方,一般不会把用户密码 hash 暴露给接入应用。即使拿得到,也通常没法直接给 Laravel 用:hash 算法、salt、pepper、迭代参数和存储格式都可能不同,Laravel 默认的 Hash::check 只认它自己支持的哈希格式。自己写 custom hasher 理论上可行,前提是能拿到完整且稳定的哈希参数,这在 Salesforce SSO 场景里基本不现实。
因此,明文密码和复制 Salesforce 密码都不在可选项之内。
推荐方案:空密码 + 安全设置链接
保留现有 users 记录和主键,用 salesforce_id 或 email 做匹配,把迁移用户的 password 置空,再加一个状态字段标记还没设置本地密码。登录时先判断状态,避免空密码进入 Hash::check。
Schema::table('users', function (Blueprint $table) {
$table->string('salesforce_id')->nullable()->unique();
$table->boolean('local_password_enabled')->default(false);
$table->timestamp('password_set_at')->nullable();
});
如果 password 列不是 nullable,要先改成 nullable:
Schema::table('users', function (Blueprint $table) {
$table->string('password')->nullable()->change();
});
登录时要显式拦下未设置本地密码的账号:
$user = User::where('email', $request->email)->first();
if (!$user || !$user->local_password_enabled || $user->password === null) {
return back()->withErrors([
'email' => '该账号尚未设置本地密码,请使用邮件中的链接完成设置。',
]);
}
if (!Hash::check($request->password, $user->password)) {
return back()->withErrors(['email' => '邮箱或密码不正确。']);
}
Auth::login($user, $request->boolean('remember'));
用户设置密码后正常写入:
$data = $request->validate([
'password' => ['required', 'confirmed', 'min:12'],
]);
$user->password = Hash::make($data['password']);
$user->local_password_enabled = true;
$user->password_set_at = now();
$user->save();
设置链接可以用 Laravel 的 password broker,也可以用带签名的临时 URL。过期时间、限流和一次性使用这几项都要处理:
$token = Password::broker()->createToken($user);
$user->notify(new LocalPasswordSetupNotification($token));
更平滑的过渡:临时双认证 + 下次登录引导
如果不想让用户在切换当天集中设置密码,可以短期保留 Salesforce SSO。用户通过 SSO 成功登录后,用 salesforce_id 或已验证的 email 匹配 Laravel 用户,再跳到设置本地密码的页面。整个过程不要让 Laravel 接触或保存 Salesforce 密码。宽限期结束后关闭 SSO,还没完成设置的用户走重置链接。
magic link 或一次性验证码也能用作过渡验证方式。不过重点在于让用户新建一个 Laravel 密码,Salesforce 的 hash 迁移可以完全跳过。
迁移注意事项
匹配用户时优先用 salesforce_id,email 只作 fallback,同时注意 email 变更和重复账号的情况。原用户 ID、角色和权限要保留,不要建出重复账号。迁移前先通知用户,登录页的文案和入口尽量保持用户熟悉的样子;上线后测试空密码是否被拒、重置链接、角色权限有没有变化,以及 SSO 关闭后的回滚方案。
备注:内容仅供参考。
