Desktop Integration

Learn how to integrate 2GC CloudBridge with desktop applications, manage API tokens, and set up secure connections.

Desktop Integration Overview

Desktop integration allows you to connect your local applications to 2GC CloudBridge using secure API tokens. This enables seamless data synchronization, automated workflows, and enhanced productivity tools.

API Tokens

Secure authentication for desktop apps

Real-time Sync

Automatic data synchronization

Secure Connection

Encrypted communication channels

API Token Management

Creating API Tokens

Step-by-Step Process

  1. 1
    Access Token Management

    Go to Admin → API Tokens in the main navigation

  2. 2
    Click "Generate Token"

    Use the "Generate New Token" button

  3. 3
    Configure Token

    Set name, permissions, and expiration date

  4. 4
    Copy Token

    Copy the generated token immediately (it won't be shown again)

  5. 5
    Store Securely

    Save the token in your application's secure configuration

Token Permissions

Read Permissions

  • View users and profiles
  • Access organization data
  • Read analytics and reports
  • View system status

Write Permissions

  • Create and update users
  • Manage groups and permissions
  • Update organization settings
  • Execute workflows

Token Security

Security Best Practices

  • Never share tokens

    Keep API tokens confidential and never share them publicly

  • Use environment variables

    Store tokens in secure environment variables, not in code

  • Set expiration dates

    Always set reasonable expiration dates for tokens

  • Monitor usage

    Regularly check token usage and revoke unused tokens

Desktop Applications

Windows

Official 2GC CloudBridge desktop client for Windows.

• Windows 10/11 (64-bit)
• .NET Framework 4.8+
• 4GB RAM minimum
• 500MB free disk space

macOS

Native macOS application with full system integration.

• macOS 11.0+
• Apple Silicon or Intel
• 4GB RAM minimum
• 500MB free disk space

Integration Examples

Basic API Request

curl -X GET "https://api.2gc.ru/v1/users" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

JavaScript Example

const response = await fetch('https://api.2gc.ru/v1/users', {
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});
const users = await response.json();

Python Example

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.2gc.ru/v1/users', headers=headers)
users = response.json()

Common Issues

Token Authentication Failed

The API token is invalid or has expired.

Verify the token is correct and not expired
Check token permissions for the requested endpoint
Generate a new token if necessary

Connection Timeout

The application cannot connect to the API.

Check your internet connection
Verify firewall settings
Check if the API is available