Installationsanleitung Toolkit42 Suite On-Premises

In dieser Anleitung wird Ihnen gezeigt, wie Sie die Toolkit42 Suite On-Premises installieren.

Systemvoraussetzung: mindestens Microsoft .NET Framework 4.6 oder höher

1. SharePoint für Apps konfigurieren

Ihre SharePoint Farm muss so konfiguriert sein, dass Apps genutzt werden können:
Hier finden Sie die Informationen dazu:
https://technet.microsoft.com/en-us/library/fp161236%28v=office.15%29.aspx
Zusätzlich muss die WebApplication SSL gesichert sein.

2. Konfiguration des App-Servers

Sie können einen eigenen Server oder einen Front-End Server der SharePoint Farm für den Betrieb des App-Servers verwenden. Folgende Programme und Dienste müssen dazu installiert und konfiguriert werden:

Server Rollen:

• Application Server
  • .NET Framework 4.5
  • TCP Port Sharing
  • Web Server (IIS) Support
  • Windows Process Activation Service Support
    • HTTP Activation
    • Named Pipes Activation
    • TCP Activation
  • Web Server (IIS)
    • Web Server
      • Common HTTP Features
        • Default Document
      • Security
        • Request Filtering
        • Basic Authentication
        • Client Certificate Mapping Authentication
        • Digest Authentication
        • IIS Client Certificate Mapping Authentication
        • Windows Authentication
      • Application Development
        • .NET Extensibility 3.5
        • .NET Extensibility 4.5
        • NET 3.5
        • NET 4.5
        • ISAPI Extensions
        • ISAPI Filters
        • WebSocket Protocol

Features:

• .NET Framework 3.5 Features
  • .NET Framework 3.5
• .NET Framework 4.5 Features
  • .NET Framework 4.5
  • NET 4.5
  • WCF Services
    • HTTP Activation
    • Named Pipe Activation
    • TCP Activation
    • TCP Port Sharing

3. SSL Zertifikate beantragen oder erstellen

Es wird ein Wild-Card SSL Zertifikat zwischen SharePoint und APP (IIS Website auf dem APP-Server) benötigt.
Für Test-Zwecke können Sie ein Self-Signed Zertifikat erstellen.

4. APP-Website erstellen

1. IIS Manager öffnen
2. Application Pools aufrufen
3. Neu hinzufügen
4. Name vergeben (z.B. Toolkit42AppPool)
5. Nach dem erstellen des AppPools in die erweiterten Einstellungen wechseln und den Dienst-Nutzer auf den SharePoint Farm Account umstellen.
6. Eine Neue Website erstellen. 
7. Den ApplicationPool auswählen, den Sie gerade erstellt haben, einen Pfad wählen, HTTPS umstellen, Hostname wählen, das SSL Zertifikat wählen (Self-Signes oder gekauftes)
8. Authentifizierung wählen, Windows Disable, Anonymous anschalten

5. App registrieren

1. In der SiteCollection folgende URL aufrufen: {SiteCollectionURL}/_layouts/15/appregnew.aspx
2. Im Titel "Toolkit42" eingeben
3. Domain: Zu App-Server Seite angeben, welche Sie eben erstellt haben (ohne http, oder https)
4. Redirect URL zur gerade angelegten Webseite mit https.

6. Zertifikat einrichten

Hier reicht ein self-signed Zertifikat.

1. Im IIS Manager auf den Server klicken, dort dann auf Server Zertifikate klicken.
2. Auf der rechten Seite eine Self-Signed Zertifikat erstellen
3. Erstellen und markieren, wenn das Zertifikat markiert ist, auf Export klicken. Als .pfx Zertifikat speichern.
4. Das Zertifikat noch einmal öffnen, dort dann auf "Als Datei speichern" (als.cer) klicken.
5. Dieses Zertifikat auf dem Server per Doppelklick installieren

Das Zertifikat in SharePoint registrieren PowerShell auf dem SharePoint Server starten und folgende Befehle ausführen:

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue
$publicCertPath = "Pfad zum Self-Signed SSl Zertifikat (.cer)"
$issuerID = "ClientId aus der Registrierung innerhalb von SharePoint weiter oben"
$targetTenantSite = "Die SiteCollection URL ind er das toolkit42 genutzt werden soll"
$authorityName = "Toolkit42Suite"
$certificate = Get-PfxCertificate $publicCertPath
New-SPTrustedRootAuthority -Name $authorityName -Certificate $certificate
$spweb = Get-SPWeb $targetTenantSite
$realm = Get-SPAuthenticationRealm -ServiceContext $spweb.Site
$fullIssuerIdentifier = $issuerId + '@' + $realm
New-SPTrustedSecurityTokenIssuer -Name $authorityName -Certificate $certificate -RegisteredIssuerName $fullIssuerIdentifier -IsTrustBroker
Iisreset

IISReset auf allen Front-End-Server durchführen.

7. Web-Config Einstellungen

1. Web.Config öffnen (Der App) 
2. ClientId und ISSuerIs einsetzen
3. Zertifikat-Adresse und Zertifikatpassword angeben

8. App konfigurieren und hochladen

Nennen Sie die Datei Toolkit42.app um zu Toolkit42.zip. Danach die zip Datei im Explorer öffnen, nicht entpacken! Dort die Datei AppManifest.xml anpassen.

Dort die Paramter "StartPage", "InstalledEventEndpoint", "UpgradedEventEndPoint", "RemoteWebApplication" anpassen.

9. App in AppCatalog hochladen

Folgen Sie hierfür folgender Anleitung:
http://sharepointtemplate.userecho.com/topics/22-installationsanleitung-toolkit42/ bzw. geben Sie unter der Suche folgenden Titel ein: "Installationsanleitung Toolkit42"