Quick Start with ByteHide Secrets (.NET)

Once you have installed the ByteHide Secrets Integration package, you can quickly start using it to secure your sensitive data in your .NET projects. This guide will help you get started with ByteHide Secrets Integration in Visual Studio.

Quick Start Guide

1. Install ByteHide Secrets Integration in your project.
2. Authenticate ByteHide Secrets Integration with your Project Token.
3. Build your project.
4. ByteHide Secrets will automatically analyze and replace your sensitive data.
5. Done! Your project is now protected.
6. Manage your sensitive data in the ByteHide panel.

Using ByteHide Secrets Integration in Visual Studio is simple and straightforward. Once installed and authenticated with your Project Token, you only need to Build your project and ByteHide Secrets will automatically analyze and replace your sensitive data.

ByteHide Secrets will try to detect automatically your sensitive data, for example, if you have a JSON token in your code, it will be replaced by a new one.

Output

You can see the output of the ByteHide Secrets Integration process in the Visual Studio Output window.

ByteHide Secrets Panel

Go to the ByteHide panel and select your project to manage your sensitive data.

Keys tab:

This tab will show you the keys that have been detected in your code.

Analysis tab:

This tab will show you the analysis and details of the sensitive data that has been detected in your code.

Checking the protection

Using some tools like dnSpy, you can check the protection applied to your IL code.

Set manually secrets

If you want to protect some data manually, using Bytehide.ToolBox.Secrets.SecretsMarker.ThisIsASecret.

using System;

namespace Hollow
{
    internal class Program
    {
        private static void Main()
        {
            var password = Bytehide.ToolBox.Secrets.SecretsMarker.ThisIsASecret("drowssap", "my_db_password");
            var database = new DB.Database("Hollow", password);
            database.CreateDatabase();

            Console.ReadKey();
        }
    }
}

You can simplify the code by declaring using Bytehide.ToolBox.Secrets;

ThisIsASecret will protect the value of the variable password in the code using the key my_db_password.

You can also omit the key and use a key generated by ByteHide Secrets.

var password = SecretsMarker.ThisIsASecret("drowssap");

Or you can use the IsASecret extension method to protect the value of the variable password in the code using the key my_db_password.

var password = "drowssap".IsASecret("my_db_password");

The Bytehide.ToolBox.Secrets.SecretsMarker.IsASecret extension method will protect the value of the variable password in the code using the key my_db_password.

You can also omit the key and use a key generated by ByteHide Secrets.

var password = "drowssap".IsASecret();

Using attributes

You can also use the Bytehide.ToolBox.Secrets.SecretsMarker.ThisIsASecret attribute to protect the value of a property.

using System;
using Bytehide.ToolBox.Secrets;

namespace Hollow
{
    internal class Program
    {
        [ThisIsASecret("my_db_password")]
        private static readonly string _password = "drowssap";

        public static void Main()
        {
            var database = new DB.Database("Hollow", _password);
            database.CreateDatabase();

            Console.ReadKey();
        }
    }
}

The Bytehide.ToolBox.Secrets.SecretsMarker.ThisIsASecret attribute will protect the value of the property _password in the code using the key my_db_password.

You can also omit the key and use a key generated by ByteHide Secrets.

[ThisIsASecret] private static readonly string _password = "drowssap";