如何使用 OAuth 2.0 将 LinkedIn 集成入 iOS 应用

从很久以前开始，社交网络就成为了我们每天生活的一部分了。同时，社交网络也是我们程序员生活的一部分，绝大多数的应用都对进行了集成，用于接收和发送用户的信息。在大多数情况下，用户都被要求能在应用中绑定每个社交网络，并且授权该应用能代表用户发起 请求 。有很多这样的社交网络，比如 非死book 和 推ter 是使用比较频繁的。另外，iOS 也对 非死book 和 推ter 有内置的支持。但是，对于大多数其他的社交网络来说，开发者必须要配置一下才能成功地使得应用授权每个社交网络，并能代表用户发起请求。本教程中，我们将针对 LinkedIn 这样的一个社交网络演示如何使应用获得授权，并能与服务器传递受保护数据。

有两种方式可以针对 LinkedIn 授权 iOS 应用并根据 API 调用相应操作。第一种是使用 LinkedIn 支持的 OAuth 2.0 协议。第二种可行的方式是使用 LinkedIn 提供的 iOS SDK，这种方式和其他第三方的 SDK 一样，要集成到工程并配置完毕才能使用。

在本教程中，我们只会关注第一种方法，也就是说，我们会使用 LinkedIn 和 OAuth 2.0 指南让用户在应用（不仅仅是 iOS 的应用）中登录，并授权以提供与服务器的数据传递。LinkedIn iOS SDK 也是一个很好的选择，但是我坚持使用 OAuth 是出于以下几点原因：

1. 老实说，我是被以下这种方式的交互给吸引的：在授权成功后，直接与服务器通过 REST API 调用来交互。

2. 关于 Linnked In iOS SDK 的使用，在 LinkedIn 已经有了很详细的教程，我不确定再写一篇相同主题的教程会有什么好处。

3. 在我看来，使用 LinkedIn iOS SDK 时会有一个缺点：必须在设备上安装 LinkedIn 的官方应用，否则不能登录和进行授权。这样在需要获取用户帐户信息，而用户不想仅仅为了登录而安装 LinkedIn 官方应用时，就会产生问题。

关于 OAuth 2.0 协议，没有什么可以多说的，你可以移步到该协议的 官方网站 查看详情。简而言之，为了成功登录并授权，在本教程中我们会使用以下的步骤：

• 我们会在 LinkedIn 开发者网站 创建一个应用。同时，我们会得到 Client ID 和 Client Secret ，这两个值会在后面的步骤中用的到。

• 我们会在 webview 中让用户登录 LinkedIn 账号。

• 通过上一步，添加一些必要数据后，让 LinkedIn 服务器返回一个 授权码 。

• 我们会交换授权码以获得 access token 。

access token 是我们在使用 OAuth 时真正需要的。使用一个有效的 token，我们可以向 LinkedIn 服务器发起授权请求，并通过 get 或 post 请求获取用户的信息。

在我们行动之前，请确保你对 OAuth 2.0 的运行有一个基本的了解，和它的流程是什么。如果可以的话，建议看看其他资源以获得更多帮助（比如 这里 ， 这里 还有 这里 ）。

说完了上面这些，让我们继续本教程的演示应用程序，然后直接过渡到实际的实现。我真的希望接下来我们要做的可以对你有些帮助。

LinkedIn 官方文档有以下这些链接可以作为参考：

• 关于 OAuth 2.0

• 如何用 LinkedIn 登录

演示应用总览

我们将要实现的演示应用是由两个视图控制器构成的。第一个视图控制器（默认的 ViewController 类）里会有三个按钮：

1. 一个叫 LinkedIn Sign In 的按钮，用来初始化登录以及授权过程。

2. 一个叫 Get my profile URL 的按钮，使用 access token 发起授权请求后获得 profile URL。

3. 一个会显示 profile URL 的按钮，当点击它的时候会跳转到 Safari 打开相应的网页。

默认情况下，只有第一个按钮可以被点击。实际上，只要没有获取到 access token，它都是可以被点击的。在任何其他情况下，第一个按钮不能点击的时候，第二个按钮就可以被点击了。第三个按钮是隐藏的，但是当使用第二个按钮获取到 profile URL 的时候，第三个按钮就会显示出来了。

第二个视图控制器会包含一个 webview。我们可以使用 webview 来登录 LinkedIn 的帐号，并完成认证授权成功。这个视图控制器会在获取到授权所需的 access token 后就会消失（dismiss）。

与通常一样，我们不从头开始做项目，可以从 这里 下载一个初始的工程，然后在这个工程上开始。

我们会将注意力主要集中在如何获得 access token 上。我们也会根据 OAuth 2.0 协议和 LinkedIn 指南上的内容一步步操作。一旦我们获取到了 access token，就可以使用它来向 LinkedIn 请求授权了。一旦授权成功，我们就可以在 Safari 里通过我上面谈到的第三个按钮显示用户信息了。

在开始行动之前，确保你下载了之前的初始工程。如果没问题的话，就可以继续下去了。

LinkedIn 开发者网站 - 创建一个应用

在我们的演示应用中，实现 OAuth 2.0 登录的第一步就是在 LinkedIn 开发者网站上创建一个应用。我们需要先访问 这个链接 如果你还未登录 LinkedIn 的话，网站会提示你要先进行登录。

值得注意的是，如果你使用 Safari，并且在以下步骤中遇到任何问题，那就换另一个浏览器试试。我使用的是 Chrome 浏览器。

点击网页的 My Applications 区域，然后你会看到一个叫 Create Application 的黄色按钮，点击它就可以创建我们之后要在 iOS APP 中进行连接的应用。

接下来出现的表单中的每一项都必须填写。不用担心它需要你填写的公司名字或应用 logo，提交一些假数据即可。接着勾选“已阅读使用条款”，点击提交按钮。每一项带有红色星星的都必须填写，否则是不能继续下去的。下图是个例子：

下一个界面就是我们需要的了：

正如你在上面的截图看到的，我们可以在这里找到我们需要的 Client ID 和 Client Secret 。先不要关闭当前页面，我们下一步还要用到。同时，可以看看菜单选项窗口的左侧中其他的各种应用设置。

在这里有一个非常重要的任务(除了简单地访问客户端密钥外)，那就是把 Authorized Redirect URLs 这个表单给填上。当客户端应用尝试刷新已经存在的 access token 时，就需要 Authorized Redirect URL，且用户不需要再像一开始那样在网页浏览器里登录帐号。OAuth 会根据该 URL 自动重定向客户端应用。对于一个正常的登录操作来说，当我们在获取授权码和 access token 时，重定向的 URL 会在应用和服务器之间交换。不管怎样，这个 URL 必须存在并在之后和服务器端进行交换。

重定向的 URL 不需要是真实存在的 URL。它可以是任何以“ https://”开头的值。我在这里设置的值如下，你也可以设置你想要的 URL：

https://com.appcoda.linkedin.oauth/oauth

func startAuthorization() {      // 指定响应类型应该是 "code".      let responseType = "code"         // 设置重定向 URL。增加的百分比 escape characthers 是必要的。      let redirectURL = "https://com.appcoda.linkedin.oauth/oauth".stringByAddingPercentEncodingWithAllowedCharacters(NSCharacterSet.alphanumericCharacterSet())!         // 创建一个基于时间间隔的随机字符串 (它将是这样的 linkedin12345679).      let state = "linkedin\(Int(NSDate().timeIntervalSince1970))"         // 设置首选的范围。      let scope = "r_basicprofile"  }

https://com.appcoda.linkedin.oauth/oauth

https%3A%2F%2Fcom.appcoda.linkedin.oauth%2oauth

func startAuthorization() {      ...         // 创建授权的 URL 字符串.      var authorizationURL = "\(authorizationEndPoint)?"      authorizationURL += "response_type=\(responseType)&"      authorizationURL += "client_id=\(linkedInKey)&"      authorizationURL += "redirect_uri=\(redirectURL)&"      authorizationURL += "state=\(state)&"      authorizationURL += "scope=\(scope)"         print(authorizationURL)  }

func startAuthorization() {      ...         // 创建一个 URL 请求和负载的 web 视图。      let request = NSURLRequest(URL: NSURL(string: authorizationURL)!)      webView.loadRequest(request)  }

override func viewDidLoad() {      ...         startAuthorization()  }

http://com.appcoda.linkedin.oauth/oauth?code=AQSetQ252oOM237XeXvUreC1tgnjR-VC1djehRxEUbyZ-sS11vYe0r0JyRbe9PGois7Xf42g91cnUOE5mAEKU1jpjogEUNynRswyjg2I3JG_pffOClk&state=linkedin1450703646

func webView(webView: UIWebView, shouldStartLoadWithRequest request: NSURLRequest, navigationType: UIWebViewNavigationType) -> Bool {      let url = request.URL!      print(url)         if url.host == "com.appcoda.linkedin.oauth" {          if url.absoluteString.rangeOfString("code") != nil {             }      }         return true  }

func webView(webView: UIWebView, shouldStartLoadWithRequest request: NSURLRequest, navigationType: UIWebViewNavigationType) -> Bool {      let url = request.URL!      print(url)         if url.host == "com.appcoda.linkedin.oauth" {          if url.absoluteString.rangeOfString("code") != nil {              // 提取授权 code。              let urlParts = url.absoluteString.componentsSeparatedByString("?")              let code = urlParts[1].componentsSeparatedByString("=")[1]                 requestForAccessToken(code)          }      }         return true  }

func requestForAccessToken(authorizationCode: String) {      let grantType = "authorization_code"         let redirectURL = "https://com.appcoda.linkedin.oauth/oauth".stringByAddingPercentEncodingWithAllowedCharacters(NSCharacterSet.alphanumericCharacterSet())!  }

func requestForAccessToken(authorizationCode: String) {      ...         // 设置 POST 参数。      var postParams = "grant_type=\(grantType)&"      postParams += "code=\(authorizationCode)&"      postParams += "redirect_uri=\(redirectURL)&"      postParams += "client_id=\(linkedInKey)&"      postParams += "client_secret=\(linkedInSecret)"  }

func requestForAccessToken(authorizationCode: String) {      ...         // 转换 POST 参数 为一个 NSData 对象.      let postData = postParams.dataUsingEncoding(NSUTF8StringEncoding)  }

func requestForAccessToken(authorizationCode: String) {      ...             // 使用 access token endpoint URL string 初始化一个可变的 URL 请求对象      let request = NSMutableURLRequest(URL: NSURL(string: accessTokenEndPoint)!)  }

func requestForAccessToken(authorizationCode: String) {      ...         // 标明我们将要发起的请求类型为 POST 请求      request.HTTPMethod = "POST"         // 将之前创建的 postData 对象设置给 HTTP body       request.HTTPBody = postData  }

func requestForAccessToken(authorizationCode: String) {      ...         // 为请求添加 HTTP header      request.addValue("application/x-www-form-urlencoded;", forHTTPHeaderField: "Content-Type")  }

func requestForAccessToken(authorizationCode: String) {      ...         // 初始化 NSURLSession 对象      let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())         // 发起请求      let task: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) -> Void in         }         task.resume()  }

func requestForAccessToken(authorizationCode: String) {          ...         // 发起请求      let task: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) -> Void in          // 获取请求的 HTTP 状态码          let statusCode = (response as! NSHTTPURLResponse).statusCode             if statusCode == 200 {              // 将 JSON 数据转换成字典              do {                  let dataDictionary = try NSJSONSerialization.JSONObjectWithData(data!, options: NSJSONReadingOptions.MutableContainers)                     let accessToken = dataDictionary["access_token"] as! String              }              catch {                  print("Could not convert JSON data into a dictionary.")              }          }      }         task.resume()  }

func requestForAccessToken(authorizationCode: String) {          ...         // 发起请求      let task: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) -> Void in          // 获取请求的 HTTP 状态码          let statusCode = (response as! NSHTTPURLResponse).statusCode             if statusCode == 200 {              // 将 JSON 数据转换成字典              do {                  ...                     NSUserDefaults.standardUserDefaults().setObject(accessToken, forKey: "LIAccessToken")                  NSUserDefaults.standardUserDefaults().synchronize()                     dispatch_async(dispatch_get_main_queue(), { () -> Void in                      self.dismissViewControllerAnimated(true, completion: nil)                  })                              }              catch {                  print("Could not convert JSON data into a dictionary.")              }          }      }         task.resume()  }

func checkForExistingAccessToken() {      if NSUserDefaults.standardUserDefaults().objectForKey("LIAccessToken") != nil {          btnSignIn.enabled = false          btnGetProfileInfo.enabled = true      }  }

override func viewWillAppear(animated: Bool) {      super.viewWillAppear(animated)         checkForExistingAccessToken()  }

@IBAction func getProfileInfo(sender: AnyObject) {      if let accessToken = NSUserDefaults.standardUserDefaults().objectForKey("LIAccessToken") {          // 为 targetURLString 赋值用户信息对应的 URL 字符串          let targetURLString = "https://api.linkedin.com/v1/people/~:(public-profile-url)?format=json"      }  }

@IBAction func getProfileInfo(sender: AnyObject) {      if let accessToken = NSUserDefaults.standardUserDefaults().objectForKey("LIAccessToken") {          ...             // 初始化一个可变的 URL 请求对象          let request = NSMutableURLRequest(URL: NSURL(string: targetURLString)!)             // 标明我们将要发起的请求类型为 GET 请求           request.HTTPMethod = "GET"             // 为 HTTP header 添加 access token          request.addValue("Bearer \(accessToken)", forHTTPHeaderField: "Authorization")              }  }

@IBAction func getProfileInfo(sender: AnyObject) {      if let accessToken = NSUserDefaults.standardUserDefaults().objectForKey("LIAccessToken") {          ...             // 初始化 NSURLSession 对象          let session = NSURLSession(configuration: NSURLSessionConfiguration.defaultSessionConfiguration())             // 发起请求          let task: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) -> Void in             }             task.resume()      }  }

@IBAction func getProfileInfo(sender: AnyObject) {      if let accessToken = NSUserDefaults.standardUserDefaults().objectForKey("LIAccessToken") {          ...             // 发起请求          let task: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) -> Void in              // 获取请求的 HTTP 状态码              let statusCode = (response as! NSHTTPURLResponse).statusCode                 if statusCode == 200 {                  // 将 JSON 数据转换成字典                  do {                      let dataDictionary = try NSJSONSerialization.JSONObjectWithData(data!, options: NSJSONReadingOptions.MutableContainers)                         let profileURLString = dataDictionary["publicProfileUrl"] as! String                  }                  catch {                      print("Could not convert JSON data into a dictionary.")                  }              }          }             task.resume()      }  }

@IBAction func getProfileInfo(sender: AnyObject) {      if let accessToken = NSUserDefaults.standardUserDefaults().objectForKey("LIAccessToken") {          ...             // 发起请求          let task: NSURLSessionDataTask = session.dataTaskWithRequest(request) { (data, response, error) -> Void in              // 获取请求的 HTTP 状态码              let statusCode = (response as! NSHTTPURLResponse).statusCode                 if statusCode == 200 {                  // 将 JSON 数据转换成字典                  do {                      ...                         dispatch_async(dispatch_get_main_queue(), { () -> Void in                          self.btnOpenProfile.setTitle(profileURLString, forState: UIControlState.Normal)                          self.btnOpenProfile.hidden = false                         })                  }                  catch {                      print("Could not convert JSON data into a dictionary.")                  }              }          }             task.resume()      }  }

@IBAction func openProfileInSafari(sender: AnyObject) {      let profileURL = NSURL(string: btnOpenProfile.titleForState(UIControlState.Normal)!)      UIApplication.sharedApplication().openURL(profileURL!)  }