Passage.NET 1.0.0

<img src="https://storage.googleapis.com/passage-docs/passage-logo-gradient.svg" alt="Passage logo" style="width:250px;"/>

Passage.NET

This dotnet SDK allows for verification of server-side authentication for applications using Passage

Install this package using nuget.

dotnet add pacakge Passage.NET

Validate JWT

You need to provide Passage with your App ID in order to verify the JWTs.

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID"
}

var passage = new Passage(config);

var subject = await passage.ValidateToken("JWT_TO_VALIDATE");

Retrieve App Info

To retrieve information about an app, you should use the passage.GetApp() function.

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID",
    ApiKey = "YOUR_API_KEY"
}

var passage = new Passage(config);

var passageApp = await passage.GetApp();

Retrieve User Information By Identifier

To retrieve information about a user, you should use the passage.GetUserByIdentifier("your@email.cc") function.

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID",
    ApiKey = "YOUR_API_KEY"
}

var passage = new Passage(config);

var passageUser = await passage.GetUserByIdentifier("user@email.cc");

Retrieve User Information By User Id

To retrieve information about a user, you should use the passage.GetUser("USER_ID") function.

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID",
    ApiKey = "YOUR_API_KEY"
}

var passage = new Passage(config);

var passageUser = await passage.GetUser("USER_ID");

Create a User

You can also create a Passage user by providing an email or phone (phone number must be a valid E164 phone number).

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID",
    ApiKey = "YOUR_API_KEY"
}

var passage = new Passage(config);

var createRequest = new CreateUserRequest()
{
    Email = "user@email.cc",
    //note that user_metadata is an optional field and is defined in your Passage App settings (Registration Fields).
    User_metadata = new
    {
        example = 123
    }
};
    
var passageUser = await passage.CreateUser(createRequest);

Update a User

You can update a user attributes

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID",
    ApiKey = "YOUR_API_KEY"
}

var passage = new Passage(config);

var updateRequest = new UpdateUserRequest()
{
    Email = "user@email.cc",
    //note that user_metadata is an optional field and is defined in your Passage App settings (Registration Fields).
    User_metadata = new
    {
        example = 1234
    }
};

var passageUser = await passage.UpdateUser("USER_ID",updateRequest);

Delete a User

To delete a Passage user, you will need to provide the userID, and corresponding app credentials.

var config = new PassageConfig()
{
    AppId = "YOUR_APP_ID",
    ApiKey = "YOUR_API_KEY"
}

var passage = new Passage(config);

await passage.DeleteUser("USER_ID");