Экспорт (0) Печать
Развернуть все

Операция входа, управляемая службой

Обновлено: Июль 2013 г.

Запрашивает у Мобильные службы Microsoft Azure проверку подлинности с использованием определенного поставщика удостоверений. Возвращенный токен используется для выполнения последующих запросов проверки подлинности к мобильной службе. При использовании имени входа под управлением службы Мобильные услуги инициирует поток OAuth, позволяющий клиенту войти в Мобильные услуги, используя запрошенный поставщик удостоверений. Если токен уже получен от поставщика удостоверений, воспользуйтесь Операция входа, управляемая клиентом.

Запрос можно указать следующим образом. Замените <service_name> на имя мобильной службы, а <provider> на имя поставщика удостоверений.

 

HTTP-команда URI запроса Версия HTTP

GET

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Примечание
Сначала нужно настроить поставщик удостоверений, используемый для проверки подлинности в мобильной службе. Дополнительные сведения см. в Настройка удостоверения.

Этот запрос запускает поток OAuth, инициируемый Мобильные услуги.

В начальном запросе — нет.

Не требуются какие-либо заголовки запроса, характерные для Мобильные услуги. Запрос может также включать дополнительные стандартные заголовки HTTP.

Отсутствует.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа. Точный ответ зависит от состояния в потоке OAuth.

Операция возвращает один следующих кодов состояния:

 

Код состояния Описание

200 (OK)

Вход выполнен успешно. Если вход завершен успешно, выполняется переход по URL-адресу, содержащему токен проверки подлинности как веб-токен JSON (JWT) в следующем формате:

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

401 (не санкционировано)

Этот код состояния возвращается при ошибке проверки подлинности. Это может произойти, если поставщик удостоверений еще не зарегистрирован в Мобильные услуги. Дополнительные сведения см. в Настройка удостоверения. Дополнительные сведения см. в сообщении ошибки в тексте ответа.

noteПримечание
Во время процесса OAuth состояние OAuth можно определить по значению <oauth_state> в URL-адресе, которое использует следующий формат:

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>"
}

.

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft