feat(auth): Added VerifySessionCookieAsync() APIs (#177)

* feat(auth): Added VerifySessionCookieAsync() APIs

* Updated API ref docs

Author: hiranya911

FirebaseAdmin/FirebaseAdmin.Tests/Auth/EmailActionRequestTest.cs

@@ -365,6 +365,7 @@ private FirebaseAuth CreateFirebaseAuth(HttpMessageHandler handler)
                 UserManager = new Lazy<FirebaseUserManager>(userManager),
                 TokenFactory = new Lazy<FirebaseTokenFactory>(),
                 IdTokenVerifier = new Lazy<FirebaseTokenVerifier>(),
+                SessionCookieVerifier = new Lazy<FirebaseTokenVerifier>(),
             });
         }
 

FirebaseAdmin/FirebaseAdmin.Tests/Auth/FirebaseTokenVerifierTest.cs

@@ -31,6 +31,7 @@ public void NoProjectId()
                 Credential = MockCredential,
             });
             Assert.Throws<ArgumentException>(() => FirebaseTokenVerifier.CreateIDTokenVerifier(app));
+            Assert.Throws<ArgumentException>(() => FirebaseTokenVerifier.CreateSessionCookieVerifier(app));
         }
 
         [Fact]
@@ -43,6 +44,9 @@ public void ProjectIdFromOptions()
             });
             var verifier = FirebaseTokenVerifier.CreateIDTokenVerifier(app);
             Assert.Equal("explicit-project-id", verifier.ProjectId);
+
+            verifier = FirebaseTokenVerifier.CreateSessionCookieVerifier(app);
+            Assert.Equal("explicit-project-id", verifier.ProjectId);
         }
 
         [Fact]
@@ -54,6 +58,9 @@ public void ProjectIdFromServiceAccount()
             });
             var verifier = FirebaseTokenVerifier.CreateIDTokenVerifier(app);
             Assert.Equal("test-project", verifier.ProjectId);
+
+            verifier = FirebaseTokenVerifier.CreateSessionCookieVerifier(app);
+            Assert.Equal("test-project", verifier.ProjectId);
         }
 
         [Fact]
@@ -68,6 +75,9 @@ public void ProjectIdFromEnvironment()
                 });
                 var verifier = FirebaseTokenVerifier.CreateIDTokenVerifier(app);
                 Assert.Equal("env-project-id", verifier.ProjectId);
+
+                verifier = FirebaseTokenVerifier.CreateSessionCookieVerifier(app);
+                Assert.Equal("env-project-id", verifier.ProjectId);
             }
             finally
             {

FirebaseAdmin/FirebaseAdmin.Tests/Auth/FirebaseUserManagerTest.cs

@@ -1723,6 +1723,7 @@ private FirebaseAuth CreateFirebaseAuth(HttpMessageHandler handler)
                 UserManager = new Lazy<FirebaseUserManager>(userManager),
                 TokenFactory = new Lazy<FirebaseTokenFactory>(),
                 IdTokenVerifier = new Lazy<FirebaseTokenVerifier>(),
+                SessionCookieVerifier = new Lazy<FirebaseTokenVerifier>(),
             });
         }
 

FirebaseAdmin/FirebaseAdmin.Tests/Auth/IdTokenVerificationTest.cs

@@ -226,7 +226,7 @@ public async Task InvalidIssuer()
             var exception = await Assert.ThrowsAsync<FirebaseAuthException>(
                 async () => await auth.VerifyIdTokenAsync(idToken));
 
-            var expectedMessage = "ID token has incorrect issuer (iss) claim.";
+            var expectedMessage = "Firebase ID token has incorrect issuer (iss) claim.";
             this.CheckException(exception, expectedMessage);
         }
 
@@ -243,7 +243,7 @@ public async Task InvalidAudience()
             var exception = await Assert.ThrowsAsync<FirebaseAuthException>(
                 async () => await auth.VerifyIdTokenAsync(idToken));
 
-            var expectedMessage = "ID token has incorrect audience (aud) claim."
+            var expectedMessage = "Firebase ID token has incorrect audience (aud) claim."
                 + " Expected test-project but got wrong-audience";
             this.CheckException(exception, expectedMessage);
         }
@@ -401,7 +401,7 @@ internal static async Task<string> CreateTestTokenAsync(
             return await JwtUtils.CreateSignedJwtAsync(header, payload, Signer);
         }
 
-        private static ISigner CreateTestSigner()
+        internal static ISigner CreateTestSigner()
         {
             var credential = GoogleCredential.FromFile("./resources/service_account.json");
             var serviceAccount = (ServiceAccountCredential)credential.UnderlyingCredential;
@@ -428,6 +428,7 @@ private FirebaseAuth CreateFirebaseAuth(HttpMessageHandler handler = null)
             return new FirebaseAuth(new FirebaseAuth.FirebaseAuthArgs()
             {
                 IdTokenVerifier = new Lazy<FirebaseTokenVerifier>(tokenVerifier),
+                SessionCookieVerifier = new Lazy<FirebaseTokenVerifier>(),
                 UserManager = new Lazy<FirebaseUserManager>(userManager),
                 TokenFactory = new Lazy<FirebaseTokenFactory>(),
             });