Interagir avec le SharePoint Version 1.0 Z
2 Interagir avec le SharePoint 15/04/09 Sommaire 1 Introduction... 3 2 La personnalisation mineure d interface... 3 2.1 Site Settings > Look and Feel... 3 2.2 Custom Actions (liens personnalisables)... 3 2.3 Modèle de mise en page (page layout)... 5 2.4 Les autres développements... 5 3 Utilisateurs... 5 3.1 Création d utilisateurs... 5 3.1.1 Création d utilisateur sous Windows server 2008... 6 3.1.2 Active Directory... 6 3.2 Permissions... 7 4 Les Authentifications... 8 4.1 L authentification par formulaire... 8 4.1.1 Qu est-ce que l authentification par formulaire... 8 4.1.2 Forms authentication : la mise en place... 8 4.2 Windows Authentication... 13 4.2.1 Qu est-ce que l authentification Windows... 13 4.2.2 La mise en place... 13 4.3 Web single sign-on... 13 4.3.1 Qu est-ce que l authentification unique... 13 4.3.2 La mise en place... 13 5 Conclusion... 14
3 Interagir avec le SharePoint 15/04/09 1 Introduction Dans ce chapitre nous aborderons la personnalisation de l ensemble de notre SharePoint de façon très sommaire, il y aura des parties d administration que nous aborderons très rapidement. L interface et l authentification seront les deux grandes parties de cette partie de notre cursus SharePoint développement. 2 La personnalisation mineure d interface 2.1 Site Settings > Look and Feel L interface graphique est la première chose que nous voyons et que nos utilisateurs verront, donc il faut qu elle soit ergonomique, rapide et intelligente. La modification d interface de façon purement graphique ce fait au niveau de l onglet Site Settings situé dans notre Site Actions. Une fois sur cette page vous pourrez voir le menu Look and Feel, comme son nom l indique, il va nous permettre de modifier notre interface. Pour la suite, nous ne détaillerons pas comment faire ces modifications, car cela rentre d un point de vue administration. 2.2 Custom Actions (liens personnalisables) Les Custom Actions sont des liens personnalisables situés dans notre SharePoint. Ils sont généralement peu connus du développement, mais peuvent nous apporter beaucoup d avantages. Nous pouvons améliorer l ergonomie de notre espace de travail tant au niveau administration qu utilisateur. Nous procéderons au déploiement d un Custom Action situé dans l onglet Site Actions. Nous détaillerons pas à pas la méthode d intégration de celui-ci. Nous allons créer une feature qui consistera à ajouter un lien qui nous rédigera vers le site dotnet-france. Les fichiers XML suivant doivent être créés dans un nouveau dossier dans l arborescence suivante : C:\Program Files \Common Files \microsoft shared \Web Server Extensions \12 \TEMPLATE \FEATURES \dotnet-france ( nom de dossier de votre choix ).
4 Interagir avec le SharePoint 15/04/09 Création de notre fichier feature.xml : <?xml version="1.0" encoding="utf-8"?> <Feature xmlns="http://schemas.microsoft.com/sharepoint/" Id="DBEC953E-B5E8-4a57-AB7B-F2112BFEF3F4" Title="Dotnet-France" Description="Lien vers Dotnet-France" Scope="Site" Hidden="false" ImageUrl="images.jpg"> <ElementManifests> <ElementManifest Location="elements.xml"/> </ElementManifests> </Feature> Création de notre fichier éléments.xml : <?xml version="1.0" encoding="utf-8"?> <Elements xmlns="http://schemas.microsoft.com/sharepoint/"> <CustomAction Id="SiteSettings" GroupId="SiteActions" Location="Microsoft.SharePoint.StandardMenu" Sequence="1000" Title="Liens vers Dotnet-France" Description="Lien vers Dotnet-France"> <UrlAction Url="http://www.dotnet-France.com"/> </CustomAction> </Elements> La balise CustomAction de notre fichier XML nous permet de définir notre nouvelle action. L attribut Location vous permet de définir l endroit de l ajout de votre CustomAction. Après la création de nos fichiers XML, nous devons maintenant déployer notre solution. Pour cela nous allons utiliser deux commandes prompt : stsadm -o installfeature -filename dotnet-france\feature.xml stsadm -o activatefeature -filename dotnet-france\elements.xml url (url de votre collection de site) Pour cela vous devez dans un premier temps vous placez dans le répertoire suivant : C:\Program Files\Common Files\microsoft shared\web Server Extensions\12\BIN Une fois notre solution déployée nous obtenons donc ceci :
5 Interagir avec le SharePoint 15/04/09 Il est possible d utiliser également WSPbuilder pour le déploiement de notre solution. Dans le cas que nous avons décris ici, nous ajoutions un item dans l emplacement Site Actions. Pour l ajout de nouveaux CustomAction sur d autre emplacement sur notre SharePoint, vous pouvez vous rendre sur le site suivant : http://msdn.microsoft.com/fr-fr/library/bb802730.aspx 2.3 Modèle de mise en page (page layout) Un modèle de mise en page est un template utilisé conjointement avec une MasterPage pour contrôler l'aspect et le contenu d'une page. L édition de ce type de template ce fait à l aide de SharePoint designer, cela va nous permettre de modifier une page de type aspx, avec une possibilité de réorganisations. Toutes nos pages aspx se trouvent dans le dossier suivant : C:\Program Files\Common Files\microsoft shared\ Web Server Extensions\ 12\TEMPLATE\ LAYOUTS 2.4 Les autres développements Il existe bien d autre développement, nous les verrons dans les chapitres suivant de façon détaillée. Il concernera la Master Page, les webparts, Silverlight etc 3 Utilisateurs 3.1 Création d utilisateurs Dans un premier temps il faut savoir qu il y a plusieurs méthodes pour la création d utilisateurs pour l accès à un SharePoint. La première concerne l ajout au niveau de Windows, ensuite nous pouvons créer un active directory, et enfin par un site ASP.NET accompagné de l authentification par formulaire.
6 Interagir avec le SharePoint 15/04/09 3.1.1 Création d utilisateur sous Windows server 2008 Pour ajouter un utilisateur à notre SharePoint nous devons lui créer un compte sur notre serveur. Ce n est qu après cette étape que nous pourrons faire appel a eux dans notre SharePoint. Allez dans : Control Panel > System > Advanced System Settings Ensuite il faut aller dans l onglet Advanced, ouvrir les settings d user profiles, ouvrir la fenêtre pour créer de nouveaux utilisateurs, et pour finir un clique-doit sur le dossier Users. La procédure pour créer un groupe est exactement la même. 3.1.2 Active Directory L objectif principal d un Active Directory est la centralisation de l identification et de l authentification auprès d un réseau s exécutant sous Windows. Donc si vous éprouvez le besoin de passer par un Active Directory, vous pourrez le faire, et la liaison avec notre SharePoint est automatique.
7 Interagir avec le SharePoint 15/04/09 3.2 Permissions Dorénavant nous pouvons ajouter tous nos nouveaux utilisateurs à notre SharePoint. C est à partir de maintenant que nous allons donc voir comment gérer très rapidement les permissions de chacun d eux. Ajout des utilisateurs sur notre SharePoint : Site Settings > Permissions > Add Users Pour la gestion des permissions, vous devez retourner dans la partie Site Settings et aller dans la partie Advanced Permissions. Nous ne détaillerons pas la gestion détaillée des permissions, ce sujet est l objet d autres chapitres concernant l administration SharePoint.
8 Interagir avec le SharePoint 15/04/09 4 Les Authentifications 4.1 L authentification par formulaire 4.1.1 Qu est-ce que l authentification par formulaire L authentification par formulaire nous offre un moyen d'authentifier des utilisateurs à l'aide de notre propre code puis de les garder en mémoire dans un cookie. Un des ajouts de la version 2007 de SharePoint est de supporter l'authentification par formulaire. Ainsi on peut très facilement mettre en place un site SharePoint dont les comptes sont stockés dans une base de données SQL Server. 4.1.2 Forms authentication : la mise en place Dans un premier temps nous allons créer notre nouvelle base de données stockant nos utilisateurs :
9 Interagir avec le SharePoint 15/04/09 Maintenant il faut autoriser l authentification par formulaire au niveau de notre base de données : Ensuite nous devons initialiser celle-ci ; pour se faire nous ouvrons aspnet_regsql.exe qui se trouve dans l arborescence suivante : C:\Windows\Microsoft.NET\Framework\v2.0.50727
10 Interagir avec le SharePoint 15/04/09 Pour ajouter les premiers utilisateurs, en particulier le compte Administrateur, créez une nouvelle application Web dans Visual Studio 2008 : Ajouter un nouvel item de type web configuration file :
11 Interagir avec le SharePoint 15/04/09 Ensuite nous devons modifier notre fichier web.config : <?xml version="1.0" encoding="utf-8"?> <configuration xmlns="http://schemas.microsoft.com/.netconfiguration/v2.0"> <connectionstrings> <remove name="localsqlserver"/> <add name="localsqlserver" connectionstring="server=server- LABODOTN;database=Form_Database;Trusted_Connection=true"></add> </connectionstrings> <system.web> <rolemanager enabled="true"/> <authentication mode="forms"/> <compilation debug="true"/> </system.web> </configuration> Ouvrir ensuite ASP.NET configuration pour ajouter nos utilisateurs, en particulier notre administrateur :
12 Interagir avec le SharePoint 15/04/09 Pour intégrer cette solution d authentification par formulaire, nous allons changer nos web.config (celui de notre collection de site ainsi que celui principal) : <connectionstrings> <remove name="localsqlserver" /> <add name="localsqlserver" connectionstring="server=server- LABODOTN;database=Form_Database;Trusted_Connection=true" /> </connectionstrings> Ensuite la partie suivant dans la balise <system.web> : <membership defaultprovider="aspnetsqlmembershipprovider"> <providers> <remove name="aspnetsqlmembershipprovider" /> <add name="aspnetsqlmembershipprovider" type="system.web.security.sqlmembershipprovider, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" description="stores and retrieves membership data from the Microsoft SQL Server database" connectionstringname="localsqlserver" passwordattemptwindow="10" enablepasswordretrieval="false" enablepasswordreset="true" requiresquestionandanswer="true" applicationname="/" requiresuniqueemail="true" passwordformat="hashed" /> </providers> </membership> Une fois cette opération effectuée, allons dans l administration central de notre SharePoint : Application Management > Authentication Providers. Cliquez sur Windows qui est sur default, puis sélectionnez Form, et remplissez le champ Membership provider name par : aspnetsqlmembershipprovider.
13 Interagir avec le SharePoint 15/04/09 Nous voilà arrivé à la dernière étapes de mise en place de notre Authentification par Formulaire. Allez dans Application Management et ensuite dans Site collection administrators, et une fois ici, entrez votre administrateur : Dorénavant votre authentification sera de type formulaire, pour retourner à l ancienne authentification, il suffit de procéder a la méthode inverse. 4.2 Windows Authentication 4.2.1 Qu est-ce que l authentification Windows SharePoint utilise nativement l'authentification Windows NT. On peut donc directement utiliser la sécurité comme on la connait dans le monde Windows. 4.2.2 La mise en place Comme dit précédemment, l authentification Windows est l authentification par défaut, donc il n y a rien a touché a par au niveau de l administration de notre SharePoint. 4.3 Web single sign-on 4.3.1 Qu est-ce que l authentification unique L'authentification unique (Sign-On ou SSO) est une méthode permettant à un utilisateur de ne procéder qu'à une seule authentification pour accéder à plusieurs applications. 4.3.2 La mise en place Comme l authentification Windows, la mise en place d une authentification unique se fait au niveau de l administration Windows server, server IIS et de notre SharePoint, donc cette partie ne sera pas détaillée dans ce chapitre.
14 Interagir avec le SharePoint 15/04/09 5 Conclusion Nous voilà arriver à la fin de cette partie, qui était en quelque sorte, une suite à l introduction SharePoint développement. Nous avons pu voir qu il est très facile de changer l interface graphique de son SharePoint sans trop faire de développement dans un premier temps, avec l aide de thème ( CKS ) et template existant sur internet.