Project token docs

The project token connects your application to the ByteHide cloud platform. With a token, logs are automatically sent to the cloud. Without it, logs are only stored locally.

Setting the Project Token

Configure your project token using the SetProjectToken method:

using Bytehide.Logger.Core;

// Set your project token
Log.SetProjectToken("your-project-token-here");

Obtaining Your Project Token

To get your project token, you first need to create a Logs project in the ByteHide dashboard.

Create Logs Project

If you haven't created a Logs project yet, follow our step-by-step guide: Create a Logs project

Once your project is created:

Navigate to your Logs project dashboard
Copy your project token from the project settings
Use the token in your application configuration

Environment-Based Configuration

Using Environment Variables

// Get token from environment variable
var projectToken = Environment.GetEnvironmentVariable("BYTEHIDE_PROJECT_TOKEN");
Log.SetProjectToken(projectToken);

Configuration in ASP.NET Core

In appsettings.json:

{
  "ByteHide": {
    "ProjectToken": "your-project-token-here"
  }
}

In your application:

public void ConfigureServices(IServiceCollection services)
{
    var projectToken = Configuration["ByteHide:ProjectToken"];
    Log.SetProjectToken(projectToken);
}

Token Behavior

Scenario	Behavior
Token Set	Logs sent to ByteHide cloud + local files (if enabled)
No Token	Logs only stored in local files
Invalid Token	Logs fallback to local files only

Security Best Practices

Token Security

Never hardcode tokens in your source code. For maximum security, consider using ByteHide Secrets to manage your project tokens and other sensitive configuration.

Option 1: ByteHide Secrets (Recommended)

Use ByteHide Secrets to securely manage your project tokens:

// Use ByteHide Secrets to retrieve your project token
var projectToken = await Secrets.GetAsync("BYTEHIDE_PROJECT_TOKEN");
Log.SetProjectToken(projectToken);

ByteHide Secrets Integration

ByteHide Secrets provides enterprise-grade secret management. Learn more: ByteHide Secrets for .NET

Option 2: Environment Variables

// ❌ Don't do this
Log.SetProjectToken("bh_1234567890abcdef");

// ✅ Do this instead
Log.SetProjectToken(Environment.GetEnvironmentVariable("BYTEHIDE_PROJECT_TOKEN"));

Validation

Check if your token is working:

Log.SetProjectToken("your-token");
Log.Info("Test log message");

// Check ByteHide dashboard to confirm logs are received