From b1160360de1b566d08ef9f6f75e6bf3e8deea3d2 Mon Sep 17 00:00:00 2001 From: Moe Katib Date: Fri, 5 Apr 2024 13:20:18 -0400 Subject: [PATCH] Added the initial readme file (#1) --- README.md | 185 +++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 177 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 315a3db2..6a07ad4e 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,179 @@ -# core +

+馃摉 Just launched IntegrationOS +
+

-Projects related to IntegrationOS platform: +

+ + + +

-- [API](./api) -- [Event Core](./event-core) -- [Gateway](./gateway) -- [Redis Retry](./redis-retry) -- [Google Token Fetcher](./google-token-fetcher) -- [Watchdog](./watchdog) +

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. + +# Get started + +To get the most out of this guide, you'll need: + +1. An [IntegrationOS account](https://app.integrationos.com) +2. Your IntegrationOS [API Key](https://docs.integrationos.com/docs/glossary#api-key) + +## Step 1: Backend - Create secure tokens + +First, we'll add an endpoint to our backend that'll let us generate secure tokens for our frontend component. + +### Install the SDK + +To make this easy, IntegrationOS offers native SDKs in several popular programming languages. This guide will use the popular AuthKit SDK for Node.js. + +```shell npm +npm install @integrationos/authkit-node +``` + +### Set secrets + +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. + +```shell +INTEGRATIONOS_SANDBOX_API_KEY='sk_test_example_123456789' +INTEGRATIONOS_PRODUCTION_API_KEY='sk_live_example_123456789' +``` + +### Create a token endpoint + +Next, we'll need to add the token endpoint which will exchange the authorization token (valid for 10 minutes) for an authenticated Connected Account. + +```javascript +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); + +}); +``` + +## Step 2: Frontend - Make AuthKit appear + +Next, we'll add the AuthKit component to your frontend application. + +### Install the React SDK + +In the same fashion, IntegrationOS offers native frontend SDKs in several popular frameworks. This guide will use the popular AuthKit SDK for React. + +```shell npm +npm install @integrationos/authkit-react +``` + +### Use the AuthKit Component + +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. + +```javascript +import { useAuthKit } from "@integrationos/authkit-react"; + +const { open } = useAuthKit({ + token: { + url: "https://api.your-company-name.com/authkit-token", + headers: {}, + }, + onSuccess: (connections) => {}, + onError: (error) => {}, + onClose: () => {}, +}); +``` + +### Launch the AuthKit flow + +With your client and server setup complete, you can now test the authentication flow by calling open(). + +```javascript + +``` + +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](https://docs.integrationos.com/docs/quickstart). + +# Running IntegrationOS locally + +## Prerequisites + +* [Docker](https://docs.docker.com/engine/) and [Docker Compose](https://docs.docker.com/compose/) +* A [Google Cloud KMS](https://cloud.google.com/kms/docs) key ring +* [`gcloud`](https://cloud.google.com/sdk/gcloud) installed and logged into an account with `roles/cloudkms.cryptoKeyEncrypterDecrypter` access + +## Setup + +1. Copy `.env-example` to `.env` and set the values + +2. Run the containers + + ```shell + docker-compose up -d + ``` + +3. Load seed data + + ```shell + 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 + + ```shell + source .env + docker-compose -f docker-compose.data.yml run migrate-before + docker-compose -f docker-compose.data.yml run migrate-after + ``` + +## Other actions + +Connecting to a MongoDB shell + +```shell +source .env +docker-compose exec mongo mongosh -u integrationos -p $MONGO_PASSWORD --authenticationDatabase=admin events-service +``` + + +# License + +IntegrationOS is released under the [**GPL-3.0 license**](LICENSE).