Compartir a través de

ISocialSession::LogonWeb

  • Artículo

Inicie sesión en el sitio de red social mediante la autenticación basada en formularios.

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

Parameters

connectIn

[in] Cadena que es null, una dirección URL a un formulario de inicio de sesión en la web o una cadena que contiene credenciales de inicio de sesión, en función del contexto del proceso de inicio de sesión cuando se llama a este método.

connectOut

[out] Cadena que contiene credenciales de inicio de sesión.

Comentarios

Outlook Social Connector (OSC) llama al método LogonWeb solo si el proveedor indica que admite la autenticación basada en formularios. El proveedor indica que requiere autenticación basada en formularios estableciendo useLogonWebAuth como true en el XML para las funcionalidades. Si el proveedor establece useLogonWebAuth como false, el OSC usa la autenticación básica y llama al método ISocialSession::Logon .

Iniciar sesión en un sitio de red social mediante la autenticación basada en formularios implica llamar a los métodos LogonWeb e ISocialSession::GetLogonUrl en un orden específico:

  1. El OSC llama a LogonWeb la primera vez, pasando null al parámetro connectIn .

  2. El proveedor genera el error de OSC_E_AUTH_ERROR al OSC.

  3. A continuación, el OSC llama a GetLogonUrl.

  4. El proveedor devuelve la dirección URL adecuada a una página de inicio de sesión en el método GetLogonUrl .

  5. El OSC usa la dirección URL devuelta por GetLogonUrl para mostrar la página de inicio de sesión basada en formularios.

  6. A continuación, el OSC llama a LogonWeb por segunda vez, pasando la dirección URL al formulario de inicio de sesión en el parámetro connectIn .

  7. Si la autenticación se realiza correctamente, el proveedor devuelve las credenciales de inicio de sesión del parámetro connectOut al OSC. Si se produce un error en la autenticación, el proveedor genera el error de OSC_E_AUTH_ERROR al OSC.

Si el proveedor de OSC admite el inicio de sesión con credenciales almacenadas en caché, especifica useLogonCached como true en el XML de funcionalidades . El proveedor debe colocar las credenciales de inicio de sesión en la cadena connectOut que el proveedor desea que el OSC almacene entre conexiones. El OSC no interpreta la cadena connectOut . Una vez que el OSC comprueba que useLogonCached es true, el OSC cifra la cadena de seguridad antes de almacenarla en el Registro de Windows. El OSC pasa esta cadena al parámetro connectIn en los intentos posteriores de iniciar sesión en la red social llamando a ISocialSession2::LogonCached.

Para obtener información sobre códigos de error, vea Códigos de error del proveedor Outlook Social Connector.

Vea también