DEVELOPING APROVIDER HOSTEDSHAREPOINT APPTalbott CrowellBoston Area SharePoint User GroupMarch 13nd, 2013
About Me• http://about.me/talbott• Solutions Architect at ThirdM• A Founder of SharePoint Saturday Boston• Microsoft MVP• Blogger and Author• @talbott
About this Talk• For Developers • Who want to build Apps For SharePoint• For Architects • Who want to understand options and architecture considerations of a Provider Hosted App• For Anyone • Who wants to learn more about SharePoint 2013 and the future of Extending and Customizing SharePoint
What is a Provider Hosted App• SharePoint 2013 Compatible Application• Hosted outside of SharePoint • Azure • Amazon Web Services (AWS) • Rackspace • Your Datacenter • An on-premise server in your customer’s Datacenter (you provide the Application, Hardware, and/or VM)• Written in any language on any platform • Java, F#, Ruby, Linux, Unix
Provider Hosted Apps Office 365 Data Center Application Runtime and Backendor On-Premise SharePoint 2013 Farm (Can be anywhere: On-Premise or Cloud) Provider SharePoint Provider 2013 Hosted Service app Provider Data Customer Provider
Alternative Using Autohosted Office 365 Data Center Application Runtime and Backend (including Azure) (Cloud Service you Host) Office 365 Autohosted app Provider(SharePoint Windows Azure Online) Service Azure Database Customer Data Provider Data Customer Provider
Provider Hosted Architecture• Store or App Catalog – Deployment Manifest .APP file• App Manifest – Declare App Permission Requests• Trust Settings – User must “allow” or “trust” your app• Provider receives Request with Trust Token• Provider uses CSOM to call back to SharePoint using the Trust Token• SharePoint persists changes made by the Provider in the Content Database (just like SharePoint Designer)
Costs of Being a Provider• Need to maintain and cover hosting cost • But you can extend your app to other ecosystems outside of SharePoint • iPad, Facebook, Kindle, Salesforce• Changes will affect ALL customers • May need a versioning strategy for customers in Life Sciences (long validation lifecycle)
Benefits of Provider Hosted• Does not tax the SharePoint Farm’s resources as much as Farm Solution might• Update 1000’s of SharePoint Farms with one release update to the Provider• Centrally managed at the Provider’s location• Develop on any platform using any language leveraging your existing developer and infrastructure knowledge• Same App works on Office 365 and SharePoint 2013 on- premise
Development Model• Get Started using Azure and Office 365 Preview • Many Blog posts on getting started• Deploy your Provider Hosted app to your Provider (Azure, AWS, Rackspace, local server)• Deploy your .APP file to SharePoint
Development System Requirements• Visual Studio 2012 • On Premise Development Environment • http://bit.ly/spappdevenv• Office Developer Tools for Visual Studio 2012 • http://bit.ly/spapptools
Decisions• Office 365 or On-Premise? • If Office 365, Visual Studio 2012 • If On-Premise then build your SharePoint 2013 Dev Server • Windows Server 2012 or Windows Server 2008 R2 SP1 • http://msdn.microsoft.com/en-us/library/fp161179.aspx • http://msdn.microsoft.com/en-us/library/fp179923.aspx• Andrew Connell’s Critical Path Training • SharePoint 2013 Setup Guide for Developers • http://bit.ly/cp2013setup
App Packaging• Start with Visual Studio 2012 Project Template• .APP • Contains AppManifest.xml • Set Permission Requests for your App • Start Page • Client ID • App Icon Image File• You can unpack the .APP by renaming .ZIP
Demo• Using Visual Studio to create the App Manifest• Explore Contents
Security• Client Secret vs Certificate • Client Secret requires SharePoint is farm connected to ACS • Azure ACS (Access Control Service) • Office 365 is already connected to ACS• AppManifest.xml (.APP) • Contains permissions• OAuth • TokenHelper.cs (runs on the Provider) • Helps you manage requests for app tokens • If you are developing in another language you will need to implement this yourself
CSOM Example ClientContext clientContext = TokenHelper.GetClientContextWithAccessToken( sharepointUrl.ToString(), accessToken); //Load the properties for the web object. Web web = clientContext.Web; clientContext.Load(web); clientContext.ExecuteQuery(); //Get the site name. siteName = web.Title; //Get the current user. clientContext.Load(web.CurrentUser); clientContext.ExecuteQuery(); currentUser = clientContext.Web.CurrentUser.LoginName; //Load the lists from the Web object. ListCollection lists = web.Lists; clientContext.Load<ListCollection>(lists); clientContext.ExecuteQuery();
Scope of Access• What can you get to from CSOM?
Putting it all together• Generate Client ID and Client Secret • Generated by form on SharePoint Online • https://<your site>/_layouts/15/appregnew.aspx• APP Manifest and Icon packaged in .APP file • Includes Permission Requests • Includes Client ID • Deployed to SharePoint• Your app is deployed to Azure, etc… • ClientID and ClientSecret• Your app receives Token from SharePoint user request• Your app uses Token to call CSOM
Review• SharePoint has completely new Development Model• Leverage existing understanding with CSOM• Leverage existing other technology knowledge• Update many customers (or Farms) at once• Costs and Benefits of being a Provider• Security with OAuth• Package and Deploy to Store
Resources• My Blog for Slides, Questions, and Follow up information • http://bit.ly/tcrowell• Pluralsight Videos by Andrew Connell • Over 12 hours of Video • http://bit.ly/acplural• Microsoft MSDN Documentation • http://bit.ly/spappmsdn• CloudShare for developer and test hosting • http://www.cloudshare.com/
More Resources• Steve Fox’s Blog • Create a free Azure Web Site to develop Provider Hosted App • http://bit.ly/sfoxpart1 • http://bit.ly/sfoxpart2• Chris Johnsons loosely typed thoughts… • Build a SharePoint Provider Hosted App in 5 mins • http://bit.ly/spapp5min
Thank You Developing a Provider Hosted SharePoint App Presented by Talbott Crowell @talbott Questions?
A particular slide catching your eye?
Clipping is a handy way to collect important slides you want to go back to later.