sharpgrip / openiddict.api

SharpGrip OpenIddict API is an extension of the OpenIddict library exposing the OpenIddict entities through a RESTful API.

SharpGrip OpenIddict API

Builds

Introduction

SharpGrip OpenIddict API is an extension of the OpenIddict library exposing the OpenIddict entities through a RESTful API.

Installation

Reference NuGet package SharpGrip.OpenIddict.Api (https://www.nuget.org/packages/SharpGrip.OpenIddict.Api).

Follow the OpenIddict installation guide Getting started and call the AddApi<TKey> extension method on the OpenIddictEntityFrameworkCoreBuilder.

serviceCollection.AddOpenIddict().AddCore(options =>
{
    options.UseEntityFrameworkCore()
        .UseDbContext<ApplicationDbContext>()
        .AddApi<long>();
});

Configuration

In case you are overriding the OpenIddict entities you need to use the AddApi<TApplication, TAuthorization, TScope, TToken, TKey> overload to make sure the API is working with the correct entity types.

Both AddApi extension methods expose an options builder with which you can configure your API. In the example below the Application API route will become /open-id-api/application and the endpoints exposed in that route will require an access token with the my_application_access_scope scope.

serviceCollection.AddOpenIddict().AddCore(options =>
{
    options.UseEntityFrameworkCore()
        .UseDbContext<ApplicationDbContext>()
        .AddApi<OpenIdApplication, OpenIdAuthorization, OpenIdScope, OpenIdToken, long>(apiConfiguration =>
        {
            apiConfiguration.ApiRoutePrefix = "open-id-api";
            apiConfiguration.ApplicationApiRoute = "application";
            apiConfiguration.ApplicationApiAccessScope = "my_application_access_scope";
        });
});

Properties

Property	Default value	Description
ApiRoutePrefix	api/open-id	The prefix used in all the API routes.
ApplicationApiRoute	application	The Application API route.
ApplicationApiAccessScope	open_id_application_api_access	The access scope needed to access the Application endpoints.
AuthorizationApiRoute	authorization	The Authorization API route.
AuthorizationApiAccessScope	open_id_authorization_api_access	The access scope needed to access the Authorization endpoints.
ScopeApiRoute	scope	The Scope API route.
ScopeApiAccessScope	open_id_scope_api_access	The access scope needed to access the Scope endpoints.
TokenApiRoute	token	The Token API route.
TokenApiAccessScope	open_id_token_api_access	The access scope needed to access the Token endpoints.

Supported operations

Please find below an overview of the supported operations using the default route configuration.

Application

Method	Endpoint	Description	Parameters
GET	api/open-id/application	Returns all applications.
GET	api/open-id/application/{id}	Returns an application by ID.	string id
POST	api/open-id/application	Creates an application.	ApplicationCreateModel
PUT	api/open-id/application/{id}	Updates an application by ID.	string id & ApplicationUpdateModel
DELETE	api/open-id/application/{id}	Deletes an application by ID.	string id

Authorization

Method	Endpoint	Description	Parameters
GET	api/open-id/authorization	Returns all authorizations.
GET	api/open-id/application/{id}	Returns an authorization by ID.	string id

Scope

Method	Endpoint	Description	Parameters
GET	api/open-id/scope	Returns all scopes.
GET	api/open-id/scope/{id}	Returns a scope by ID.	string id
POST	api/open-id/scope	Creates a scope.	ScopeCreateModel
PUT	api/open-id/scope/{id}	Updates a scope by ID.	string id & ScopeUpdateModel
DELETE	api/open-id/scope/{id}	Deletes a scope by ID.	string id

Token

Method	Endpoint	Description	Parameters
GET	api/open-id/token	Returns all tokens.
GET	api/open-id/token/{id}	Returns a token by ID.	string id