使用备用邮箱将现有用户迁移至 Google 身份验证

我们为一个拥有200多名活跃用户的协会运营着一个私有的 Discourse 网站。目前,绝大多数用户使用的是他们的个人电子邮件账户注册,而不是我们为它们创建的 Google 账户(因为在我们最初设置 Discourse 时,这些 Google 账户还不存在,而且很多人本来就更可能查看个人电子邮件以获取通知)。
现在我想将身份验证来源切换为 Google 账户,但我想尽量避免让用户手动更改或添加他们的 Google 账户电子邮件(因为让非技术背景的志愿者做这样的事情对我来说总是一场噩梦)。我还想避免拥有私人 Google 账户的用户使用这些账户进行单点登录(SSO),并强制所有用户使用我们的 Google 域名账户进行 SSO。

经过一些网上搜索,我拟定了一个可能的计划来实现这一目标,但想确认一下我的思路是否正确。以下是该计划:

  1. 将所有 Google 电子邮件地址添加为辅助电子邮件(我已经在设置中启用了“辅助电子邮件地址”)
  2. 按照 Discourse 文档 设置 OAuth2 授权和凭证
  3. 在 管理员 > 登录与身份验证 > OAuth2 中输入凭证,即 google oauth2 client id 和 google oauth2 client secret。然后启用设置 启用 Google OAuth2 登录。
  4. 通过设置 管理员 > 登录与身份验证 中的 允许的电子邮件域名 来将身份验证限制为我们的域名——这有必要吗?

另外,Google 的 AI 建议我使用此 Ruby 脚本来自动化添加电子邮件地址:

require 'csv'

csv_path = "/shared/users_map.csv"
updated = 0
skipped = 0

CSV.foreach(csv_path) do |personal_email, domain_email|
personal_email = personal_email&.strip&.downcase
domain_email = domain_email&.strip&.downcase
next if personal_email.blank? || domain_email.blank?

user = User.find_by_email(personal_email)

if user.nil?
puts "NOT FOUND: #{personal_email}"
skipped += 1
next
end

if UserEmail.exists?(email: domain_email)
puts "ALREADY EXISTS: #{domain_email} (User: #{user.username})"
skipped += 1
next
end

Attach the domain email as a confirmed secondary email

UserEmail.create!(
user_id: user.id,
email: domain_email,
primary: false,
confirmed_at: Time.zone.now
)

puts "LINKED: #{user.username} -> #{domain_email}"
updated += 1
end

puts "\nDone! Updated: #{updated}, Skipped/Errors: #{skipped}"

欢迎提供任何反馈!

你的计划看起来没问题。Discourse 可以通过辅助邮箱将 Google 登录匹配到现有账户,因此用户可以保留其个人邮箱用于接收通知。

对于域名限制,请使用 google oauth2 hd 而不是 allowed email domains。此外,请保持 auth overrides email 处于禁用状态,以确保其主邮箱地址保持不变。

关于脚本,UserEmail 没有 confirmed_at 列,因此请将其移除。Attach the domain email... 这一行前面也需要加上 #。

创建步骤可以如下:

user.user_emails.create!(email: domain_email, primary: false)

建议先备份,并在一两个用户身上进行测试,特别是因为该脚本跳过了邮箱验证。请确认 Google 登录能够将用户引导至其现有账户,并检查个人 Google 账户是否被阻止。一切正常后,即可禁用本地登录。