Forms-Based Authentication

Office 2013 and later

The Outlook Social Connector (OSC) calls the ISocialProvider::GetCapabilities method to determine the capabilities of the OSC provider for a social network. The OSC uses the returned capabilities to determine how to support an Office user who is logging on to this social network. If the useLogonWebAuth element in the returned capabilities XML indicates that the OSC provider supports forms-based authentication, the OSC can make the following calling sequence to allow a user to log on to that social network:

  1. ISocialProvider::Load —The OSC loads the provider.

  2. ISocialProvider::Version —The OSC gets a string that represents the version number of the provider for this social network.

  3. ISocialProvider::SocialNetworkName —The OSC gets a string that represents the social network name.

  4. ISocialProvider::SocialNetworkGuid —The OSC gets an immutable GUID that represents the social network.

  5. ISocialProvider::GetCapabilities —The OSC gets a string that represents the provider’s capabilities and that complies with the schema definition for the capabilities element.

  6. ISocialProvider::SocialNetworkIcon —The OSC gets a byte array that represents the icon for the social network site.

  7. ISocialProvider::GetSession —The OSC gets an ISocialSession interface.

  8. ISocialSession::LogonWeb —The OSC initializes logging on to the social network site by forms-based authentication. For this initial logon call, the OSC passes null for the connectIn parameter.

  9. ISocialSession::GetLogonUrl —The OSC gets the URL to display a browser-based form to the user during web authentication.

  10. ISocialSession::LogonWeb —The OSC completes the logon to the social network site by using forms-based authentication. The OSC calls this method a second time, passing the URL of the logon form to the provider in the connectIn parameter.

  11. ISocialSession::GetLoggedOnUser —The OSC gets an ISocialProfile interface that represents the logged-on user.

  12. ISocialSession::GetNetworkIdentifier —The OSC gets a string that represents a unique identifier for a social network site. The network identifier can be equivalent to the network name.