安全网络IOS SDK使用说明

安全网络IOS SDK使用说明

更新时间:2017-06-07 13:26:11

IOS SDK接入 

运行环境 

iOS 5.1及以上系统版本 3G、4G或Wi-Fi网络

添加SDK到工程中

在使用SDK前,需要先将SDK添加到应用的工程中,步骤如下

将压缩包解压缩,得到YunCeng.framework 使用XCode打开应用工程,将YunCeng.framework从Finder中拖到应用工程的Project Navigator中 

1、初始化 

在请求动态IP之前,应用需要调用SDK的初始化函数,初始化函数的原型如下: 

/*! @brief 初始化

 int YunCeng_Init(const char *app_key);

* @param app_key

* @return YC_CODE

*/ 

参数app_key是在云盾控制台申请的appKey。app_key如果被泄露,可能会被攻击者用来伪造 应用请求从安全网络的控制中心获得动态IP,对应用的后端服务器发起DDOS攻击。建议将 app_key保存在keychain中。 

2、请求动态IP 

在初始化完成之后,应用可以通过下面的函数向安全网络控制中心请求一个动态IP 

/*! @brief 获取动态IP地址

int YunCeng_GetNextIPByGroupName(const char *group_name, char *ip);

* @param group_name

* @param ip 出参,动态IP地址

* @return YC_CODE

*/ 

返回值见错误码定义,参数group_name是在云盾控制台创建的分组名称。ip是出参,在函数执行成功之后保存动态IP地址。使用范例如下: 

char ip[16];

int ret = YunCeng_GetNextIPByGroupName("group1", ip);