OLT.Infisical.API.Wrapper 10.0.1

OLT.Infisical.API.Wrapper - Wrapper for Infisical API

A .NET API wrapper for Infisical's secrets management endpoints. This library provides strongly-typed interfaces for interacting with Infisical's REST API, including secret creation, update, deletion, retrieval, bulk operations, and tag management.

Install the package:

dotnet add package OLT.Infisical.API.Wrapper

Overview

• Fully async API using Task
• Designed for .NET 8 and .NET 9
• Uses Refit for declarative REST API calls

Add the Infisical HTTP Client to your service collection:

using OLT.Infisical.API.Wrapper;


services.AddInfisicalHttpClient(opts =>
{
    // opts.SiteUrl = "https://infisical.mydomain.com";  <-- Custom URL if needed (default is https://us.infisical.com)
    opts.ClientId = "00000000-0000-0000-0000-000000000000";
    opts.ClientSecret = "client secret here";
});

Secrets

• Create, update, delete, and retrieve secrets
• Bulk operations for secrets (create, update, delete)
• Attach and detach tags to secrets
• Query secrets with advanced filtering

Usage

• CreateSecret - Create a new secret
• UpdateSecret - Update an existing secret
• DeleteSecret - Delete a secret
• RetrieveSecret - Get a secret by name
• ListSecrets - List all secrets
• BulkCreate - Create multiple secrets
• BulkUpdate - Update multiple secrets
• BulkDelete - Delete multiple secrets
• AttachTags - Attach tags to a secret
• DetachTags - Detach tags from a secret

API Endpoints

public class InfisicalSecretService : IInfisicalSecretService
{
    private readonly OLT.Infisical.API.Wrapper.IInfisicalApiSecrets _infiscialSecretsApi;

    public InfisicalSecretService(OLT.Infisical.API.Wrapper.IInfisicalApiSecrets infiscialSecretsApi)
    {
        _infiscialSecretsApi = infiscialSecretsApi;
    }

    public async Task GetAllAsync(CancellationToken cancellationToken)
    {
        var query = new OLT.Infisical.API.Wrapper.Secrets.Query.InfisicalListSecretsQuery
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Environment = "prod",
            SecretPath = "/MyPath",            
            Recursive = true,
            IncludeImports = true,
        };

        var queryResult = await _infiscialSecretsApi.ListSecrets(query, cancellationToken);

        foreach (var secret in queryResult.Secrets)
        {
            //Do Stuff
            Console.WriteLine(secret.SecretPath);
            Console.WriteLine(secret.SecretKey);
            Console.WriteLine(secret.SecretValue);
        }
    }

    public async Task<string?> GetAsync(string path, string secretKey, CancellationToken cancellationToken = default)
    {
        var query = new OLT.Infisical.API.Wrapper.Secrets.Query.InfisicalGetSecretQuery
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Environment = "prod",
            SecretPath = path,            
            IncludeImports = true,
        };

        var result = await _infiscialSecretsApi.RetrieveSecret(secretKey, query, cancellationToken);
        return result.Secret?.SecretValue;
    }

    public async Task CreateSecretAsync(string path, string secretKey, string secretValue, CancellationToken cancellationToken)
    {
        var request = new OLT.Infisical.API.Wrapper.Secrets.Request.InfisicalCreateSecretRequest
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Environment = "prod",
            SecretPath = path,
            SecretValue = secretValue,
        };

        var result = await _infiscialSecretsApi.CreateSecret(secretKey, request, cancellationToken);

        Console.Write(result.Secret?.Id);
    }

    public async Task UpdateSecretAsync(string path, string secretKey, string secretValue, InfisicalEnvironmentTypes environment, CancellationToken cancellationToken)
    {
        _ = await GetOrCreateFolderAsync(path, environment, cancellationToken);

        var request = new OLT.Infisical.API.Wrapper.Secrets.Request.InfisicalUpdateSecretRequest
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Environment = "prod",
            SecretPath = path,
            SecretValue = secretValue,
        };

        var result = await _infiscialSecretsApi.UpdateSecret(secretKey, request, cancellationToken);

        Console.Write(result.Secret?.Id);
    }

    public async Task RenameSecretAsync(string path, string secretKey, string newSecretKey, InfisicalEnvironmentTypes environment, CancellationToken cancellationToken)
    {
        _ = await GetOrCreateFolderAsync(path, environment, cancellationToken);

        var request = new OLT.Infisical.API.Wrapper.Secrets.Request.InfisicalUpdateSecretRequest
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Environment = "prod",
            SecretPath = path,
            NewSecretName = newSecretKey,
        };

        var result = await _infiscialSecretsApi.UpdateSecret(secretKey, request, cancellationToken);

        Console.Write(result.Secret?.Id);

    }
}

Folders

• Create, update, delete, and retrieve folders
• Query folders with advanced filtering

Usage

• CreateFolder - Create a new folder
• UpdateFolder - Update a folder
• DeleteFolder - Delete a folder
• GetFolder - Get folder by id
• ListFolders - List all folders

API Endpoints

public class InfisicalFolderService : IInfisicalFolderService
{
    private readonly OLT.Infisical.API.Wrapper.IInfisicalApiFolders _infiscialFoldersApi;

    public InfisicalSecretService(OLT.Infisical.API.Wrapper.IInfisicalApiFolders infiscialFoldersApi)
    {
        _infiscialFoldersApi = infiscialFoldersApi;
    }

    public async Task GetAllAsync(CancellationToken cancellationToken)
    {
        var query = new OLT.Infisical.API.Wrapper.Folders.Query.InfisicalListFoldersQuery
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Path = "/MyPath",
            Environment = "prod"
        };

        var queryResult = await _infiscialFoldersApi.ListFolders(query, cancellationToken);

        foreach (var folder in result.Folders)
        {
            //Do Stuff
            Console.WriteLine(folder.Id);
            Console.WriteLine(folder.Name);
        }
    }

    public async Task CreateAsync(CancellationToken cancellationToken)
    {
        var request = new OLT.Infisical.API.Wrapper.Folders.Requests.InfiscalCreateFolderRequest
        {
            WorkspaceId = "00000000-0000-0000-0000-000000001234",
            Environment = "prod",
            Path = "/MyPath",            
            Name = "NewFolderName"
        };

        var createFolderResult = await _infiscialFoldersApi.CreateFolder(request, cancellationToken);

        Console.WriteLine(createFolderResult.Folder.Id);
        Console.WriteLine(createFolderResult.Folder.Name);
    }
}