Locoia
Search…
Setting up authentication

Authentication Overview

We offer multiple authentication methods ranging from basic auth to Oauth2. Although often used in the same sentence, authentication and authorization are not the same. Authorization happens after your identity has been authenticated (confirmed to be who you are) by an app. Thus, you are authorized to get access to data, files and the like.

Hot to start setting up authentication?

In the side-menu of the app, click on ConnectorAuth to get to the authentication screen. Next click on the Add button in the upper left corner. Now you should see the below screen:
Select the Connector or Helper you want want to set auth up for - then:
    1.
    Enter a Name that describes the Connector or Helper as well as the environment e.g. DEV, Production or the like.
    2.
    Only enter an API Endpoint if the integration requires a subdomain or if you want to send request e.g. against an older version of the API. You can place the full URL of endpoints later in the FlowBuilder and don't have to do it here.
    3.
    In the Auth Type drop down, depending on whether we offer one or both authentication methods, you will only see those auth types that we offer. For e.g. the Rest helper we offer both, but most likely you will need basic_auth

Authentication with OAuth2

Let's suppose you select Slack. Enter the name and select oauth2 and then hit confirm:
Now you will be redirected to the Slack authentication screen that you may know from other apps. Review the content and click allow:

Authentication with Basic Auth for helpers

Basic Auth for Helpers e.g. REST Helper or CSV Helper

To setup basic auth for the REST Helper or CSV Helper, enter a name, select basic_auth and enter the full API token in the Auth token field.
If the token require a "Bearer " or "Basic " prefix enter it in full like this:
1
Bearer ey_my_secret_token
Copied!
or
1
Basic ey_my_secret_token
Copied!
The auth details field is usually not needed. Should your authentication require user:password base64 encoded, please combine the user:password as described, base64 encode it someone on your Computer / Mac and then enter the base64 encoded string with the prefix like this:
1
Basic my_base_64encoded_token
Copied!
Once all is entered, click Confirm and start using the Authentication in all of your automation flows. It is visible only on the Connector or Helper you set it up for.

Authentication with Basic Auth for Connectors

For connectors, basic auth is setup in the same way as for helpers, but we do the base64 encoding for you and safe you some work.
E.g. for Zendesk, which requires a subdomain, Enter the full domain including subdomain and trailing slash like:
1
https://my-company.zendesk.com/api/v2/
Copied!
Next enter the user-email associated to the Zendesk account in Auth Details.
Then enter your API-token non base64 encoded as it is. Locoia does the base64 encoding for you in the background.
Finally, hit confirm and start using the authentication in your flows in the FlowBuilder. It is visible only on the Connector or Helper you set it up for.

Authentication Tips & Tricks

Should an API, e.g. the Dropbox API has api.dropbox.com for regular API-calls and content.dropbox.com for all file-related API calls, have two endpoints, please create two ConnectorAuth, one for each endpoint. This allows you to have individual Base-Domains per each endpoint.
Last modified 26d ago