PlayerGrpc Service konfigurieren

Der PlayerGrpc-Dienst ermöglicht die Kommunikation zwischen dem Server und dem Player über das RPC-Framework (Remote Procedure Call). Der Dienst muss auf allen Webservern installiert sein, mit denen die Player kommunizieren.

Voraussetzungen: HTTP vs. HTTPS

Sie können bei der Installation entscheiden, ob Sie eine HTTP- oder HTTPS-Verbindung verwenden möchten. Wir empfehlen HTTPS.

<appSettings type="PlayerGrpcService">
  <add key="Kestrel:Endpoints:Https:Url" value="https://*:50118" />

<appSettings type="PlayerGrpcService">
  <add key="Kestrel:Endpoints:Http:Url" value="http://*:50118" />

PlayerGrpc Service installieren

Der PlayerGrpc Service ist Teil der IXM Plattform-Installation und wird standardmäßig installiert. Sie müssen ihn während der Installation konfigurieren.

Führen Sie die folgenden Schritte aus, um den PlayerGrpc Service zu installieren:

1. Starten Sie die IXM Plattform-Installation und befolgen Sie die Anweisungen.

2. Wenn Sie im Installer das Fenster Grpc erreicht haben, geben Sie Ihren GRPC-Port ein. Diese Information ist obligatorisch, d.h. sie muss angegeben werden.

3. Wählen Sie optional HTTPS aus und geben Sie das Subject des HTTPS-Zertifikats ein. Das heißt, den Namen oder die Kennung des Zertifikats, zum Beispiel: *.grassfish.com

4. Klicken Sie auf Weiter und schließen Sie die Installation ab.

PlayerGrpc Service konfigurieren

Wenn Sie den GRPC-Port und das HTTPS-Zertifikat weiter anpassen müssen, können Sie dies in der Datei master.config tun. Dies ist beispielsweise erforderlich, wenn Sie nicht den Standard-Certificat Store verwenden oder das Zertifikat lokal in Ihrem Dateisystem gespeichert ist.

Der Abschnitt PlayerGrpc wird während der Installation der IXM Plattform zur master.config Datei hinzugefügt. Um diesen zu konfigurieren, führen Sie die folgenden Schritte aus:

1. Öffnen Sie die Datei master.config auf dem Server mit einem Texteditor wie Notepad++.

2. Gehen Sie zum Abschnitt PlayerGrpcService.

3. Der Wert von Kestrel:Endpoints:Https:Url ist der Port, den Sie während der Installation angegeben haben. Sie können diesen hier bei Bedarf ändern.

4. Wenn Sie nicht den Standard-Certificate Store verwenden, geben Sie unter Windows Certificate Store die folgenden Werte an:

   • Geben Sie für Kestrel:Endpoints:Https:Url die URL des Certificate Store als Wert ein.

   • Geben Sie für Kestrel:Endpoints:Https:Certificate:Store den Namen des Certificate Store als Wert ein.

   • Geben Sie für Kestrel:Endpoints:Https:Certificate:Location den Speicherort des Zertifikats als Wert ein.

   • Geben Sie für Kestrel:Endpoints:Https:Certificate:Subject das Subject des Zertifikats (Name, Kennung) als Wert ein.

5. Wenn Ihr Zertifikat lokal gespeichert ist, geben Sie unter Local Certificate File die folgenden Werte an:

   1. Geben Sie für Kestrel:Endpoints:Https:Url die URL des Certificate Store als Wert ein.

   2. Geben Sie für Kestrel:Endpoints:Https:Certificate:Path den Dateipfad zum Zertifikat als Wert ein.

   3. Geben Sie für Kestrel:Endpoints:Https:Certificate:Password das Passwort des Zertifikats als Wert ein.

6. Speichern Sie Ihre Änderungen und schließen Sie die Datei.

<appSettings type="PlayerGrpcService">
  <add key="Kestrel:Endpoints:Http:Url" value="http://*:50118" />

  <!-- Windows Certificate Store
  <add key="Kestrel:Endpoints:Https:Url" value="https://*:5000" />
  <add key="Kestrel:Endpoints:Https:Certificate:Store" value="My" />
  <add key="Kestrel:Endpoints:Https:Certificate:Location" value="LocalMachine" />
  <add key="Kestrel:Endpoints:Https:Certificate:Subject" value="*.grassfish.com" />
  -->
  
  <!-- Local Certificate File
  <add key="Kestrel:Endpoints:Https:Url" value="https://*:5000" />
  <add key="Kestrel:Endpoints:Https:Certificate:Path" value="C:\Grassfish\certificate.pfx" />
  <add key="Kestrel:Endpoints:Https:Certificate:Password" value="Password" />
  -->
</appSettings>