【ソーシャルログイン】Experience Cloud に Google アカウントでログインさせる完全ガイド：Apex とカスタムメタデータ型による「実務級」の実装【決定版】

/**
 * @description Googleソーシャルログイン用の登録ハンドラ (完全版・VIP対応)
 * 外部ユーザー（Community）の自動作成と紐付けを行います。
 * 設定値（プロファイル名、取引先名）はすべてカスタムメタデータ型から取得します。
 */
global class AutocreatedRegHandler1764930569603 implements Auth.RegistrationHandler {

    /**
     * @description ユーザー作成を許可するかどうかの判定
     */
    global boolean canCreateUser(Auth.UserData data) {
        return true; 
    }

    /**
     * @description 新規ユーザー作成ロジック
     * Google未連携の既存のユーザーがログインした場合、Google連携済みに更新します。
     * Contactあり / Userなし: Google から受け取った情報で User を作成してログインさせます。
     * Contactなし / Userなし: Google から受け取った情報で Contact も User も新規作成します。
     */
    global User createUser(Id portalId, Auth.UserData data) {
        if (!canCreateUser(data)) {
            return null;
        }

        // Google未連携の既存のユーザーがいれば、それを返して「紐付け」完了とする
        List<User> existingUsers = [
            SELECT Id, Email, ContactId 
            FROM User 
            WHERE Username = :data.email + '.' + UserInfo.getOrganizationId() // ユーザー名生成ルールに合わせる
            OR Email = :data.email
            LIMIT 1
        ];

        if (!existingUsers.isEmpty()) {
            System.debug('既存ユーザーが見つかりました。紐付けを行います。');
            return existingUsers[0]; // これを返すだけでリンクが作成されます
        }

        // 1. CMDTから設定値を読み込む
        Social_Login_Config__mdt config = Social_Login_Config__mdt.getInstance('GoogleAuthSettings');
        
        // デフォルト設定の取得
        String accountName = (config != null) ? config.DefaultAccountName__c : 'Google Auth Users';
        String defaultProfileName = (config != null) ? config.ExternalProfileName__c : 'Customer Community User';
        
        // ★VIP用プロファイル名もCMDTから取得
        String vipProfileName = (config != null && config.VipProfileName__c != null) ? config.VipProfileName__c : 'My Site VIP User';

        // コミュニティ経由のログインかどうか判定
        if (data.attributeMap.containsKey('sfdc_networkid')) {
            
            // 2. 既存の取引先責任者 (Contact) をメールアドレスで検索
            // これにより「既存顧客の紐付け」と「ランク判定」を同時に行います
            List<Contact> existingContacts = [
                SELECT Id, AccountId, Is_VIP__c // 判定に使いたい項目
                FROM Contact 
                WHERE Email = :data.email 
                LIMIT 1
            ];

            Contact c;
            String targetProfileName;

            if (!existingContacts.isEmpty()) {
                // A. 既存Contactが見つかった場合
                c = existingContacts[0];
                
                // ★Contactの属性を見てプロファイルを出し分ける
                if (c.Is_VIP__c == true) {
                    targetProfileName = vipProfileName;
                } else {
                    targetProfileName = defaultProfileName;
                }
                
                // ※本来はここでAccountIDの整合性チェックなどを行うとより安全です

            } else {
                // B. 見つからない場合（完全新規） -> デフォルトプロファイルを使用
                targetProfileName = defaultProfileName;
                
                // 取引先の取得・作成
                Account a;
                try {
                    a = [SELECT Id FROM Account WHERE Name = :accountName LIMIT 1]; 
                } catch (Exception e) {
                    a = new Account(Name = accountName);
                    insert a;
                }

                // 新規Contact作成
                c = new Contact();
                c.AccountId = a.Id;
                c.Email = data.email;
                c.FirstName = data.firstName;
                c.LastName = data.lastName;
                insert c;
            }

            // 3. 決定したプロファイル名で User を作成
            // バインド変数 :targetProfileName で検索
            Profile p = [SELECT Id FROM Profile WHERE Name = :targetProfileName LIMIT 1];
            
            User u = new User();
            u.Username = data.email + '.' + UserInfo.getOrganizationId();
            u.Email = data.email;
            u.LastName = data.lastName;
            u.FirstName = data.firstName;
            
            String alias = (data.firstName != null && data.firstName != '') ? data.firstName : 'guest';
            if (alias.length() > 8) { alias = alias.substring(0, 8); }
            u.Alias = alias;
            
            // 日本語環境に合わせて明示的に指定します
            u.LanguageLocaleKey = 'ja'; 
            u.LocaleSidKey = 'ja_JP';
            u.EmailEncodingKey = 'UTF-8';
            u.TimeZoneSidKey = 'Asia/Tokyo';
            
            u.ProfileId = p.Id;
            u.ContactId = c.Id; // 既存または新規のContactID
            
            return u;

        } else {
            return null;
        }
    }

    /**
     * @description 既存ユーザーの更新ロジック
     * Google連携済みのユーザーがログインするたびに、Googleの最新情報でSalesforceのレコードを更新します。
     */
    global void updateUser(Id userId, Id portalId, Auth.UserData data) {

        // ------------------------------------
        // 1. Userと紐付くContact情報を取得
        // ------------------------------------
        User u = [
            SELECT Id, LastName, FirstName, Email, ContactId, Contact.LastName, Contact.FirstName 
            FROM User 
            WHERE Id = :userId 
            LIMIT 1
        ];
    
        // 変更フラグ
        boolean userChanged = false;
        boolean contactChanged = false;
        
        // ------------------------------------
        // 2. User レコードの更新
        // ------------------------------------
        if (data.lastName != u.LastName) {
            u.LastName = data.lastName;
            userChanged = true;
        }
        if (data.firstName != u.FirstName) {
            u.FirstName = data.firstName;
            userChanged = true;
        }
        // ※メールアドレスも変更可能ですが、通常はユーザーがSalesforce側で変更しない限り同期しない方が安全です。
        // if (data.email != u.Email) {
        //     u.Email = data.email;
        //     userChanged = true;
        // }
    
        // ------------------------------------
        // 3. Contact レコードの更新
        // ------------------------------------
        if (u.ContactId != null) {
            Contact c = new Contact(Id = u.ContactId);
            
            // GoogleデータとContactデータを比較
            if (data.lastName != u.Contact.LastName) {
                c.LastName = data.lastName;
                contactChanged = true;
            }
            if (data.firstName != u.Contact.FirstName) {
                c.FirstName = data.firstName;
                contactChanged = true;
            }
            
            // Contactの更新実行
            if (contactChanged) {
                update c;
            }
        }

        // ------------------------------------
        // 4. User レコードの更新
        // 最終ログイン日時などの情報は自動で更新されるため、明示的に変更があったフィールドのみ更新を実行
        // ------------------------------------
        if (userChanged) {
            update u;
        }
    }
}