Rapplis.SocialAuthentication 1.0.1

dotnet add package Rapplis.SocialAuthentication --version 1.0.1
NuGet\Install-Package Rapplis.SocialAuthentication -Version 1.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Rapplis.SocialAuthentication" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Rapplis.SocialAuthentication --version 1.0.1
#r "nuget: Rapplis.SocialAuthentication, 1.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Rapplis.SocialAuthentication as a Cake Addin
#addin nuget:?package=Rapplis.SocialAuthentication&version=1.0.1

// Install Rapplis.SocialAuthentication as a Cake Tool
#tool nuget:?package=Rapplis.SocialAuthentication&version=1.0.1


SocialAuthentication .NET library verifies the social login access token in the backend & return necessary infomations to identify the user.

The access token has to be fetched in frontend applicaton by signing in thorugh social authentication provider.

Currently this library supports 3 providers- google,apple & facebook

Table of Contents


Install Rapplis.SocialAuhentication from NuGet Package Manager.

  Install-Package Rapplis.SocialAuhentication


There is some setup to be done in the frontend part to make this library work smoothly. If you care about only backend, just ignore this section.

  • Google

    • Setup OAuth client according to Google Documentation
    • Make sure to enable People API in cloud console.
    • For android, make sure your app's SHA-1 is setup in cloud console.
    • While signin in to google, make sure to use the following scopes:<br/> https://www.googleapis.com/auth/userinfo.profile<br/> https://www.googleapis.com/auth/userinfo.email<br/> https://www.googleapis.com/auth/user.gender.read<br/> https://www.googleapis.com/auth/user.birthday.read
  • Facebook

    • Create an app in Meta for Developers and setup login accroding to the Documentation
    • For Android, setup app's hash key in the console.
    • While signing in with facebook, add the following permissions: email, public_profile, user_birthday, user_gender.
  • Apple

    • Follow official Apple Documentation & get ClientId for apple sign in.
    • Setup redirect url & deep linking for Android.
    • Make sure to add the following scopes: email, fullName.
    • You will get user's full name only once when user signs in for the first time. You have to send the name to the backend as Apple is not sending user's full name to backend for safety reasons.

API Reference


  • GetUser(SocialAuthData)
  await SocialAuth.GetUser(data);
Parameter Type Return Type
SocialAuthData SocialUser

Constant Classes

  • SocialAuthProvider
    Variable Type Value
    Google string google
    Facebook string facebook
    Apple string apple


  • SocialAuthData

    This model is accepted as peremeter in GetUser method. | Field | Type | Description | | :------------ | :------- | :--------------------------------------------------------------------- | | Provider | string | required* provider name mentioned in SocialAuthProvider | | Token | string | required* access token fetched through signing in social provider | | AppleClientId | string | required for apple* client id from apple developer console |

  • SocialUser

    This model is returned by GetUser method. | Field | Type | Description | | :------------ | :---------- | :------------------------------------------------------------------------------- | | Id | string | Unique ID fetched from login provider which has to be used for identifying users | | Email | string? | nullable Email address of the user | | EmailVerified | bool | If email address have verified by social auth provider | | Name | String? | nullable User's full name | | FirstName | String? | nullable First Name of the user | | LastName | String? | nullable Last Name of the user | | Picture | String? | nullable Image url of user's profile picture | | Locale | String? | nullable User's locale | | Gender | String? | nullable Gender of the user | | Birthday | DateTime? | nullable User's birthday | | Provider | String | provider name mentioned in SocialAuthProvider |


First you have to get the access token of a provider from user through api or however you are implementing. Pass the provider name to validate the access token and get a user with unique id provided by the social authentication provider. Here is an example of Google Authentication.

var googleAuthData = new SocialAuthData {
  Token = "access_token_got_from_user",
  Provider = SocialAuthProvider.Google,
SocialUser? socialUser = null;
  socialUser = await SocialAuth.GetUser(googleAuthData);
catch (Exception e)
  //todo handle error


The objective of this library is to verify social authentication token and get user data froms social authentication providers in the backend. Just as beginning, it supports only 3 providers- google, apple & facebook. Hope to implement more providers soon. Even though it is properly tested, it may have some edge case issues. Feel free to submit issue on Github Repository. You're also welcome to contribute to this package.

Follow me for more on github/rafid08

<a href="https://www.buymeacoffee.com/rafid" target="_blank"><img style="border-radius:7px" src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a>

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 293 12/28/2022
1.0.0 283 12/23/2022

Initial Release