Skip to content

Credentials

What are credentials

To communicate with any GAIP endpoint, you need credentials from our platform. Once you create a project, you can issue credentials for it. You can create multiple credentials based on your needs and can issue or revoke/stop them anytime.

Types of credentials

There are two types of credentials:

  1. Project key and API key: Used for server-to-server communication.
  2. Client key: Used for client to server communication.

Both types of credentials can be used in any endpoints.

We will dive deeper in the use cases of two types of key in the integration steps.

Whitelisted domains

We recommend adding ‘whitelisted domains’ when creating credentials to enhance your project’s security. This ensures that only specified domains can call our endpoints using your credentials, preventing unauthorized access and reducing misuse.

Note

Please note that Gigalogy does not keep a copy of your API key, if you lose the key, create a new credential and Stop the credential with lost key.

Create credentials

Step 1 - Navigate to your project

Once you have created a project, to create a credential

  1. Go to the solution, where you have created the project
  2. Find the table "My Projects". Here all your projects of that solution will be listed
  3. Click on the project name to go inside the project. Note that depending on your project status, you might land on the "DETAILS" page or "SETUP" page. We will discuss that in a different tutorial. For now, only access the project following this steps

navigate_to_project_en

Step 2 - Navigate to your project setting page

Once inside the project, you will see tabs at the top, such as "DETAILS", "SETTINGS", "INSIGHTS", etc. Click on the "SETTINGS" tab.

click_settings_en

Step 3 - Create credentials

In the settings page, find the Section "Credentials". Click on the blue “Plus” (⊕) button on the right side of this section.

credential create button screenshot

Step 4 - Credential detail

In the pop-up, you need to fill in three fields:

  1. Credential Name: Provide a meaningful name for your credential, making it easy to identify or locate later.
  2. Credential Type: Choose between two types of credentials:
  3. Project and API Key: Best for server-to-server integrations. Avoid using this if there’s a risk of public exposure.
  4. Client Key: Suitable for client-to-server integrations, such as direct communication from your front-end to GAIP servers.
  5. Whitelisted Domain (Optional): You can whitelist specific domains to restrict where the credential can be used, adding an extra layer of security.

Click on the "Save" button to proceed

credential_detail_en

Step 5 - Save your credentials

On the next screen, you will see your credential. Note: This is the only time GAIP will display your credential. Please save it by downloading the JSON file or copying and pasting it to a secure location. Once saved, click "Close."

save_credentials_en

Now your credentials are ready and you can see it in the "Credentials" table under the project "SETTINGS" tab.

credential_ready_en

Note:

  • You can see if a credential is active or not under the "Status" column
  • You can stop a credential using the stop button under the "Actions" column.