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

Операция входа, управляемая клиентом

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

Запрашивает токен проверки подлинности у Мобильные службы Microsoft Azure, используя токен, уже полученный от поставщика удостоверений. Возвращенный токен используется для выполнения последующих запросов проверки подлинности к мобильной службе. Токен, представленный Мобильные услуги для проверки подлинности, должен быть получен клиентом независимо от Мобильные услуги, обычно используя пакеты SDK поставщиков, например Facebook SDK для 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.

Текст запроса содержит один объект в формате JSON. Объект содержит одно поле, которое зависит от поставщика удостоверений:

 

Поставщик Объект JSON

Учетная запись Майкрософт

{
    "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 (JWT), являющийся токеном проверки подлинности, возвращенным Мобильные услуги после положительной проверки подлинности. Этот токен предоставляется при выполнении последующих запросов проверки подлинности к мобильной службе и может кэшироваться до истечения срока его действия.

Ответ на запрос использования токена учетной записи Майкрософт содержит следующие полезные данные JSON:

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

Показ:
© 2015 Microsoft