등록 아키텍처
GitLab v19.6요약
GitLab.com은 Unified Lightweight Registration 프로젝트가 기존의 플래그로 제어되던 등록 경로를 제거한 뒤 새 사용자를 등록하고 온보딩합니다. 아래에서는 SaaS(GitLab.com) 등록 흐름을 중심으로 설명합니다.
GitLab.com은 Unified Lightweight Registration 프로젝트가 기존의 플래그로 제어되던 등록 경로를 제거한 뒤 새 사용자를 등록하고 온보딩합니다. 이 문서는 익명 방문자가 가입 페이지에 도착한 시점부터 해당 사용자가 프로젝트나 그룹에 들어가기까지 실행되는 컨트롤러와 서비스를 다룹니다.
아래에서는 SaaS(GitLab.com) 등록 흐름을 중심으로 설명합니다. GitLab Self-Managed 구독 구매는 이러한 서비스 일부를 공유하며, 차이점은 해당하는 곳에서 명시적으로 설명합니다.
개요#
이 흐름은 다섯 단계로 이루어집니다. 진입점 선택, 자격 증명 제출, 계정 상태 초기화, 선택적 신원 확인, 그리고 사용자가 등록한 이유에 따라 달라지는 환영 단계입니다.
소스 코드 보기
flowchart TD
accTitle: GitLab.com registration and onboarding flow
accDescr: An anonymous user picks an entry point, submits credentials, has their account status initialized, optionally completes identity verification on GitLab.com, then is routed through a welcome controller chosen by registration type, ending at a completion path.
A[Anonymous user] --> B{Entry point}
B --> C[Submit credentials]
C --> D[Onboarding::StatusCreateService]
D --> E{Identity verification required?}
E -->|Yes, GitLab.com only| F[RegistrationsIdentityVerificationController]
E -->|No| G[Welcome controller by registration type]
F -->|success| G
G --> H[Completion path]</code></pre></details></div>
진입점#
익명 사용자는 여러 곳에서 등록을 시작할 수 있습니다.
진입점
경로
컨트롤러
표준 가입
/users/sign_up
RegistrationsController#new (CE, EE::RegistrationsController가 prepend)
초대 링크
/users/sign_up?invite=...
RegistrationsController#new, AcceptsPendingInvitations concern 사용
체험판 가입
/-/trial_registrations/new
TrialRegistrationsController#new (EE)
OmniAuth (Google 또는 GitHub)
/users/auth/:provider
OmniAuth 요청 단계, 공급자로 리디렉션
OmniAuth 콜백
/users/auth/:provider/callback
OmniauthCallbacksController#handle_omniauth
로그인 페이지
/users/sign_in
같은 소셜 가입 버튼 표시
구독 구매
/-/subscriptions/new
GitlabSubscriptions::SubscriptionsController#new
소셜 가입 버튼은 POPULAR_PROVIDERS로 나열된 Google(google_oauth2)과
GitHub(github)만 포함합니다. SAML은 그룹별로 Enterprise SSO로 제공되지만
셀프서비스 가입 버튼에는 포함되지 않습니다.
익명 사용자가 /-/subscriptions/new에 도달하면 ensure_registered!가
store_location_for(:user, request.fullpath)를 호출합니다. 사용자가
등록한 뒤에는 기본 완료 경로가 아니라
구독 결제 페이지로 돌아갑니다.
GitLab Self-Managed 구독 구매는 별도의 분기를 따릅니다. 쿼리
매개변수 deployment_type=self_managed와 plan_id가
GitlabSubscriptions::SelfManagedPurchaseRedirect concern을 트리거하며, 이 concern은
EE::RegistrationsController와
GitlabSubscriptions::SubscriptionsController#new에 모두 포함되어 있습니다.
자격 증명 제출#
사용자가 가입 양식을 제출하면 다음 동작 중 하나가
User 레코드를 생성합니다.
POST /users → RegistrationsController#create는
Users::RegistrationsBuildService를 통해 사용자를 만듭니다.
POST /-/trial_registrations → TrialRegistrationsController#create는
#resource를 재정의하여 대신 Users::AuthorizedBuildService를 통해
사용자를 만듭니다.
- OmniAuth 가입 →
OmniauthCallbacksController#handle_omniauth. OmniAuth 아이덴티티가
2단계 인증이 활성화된 기존 사용자의 것이면 sign_in_user_flow가 로그인을 바로 완료하지 않고
prompt_for_two_factor로 요청을 가로챕니다.
Devise 및 계정 상태 초기화#
계정 생성 직후에 Devise와 관련된 두 가지 로직이 실행됩니다.
IdentityVerifiable concern
(ee/app/models/concerns/identity_verifiable.rb)은
active_for_authentication?를 재정의하여 GitLab.com에서 확인되지 않은 사용자에 대해 false를 반환하며,
이로 인해 사용자는 정상적으로 로그인하기 전에 신원 확인 경로로 들어가게 됩니다. 이는
Gitlab::Saas.feature_available?(:identity_verification)이 true일 때만 적용됩니다.
Onboarding::StatusCreateService는 user_details.onboarding_status
JSONB 열에 기록하고 onboarding_in_progress = true를 설정합니다. 이 서비스는
registration_type, initial_registration_type, 그리고 glm_source와
glm_content 마케팅 기여도 매개변수를 기록합니다. 이 단계는
GitLab Self-Managed 구독 등록에서는 건너뜁니다.
온보딩 전체는 Onboarding.enabled?로 제어되며, 이는
Gitlab::Saas.feature_available?(:onboarding)에 위임됩니다.
별개로, 엔터프라이즈 사용자 연결도 이 시점에 실행될 수 있습니다.
Groups::EnterpriseUsers::Associable concern이 등록 중에 적격 여부를 확인하며,
Groups::EnterpriseUsers::AssociateService는 AssociateWorker를 통해
소급하여 비동기적으로 실행될 수도 있습니다.
등록 유형 전략#
온보딩 동작은 사용자가 등록한 이유에 따라 달라집니다. Onboarding::StatusPresenter는
Onboarding::UserStatus에 위임하며, 이는
ee/app/models/onboarding/user_status.rb에 정의된
REGISTRATION_KLASSES와 REGISTRATION_TYPE 매핑을 사용해 전략 클래스를 선택합니다. 모든 전략 클래스는
ee/app/models/onboarding/ 아래에 있습니다.
등록 유형
전략 클래스
환영 컨트롤러
주요 서비스
무료
FreeRegistration
Registrations::WelcomeController
Onboarding::FreeNamespaceCreateService
체험판
TrialRegistration
Registrations::TrialWelcomeController
Onboarding::TrialNamespaceCreateService
자동 체험판
AutomaticTrialRegistration (TrialRegistration의 하위 클래스)
Registrations::TrialWelcomeController
Onboarding::TrialNamespaceCreateService
초대
InviteRegistration
Registrations::InviteWelcomeController
Users::InviteSignupService
구독
SubscriptionRegistration
Registrations::SubscriptionWelcomeController
Onboarding::SubscriptionNamespaceCreateService, 이후 Onboarding::FinishService
구독, GitLab Self-Managed
SubscriptionSmRegistration
없음. 이 유형에서는 Onboarding::StatusCreateService를 건너뜁니다.
없음
AutomaticTrialRegistration은 무료에서 체험판으로의 전환을 다룹니다. 사용자는
free로 등록하지만, 현재 registration_type은 trial이 되고
initial_registration_type은 분석을 위해 free로 유지됩니다. 이
전환은 "for my company"를 선택한 무료 사용자가 FreeAutomaticTrialConstraint에 의해
Registrations::TrialWelcomeController로 라우팅될 때 발생합니다.
그러면 Onboarding::TrialNamespaceCreateService가 registration_type을
trial로 설정하며, 이 때문에 Onboarding::UserStatus는 전략을 단순한 TrialRegistration이 아니라
AutomaticTrialRegistration으로 결정합니다.
신원 확인(GitLab.com 전용)#
신원 확인은 GET /users/identity_verification에서 실행되며
RegistrationsIdentityVerificationController#show가 처리합니다.
/-/users/identity_verification 경로는 이미 로그인한 사용자를 다시 확인하는 데 사용되는,
관련 없는 다른 컨트롤러가 처리합니다. 등록 문제를 추적할 때 두 가지를
혼동하지 않도록 주의합니다.
필요한 확인 방법은 위험 점수에 따라 달라집니다.
위험 수준
필요한 방법
낮음
이메일
중간
이메일, 휴대폰
높음
이메일, 휴대폰, 신용카드
높음으로 간주
이메일, 신용카드, 휴대폰
각 방법은 고유한 서비스가 뒷받침합니다.
- 이메일:
verify_email_code 작업이
Users::EmailVerification::ValidateTokenService를 호출합니다.
- 휴대폰:
send_phone_verification_code와
verify_phone_verification_code 작업이
PhoneVerification::Users::SendVerificationCodeService와
PhoneVerification::Users::VerifyCodeService를 호출합니다. 둘 다
PhoneVerification::TelesignClient::*에 위임하며, 이는 Telesign
벤더 API와 통신합니다.
- 신용카드:
verify_credit_card(GET)와
verify_credit_card_captcha(POST) 작업에는 전용 서비스가 하나만 있지 않습니다.
확인은 credit_card_validation과
Users::AutoBanService에 의존합니다. Zuora 호스팅 결제 양식은
프론트엔드에 포함되어 있으며 Gitlab::SubscriptionPortal::Client#payment_form_params와
#validate_payment_method를 사용해 CustomersDot를 통해 중개됩니다. Users::UpsertCreditCardValidationService가
zuora_payment_method_xid와 관련 Stripe 필드를 포함한
결과를 저장합니다.
Users::BaseIdentityVerificationController는 이 경로에서 악용 방지 점검으로
Arkose::TokenVerificationService를 통해 Arkose 챌린지도 적용합니다.
확인에 성공하면 success 작업이 다음을 수행합니다.
- 대기 중인 초대를 수락합니다.
- 사용자를 로그인시킵니다.
Onboarding::TriggerAccountCreatedIterableService를 호출합니다.
- 리디렉션을 결정합니다(완료 경로 참고).
Onboarding::StatusConvertToInviteService는 대기 중인 초대 단계의 일부로만 실행되며,
초대가 실제로 있을 때만 실행됩니다.
환영 컨트롤러와 서비스#
자격 증명이 제출되고, 필요한 경우 신원이 확인되면
환영 컨트롤러가 계정 설정을 마무리합니다. 다음은 현재의
컨트롤러와 서비스이며, 이 흐름의 이전 반복에서는
Users::SignupService와 Users::SubscriptionSignupService를 사용했으나, 둘 다
이를 지원하던 기능 플래그가 정리되면서 제거되었습니다.
Registrations::WelcomeController#update는
Onboarding::FreeNamespaceCreateService를 호출합니다.
Registrations::TrialWelcomeController#update는
Onboarding::TrialNamespaceCreateService를 호출하며, 이 서비스는
GitlabSubscriptions::CreateLeadService를 통해 영업 리드를 만듭니다. 이 컨트롤러는
TrialUserConstraint와 FreeAutomaticTrialConstraint 모두에서
/users/sign_up/welcome으로 제공됩니다.
Registrations::InviteWelcomeController#update는
Users::InviteSignupService를 호출합니다.
Registrations::SubscriptionWelcomeController#update는
Onboarding::SubscriptionNamespaceCreateService를 호출한 다음
Onboarding::FinishService를 호출하고,
users_sign_up_customers_portal_redirect_path로 리디렉션합니다.
Registrations::GroupsController(create와 import)는
Onboarding::FinishService를 호출합니다.
Registrations::CustomersPortalRedirectController#show는 구독 및 체험판 사용자를 위한
마지막 단계입니다. auto_submit_sso=true와 함께 CustomersDot로 리디렉션합니다.
완료 경로#
온보딩이 끝난 뒤 사용자가 도착하는 위치는 등록
유형에 따라 달라집니다.
등록 유형
목적지
무료
new_project_path
체험판
new_project_path
구독
stored_location_for(:user), CustomersDot 리디렉션을 통해 구독 결제 페이지로 확인됩니다
초대
초대받은 프로젝트 또는 그룹, polymorphic_path(last_invited_member_source)를 통해 이동
위에 해당하지 않음
/dashboard/projects
외부 시스템#
등록과 온보딩은 GitLab.com 메인 Rails 애플리케이션 외부의
여러 시스템에 의존합니다.
시스템
용도
CustomersDot
Gitlab::SubscriptionPortal::Client를 통한 리드와 구독
Arkose
신원 확인 중 악용 방지 챌린지
Telesign
전화번호 확인
CustomersDot를 통한 Zuora
저장된 Stripe 필드를 포함한 신용카드 확인
이메일 또는 SMTP
확인 안내와 인증 코드
Redis
세션 상태와 stored_location_for 리디렉션
PostgreSQL
user_details.onboarding_status JSONB 열
추적#
등록과 온보딩은 기여도 및 전환 분석을 위한 데이터를 수집합니다.
glm_source와 glm_content 쿼리 매개변수는 계정 상태가 생성될 때
onboarding_status에 저장됩니다.
- 등록 및 신원 확인 단계는 Snowplow와 내부 제품 분석 이벤트를
내보냅니다.
- 전환 분석은
initial_registration_type과
현재 registration_type을 구분하며, 등록 유형 전략에서
설명한 무료에서 체험판으로의 전환이 이렇게 측정됩니다.