📖 Just launched IntegrationOS

Ship integrations, remarkably fast.

Website · Documentation · Changelog · Blog · Slack · Twitter

Stop wrestling with UI libraries, hacking together data models, and figuring out authentication. Start shipping native integrations that move your business forward.

Access realtime data from any integration using a single API Forget the pain of having to manually parse through, transform and maintain hundreds of data models. Now integrating bi-directional flows for a new integration is as simple as calling a single API.

To get the most out of this guide, you'll need:

1. An IntegrationOS account
2. Your IntegrationOS API Key

First, we'll add an endpoint to our backend that'll let us generate secure tokens for our frontend component.

To make this easy, IntegrationOS offers native SDKs in several popular programming languages. This guide will use the popular AuthKit SDK for Node.js.

npm install @integrationos/authkit-node

To make calls to IntegrationOS, provide your API key. Store these values as managed secrets and pass them to the SDKs either as environment variables or directly in your app's configuration depending on your preferences.

INTEGRATIONOS_SANDBOX_API_KEY='sk_test_example_123456789'
INTEGRATIONOS_PRODUCTION_API_KEY='sk_live_example_123456789'

Next, we'll need to add the token endpoint which will exchange the authorization token (valid for 10 minutes) for an authenticated Connected Account.

import { AuthKitToken } from "@integrationos/authkit-node";

app.post("/authkit-token", async (request, response) => {
  const authKitToken = new AuthKitToken(process.env.INTEGRATIONOS_SANDBOX_API_KEY);

// Specifying how the token will be constructed
  const token = await authKitToken.create({
    group: "org_123", // a meaningful identifier (i.e., organizationId)
    label: "Acme" // a human-friendly label (i.e., organizationName)
  });

  response.send(token);

});

Next, we'll add the AuthKit component to your frontend application.

In the same fashion, IntegrationOS offers native frontend SDKs in several popular frameworks. Compatible with React, Next.js, Vue, Svelte and more.

npm install @integrationos/authkit

Next, we need to add the AuthKit component and replace the token URL with the URL of the token endpoint URL you created in Step 1 of this guide.

import { useAuthKit } from "@integrationos/authkit";

const { open } = useAuthKit({
  token: {
    url: "https://api.your-company-name.com/authkit-token",
    headers: {},
  },
  onSuccess: (connection) => {},
  onError: (error) => {},
  onClose: () => {},
});

With your client and server setup complete, you can now test the authentication flow by calling open().

<button onClick={open}>Add new integration</button>

This will open the AuthKit modal so your user can:

• Select an integration to connect
• Be guided through the authentication flow
• Authorize data access

Once the flow is completed, AuthKit will return a Connection object to your onSuccess callback. Each connection object contains metadata about the connected account and can be used to make API requests.

View the full guide here.

• Docker and Docker Compose
• A Google Cloud KMS key ring
• gcloud installed, logged into an account that has roles/cloudkms.cryptoKeyEncrypterDecrypter access, and configured with Application Default Credentials

1. Copy .env-example to .env. Review and update the environment variables.

2. Run the containers

   docker-compose up -d

3. Load seed data

   source .env
   docker-compose exec mongo mongorestore --host localhost --nsFrom="seed_db.*" --nsTo="events-service.*" --authenticationDatabase admin -u integrationos -p $MONGO_PASSWORD /seed-data

4. Run migrations

   source .env
   docker-compose -f docker-compose.data.yml run --rm migrate-before
   docker-compose -f docker-compose.data.yml run --rm migrate-after

Connecting to a MongoDB shell

source .env
docker-compose exec mongo mongosh -u integrationos -p $MONGO_PASSWORD --authenticationDatabase=admin events-service

IntegrationOS is released under the GPL-3.0 license.