Develop a custom app with managed authPartner Solution
As this feature is at its very early stage, we expect bugs and breaking changes. We will cover this as part of our partnership agreement.
In this guide, we'll show you how you can develop and deploy a custom app for your business so that it can offer a seamless experience for your business users.
Create a role for your application
We encourage the use of a common language between developers and business to simplify things. If you're a developer, check with your manager to figure out "which business function will be using this application?".
Currently you need to have Administrator access level to manage roles for a workspace. For Kinetics Partners, please reach out to us for bypassing this check when developing for your clients.
To keep things simple, let's create a role for Marketing in this example.
Go to Settings → General / Members → Manage Roles → Create Role, fill
out the details and save the changes. After successfully creating a role, take a note of the role ID
(in this case it's
marketing) because we will need this later.
Assign the role
Select the member to perform the changes, and click on the role to toggle the assignment.
Start a local development server
Currently we only support
single-spa apps, but we are looking to remove the dependency and making
it even easier for developers to plug in their apps.
Next, we will create a microfrontend application by follow the guides at https://single-spa.js.org/docs/ecosystem-react or checking out the example directly at https://github.com/kinetics-dev/kinetics/tree/main/examples/using-single-spa-react-netlify
Using the example,
- Start the example by running
- Use localtunnel to expose our dev-server
lt -p 8080
- Follow the localtunnel URL - note that you need to confirm the usage
- After that, you should see the
- Use the values from this page to create our placeholder application
Create a placeholder for the application
If you haven't deployed the first commit you can use any values for the
Follow the steps in Adding a Custom Micro-frontend App to add this application in Kinetics. Note that we have used the placeholder values from the previous step.
Launch into the app
You should now see the app mounted and you can now start developing your app as usual!
From here the solution is completely at your own hand. You can decide what to do with the
token which is passed onto your frontend application as a variable.
As a simple guide, all we have done is to provide "managed authentication" therefore skipping the need for you to build login form etc. from scratch over and over again. You should still protect your API with your security considerations.
Here is another example of developing a NestJS backend with Kinetics managed authentication and authorisation. https://github.com/kinetics-dev/kinetics/tree/feature/add-nestjs-kinetics-integration-example/examples/using-nestjs