如何初始化SDK并且让基本的用户名密码认证成功

• 通过阅读此文档，您可以完成用户密码登录认证，并成功启动VPN SDK
• 此文档默认已经集成SDK并且工程可以编译通过运行
• 您完全可以参考demo（特别是 AuthViewController.m）进行代码编写，但此文档仍然列出了必要的步骤
• 此文档只是参考，您应该根据具体需求因地适宜
• 此文档会略过如头文件import等基本概念与步骤，只介绍重要的概念

在集成SDK过程中，通常您都是和 SangforAuthManager这个单例打交道，您可以通过[SangforAuthManager getInstance]获取到单例，接下来让我们看看如何进行一个用户名密码认证，其实非常简单：

～初始化SDK

SDK中有很多如认证成功失败、图形校验码等事件，都是通过SangforAuthDelegate来回掉的，所以第一步就是需要实现SangforAuthDelegate 回掉

//一个测试用类
//SangforSDKTestViewController.m
//                                              声明要实现这个协议
@interface SangforSDKTestViewController () 
@end

@implementation SangforSDKTestViewController
//..............

//⚠️具体实现，这几个回调是SDK认证逻辑的基本，必须要实现
#pragma mark - SangforAuthDelegate
/**
 认证失败
 @param error 错误原因
 */
- (void)onLoginFailed:(NSError *)error {
    //例如用户密码错误了，这里您可以根据需求进行提示
    //具体类型可以参考 "errheader.h"
}

/**
 认证过程回调
 @param nextAuthType 下个认证类型
 @prarm BaseMessage  下个认证的信息
 */
- (void)onLoginProcess:(VPNAuthType)nextAuthType message:(BaseMessage *)msg {
    //如 VPNAuthTypeSms = VPNAuthTypeSms 的 短信认证 （这个与VPN服务端配置相关）
    //此时您应该通过某UI界面获取到短信验证码，然后调用对应组合认证函数进行下一次认证
}

/**
 认证成功
 */
- (void)onLoginSuccess {
    //VPN认证成功了，您可以进行下一步操作了，例如进行界面跳转等
}

/**
 图形校验码回调

 @param data 图片信息
 */
- (void)onRndCodeCallback:(NSData *)data {
    //data是img数据，您应该将起显示出来，以配合
    //onLoginProcess 中 VPNAuthType = VPNAuthTypeRand 的图形验证码认证
    //您可以参考demo的处理
    //(PS:图形验证码会在多次输入错误的密码后，防止爆破攻击时出现在 onLoginProcess 认证过程回掉中 )
}

//⚠️在执行任何对SDK的操作前...
- (void)viewDidLoad {
    [super viewDidLoad];
    [self.PWLoginBtn addTarget:self action:@selector(onPWLoginBtnPressed) forControlEvents:UIControlEventTouchUpInside];
    //⚠️初始化 SangforAuthManager 的 delegate，否则无法接收到认证回调
    [SangforAuthManager getInstance].delegate = self;
}

@end

～进行用户名密码认证

接下来，就可以进行用户名密码认证了，需要注意的是：

• 以 start...开头，如startPasswordAuthLogin，是主认证接口，用于主动触发 以do… 开头， 如doPasswordAuth:，是组合认证接口，在-(void)onLoginProcess:中调用

切勿错误使用

-(void) onPWLoginBtnPressed
{
    //这里根据您的模式选择 VPNModeL3VPN/VPNModeEasyApp
    VPNMode vpnMode    = VPNModeL3VPN;
    //这里当然您应该从UI控件获取到用户输入的VPN地址，或者固定写成贵司的VPN地址
    NSURL* vpnUrl      = [NSURL URLWithString:@"https://emm.saftest.com.cn"];
    //这里当然您应该从UI控件获取到用户输入的用户名密码
    NSString* username = @"sangfotest";
    NSString* password = @"testpw";

    //调用主认证接口进行认证
    //⚠️此处是调用主认证API
    //是   startPasswordAuthLogin
    //不是 doPasswordAuth
    //doPasswordAuth是用于组合认证的接口
    [[SangforAuthManager getInstance] startPasswordAuthLogin:vpnMode
                                                  vpnAddress:vpnUrl
                                                    username:username
                                                    password:password];
    //调用后，就会有回调通知认证结果！（所以记得先实现protocol回调并设置给 SangforAuthManager）
}

然后就会触发回调函数：

• -(void)onLoginSuccess VPN登录成功了！
• -(void)onLoginProcess: 您还需要下一次认证
• -(void)onLoginFailed: 认证错误，您应该给予用户一些提示，具体类型可以参考 errheader.h

～下一步

自此，用户密码认证就已经完成了！

如果您还进一步的需要了解 组合认证，强烈建议您⚠️⚠️用demo登录贵司的VPN，查看demo代码是如何处理：

• 如何处理-(void)onLoginProcess:回调来进行组合认证的
• 如何处理图形验证码回调
• 如何出处理密码修改请求或主动进行密码修改
• 如何使用其他的一些常见API