Expand Docs with how to initialize V2 Clients.

[VilleFTW]

Hello there,

We are struggling to find a way to initialize the V2 clients, as part of the v4 release of Zitadel. Any chance for a small working snippet?

Regards,
Ville

[VilleFTW]

Any update on this? As zitadel is preparing for the v5 release, this should take the utmost priority

[dennisoehme]

fyi: main...gardenofconcepts:zitadel-net:goc-main

[the-inconvenience-store]

I think this lib has been abandoned, maybe its time to pursue a fork. @dennisoehme would you like to setup a fork with your changes there, I'm happy to help you maintain it.

[dennisoehme]

Let me try to contact some of the maintainers here, or at least the company behind them. If there is no response, or if they are no longer willing to maintain this repository, I will create an organization for that purpose. Creating a fork without the original 'owner' should be a last resort.

In addition to this, I am currently working on an Aspire resource for Zitadel. It needs a new home, too. It is not publicly available at the moment as it is part of an application, but I would like to extract it and maintain it separately.

[skillmaker-dev]

Let me try to contact some of the maintainers here, or at least the company behind them. If there is no response, or if they are no longer willing to maintain this repository, I will create an organization for that purpose. Creating a fork without the original 'owner' should be a last resort.

In addition to this, I am currently working on an Aspire resource for Zitadel. It needs a new home, too. It is not publicly available at the moment as it is part of an application, but I would like to extract it and maintain it separately.

I also found this section: https://zitadel.com/docs/sdk-examples/introduction#missing-sdk

I tried it with C# this way

buf.gen.yaml:

version: v2
managed:
  enabled: true
plugins:
  - remote: buf.build/protocolbuffers/csharp:v33.0
    out: gen
    opt:
      - base_namespace=
  - remote: buf.build/grpc/csharp:v1.76.0
    out: gen
    opt:
      - base_namespace=

Then i ran this cmd in the same folder as the .yaml file:

 npx buf generate https://github.com/zitadel/zitadel.git#tag=v4.4.0 --include-imports

Then I imported the content of the gen folder into my ASP.NET project and started using it, and it works, I can also put it in a separate C# Library to use it in my projects:

using Grpc.Core;
using Grpc.Net.Client;
using Microsoft.AspNetCore.Mvc;
using Zitadel.Settings.V2beta;

namespace ZitadelTest.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class ZitadelController(ILogger<ZitadelController> logger, IConfiguration configuration) : ControllerBase
    {
        [HttpGet(Name = "GetWeatherForecast")]
        public async Task<IActionResult> Get()
        {
            // Get configuration from appsettings.json
            var zitadelInstance = configuration["ServiceAdmin:Authority"];
            var personalAccessToken = configuration["ServiceAdmin:PersonalAccessToken"];

            if (string.IsNullOrEmpty(zitadelInstance) || string.IsNullOrEmpty(personalAccessToken))
            {
                return StatusCode(500, "App is not configured");
            }

            // Configure the channel with the Personal Access Token
            var channel = GrpcChannel.ForAddress(zitadelInstance, new GrpcChannelOptions
            {
                Credentials = ChannelCredentials.Create(
                    ChannelCredentials.SecureSsl,
                    CallCredentials.FromInterceptor((context, metadata) =>
                    {
                        metadata.Add("Authorization", $"Bearer {personalAccessToken}");
                        return Task.CompletedTask;
                    })
                )
            });

            // Create a client - authenticated with Personal Access Token
            var client = new SettingsService.SettingsServiceClient(channel);

            var request = new GetGeneralSettingsRequest
            {
                // Add your request properties here
            };

            // Make a call - authenticated with Personal Access Token
            var response = await client.GetGeneralSettingsAsync(request);

            return Ok(response);
        }
    }
}

This can be automated, which may simplify the process of instantiating the services and authentication. AI can help create this process.

@dennisoehme This might help you in case you created a new fork or something from scratch, and I'm glad you are working on an Aspire integration. Good luck!