Credentials
How to obtain credentials used in the Connectors Ecosystem.
GL Connectors is a multi-tenant system that deals with multiple clients, where each client has their own sets of users. To understand more about the concepts of Clients, Users, and Integrations, please refer to HTTP Plugin Concepts to understand the relationship between them.
This guide utilizes CLI for guide on how to use the credentials and interact with the GL Connector Ecosystem. Please refer to the page for more details on comprehensive activities using the GL Connectors CLI. This page utilizes only the most basic of interactions necessary to deal with GL Connectors systems.
Console
There is an easy way to retrieve both Client Key and User Token. For starting out and for those who just want to experience or experiment with GL Connectors, we recommend checking the Console to retrieve the necessary values.
The documentation for utilizing the Console can be accessed here in Connectors Console
Client API Key
A Client API Key is used to identify which client is trying to connect to GL Connectors. Typically, this is in the form of sk-client-{random_string}.
How to obtain
Contact your team lead (typically those that dealt with GL Connectors first).
Contact GL Connectors Team (bosa-eng@gdplabs.id) and request for the generation of a key. Provide what team you want it for, what's the purpose for the key.
User
When you create a new user, the secret is only shown once. If you lose it, you must contact GL Connectors Team as we do not currently provide a way to reset the secret. We cannot restore or retrieve it for you, so we will have to reset it for you.
Creating a new User
After you get your API key, you need to create a new user. All you need to do is provide the username you want to create for in the CLI, using glcon users create {username} as follows. Remember that the secret is only shown once, so do not lose it!
$ glcon users create samuel
ℹ Creating user 'samuel'...
✓ User created successfully!
User Details
============
ℹ Username: samuel
⚠ The full user secret is only shown once and cannot be recovered.
ℹ Full secret: sk-user-secretLogin
In essence, this is equivalent to logging in, except the "password" is system-generated. To do so, all you need to do is do the command glcon auth login and you will be prompted with the Client Key, Username, and Secret.
User Token
After logging in following Login, you can now retrieve the token used for authentication. To retrieve this information, you simply need to go to the file provided glcon auth status as provided below
All the necessary information can be retrieved by accessing the file /home/user/.connector/config.json , or shortened to ~/.connector/config.json. Here is the easiest way you can retrieve both API Key and Tokens (only in Linux or Nix based systems):
Third Party Integration
Please refer to Integration Management to understand how we can initiate a new integration using the GL Connectors CLI, or Quickstart using GL Connectors SDK. You can also use the aforementioned Connectors Console for an easy way adding new integrations.
Last updated