Skip to content

casdoor/casdoor-dotnet-sdk

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date
May 20, 2023
Mar 28, 2022
Dec 1, 2023
Feb 16, 2024
Feb 16, 2024
Mar 21, 2022
May 10, 2022
Mar 28, 2022
Mar 28, 2022
May 10, 2022
Aug 13, 2021
Feb 3, 2024

Repository files navigation

Casdoor .NET SDK

Actions Status GitHub

The Casdoor's SDK for .NET/ASP.NET Core, which will allow you to easily connect your application to the Casdoor authentication system without having to implement it from scratch.

Packages

This SDK is built using the following packages for different platforms:

Package Name Develop (MyGet) Release (NuGet) Description Supported frameworks
Casdoor.Client MyGet NuGet SDK for .NET .NET Standard 2.0/.NET 4.6.1 and newer
Casdoor.AspNetCore MyGet NuGet SDK for ASP.NET Core .NET Core 3.1 and newer
Casdoor.Native wait develop wait publish SDK for WPF or Maui -

Casdoor Client

Casdoor.Client is a base package for the specific platform SDKs. It contains follow features.

  • CasdoorClient: A API client implementation for the Casdoor. You can use to call the Casdoor APIs.
Usage
var httpClient = new HttpClient();
var client = new CasdoorClient(HttpClient, new CasdoorOptions{
    Endpoint = "https://door.casdoor.com",
    OrganizationName = "casbin", // your Casdoor organization
    ApplicationName = "app-example", // your Casdoor application
    ApplicationType = "native", // webapp, webapi or native
    ClientId = "b800a86702dd4d29ec4d", // your Casdoor application's client ID
    ClientSecret = "1219843a8db4695155699be3a67f10796f2ec1d5", // your Casdoor application's client secret
});

// Request tokens (You should enable credentials flow in your Casdoor application)
var token = await client.RequestClientCredentialsTokenAsync();
client.SetBearerToken(token);

var currentUser = client.ParseJwtToken(token.AccessToken);

// Request user info
var users = await client.GetUsersAsync();
// Request roles
var roles = await client.GetRolesAsync();
// Request Permissions
var persmissions = await client.GetPermissionsAsync();

var policy = new CasdoorPermissionRule()
{
    Id = $"{currentUser.Owner}/{persmissions.First().Name}",
    V0 = $"{currentUser.Owner}/{currentUser.Name}",
    V1 = "example-resource",
    V2 = "example-action"
};

var isPermissionAvaliable = await client.EnforceAsync(policy);
  • CasdoorOptions (Updating)
  • Extensions (Updating)

Casdoor AspNetCore

Getting started

  1. Add the following settings about casdoor in your appsettings.json file:
{
    "Casdoor": {
        "Endpoint": "<your Casdoor endpoint>",
        "OrganizationName": "<your Casdoor organization>",
        "ApplicationName": "<your Casdoor application>",
        "ApplicationType": "webapp", // webapp or webapi (webapi is not yet supported)
        "ClientId": "<your Casdoor application's client ID>",
        "ClientSecret": "<your Casdoor application's client secret>",

        // Optional: The callback path that the client will be redirected to
        // after the user has authenticated. default is "/casdoor/signin-callback"
        "CallbackPath": "/callback",
        // Optional: Whether require https for casdoor endpoint
        "RequireHttpsMetadata": false,
        // Optional: The scopes that the client will request
        "Scopes": [
            "openid",
            "profile",
            "email",
        ]
    }
}
  1. Add the following code to your webapp:
builder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCasdoor(builder.Configuration.GetSection("Casdoor"))
    .AddCookie(CookieAuthenticationDefaults.AuthenticationScheme);
  1. Now you can use the Casdoor authentication scheme in your webapp!

Samples

It is a MVC webapp that uses Casdoor authentication. The default settings use the public demo Casdoor and Casnode configuration, you can directly start the webapp by running:

dotnet run

Or change the settings in the appsettings.json according to your deployed casdoor configuration.

License

This project is licensed under the Apache 2.0 license.