Automated User Logins

Background and Overview

To understand what this functionality addresses, we must first understand OAuth. Many services utilize OAuth as a means to allow 3rd party services to become authorized to consume a user's information. For example, if you log in with Facebook on another website, you are using the OAuth protocol. OAuth is simply a protocol to grant access to information which otherwise is private.

The important takeaway here is that this requires a browser to accomplish. Therefore any time one needs to activate a conduit with a 3rd party service (utilizing OAuth), they are required to enter a browser and enter credentials so that permission can be granted to the 3rd party service's information.

This is certain functionality which automates the login of users with supported 3rd party integrations by automating the browser aspect of logging in. This allows for a now programmatic interface to a once manual process.

How It Works

To enable this process, one simply needs to create an activation using the details prescribed under Implementation. This feature does the following:

• Exposes a programatic means of creating conduit activations
• If it is determined that an activation fails (which can occur due to unforeseen issues, e.g. network downtime, service downtime, etc.), this process is automatically kicked off in the background to re-activate the activation using the stored credentials.

FAQ

• Where are credentials stored?
  • Credentials passed in request are saved within the context of the activation that will be created.
• How do I delete credentials from Droplit?
  • Delete conduit activation

Use Cases

The reason for this functionality is twofold:

1. If an activation fails due to an unforeseen error, for example a network issue or service downtime, this automates the re-activation process which would otherwise be manual.
2. When many user accounts are being managed, it is incredibly cumbersome to individually activate environments. This provides a programmatic means to activate conduits within environments (and keep them activated)

Implementation

Endpoint

POST https://droplit.io/api/conduits/:id/conduit-activations/credentials

Body

It is important to note different conduits have different body requirements. Please reference supported conduits table (below) view body requirements.

{
    user?: string,
    passphrase?: string,
    environment: string
}

Supported Conduits and Requirements

This document requires dramatic polishing. Please direct any questions on this topic to [email protected]