Implement TOTP Support for .NET Management SDK

Time-based One-Time Password (TOTP) is a widely used method of two-factor authentication (2FA). It generates short-lived, unique numeric codes based on a shared secret and the current timestamp. These codes are used in addition to a user’s password to verify identity and enhance login security.

Contentstack’s .NET Management SDK supports TOTP as part of its multi-factor authentication (MFA) capabilities. This allows developers to authenticate MFA-enabled users by providing either a 2FA token or an MFA secret that dynamically generates the TOTP token.

By implementing TOTP support in your integration, you:

• Improve the security of user authentication using time-based verification.
• Enable support for MFA-enabled accounts directly within applications.
• Allow automation workflows to generate TOTP tokens programmatically using a stored MFA secret.

This guide explains how to use the updated Login and LoginAsync methods in the .NET Management SDK to support both standard and MFA-protected login flows.

The Login method is a synchronous function that authenticates a user to their Contentstack account using credentials. Upon successful authentication, it returns an auth token for accessing other APIs.

This method now supports MFA by accepting either a 2FA token or an MFA secret to generate a TOTP for enhanced login security.

Returns:

Type ContentstackResponse

Example

The following code demonstrates how to authenticate users using the Login method in the .NET Management SDK.

The SDK supports three scenarios:

• Standard login (no MFA)
• Login with a 2FA token
• Login using an MFA secret to dynamically generate a token

Update the placeholders with actual user credentials and MFA values as applicable.

using Contentstack.Management.Core;
using Contentstack.Management.Core.Models;
ContentstackClient client = new ContentstackClient();

NetworkCredential credentials = new NetworkCredential("<EMAIL>", "<PASSWORD>");

// Login when MFA is not enabled for the user 

ContentstackResponse contentstackResponse = client.Login(credentials);

// Login when MFA is enabled: use a valid TOTP token generated from an authenticator app

string tfa_token = "<my_tfa_token>";
ContentstackResponse contentstackResponse = client.Login(credentials, token = tfa_token);

// Login using the MFA secret: SDK will generate the TOTP token dynamically

string mfa_secret = "<my_mfa_secret>";
ContentstackResponse contentstackResponse = client.Login(credentials, mfaSecret = mfa_secret);

Note: The mfaSecret is not passed in the request body. It is used internally to generate a TOTP, which is sent as the tfa_token.

The LoginAsync method allows developers to authenticate users without blocking application execution. It returns a task with an auth token upon successful login.

This method also supports multi-factor authentication (MFA) using either a 2FA token or an MFA secret to dynamically generate a TOTP token.

Returns:

Type Task<ContentstackResponse>

Example

The following code demonstrates how to authenticate users using the LoginAsync method in the .NET Management SDK.

The SDK supports three scenarios:

• Standard login (no MFA)
• Login with a 2FA token
• Login using an MFA secret to dynamically generate a token

Update the placeholders with actual user credentials and MFA values as applicable.

using Contentstack.Management.Core;
using Contentstack.Management.Core.Models;
ContentstackClient client = new ContentstackClient();

NetworkCredential credentials = new NetworkCredential("<EMAIL>", "<PASSWORD>");
// Login when MFA is not enabled for the user
ContentstackResponse contentstackResponse = await client.Login(credentials);

// Login when MFA is enabled: use a valid TOTP token generated from an authenticator app
string tfa_token = "<my_tfa_token>";
ContentstackResponse contentstackResponse = await client.Login(credentials, token=tfa_token);

// Login using the MFA secret: SDK will generate the TOTP token dynamically
string mfa_secret = "<my_mfa_secret>";
ContentstackResponse contentstackResponse = await client.Login(credentials, mfaSecret = mfa_secret);

Note: The mfaSecret is not sent in the request body. It is used internally by the SDK to generate a TOTP, which is then passed as the token during login.