Автентифікація за допомогою API-токена

Кожна задокументована операція API потребує автентифікації. Передавайте API-токен із кабінету в заголовку Authorization:

Authorization: Bearer YOUR_API_TOKEN

Офіційні SDK читають токен із серверного середовища й додають цей заголовок до кожного запиту:

JavaScript

import { LTESocksClient } from '@ltesocks/sdk';

const client = LTESocksClient.withBearerToken(
  process.env.LTESOCKS_API_TOKEN,
  { language: 'en' },
);

Python

import os

from ltesocks_sdk import Client

client = Client.with_bearer_token(
    os.environ["LTESOCKS_API_TOKEN"],
    language="en",
)

PHP

<?php

use LTESocks\Client;

require __DIR__ . '/vendor/autoload.php';

$client = Client::builder()
    ->withBearerToken((string) getenv('LTESOCKS_API_TOKEN'))
    ->withLanguage('en')
    ->build();

Створення або скидання токена

1. Увійдіть до кабінету LTESocks.
2. Відкрийте Settings → Profile.
3. Знайдіть розділ API Token.
4. Створіть токен або скиньте його під час оновлення облікових даних.
5. Одразу скопіюйте нове значення та збережіть його як секрет.

Скидання токена робить попереднє значення недійсним. Оновіть усі серверні інтеграції до ротації або відразу після неї.

Лише для серверного використання

Поводьтеся з токеном як із паролем облікового запису:

• передавайте його через змінну середовища або менеджер секретів;
• використовуйте HTTPS і перевіряйте TLS-сертифікати;
• вилучайте Authorization із журналів застосунку та проксі;
• ніколи не розкривайте токен у клієнтському JavaScript;
• використовуйте окремий секрет розгортання для кожного середовища;
• змінюйте його після будь-якої підозри на витік.

Сумісність

Сервіс містить механізм сумісності зі старими форматами токенів. Нові інтеграції завжди мають використовувати задокументований заголовок Bearer.

Помилки автентифікації

Відсутній, неправильний, прострочений або скинутий токен спричиняє неуспішну відповідь. Обробляйте 401 як постійну помилку облікових даних: припиніть повторні спроби, сповістіть оператора й замініть секрет. Не створюйте токени автоматично з коду застосунку.