IBM Bluemix Mobile Services - 客户端 SDK Swift 安全 - Facebook

这是 IBM Bluemix Mobile Services 的 Swift SDK 的 Facebook 安全组件。

要求

• iOS 8.0 或更高版本
• Xcode 7 或更高版本（XCode 8 支持 Swift 3）

安装

Bluemix Mobile Services Facebook 身份验证 Swift SDK 通过 Cocoapods 提供。要安装，请将 BMSFacebookAuthentication Pod 添加到您的 Podfile。

iOS

use_frameworks!

target 'MyApp' do
    platform :ios, '8.0'
    pod 'BMSFacebookAuthentication'
end

更新您的 Podfile 后，Pod 的源代码将被添加到您的工作区。将 FacebookAuthenticationManager.swift 文件从 BMSFacebookAuthentication Pod 源文件夹复制到您的应用文件夹。然后找到 info.plist 文件（通常位于您的项目的 支持文件 文件夹中）并将以下数据添加到 info.plist 的源代码中。将 <YOUR_FACEBOOK_APP_ID> 和 <YOUR_FACEBOOK_APP_NAME> 替换为您应用的 Facebook 数据值

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>fb<YOUR_FACEBOOK_APP_ID></string>
        </array>
    </dict>
</array>
<key>FacebookAppID</key>
<string><YOUR_FACEBOOK_APP_ID></string>
<key>FacebookDisplayName</key>
<string><YOUR_FACEBOOK_APP_NAME> </string>
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>fbauth</string>
    <string>fbauth2</string>
</array>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        <key>facebook.com</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>                
            <key>NSThirdPartyExceptionRequiresForwardSecrecy</key>
            <false/>
        </dict>
        <key>fbcdn.net</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSThirdPartyExceptionRequiresForwardSecrecy</key>
            <false/>
        </dict>
        <key>akamaihd.net</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSThirdPartyExceptionRequiresForwardSecrecy</key>
            <false/>
        </dict>
    </dict>
</dict>

注意：不要覆盖 info.plist 文件中的任何现有属性。如果您有重叠的属性，请手动使用此段合并您的文件。

启用密钥链共享

当使用 Xcode 8.x 时，为了使用 BMSFacebookAuthentication，您需要在您的应用中启用密钥链共享。您可以在目标的功能选项卡中启用此功能。

入门指南

要使用 Bluemix Mobile Services Facebook 身份验证 Swift SDK，向您想要在其中使用 Facebook 身份验证的类添加以下导入

import BMSCore
import BMSSecurity

您的移动应用程序与Bluemix服务的连接和交互取决于与Bluemix应用程序关联的应用ID和路由。

BMSClient和MCAAuthorizationManager API是与SDK交互的入口点。在调用其他API之前，您必须调用以下API。

MCAAuthorizationManager.sharedInstance.initialize(tenantId: tenantId, bluemixRegion: regionName)

此方法通常在您的移动应用程序的代理中调用。

您还需要将MCAAuthorizationManager定义为您的授权管理器。

BMSClient.sharedInstance.authorizationManager = MCAAuthorizationManager.sharedInstance

然后为Facebook的领域注册代理。

FacebookAuthenticationManager.sharedInstance.register()

然后添加以下代码到您的应用程序代理中。

func application(_ app: UIApplication,
                open url: URL,
                options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool{
      return FacebookAuthenticationManager.sharedInstance.onOpenURL(app, open: url, options: options)
}

要注销当前登录用户，您可以使用以下代码。

FacebookAuthenticationManager.logout(<callBack>)

要切换用户，必须调用此代码，并且用户必须从他们的浏览器中注销Facebook。

示例应用程序

您可以使用'pod try BMSFacebookAuthentication'获取示例应用程序。有关如何运行示例应用程序的详细信息，可以在应用程序文件夹中的README文件中找到。

版权所有 2016 IBM公司。

根据Apache许可证第2版（“许可证”）；除非遵守许可证，否则不得使用此文件。您可以从以下地址获取许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件是基于“原样”基础分发的，不提供任何明示或暗示的保证或条件。有关许可证的具体语言规定许可权和限制，请参阅许可证。