Configure PlayerGrpc service

The PlayerGrpc service enables communication between the server and the player via remote procedure call (RPC) framework. The service must be installed on all web servers that the players communicate with.

Prerequisites: HTTP vs. HTTPS

You can decide during installation whether you want to use an HTTP or HTTPS connection. We recommend 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" />

Install PlayerGrpc service

The PlayerGrpc service is part of the IXM Platform installation and installed by default. You must configure it during the installation.

To install the PlayerGrpc service, perform the following steps:

1. Start the IXM Platform installer and follow the instructions.

2. When you’ve reached the installer’s Grpc window, enter your GRPC port. This information is mandatory, you must specify it.

3. Optionally, select HTTPS and enter the HTTPS certificate subject. That is, the certificate’s name or identifier, such as: *.grassfish.com

4. Click on Next and finish the installation.

Configure PlayerGrpc service

If your need to further adjust the GRPC port and HTTPS certificate, you can do so in the master.config file. This is necessary, for example, if you don’t use the standard certificate store or if the certificate is stored locally in your file system.

The PlayerGrpc section is added to the master.config file during the IXM Platform installation. To configure it, perform the following steps:

1. Open to the master.config file on the server with a text editor like Notepad++.

2. Go to the PlayerGrpcService section.

3. The value of Kestrel:Endpoints:Https:Url is the port that you specified during the installation. You can change it here if needed.

4. If you don’t use the standard certificate store, specify the following values under Windows Certificate Store:

   • For Kestrel:Endpoints:Https:Url enter the URL of the certificate store as value.

   • For Kestrel:Endpoints:Https:Certificate:Store enter the certificate store’s name as value.

   • For Kestrel:Endpoints:Https:Certificate:Location enter the certificate’s location as value.

   • For Kestrel:Endpoints:Https:Certificate:Subject enter the certificate’s subject (name, identifier) as value.

5. If your certificate is stored locally, specify the following values under Local Certificate File:

   1. For Kestrel:Endpoints:Https:Url enter the URL of the certificate’s location as value.

   2. For Kestrel:Endpoints:Https:Certificate:Path enter the file path to the certificate as value.

   3. For Kestrel:Endpoints:Https:Certificate:Password enter the certificate’s password as value.

6. Save your changes and close the file.

<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>