向 Xamarin.iOS 应用添加身份验证

本主题演示如何从客户端应用程序对应用服务移动应用的用户进行身份验证。 在本教程中,使用应用服务支持的标识提供者向 Xamarin.iOS 快速入门项目添加身份验证。 移动应用成功进行身份验证和授权后,将显示用户 ID 值,该用户能够访问受限制的表数据。

必须先完成教程 创建 Xamarin.iOS 应用。 如果不使用下载的快速入门服务器项目,必须将身份验证扩展包添加到项目。 有关服务器扩展包的详细信息,请参阅使用适用于 Azure 移动应用的 .NET 后端服务器 SDK

注册应用以进行身份验证并配置应用服务

首先,需要在标识提供者网站上注册应用,然后在移动应用后端设置提供者生成的凭据。

  1. 请按照以下提供者特定的说明来配置首选标识提供者:

  2. 为要在应用中支持的各提供者重复上述步骤。

将应用添加到允许的外部重定向 URL

安全身份验证要求为应用定义新的 URL 方案。 此方案允许在完成身份验证过程后,身份验证系统重定向到应用。 在本教程中,我们自始至终使用 URL 方案 appname 。 但是,可以使用任何你所选的 URL 方案。 对于移动应用程序而言,它应是唯一的。 在服务器端启用重定向:

  1. Azure 门户中,选择应用服务。

  2. 单击“身份验证/授权”菜单选项。

  3. 在“允许的外部重定向 URL”中,输入 url_scheme_of_your_app://easyauth.callback。 此字符串中的 url_scheme_of_your_app 是移动应用程序的 URL 方案。 它应该遵循协议的正常 URL 规范(仅使用字母和数字,并以字母开头)。 应记下此字符串,因为在一些地方需要使用此 URL 方案调整移动应用代码。

  4. 单击 “确定”

  5. 单击“保存” 。

将权限限制给已经过身份验证的用户

默认情况下,可匿名调用移动应用后端中的 API。 接下来,需限制为仅可访问已验证的客户端。

  • Node.js 后端(通过 Azure 门户)

    在移动应用设置中,单击“简易表”并选择相应的表。 单击“更改权限”,为所有权限选择“仅限已验证的访问”,然后单击“保存”。

  • .NET 后端 (C#):

    在服务器项目中,导航到“控制器” > “TodoItemController.cs”。 将 [Authorize] 属性添加到“TodoItemController”类,如下所示。 若要限制为仅可访问特定方法,还可只向这些方法应用此属性(而非类)。 重新发布服务器项目。

    [Authorize]
    public class TodoItemController : TableController<TodoItem>
    
  • Node.js 后端(通过 Node.js 代码)

    若要访问表时需验证身份,请向 Node.js 服务器脚本添加以下行:

    table.access = 'authenticated';
    

    有关更多详细信息,请参阅如何:要求在访问表时进行身份验证。 若要了解如何从网站下载快速入门代码项目,请参阅如何:使用 Git 下载 Node.js 后端快速入门代码项目

  4. 在 Visual Studio 或 Xamarin Studio 中,运行设备或模拟器中的客户端项目。 验证在应用启动后是否引发状态代码为 401(“未授权”)的未处理异常。 失败将记录到调试器的控制台中。 因此,在 Visual Studio 中,应在输出窗口中看到失败。

  发生此未授权失败的原因是应用尝试以未经身份验证的用户身份访问移动应用后端。 TodoItem 表现在要求身份验证。

接下来,更新客户端应用,以使用经过身份验证的用户从移动应用后端请求资源。

向应用程序添加身份验证

本部分介绍如何修改应用程序,以便在显示数据之前显示登录屏幕。 应用启动时,它不会连接到应用服务,并且不会显示任何数据。 用户首次执行刷新笔势后,显示登录屏幕;成功登录后,显示 Todo 项列表。

  1. 在客户端项目中,打开文件 QSTodoService.cs,向 QSTodoService 类添加以下 using 语句和带访问器的 MobileServiceUser

    using UIKit;
    
    // Logged in user
    private MobileServiceUser user;
    public MobileServiceUser User { get { return user; } }
    
  2. 使用以下定义向 QSTodoService 添加名为 Authenticate 的新方法:

    public async Task Authenticate(UIViewController view)
    {
        try
        {
                AppDelegate.ResumeWithURL = url => url.Scheme == "zumoe2etestapp" && client.ResumeWithURL(url);
                user = await client.LoginAsync(view, MobileServiceAuthenticationProvider.MicrosoftAccout, "{url_scheme_of_your_app}");
        }
        catch (Exception ex)
        {
            Console.Error.WriteLine (@"ERROR - AUTHENTICATION FAILED {0}", ex.Message);
        }
    }
    

    Note

    如果使用的标识提供者不是 MicrosoftAccount,请将传递给上述 LoginAsync 的值更改为以下值:WindowsAzureActiveDirectory

  3. 打开 QSTodoListViewController.cs。修改 ViewDidLoad 的方法定义,删除接近结尾处对 RefreshAsync() 的调用:

    public override async void ViewDidLoad ()
    {
        base.ViewDidLoad ();
    
        todoService = QSTodoService.DefaultService;
       await todoService.InitializeStoreAsync ();
    
       RefreshControl.ValueChanged += async (sender, e) => {
            await RefreshAsync ();
       }
    
        // Comment out the call to RefreshAsync
        // await RefreshAsync ();
    }
    
  4. 修改方法 RefreshAsync,以便在 User 属性为 null 时进行身份验证。将以下代码添加到方法定义顶部:

    // start of RefreshAsync method
    if (todoService.User == null) {
        await QSTodoService.DefaultService.Authenticate (this);
        if (todoService.User == null) {
            Console.WriteLine ("couldn't login!!");
            return;
        }
    }
    // rest of RefreshAsync method
    
  5. 打开 AppDelegate.cs,添加以下方法:

     public static Func<NSUrl, bool> ResumeWithURL;
    
     public override bool OpenUrl(UIApplication app, NSUrl url, NSDictionary options)
     {
         return ResumeWithURL != null && ResumeWithURL(url);
     }
    
  6. 打开 Info.plist 文件,导航到“高级”节中的“URL 类型”。 现在,配置 URL 类型的“标识符”和“URL 方案”,然后单击“添加 URL 类型”。 URL 方案应与 {url_scheme_of_your_app} 相同。
  7. 在已连接到 Mac 主机的 Visual Studio 中或在 Visual Studio for Mac 中,针对设备或模拟器运行客户端项目。 验证应用程序是否未显示任何数据。

    通过向下拉动项列表来执行刷新笔势,这会导致显示登录屏幕。 成功输入有效的凭据后,应用会显示待办事项列表,用户可以对数据进行更新。