导出 (0) 打印
全部展开

服务主导的登录操作

更新时间: 2013年7月

请求 Microsoft Azure 移动服务使用特定标识提供程序启动身份验证。返回的令牌将用于对移动服务进行后续经过身份验证的请求。使用服务主导的登录时,移动服务会启动一个 OAuth 流程,使客户端能够通过使用请求的标识提供程序登录 移动服务。如果您已从身份提供程序获取了令牌,则可以改用客户端主导的登录操作

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

 

HTTP 谓词 请求 URI HTTP 版本

GET

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

HTTP/1.1

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

 

提供程序值 说明

facebook

使用 Facebook 作为标识提供程序申请一个登录名。

google

使用 Google 作为标识提供程序申请一个登录名。

microsoftaccount

使用 Live Connect 作为标识提供程序申请一个登录名。

twitter

使用 Twitter 作为标识提供程序申请一个登录名。

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

此请求会启动由 移动服务发起的 OAuth 流程。

在初始请求中没有。

不需要 移动服务特定的请求标头。请求还可包括其他标准 HTTP 标头。

无。

响应包括 HTTP 状态代码、一组响应标头和响应正文。具体响应取决于 OAuth 流程的状态。

操作最终返回以下某个状态代码:

 

状态代码 说明

200(正常)

登录已成功完成。当登录成功完成时,您会返回到一个 URL,其中包含 JSON Web 令牌 (JWT) 这样的身份验证令牌,网址格式如下:

https://<service_name>.azure-mobile.net/login/done#token=<jwt_token>

401(未授权)

当身份验证失败时会返回此状态代码。如果未向 移动服务注册标识提供程序,则可能会发生这种情况。有关更多信息,请参见配置标识。请检查响应正文中的错误消息了解详情。

note备注
在 OAuth 过程运行期间,OAuth 状态可从 URL 中的 <oauth_state> 值来判断,网址格式下如:

https://<service_name>.azure-mobile.net/login/<provider>#state=<oauth_state>

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

 

响应标头 说明

Location

将登录请求重定向到的标识提供程序的 URL。显示此页面是为了让用户可使用特定提供程序进行登录。

Set-Cookie

wams_state 特性包含状态值,该状态值用于在后续请求中标识 OAuth 会话。

x-zumo-version

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

(可选)当 OAuth 过程完成时,可能会返回一个 JSON 对象,它包含响应状态 (code) 和响应消息 (error) 的字段,如下如示:

{
    "code" : <http_code>,
    "error" : "<message>"
}

.

Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft