Postado originalmente em 10/04/2012 no Blog do desenvolvedor Valence por Craig Dunk.
Quando os desenvolvedores começam a usar o Valence, um dos primeiros desafios é entender como o sistema de autenticação funciona. Isso é particularmente verdadeiro para desenvolvedores com experiência anterior no uso de chamadas SOAP D2LWS. De um alto nível, o sistema IDKey Auth em Valence é semelhante a um sistema de estilo OAuth de três pernas (e semelhante às contas do Google ou Facebook Connect)
Abaixo está um passo a passo mais detalhado dessa descrição de alto nível que conecta as chamadas da biblioteca Valence com a documentação do Valence (chamadas de autenticação e api) e mostra o que o usuário vê durante cada uma das etapas. Ele mostra um diagrama de módulo com uma área para a exibição do navegador e, em seguida, mostra uma sequência de conexões e operações. Ele é dividido em seções para que cada diagrama mostre a ação do usuário que inicia a sequência.
Nota: A sequência abaixo é uma maneira de encadear as chamadas, mas há várias maneiras pelas quais essa sequência pode ser variada: Primeiro, a sequência real e o uso de botões e operações POST podem ser ajustados para se adequar a uma experiência de usuário de aplicativo diferente. Em segundo lugar, as etapas até onde o UserID e o UserKey são armazenados (item 15 abaixo) podem ser usadas durante uma "etapa de instalação" no cenário em que o aplicativo usará uma conta de utilitário comum para todas as operações do pacote de aprendizado. (Veja o Pergunta de estouro de pilha na autenticação da conta de utilitário para obter mais informações). Nesse cenário de conta de utilitário, a interface do usuário seria ajustada para algo como "clique para instalar a conta de utilitário" e seria executada por um administrador.
Ao trabalhar em sequências de aplicativos como a abaixo, encorajo você a começar com um dos Exemplos de introdução.
Página inicial do aplicativo básico
Sequência de início de autenticação
Sequência final de autenticação
Fazendo uma chamada de API
Resumo
O uso das bibliotecas e das amostras deve tirar a maioria das partes complicadas do caminho, mas você precisa entender essa sequência para saber como lidar com o processo de login de valência.
