기존 사용자를 보조 이메일을 사용하는 Google Auth로 마이그레이션

저희 협회는 200명 이상의 활성 사용자를 보유한 프라이빗 Discourse 사이트를 운영 중입니다. 현재 대부분은 저희가 만들어 준 Google 계정 대신 개인 이메일 계정으로 가입되어 있습니다. (Discourse를 처음 설치했을 당시에는 Google 계정이 없었고, 많은 분들이 알림을 확인할 때 개인 이메일을 더 자주 보기 때문입니다.)

이제 Google 계정을 인증 소스로 변경하되, 사용자가 직접 Google 계정 이메일을 수동으로 변경하거나 추가하도록 요구하는 것은 피하고 싶습니다. (비기술적인 자원 봉사자들에게 이런 작업을 요구하면 늘 악몽이 되기 때문입니다.) 또한 개인 Google 계정 사용자가 SSO에 해당 계정을 사용하는 것을 방지하고, 모든 사용자가 저희 Google 도메인 계정으로 SSO를 진행하도록 강제하고 싶습니다.

몇 가지 조사를 통해 이 목표를 달성할 수 있는 가능한 계획을 세웠는데, 방향이 올바른지 확인하고 싶습니다. 계획은 다음과 같습니다:

  1. 모든 Google 이메일 주소를 보조 이메일로 추가합니다. (설정에서 이미 '보조 이메일 주소’를 활성화했습니다.)
  2. Discourse 문서에 따라 OAuth2 동의 및 자격 증명을 설정합니다.
  3. 관리자 > 로그인 및 인증 > OAuth2에서 자격 증명인 google oauth2 클라이언트 ID 및 google oauth2 클라이언트 시크릿을 입력합니다. 그런 다음 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 로그인과 기존 계정을 연결할 수 있으므로, 사용자는 알림용으로 개인 이메일을 계속 사용할 수 있습니다.

도메인 제한에는 allowed email domains 대신 google oauth2 hd를 사용하세요. 또한 기본 이메일 주소가 변경되지 않도록 auth overrides email 설정을 비활성화된 상태로 두세요.

스크립트에서는 UserEmail에 confirmed_at 열이 없으므로 해당 부분을 제거해야 합니다. 또한 Attach the domain email... 줄 앞에 #을 추가해야 합니다.

생성 단계는 다음과 같이 할 수 있습니다:

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

스크립트가 이메일 확인 단계를 생략하므로, 먼저 백업을 취하고 소수의 사용자로 테스트해 보시는 것을 권장합니다. Google 로그인 시 기존 계정으로 잘 연결되는지, 그리고 개인 Google 계정은 차단되는지 확인하세요. 정상 작동이 확인되면 로긴(로그인)을 비활성화하실 수 있습니다.