导出 (0) 打印
全部展开

客户端主导的登录操作

更新时间: 2013年7月

通过使用已从标识提供程序获得的标识令牌从 Microsoft Azure 移动服务 请求身份验证令牌。返回的令牌将用于对移动服务进行后续经过身份验证的请求。出示给 移动服务用于身份验证的令牌必须由独立于 移动服务的客户端获取,通常是使用提供程序 SDK,如 Facebook SDK for iOS。当应用程序获取标识令牌来支持单一登录或使用提供程序 SDK 获取额外用户信息时,请使用客户端启动的身份验证。如果你的应用程序不需要与标识提供程序直接交互,则可以改用服务主导的登录操作

可按如下方式指定请求。将 <service_name> 替换为移动服务名称,将 <provider> 替换为标识提供程序。

 

HTTP 谓词 请求 URI HTTP 版本

POST

https://<service_name>.azure-mobile.net/login/<provider>

HTTP/1.1

用于身份验证的标识提供程序可以为以下提供程序中的一种:

 

提供程序值 说明 JavaScript 后端支持 .Net 后端支持

facebook

通过出示从 Facebook 获得的令牌登录。

google

通过出示从 Google 获得的令牌登录。

microsoftaccount

通过出示从 Live Connect 获得的令牌登录。

twitter

通过提供从 Twitter 获得的令牌登录。

windowsazureactivedirectory

通过提供从 Azure Active Directory 获得的令牌登录。

note备注
你必须首先配置要用于移动服务身份验证的标识提供程序。有关详细信息,请参阅配置标识

无。

下表介绍请求标头。

 

请求标头 必需  

Accept

将此标头设置为 application/json

Content-Length

请求正文的长度。

Content-Type

将此标头设置为 application/json

请求正文包含一个对象,以 JavaScript 对象表示法 (JSON) 表示。对象只包含一个字段,具体取决于标识提供程序:

 

提供程序 JSON 对象

Microsoft 帐户

{
    "authenticationToken" : "<authentication_token_value>"
}

Facebook

Google

Azure Active Directory

{
    "access_token" : "<access_token_value>"
}

响应包括 HTTP 状态代码、一组响应标头和响应正文。

成功的操作返回状态码 200(正常)

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都符合 HTTP/1.1 协议规范

 

响应标头 说明

Content-Length

响应正文的长度。

Content-Type

标头设置为 application/json

x-zumo-version

指示执行请求的运行时的版本。

请求正文包含一个 JSON 对象,后者具有两个属性。下表介绍响应正文中 JSON 对象的属性。

 

属性名称 说明

user

JSON 对象,它包含由 移动服务分配给经过身份验证的用户的 userId 值。

authenticationToken

JSON Web 令牌 (JWT),这是 移动服务基于成功身份验证返回的身份验证令牌。此令牌在对移动服务的后续经过身份验证的请求中提供,且可以缓存,直到过期为止。

对于使用 Microsoft 帐户令牌的请求,响应包含以下 JSON 负载:

{
    "user": {
        "userId" : "MicrosoftAccount: <user_id>"
    },
    "authenticationToken" : "<jwt_token>" 
}

显示:
© 2015 Microsoft