Nastavenie autentifikácie

Brevo ponúka dve metódy autentifikácie podľa toho, na čo ho používate: autentifikáciu cez API kľúč pre štandardný prístup k API a autentifikáciu cez MCP token pre AI integrácie. Táto príručka pokrýva obe metódy.

Autentifikácia cez API kľúč

API kľúče Brevo slúžia na štandardný prístup cez REST API ku všetkým službám Brevo.

Vygenerovanie API kľúča

1. Prihláste sa do svojho Brevo dashboardu
2. Prejdite na Settings → API Keys
3. Kliknite na Generate a New API Key
4. Dajte kľúču výstižný názov (napríklad “My App Production”)
5. Skopírujte a bezpečne uložte kľúč (druhýkrát sa Vám už nezobrazí)

Osvedčené postupy pre bezpečnosť API kľúčov

✅ ROBTE

• Ukladajte kľúče bezpečne pomocou premenných prostredia
• Používajte odlišné kľúče pre vývoj a produkciu
• Pravidelne kľúče obmieňajte (odporúčame každých 90 dní)
• Obmedzte oprávnenia kľúča len na to, čo je nevyhnutné
• Sledujte využitie kľúča vo svojom dashboarde

❌ NEROBTE

• Nikdy nevkladajte kľúče do systému správy verzií
• Nezapisujte kľúče natvrdo do aplikácie
• Nezdieľajte kľúče e-mailom ani cez chat
• Nepoužívajte produkčné kľúče na testovanie

Premenné prostredia

Ukladajte svoje API kľúče ako premenné prostredia:

Linux/macOS (.bashrc alebo .zshrc)

export BREVO_API_KEY="your_api_key_here"

Windows (Command Prompt)

set BREVO_API_KEY=your_api_key_here

Node.js (súbor .env)

BREVO_API_KEY=your_api_key_here

// Load from environment
const apiKey = process.env.BREVO_API_KEY;

Python

import os

api_key = os.getenv('BREVO_API_KEY')

PHP

$apiKey = $_ENV['BREVO_API_KEY'];
// or
$apiKey = getenv('BREVO_API_KEY');

Hlavičky autentifikácie

Svoj API kľúč vložte do hlavičiek požiadavky:

Štandardný formát hlavičky

GET /v3/account HTTP/1.1
Host: api.brevo.com
Accept: application/json
api-key: your_api_key_here

Príklad v JavaScripte

const headers = {
  'Accept': 'application/json',
  'api-key': process.env.BREVO_API_KEY
};

fetch('https://api.brevo.com/v3/account', { headers })
  .then(response => response.json())
  .then(data => console.log(data));

Python Requests

import requests

headers = {
    'Accept': 'application/json',
    'api-key': os.getenv('BREVO_API_KEY')
}

response = requests.get('https://api.brevo.com/v3/account', headers=headers)

Oprávnenia a rozsahy kľúčov

Rôzne API kľúče môžu mať rôzne oprávnenia:

• Len na čítanie: povolené sú iba požiadavky GET
• Odosielanie e-mailov: oprávnenia pre transakčné e-maily
• Správa kontaktov: vytváranie, aktualizácia a mazanie kontaktov
• Správa kampaní: vytváranie a odosielanie kampaní
• Plný prístup: všetky endpointy API

Otestovanie autentifikácie

Pomocou tohto endpointu si overíte, či Vaša autentifikácia funguje:

curl -X GET "https://api.brevo.com/v3/account" \
  -H "Accept: application/json" \
  -H "api-key: $BREVO_API_KEY"

Úspešná odpoveď (200 OK):

{
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe"
}

Chyba autentifikácie (401 Unauthorized):

{
  "code": "unauthorized",
  "message": "Invalid API key provided"
}

Obmena kľúča

Ako obmeniť API kľúč:

1. Vygenerujte nový kľúč v dashboarde
2. Aktualizujte premenné prostredia novým kľúčom
3. Nasaďte aplikáciu s novým kľúčom
4. Dôkladne otestujte, či všetko funguje
5. Zrušte starý kľúč, keď si budete novým istí

Sledovanie využitia API kľúča

Využitie svojho API kľúča sledujte v Brevo dashboarde:

• Počet požiadaviek za deň/mesiac
• Chybovosť podľa endpointu
• Geografické vzorce používania
• Časy najvyššej záťaže

Stratégia viacerých API kľúčov

Pri väčších aplikáciách zvážte použitie viacerých API kľúčov:

• Produkcia: reálne zákaznícke dáta a e-maily
• Staging: testovanie pred nasadením
• Vývoj: lokálny vývoj a testovanie
• Monitoring: kontroly stavu a metriky
• Tretie strany: externé integrácie

Autentifikácia cez MCP token

Brevo Model Context Protocol (MCP) je framework pre AI integrácie, ktorý umožňuje AI asistentom pracovať so službami Brevo. MCP používa samostatnú metódu autentifikácie prostredníctvom MCP tokenov.

Čo je MCP?

MCP poskytuje štandardizovaný prístup AI k rozhraniam Brevo API cez:

• Prenos: HTTPS
• Základná URL: https://mcp.brevo.com/v1/
• Formát odpovede: JSON
• Autentifikácia: MCP token (odlišný od API kľúčov)

Vygenerovanie MCP tokenu

1. Prihláste sa do svojho Brevo dashboardu
2. Prejdite na Settings → MCP Tokens (alebo do nastavení účtu)
3. Vygenerujte nový MCP token
4. Skopírujte a bezpečne uložte token

Poznámka: MCP je momentálne dostupné len pre používateľov v režime skorého prístupu.

Používanie MCP tokenov

MCP tokeny slúžia špecificky pre AI integrácie a pripojenia cez Model Context Protocol:

export BREVO_MCP_TOKEN="your_mcp_token_here"

MCP token vložte do požiadaviek smerujúcich na MCP endpointy:

GET /v1/account HTTP/1.1
Host: mcp.brevo.com
Accept: application/json
Authorization: Bearer your_mcp_token_here

MCP verzus API kľúč

Osvedčené postupy pre bezpečnosť MCP

• Ukladajte MCP tokeny oddelene od API kľúčov
• Na uloženie tokenov používajte premenné prostredia
• Tokeny pravidelne obmieňajte
• Nikdy nevkladajte tokeny do systému správy verzií
• Sledujte využitie MCP vo svojom dashboarde

Riešenie problémov s autentifikáciou

Bežné problémy s API kľúčmi

Neplatný formát API kľúča

• Kľúče musia mať presne 64 znakov
• Skontrolujte, či tam nie sú medzery navyše alebo iné znaky

Chyba oprávnení

• Overte, či má Váš kľúč potrebné oprávnenia
• Skontrolujte, či je kľúč vo Vašom dashboarde aktívny

Obmedzenie počtu požiadaviek

• Neúspešné pokusy o autentifikáciu sa počítajú do limitu požiadaviek
• Pred ďalším pokusom so správnymi údajmi chvíľu počkajte

Geografické obmedzenia

• Niektoré účty majú obmedzenia podľa IP adries
• Ak potrebujete pridať IP adresy na zoznam povolených, obráťte sa na podporu

Bežné problémy s MCP tokenmi

MCP nie je dostupné

• Uistite sa, že máte skorý prístup k funkciám MCP
• O prístup požiadajte podporu Brevo

Neplatný token

• Overte, či je token skopírovaný správne a bez medzier
• Skontrolujte, či tokenu neuplynula platnosť a či nebol zrušený

Nesprávna základná URL

• MCP tokeny fungujú iba s mcp.brevo.com
• Nepoužívajte MCP tokeny na endpointoch api.brevo.com

Ďalšie kroky

• Prečítajte si o limitoch požiadaviek
• Nainštalujte si SDK
• Uskutočnite svoje prvé API volanie