WF-1242 Add sample implementation of PlayerIdentityToken verification code in authentication flow example (#41)

* Add sample implementation of PlayerIdentityToken verification code required by customer side
* Update README to give specific instructions for running examples in own project

Author: jasminequah

examples/BYOAuthFlow/Program.cs

@@ -18,9 +18,10 @@ namespace BYOAuthFlow
     ///     This contains the implementation of the "Player authentication" scenario.
     ///     1. Start a cloud deployment.
     ///     2. Create a PlayerIdentityToken.
-    ///     3. Choose a deployment that is ready for login.
-    ///     4. Create a LoginToken for a selected deployment.
-    ///     5. Connect to the deployment using the PlayerIdentityToken and the LoginToken.
+    ///     3. Verify the PlayerIdentityToken.
+    ///     4. Choose a deployment that is ready for login.
+    ///     5. Create a LoginToken for a selected deployment.
+    ///     6. Connect to the deployment using the PlayerIdentityToken and the LoginToken.
     /// </summary>
     internal class BYOAuthScenario : ScenarioBase
     {
@@ -103,6 +104,17 @@ protected override void Run()
                     ProjectName = ProjectName
                 });
 
+            Console.WriteLine("Verifying PlayerIdentityToken");
+            var decodePlayerIdentityTokenResponse = _playerAuthServiceClient.DecodePlayerIdentityToken(
+                new DecodePlayerIdentityTokenRequest
+                {
+                    PlayerIdentityToken = playerIdentityTokenResponse.PlayerIdentityToken
+                });
+            var playerIdentityToken = decodePlayerIdentityTokenResponse.PlayerIdentityToken;
+            if (playerIdentityToken.Provider != "provider") throw new Exception("Provider not recognised.");
+            if (playerIdentityToken.ProjectName != ProjectName) throw new Exception("Project not recognised.");
+            if (DateTime.Now.CompareTo(playerIdentityToken.ExpiryTime.ToDateTime()) > 0) throw new Exception("PlayerIdentityToken expired.");
+            
             Console.WriteLine("Choosing a deployment");
             var suitableDeployment = _deploymentServiceClient.ListDeployments(new ListDeploymentsRequest
             {

examples/README.md

@@ -18,6 +18,14 @@ dotnet restore
 dotnet run
 ```
 
+## Running this example in your own SpatialOS project
+Building and uploading the assembly of this project is not required to use the example C# code for the scenarios shown here in your own project. However, if you wish to see this example in action for yourself, you can use the pre-built assembly included in this repository to run a deployment on your own SpatialOS project:
+
+1. Modify the `spatialos.json` file in the `blank_project` directory to use the name of your SpatialOS project.
+2. Run `spatial cloud upload blank_project` from the `blank_project` directory to upload the pre-built assembly into your project.
+3. Modify the required fields in the `Program.cs` file of the example project in the solution you wish to run. These fields are specified in the comments of the file.
+4. Follow the steps to run the solution using an IDE or the .NET core CLI.
+
 ## Installing C# Platform SDK
 
 * Please see the [SpatialOS documentation](https://docs.improbable.io/reference/latest/platform-sdk/introduction)