In this week's newsletter I want to show you how to implement API Key authenticationin ASP.NET Core. This authentication approach uses an API Key to authenticate theclient of an API. You can pass the API Key to the API in a few ways, such as throughthe query string or a request header.
I will show you how to implement API Key authentication where the API key is passedin a request header. But the implementation would be similar if we were to use anyother approach.
When would you want to use API Key authentication? This kind of authenticationmechanism is common in Server-to-Server (S2S) communication. When your API servesrequest for other server-side applications to consume and integrate with. It'sless common in client-server communication scenarios.
Let's see how we can implement API Key authentication in ASP.NET Core!
Implementing API Key Authentication
We will start off by creating an attribute that we can place on endpointswhere we want to apply API Key authentication. It won't be any kind ofattribute, because we will use a ServiceFilterAttribute
.
What a ServiceFilterAttribute
allows us to do is specify a type for thefilter that will be created for that attribute.This means we can implement our authentication logic in an IAuthorizationFilter
.With a ServiceFilterAttribute
we also have support for dependency injectionin our IAuthorizationFilter
implementation.
Let's first define the ApiKeyAttribute
class:
public class ApiKeyAttribute : ServiceFilterAttribute{ public ApiKeyAttribute() : base(typeof(ApiKeyAuthorizationFilter)) { }}
In the ApiKeyAttribute
we specify ApiKeyAuthorizationFilter
class as thefilter that will be resolved from the DI container. Here's what it looks like:
public class ApiKeyAuthorizationFilter : IAuthorizationFilter{ private const string ApiKeyHeaderName = "X-API-Key"; private readonly IApiKeyValidator _apiKeyValidator; public ApiKeyAuthorizationFilter(IApiKeyValidator apiKeyValidator) { _apiKeyValidator = apiKeyValidator; } public void OnAuthorization(AuthorizationFilterContext context) { string apiKey = context.HttpContext.Request.Headers[ApiKeyHeaderName]; if (!_apiKeyValidator.IsValid(apiKey)) { context.Result = new UnauthorizedResult(); } }}
The implementation comes down to validating the API Key obtained fromthe header of the current request. If we determine that the API Keyis not valid, we set the value of AuthorizationFilterContext.Result
to a new instance of an UnauthorizedResult
.
And lastly, all that's left for us to do is implement our customvalidation logic for the API Key inside of ApiKeyValidator
:
public class ApiKeyValidator : IApiKeyValidator{ public bool IsValid(string apiKey) { // Implement logic for validating the API key. }}public interface IApiKeyValidator{ bool IsValid(string apiKey);}
The actual implementation for validating the API Key will vary basedon your use case, and where you are storing the API keys.For example, if you store the API keys in the database you would checkif the provided API Key exists in the database.If it exists, then validation passes.If it doesn't exist, then validation fails and we return anUnauthorizedResult
.
Registering Services With Dependency Injection
We have to make sure to register our ApiKeyAuthorizationFilter
andApiKeyValidator
services with the dependency injection container.
builder.Services.AddSingleton<ApiKeyAuthorizationFilter>();builder.Services.AddSingleton<IApiKeyValidator, ApiKeyValidator>();
This will register them as singleton services in our application.You can use a different service scope such as Transient
or Scoped
if you need to.
Applying API Key Authentication To Endpoints
Finally, with our API Key authentication in place, we can apply theApiKeyAttribute
attribute to our endpoints:
public class NewslettersController : ControllerBase{ [ApiKey] [HttpGet] public IActionResult Get() { // ... }}
In this case I'm applying the ApiKeyAttribute
to an endpoint, butyou can also apply it on the NewslettersController
and it will addauthentication to all the endpoints for that controller.
Next Steps
Now that you know how to implement API Key authentication, I think youshould also learn how to implement JWT authentication. And while you'reat it, why not throw authorization into the mix.
I made a few videos about JWT authentication and permission authorizationthat you should take a look at next: