Toothless.Aspire.Hosting.OpenFga.Postgres 4.0.3

<p align="center"> <img src="./assets/icon.svg" alt="Aspire OpenFGA" width="150" height="150"> <h1 align="center">Aspire OpenFGA</h1> </p>

Aspire hosting integration for OpenFGA.

• Installation
• Usage
• Engines
  • Postgres
  • MySQL
  • SQLite
• Playground
• Model Definition
• Client Callbacks

Installation

Core package: Toothless.Aspire.Hosting.OpenFga

Engine packages:

• Toothless.Aspire.Hosting.OpenFga.Postgres
• Toothless.Aspire.Hosting.OpenFga.MySQL
• Toothless.Aspire.Hosting.OpenFga.Sqlite

Usage

By defailt AddOpenFga will setup a store with http and grpc endpoints with the engine set to in-memory. Contianers can be added using AddStore and models imported from files using WithModelDefinition.

var openFga = builder.AddOpenFga("openfga");

var store = openFga.AddStore("my-store")
    .WithModelDefinition("models", Path.Join(builder.AppHostDirectory, "Models"), "fga.mod");

builder.AddProject<MyProject>("project")
    .WithEnvironment("OpenFga__Connection", store.HttpEndpoint)
    .WithEnvironment("OpenFga__Store", store)

The AddStore method will adopt the Store ID of an existing store in the openFga resource if a store with the same name already exists.

Engines

Postgres

To use the postgres engine install Toothless.Aspire.Hosting.OpenFga.Postgres and call WithDatastore on the OpenFGA resource.

var database = builder.AddPostgres("postgres")
    .AddDatabase("db");

builder.AddOpenFga("openfga")
    .WithDatastore(database);

MySql

To use the postgres engine install Toothless.Aspire.Hosting.OpenFga.MySQL and call WithDatastore on the OpenFGA resource.

var database = builder.AddMySql("mysql")
    .AddDatabase("db");

builder.AddOpenFga("openfga")
    .WithDatastore(database);

Sqlite

To use the postgres engine install Toothless.Aspire.Hosting.OpenFga.Sqlite and call WithDatastore on the OpenFGA resource.

var database = builder.AddSqlite("sqlite");

builder.AddOpenFga("openfga")
    .WithDatastore(database);

Custom Engine

To use a custom engine users shoud call WithDatastore(engine, datastoreUri) on the OpenFGA resource. This will return an instance of IResourceBuilder<OpenFgaDatastoreResource> configuring the parent OpenFgaResource's and the OpenFgaDatastoreResource resources OPENFGA_DATASTORE_ENGINE, OPENFGA_DATASTORE_URI environment variables. The relationshiop between the OpenFgaDatastoreResource and OpenFgaResource resource is also configured such that the OpenFgaResource will wait for the completion of the OpenFgaDatastoreResource.

Playground

The playground can be enabled by calling WithPlayground on the OpenFGA resource. This will add a new "playground" endpoint to the OpenFGA resource.

builder.AddOpenFga("openfga")
    .WithPlayground();

Model Definition

Models can be imported from files using WithModelDefinition. This will import the modes from the specified path into the store the method was called on.

builder.AddOpenFga("openfga")
    .AddStore("my-store")
    .WithModelDefinition("models", Path.Join(builder.AppHostDirectory, "Models"), "fga.mod");

Client Callbacks

For arbitrary client callbacks use WithClientCallback. This will add a callback that will be called when the resource is started. The callback is provided with a OpenFgaClient instance that is configured to connect a store when used on a store resource.

builder.AddOpenFga("openfga")
    .AddStore("my-store")
    .WithClientCallback(static async (ctx, ct) =>
    {
        await ctx.Client.ReadAuthorizationModels(
            new ClientReadAuthorizationModelsOptions(),
            cancellationToken: ct);
    });

Tracing

By default, pusing otel traces into Aspire is disabled. To enable WithTracing should be used. This will use a sample rate of 100% by default when enabled.

builder.AddOpenFga("openfga")
    .WithTracing(sampleRaito: 1);

Metrics

By default, the metrics endpoint is disabled. To enable WithMetrics should be used. By default this will proxy the metrics endpoint.

builder.AddOpenFga("openfga")
    .WithMetrics(port: 2112, proxy: true);