Exportar (0) Imprimir
Expandir Tudo

Operação de logon direcionada pelo cliente

Atualizado: julho de 2013

Exige um token de autenticação do Serviços Móveis do Windows Azure usando um token de identidade já obtido de um provedor de identidade. O token retornado é usado para fazer solicitações autenticadas subsequentes para o serviço móvel. O token apresentado para o Serviços Móveis para autenticação deve ser obtido pelo cliente independentemente do Serviços Móveis, geralmente usando o SDK do provedor, como o SDK do Facebook SDK para iOS. Use autenticação iniciada pelo cliente quando seu aplicativo obtiver um token de identidade para habilitar logon único ou obter informações adicionais do usuário usando o SDK do provedor. Se seu aplicativo não precisar interagir diretamente com o provedor de identidade, você poderá usar o Operação de logon direcionada pelo serviço.

A solicitação pode ser especificada da seguinte maneira. Substitua <service_name> pelo nome do seu serviço móvel e <provider> pelo provedor de identidade.

 

Verbo HTTP URI de solicitação Versão de HTTP

POST

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

HTTP/1.1

O provedor de identidade usado para autenticação pode ser um dos seguintes:

 

Valor do provedor Descrição

facebook

Logon apresentando um token obtido do Facebook.

google

Logon apresentando um token obtido do Google.

microsoftaccount

Logon apresentando um token obtido do Live Connect.

noteObservação
Você primeiro deve configurar o provedor de identidade usado para autenticação com seu serviço móvel. Para obter mais informações, consulte Configurar identidade.

Parâmetros URI

Nenhum.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Obrigatório  

Accept

Não

Defina este cabeçalho como application/json.

Content-Length

Sim

O comprimento do corpo da solicitação.

Content-Type

Não

Defina este cabeçalho como application/json.

Corpo da solicitação

O corpo da solicitação contém um único objeto, expresso em JSON (JavaScript Object Notation). O objeto contém um único campo, que depende do provedor de identidade:

 

Provedor Objeto JSON

Conta da Microsoft

{
    "authenticationToken" : "<authentication_token_value>"
}

Facebook

- ou -

Google

{
    "access_token" : "<access_token_value>"
}

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

Content-Length

O comprimento do corpo da resposta.

Content-Type

Cabeçalho definido como application/json.

x-zumo-version

Indica qual versão do tempo de execução executou a solicitação.

Corpo da resposta

O corpo da solicitação contém um único objeto JSON com duas propriedades. A tabela a seguir descreve as propriedades do objeto JSON no corpo da resposta.

 

Nome da propriedade Descrição

user

O objeto JSON que contém o valor userId atribuído pelo Serviços Móveis para o usuário autenticado.

authenticationToken

Um token da web JSON (JWT), que é o token de autenticação retornado pelo Serviços Móveis com base na autenticação positiva. Esse token é fornecido em solicitações autenticadas subsequentes para o serviço móvel e pode ser armazenado em cache até expirar.

A resposta a uma solicitação para usar um token da conta da Microsoft contém a seguinte carga JSON:

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

Mostrar:
© 2014 Microsoft