MojoAuth.NET.V2 1.0.1

MojoAuth .NET SDK Documentation

Overview

This SDK allows you to easily integrate MojoAuth into your .NET applications to handle authentication processes like sending magic links, OTP verification via email or phone.

Installation

To get started, add the SDK to your project and instantiate the MojoAuthHttpClient with your credentials.

Authentication Methods

1. Send Magic Link

Send a magic link to an email address for authentication.

using MojoAuth.NET;

var mojoAuthHttpClient = new MojoAuthHttpClient("your_client_id", "your_client_secret");
var resp = await mojoAuthHttpClient.SendMagicLink("email.address@example.com");
Console.WriteLine(resp.Result.SessionId);

Alternatively, you can customize the client options:

using MojoAuth.NET;

var mojoAuthHttpClient = new MojoAuthHttpClient(new MojoAuthHttpClientOptions()
{
    Key = "your MojoAuth Client ID",
    Secret = "your MojoAuth Client Secret",
    BaseUrl = "https://your_tenant.mojoauth.com/api" // Optional, for single tenant private cloud
});

var resp = await mojoAuthHttpClient.SendMagicLink("email.address@example.com");
Console.WriteLine(resp.Result.SessionId);

Method Definition

Task<SendMagicLinkResponse> SendMagicLink(string email, string redirectUrl = "", string language = "")

Parameters:

• email (string): The recipient's email address.
• redirectUrl (string, optional): URL to redirect the user after successful authentication.

2. Check Authentication Status

Verify the status of the authentication initiated by the magic link.

var status = await mojoAuthHttpClient.CheckAuthenticationStatus("session_id");
Console.WriteLine(status.Result.IsAuthenticated);

Method Definition

Task<AuthenticationStatusResponse> CheckAuthenticationStatus(string sessionId)

Parameters:

• sessionId (string): The session ID from the authentication process (e.g., magic link or OTP).

3. Send Email OTP

Send a One-Time Password (OTP) to an email address.

var resp = await mojoAuthHttpClient.SendEmailOTP("email.address@example.com");
Console.WriteLine(resp.Result.SessionId);

Method Definition

Task<EmailOTPResponse> SendEmailOTP(string email)

Parameters:

• email (string): The recipient's email address.

4. Verify Email OTP

Verify the OTP sent to the email address.

var verifyResp = await mojoAuthHttpClient.VerifyEmailOTP("session_id", "123456");
Console.WriteLine(verifyResp.Result.IsAuthenticated);

Method Definition

Task<VerifyOTPResponse> VerifyEmailOTP(string sessionId, string otp)

Parameters:

• sessionId (string): The session ID received during the OTP sending process.
• otp (string): The OTP sent to the user's email.

5. Send Phone OTP

Send a One-Time Password (OTP) to a phone number.

var phoneOtpResp = await mojoAuthHttpClient.SendPhoneOTP("phone_number");
Console.WriteLine(phoneOtpResp.Result.SessionId);

Method Definition

Task<PhoneOTPResponse> SendPhoneOTP(string phoneId)

Parameters:

• phoneId (string): The phone number or ID to send the OTP to.

6. Verify Phone OTP

Verify the OTP sent to the phone.

var phoneVerifyResp = await mojoAuthHttpClient.VerifyPhoneOTP("session_id", "123456");
Console.WriteLine(phoneVerifyResp.Result.IsAuthenticated);

Method Definition

Task<VerifyOTPResponse> VerifyPhoneOTP(string sessionId, string otp)

Parameters:

• sessionId (string): The session ID received during the OTP sending process.
• otp (string): The OTP sent to the user's phone.