This document provides the details of the application programming interface (API) for the ManagedSharePoint2007 namespace included with the Microsoft® Provisioning System (MPS) in Contained herein are descriptions of the procedures of this namespace along with method input parameters and return values. In addition, example XML requests are provided along with a typical Extensible Markup Language (XML) response that the provisioning system returns after a request is submitted to MPS and tasks are completed.

Developers should use this API document as a reference when creating XML requests that initiate the provisioning of Microsoft Office SharePoint 2007 services or as a basis for review of the SharePoint 2007 named procedures that are implemented in the Web Service.

The ManagedSharePoint2007 namespace provides a set of multifunction peripherals (MPF) named procedures for provisioning Windows Sharepoint sites for customers in both shared scenarios. This namespace enhances the low level Windows SharePoint Services provider by integrating several aspects of a hosted Windows SharePoint Services site provisioning including:

• Windows SharePoint Services Site Collection for Hosted Customer
• Active Directory

The ManagedSharePoint2007 namespace is designed to provide business logic regarding the creation of Windows SharePoint Services sites and accounts. This namespace, however, does not implement any plans or resource management logic as these will be provided by a higher-level namespace. This allows for scenarios where built in plans and resource management are not desired by the customer.

Many of the procedures in this namespace accept as a parameter a target URL. This URL is passed to the SharePoint Provider to dictate which remote SharePoint Front-End server the provider will submit provisioning requests to, in order to perform the corresponding provisioning action. Since the MPS Engine will submit authenticated HTTP requests to the server specified by the target URL, it is important that you ensure that only valid Windows SharePoint Front-End servers are targeted for provisioning actions.

Suggestions for ensuring validity of servers in target URL:

• User Interfaces or automation engines that use the Hosted or Managed Sharepoint namespaces should build a valid target URL from a protected list of known good servers.
• The target parameter should not be based on any direct end-user input.
• Firewall rules should be configured such that the MPF Engine servers can only establish HTTP(S) connections to valid WSS FE servers.
• User Interfaces or automation engines should perform basic URL encoding on the URL before setting the value of target.

Besides target, validation should be performed for parameters like URL, GUID, size, and email . For more information about input data validation, see Input Validation and Protection against Injection Attacks.

The ManagedSharePoint2007 namespace installs as a MPF Namespace in MPS Provisioning Manager. It may require the additional execution of a procedure to set up permissions, credentials, or perform additional initialization configuration.

Applies To

Hosted Messaging and Collaboration version 4.5 Hosted Messaging and Collaboration version 4.0 Windows-based Hosting version 4.5