Headers in Groove Web Services

Applies to: SharePoint Workspace 2010 | Visual Studio 2008

Groove Web Services define two custom SOAP headers that are used in the SOAP messages: the GrooveRequestHeader and the GrooveResponseHeader. The GrooveRequestHeader provides information that Groove Web Services use to ensure that the request comes from an authorized source, and to identify the SharePoint Workspace user that provides the service.

The GrooveResponseHeader is set by SharePoint Workspace and allows the calling application to ensure that it is communicating with the GROOVE.EXE process.

The GrooveRequestHeader provides the GrooveRequestKey and the GrooveIdentityURL. Groove Web Services use the GrooveRequestKey to ensure that the request comes from an authorized source.

The SharePoint Workspace application provides a response key in the GrooveResponseHeader when it returns the response SOAP message to an application making local requests. Your application should check that this key matches the LocalResponseKey in the registry to verify that the response came from SharePoint Workspace.

SharePoint Workspace uses the Groove Web Services IdentityURL in the GrooveRequestHeader to identify the user that provides the data. You should specify the IdentityURL in all Groove Web Services operations except for GrooveAccounts.Read.

See Also

Reference

Headers Used in Groove Web Services

Concepts

Groove Web Services Architecture