Compartilhar via

ISocialSession::LogonWeb

  • Artigo

Faz logon no site da rede social usando autenticação baseada em formulários.

HRESULT _stdcall LogonWeb([in] BSTR connectIn, [out] BSTR* connectOut);

Parâmetros

Connectin

[in] Uma cadeia de caracteres que é nula, uma URL para um formulário de logon na Web ou uma cadeia de caracteres que contém credenciais de logon, dependendo do contexto no processo de logon quando esse método é chamado.

connectOut

[out] Uma cadeia de caracteres que contém credenciais de logon.

Comentários

O OSC (Outlook Social Connector) chamará o método LogonWeb somente se o provedor indicar que ele dá suporte à autenticação baseada em formulários. O provedor indica que ele requer autenticação baseada em formulários definindo useLogonWebAuth como true no XML para recursos. Se o provedor definir useLogonWebAuth como false, o OSC usa autenticação básica e chama o método ISocialSession::Logon.

Fazer logon em um site de rede social usando autenticação baseada em formulários envolve chamar os métodos LogonWeb e ISocialSession::GetLogonUrl em uma ordem específica:

  1. O OSC chama LogonWeb pela primeira vez, passando nulo para o parâmetro connectIn .

  2. O provedor gera o erro OSC_E_AUTH_ERROR para o OSC.

  3. O OSC chama GetLogonUrl.

  4. O provedor retorna a URL apropriada para uma página de logon no método GetLogonUrl .

  5. O OSC usa a URL retornada pelo GetLogonUrl para exibir a página de logon baseada em formulários.

  6. O OSC então chama LogonWeb uma segunda vez, passando a URL para o formulário de logon no parâmetro connectIn .

  7. Se a autenticação for bem-sucedida, o provedor retornará credenciais de logon no parâmetro connectOut para o OSC. Se a autenticação falhar, o provedor aumentará o erro de OSC_E_AUTH_ERROR para o OSC.

Se o provedor OSC dá suporte ao logon usando credenciais armazenadas em cache, ele especifica usarLogonCached como true nos recursos XML. O provedor deve colocar todas as credenciais de logon na cadeia de caracteres connectOut que o provedor deseja que o OSC armazene entre conexões. O OSC não interpreta a cadeia de caracteres connectOut . Depois que o OSC verificar se o uso deLogonCached é verdadeiro, o OSC criptografa a cadeia de caracteres para segurança antes de armazená-la no registro do Windows. O OSC passa essa cadeia de caracteres para o parâmetro connectIn em tentativas subsequentes de fazer logon na rede social chamando ISocialSession2::LogonCached.

Confira informações sobre os códigos de erro em Códigos de Erro do Provedor do Conector Social do Outlook.

Confira também