整合雲通訊 REST API 發送短信驗證碼：隨機密碼生成與 Java SDK 調用示例

業務場景

用戶入職時，系統自動生成符合複雜度要求的隨機初始密碼（8-16 位，含大小寫字母、數字、特殊符號），通過 **雲通訊 (Yuntongxun) REST API** 發送模板短信至用戶手機。

1. 隨機密碼生成器

public class PasswordGenerator {
    private static final String LOWER = "abcdefghijklmnopqrstuvwxyz";
    private static final String UPPER = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
    private static final String DIGITS = "0123456789";
    private static final String SPECIAL = "!@#$%";
    private static final String ALL = LOWER + UPPER + DIGITS + SPECIAL;
    private static final SecureRandom RANDOM = new SecureRandom(); // 密碼學安全隨機數

    /**
     * 生成 8-16 位密碼，強制包含：至少 2 小寫、2 大寫、2 數字、2 特殊符號
     */
    public static String generateSecurePassword(int length) {
        if (length < 8) length = 8;
        if (length > 16) length = 16;
        
        StringBuilder pwd = new StringBuilder(length);
        
        // 1. 強制放入各類字符（保證複雜度）
        appendRandom(pwd, LOWER, 2);
        appendRandom(pwd, UPPER, 2);
        appendRandom(pwd, DIGITS, 2);
        appendRandom(pwd, SPECIAL, 2);
        
        // 2. 剩餘長度從全字符集隨機填充
        int remaining = length - pwd.length();
        for (int i = 0; i < remaining; i++) {
            pwd.append(ALL.charAt(RANDOM.nextInt(ALL.length())));
        }
        
        // 3. 打亂順序（避免固定模式）
        char[] arr = pwd.toString().toCharArray();
        for (int i = arr.length - 1; i > 0; i--) {
            int j = RANDOM.nextInt(i + 1);
            char tmp = arr[i]; arr[i] = arr[j]; arr[j] = tmp;
        }
        return new String(arr);
    }
    
    private static void appendRandom(StringBuilder sb, String pool, int count) {
        for (int i = 0; i < count; i++) {
            sb.append(pool.charAt(RANDOM.nextInt(pool.length())));
        }
    }
}

2. 雲通訊 SDK 整合

Maven 依賴 (官方 SDK)

<dependency>
    <groupId>com.cloopen</groupId>
    <artifactId>rest-sdk</artifactId>
    <version>1.0.0</version> <!-- 請以官方最新為準 -->
</dependency>

發送模板短信代碼

public class SmsSender {
    // 配置常量（請替換為官方控制台獲取的真實值）
    private static final String SERVER_IP = "app.cloopen.com";
    private static final String SERVER_PORT = "8883";
    private static final String ACCOUNT_SID = "your_account_sid";
    private static final String AUTH_TOKEN = "your_auth_token";
    private static final String APP_ID = "your_app_id";
    private static final String TEMPLATE_ID = "1"; // 模板 ID，內容如：【公司】您的初始密碼為 {1}，請妥善保管。

    private final CCPRestSDK sdk = new CCPRestSDK();

    public SmsSender() {
        sdk.init(SERVER_IP, SERVER_PORT);
        sdk.setAccount(ACCOUNT_SID, AUTH_TOKEN);
        sdk.setAppId(APP_ID);
    }

    /**
     * 發送密碼短信
     * @param mobile 手機號（多號碼英文逗號分隔）
     * @param password 初始密碼
     * @return true 發送成功
     */
    public boolean sendPasswordSms(String mobile, String password) {
        HashMap result = sdk.sendTemplateSMS(
            mobile, 
            TEMPLATE_ID, 
            new String[]{password} // 模板變量 {1}
        );
        
        if ("000000".equals(result.get("statusCode"))) {
            // 成功：result.get("data") 包含 sid, date_created 等
            return true;
        } else {
            // 失敗：記錄錯誤碼與信息
            log.error("短信發送失敗: code={}, msg={}", 
                result.get("statusCode"), result.get("statusMsg"));
            return false;
        }
    }
}

3. 業務整合流程

@Service
public class EntryService {
    @Autowired private SmsSender smsSender;
    
    public void processEntry(User user) {
        // 1. 生成密碼
        String rawPassword = PasswordGenerator.generateSecurePassword(12);
        
        // 2. 加密存儲（BCrypt）
        String hashed = BCrypt.hashpw(rawPassword, BCrypt.gensalt(12));
        user.setPasswordHash(hashed);
        userRepository.save(user);
        
        // 3. 發送短信（異步非阻塞）
        CompletableFuture.runAsync(() -> {
            boolean ok = smsSender.sendPasswordSms(user.getMobile(), rawPassword);
            if (!ok) {
                // 重試機制、告警通知
                alertService.notifySmsFailure(user.getId(), user.getMobile());
            }
        });
    }
}

關鍵注意事項

現代化替代方案

• 阿里云短信 / 騰訊云短信 / 華為云短信：國內主流雲廠商，SDK 完善、到達率高、控制台功能豐富。
• Twilio / Vonage / Plivo：國際短信主流服務商。
• 統一通知平台：自建網關屏蔽下游差異，支援短信/郵件/推送/企業微信/鉚釘多渠道、模板管理、發送記錄查詢、限流熔斷。

總結

本文展示了從**安全隨機密碼生成**到**雲通訊 REST API 發送模板短信**的完整鏈路。核心要點：使用 SecureRandom 保證熵源、強制字符類型分布、打亂順序；SDK 初始化復用、異步發送、錯誤碼處理、日誌脫敏。生產系統建議接入雲廠商原生 SDK 或自建統一通知平台，實現多渠道、可觀測、可治理的通知能力。