API Key Authentication with Unkey
Nextbase Ultimate comes with unkey configured.
Why use Unkey?
- Unkey is a service that allows you to create API keys for your users.
- It allows you to create API keys for your users without having to store them in your database.
- It allows you to revoke API keys for your users without having to update your database.
- Keys can be created for limited time periods too.
- The keys can then be used to authenticate your users to your API endpoints.
- Usage with Zapier, Make and Integromat are also now easy.
- Necessary env variables that you need for Unkey after creating an account there
This variable likely represents the root key associated with Unkey. It may be used for specific administrative or configuration purposes within Unkey.
This variable seems to be associated with an API ID in the context of Unkey. It may serve as an identifier for your Unkey API integration.
Steps for creating Unkey Root key
Creating an route handler which can be used with api key auth
- Import Unkey Middleware
withUnkeyAuthmiddleware from the Unkey package at the beginning of your route handler file.
- Implement the Route Handler Create your route handler logic, ensuring that it includes the withUnkeyAuth middleware. This middleware handles the API key authentication process.
Now, this route handler is protected, and only requests with valid API keys will be allowed to access it.
By following these steps, you can configure Unkey and create route handlers with API key authentication in your Nextbase project, ensuring secure and authenticated access to your protected routes.
To disable Unkey, you can either remove its middleware from your route handlers or adjust your configuration to bypass Unkey authentication.
Removing Unkey Middleware
In your route handler files, look for the import statement that includes Unkey middleware and remove or comment out the line.
Exposing routes which can be used with API key auth
To expose routes with API key authentication, follow these steps:
1. Import Unkey Middleware
In your route handler files, import the Unkey middleware (
withUnkeyAuth) at the beginning of the file. This middleware will handle the API key authentication process.
2. Use Unkey Middleware in Route Handlers
Apply the Unkey middleware to the routes you want to expose with API key authentication. Wrap your route handler logic with withUnkeyAuth:
By applying withUnkeyAuth to a route handler, you ensure that the route is protected and requires a valid API key for access.
(Bonus): Usage with Zapier
Since API key auth is now built in to Nextbase, configuring Zapier, Make or Integromat is now easy.
Zapier guide coming soon.