Exportar (0) Imprimir
Expandir Tudo

Operação de logon direcionada pelo serviço

Atualizado: julho de 2013

Exige que o Serviços Móveis do Windows Azure inicie a autenticação usando um provedor de identidade específico. O token retornado é usado para fazer solicitações autenticadas subsequentes para o serviço móvel. Ao usar o logon orientado para serviço, o Serviços Móveis inicia um fluxo de OAuth que permite que seu cliente faça logon no Serviços Móveis usando o provedor de identidade solicitado. Se você já tiver obtido um token de um provedor de identidade, poderá usar o Operação de logon direcionada pelo cliente.

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

GET

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

Solicita um logon usando o Facebook como o provedor de identidade.

google

Solicita um logon usando o Google como o provedor de identidade.

microsoftaccount

Solicita um logon usando o Live Connect como o provedor de identidade.

twitter

Solicita um logon usando o Twitter como o provedor de identidade.

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.

Essa solicitação inicia um fluxo de OAuth iniciado pelo Serviços Móveis.

Parâmetros URI

Nenhum na solicitação inicial.

Cabeçalhos de solicitação

Nenhum cabeçalho de solicitação específico do Serviços Móveis é necessário. A solicitação também pode incluir cabeçalhos padrão HTTP adicionais.

Corpo da solicitação

Nenhum.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta. A resposta exata depende do estado no fluxo do OAuth.

Código de status

Uma operação retorna essencialmente um dos seguintes códigos de status:

 

Código de status Descrição

200 (OK)

O logon foi concluído com êxito. Quando um logon tiver sido concluído com sucesso, você será retornado para uma URL que contém o token de autenticação como um token da web JSON (JWT), com o seguinte formato:

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

401 (não autorizado)

Este código de status é retornado quando uma falha de autenticação corre. Isso pode ocorrer quando o provedor de identidade não tiver sido registrado com o Serviços Móveis. Para obter mais informações, consulte Configurar identidade. Verifique a mensagem de erro no corpo da resposta para obter detalhes.

noteObservação
Durante o processo de OAuth, o estado de OAuth pode ser determinado do valor de <oauth_state> na URL, que tem o seguinte formato:

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

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

Location

A URL do provedor de identidade para a qual a solicitação de logon foi redirecionada. Essa página é exibida para permitir que os usuários entrem usando o provedor específico.

Set-Cookie

O atributo wams_state contém o valor de estado que é usado em solicitações subsequentes para identificar a sessão de OAuth.

x-zumo-version

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

Corpo da resposta

(Opcional) Quando o processo de OAuth for concluído, um objeto JSON poderá ser retornado que contém campos para o status da resposta (code) e a mensagem de resposta (error), da seguinte maneira:

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

.

Mostrar:
© 2014 Microsoft