--- title: "API kulcsok | Tajo" description: "Teljes útmutató a Brevo API kulcsos hitelesítéséhez" url: https://tajo.io/hu/docs/authentication/api-keys/ markdown: https://tajo.io/hu/docs/authentication/api-keys.md lang: hu-HU author: "Set Noa" author_url: https://tajo.io/hu/set-noa/ robots: noindex --- Kérj korai hozzáférést Adja meg keresztnevét és munkahelyi e-mail-címét. Küldünk egy hivatkozást, amellyel megerősítheti a Tajo-hozzáférési kérelmét. # API kulcsok [Set Noa](https://tajo.io/hu/set-noa/) Az API kulcsok a Brevo API elsődleges hitelesítési módszere. Egyszerű és biztonságos módot adnak arra, hogy programozottan érd el a fiókodat. ## Mik azok az API kulcsok? Az API kulcsok egyedi azonosítók, amelyek hitelesítik az alkalmazásodat, amikor kérést küld a Brevo API-nak. Minden kulcs egy 64 karakteres karakterlánc, amely egyszerre azonosító és jelszó. ``` Example API key: xkeysib-a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456-Ab1Cd2Ef3Gh4 ``` ## API kulcsok létrehozása ### Lépésről lépésre 1. **Jelentkezz be a Brevóba**: nyisd meg a [Brevo irányítópultot](https://app.brevo.com/) 2. **Menj a beállításokhoz**: kattints a profilodra → Settings 3. **Nyisd meg az API kulcsokat**: válaszd az “API Keys” menüpontot a bal oldali menüből 4. **Hozz létre új kulcsot**: kattints a “Generate a New API Key” gombra 5. **Nevezd el a kulcsot**: adj neki beszédes nevet (például “Production App”, “Development Testing”) 6. **Állítsd be a jogosultságokat**: válaszd ki a megfelelő hozzáférési szintet 7. **Generálás**: kattints a “Generate” gombra, és azonnal másold ki a kulcsot ### API kulcsok elnevezési konvenciói Használj beszédes neveket, amelyekből kiderül a kulcs célja: - `production-web-app` - `staging-environment` - `mobile-app-ios` - `webhook-listener` - `data-sync-service` ## API kulcsok típusai és jogosultságai ### Teljes hozzáférésű kulcsok ``` Permissions: All API endpoints Use cases: Complete application integration Risk level: High - protect carefully ``` ### Csak olvasható kulcsok ``` Permissions: GET requests only Use cases: Analytics, reporting, dashboards Risk level: Low - limited access ``` ### Csak küldésre szolgáló kulcsok ``` Permissions: Transactional email sending Use cases: Application notifications, receipts Risk level: Medium - can send emails ``` ### Kapcsolatkezelő kulcsok ``` Permissions: Contact CRUD operations Use cases: CRM integrations, form submissions Risk level: Medium - data modification ``` ## API kulcsok használata ### Hitelesítés fejlécben Tedd be az API kulcsodat az `api-key` fejlécbe: ```http GET /v3/account HTTP/1.1 Host: api.brevo.com Accept: application/json Content-Type: application/json api-key: YOUR_API_KEY ``` ### Kódpéldák #### JavaScript/Node.js ```javascript const brevo = require('@getbrevo/brevo'); const apiInstance = new brevo.AccountApi(); apiInstance.setApiKey(brevo.AccountApiApiKeys.apiKey, process.env.BREVO_API_KEY); // Make authenticated request apiInstance.getAccount() .then(data => console.log('Account info:', data)) .catch(error => console.error('Error:', error)); ``` #### Python ```python import sib_api_v3_sdk from sib_api_v3_sdk.rest import ApiException # Configure API key configuration = sib_api_v3_sdk.Configuration() configuration.api_key['api-key'] = 'YOUR_API_KEY' # Create API instance api_instance = sib_api_v3_sdk.AccountApi(sib_api_v3_sdk.ApiClient(configuration)) try: # Get account info api_response = api_instance.get_account() print(api_response) except ApiException as e: print("Exception when calling AccountApi->get_account: %s\n" % e) ``` #### PHP ```php setApiKey('api-key', 'YOUR_API_KEY'); // Create API instance $apiInstance = new SendinBlue\Client\Api\AccountApi( new GuzzleHttp\Client(), $config ); try { $result = $apiInstance->getAccount(); print_r($result); } catch (Exception $e) { echo 'Exception when calling AccountApi->getAccount: ', $e->getMessage(), PHP_EOL; } ?> ``` #### Ruby ```ruby require 'sib-api-v3-sdk' # Configure API key SibApiV3Sdk.configure do |config| config.api_key['api-key'] = 'YOUR_API_KEY' end # Create API instance api_instance = SibApiV3Sdk::AccountApi.new begin # Get account info result = api_instance.get_account puts result rescue SibApiV3Sdk::ApiError => e puts "Exception when calling AccountApi->get_account: #{e}" end ``` ## API kulcsok biztonsága ### Biztonságos tárolás **Környezeti változók** (ajánlott) ```bash # .env file BREVO_API_KEY=xkeysib-your-api-key-here # Usage in code const apiKey = process.env.BREVO_API_KEY; ``` **Felhős titokkezelők** - AWS Secrets Manager - Google Secret Manager - Azure Key Vault - HashiCorp Vault ### Biztonsági jó gyakorlatok 1. **Soha ne égesd bele a kulcsokat a kódba** ```javascript // ❌ Bad - hardcoded const apiKey = "xkeysib-a1b2c3d4..."; // ✅ Good - environment variable const apiKey = process.env.BREVO_API_KEY; ``` 2. **Használj külön kulcsot környezetenként** ``` Production: BREVO_API_KEY_PROD Staging: BREVO_API_KEY_STAGING Development: BREVO_API_KEY_DEV ``` 3. **Cseréld rendszeresen a kulcsokat** - Állíts be naptáremlékeztetőt a negyedéves cserére - Használj automatizálási eszközöket a kulcscseréhez - Legyen kész visszaállási terved 4. **Figyeld a kulcshasználatot** - Állíts be riasztásokat a szokatlan aktivitásra - Havonta nézd át a kulcshasználati naplókat - Kövesd a földrajzi hozzáférési mintákat ## Kulcskezelés ### Aktív kulcsok figyelése Kövesd az aktív kulcsaidat az irányítópulton: ``` Key Name: production-web-app Created: 2024-01-15 Last Used: 2024-01-20 14:30 UTC Requests Today: 1,247 Status: Active ``` ### A kulcscsere folyamata 1. **Generálj új kulcsot**: hozd létre a leváltó kulcsot 2. **Frissítsd a konfigurációt**: telepíts az új kulccsal 3. **Figyeld**: győződj meg róla, hogy az új kulcs jól működik 4. **Türelmi idő**: hagyd aktívan a régi kulcsot 24-48 órán át 5. **Vond vissza a régi kulcsot**: töröld az előző kulcsot ### Kulcs sürgős visszavonása Ha egy kulcs kikerült: 1. **Azonnali visszavonás**: töröld a kulcsot az irányítópultról 2. **Hozz létre pótlást**: azonnal generálj új kulcsot 3. **Frissítsd az alkalmazásokat**: mielőbb telepíts az új kulccsal 4. **Figyeld az aktivitást**: nézd meg, volt-e illetéktelen használat 5. **Incidensjelentés**: dokumentáld a biztonsági incidenst ## Kéréskorlátozás és API kulcsok A Brevo végpontonként korlátozza a kéréseket, nem naponta. Az általános szinten, amelyet minden csomag megkap, a `POST /v3/smtp/email` másodpercenként 1 000 kérést enged, a `/v3/contacts` végpontok másodpercenként 10-et és óránként 36 000-et, a saját korlát nélküli végpontok pedig óránként 100-at. A Professional és az Enterprise csomagok magasabb szinteket nyitnak meg. A teljes táblázatot lásd a [Kérési korlátok](https://tajo.io/hu/docs/rate-limits/) oldalon. ### Kéréskorlát-fejlécek ```http HTTP/1.1 200 OK x-sib-ratelimit-limit: 1000 x-sib-ratelimit-remaining: 750 x-sib-ratelimit-reset: 1 ``` ### A kéréskorlát kezelése ```javascript async function makeApiCall() { try { const response = await fetch(url, { headers }); if (response.status === 429) { // Seconds until the window resets const waitTime = Number(response.headers.get('x-sib-ratelimit-reset') || 1); console.log(`Rate limited. Waiting ${waitTime} seconds`); await new Promise(resolve => setTimeout(resolve, waitTime * 1000)); // Retry the request return makeApiCall(); } return response.json(); } catch (error) { console.error('API call failed:', error); throw error; } } ``` ## API kulcsok hibaelhárítása ### Gyakori hibaüzenetek **Érvénytelen API kulcs (401)** ```json { "code": "unauthorized", "message": "Invalid API key provided" } ``` **Elégtelen jogosultság (403)** ```json { "code": "permission_denied", "message": "API key does not have required permissions" } ``` **Kéréskorlát túllépve (429)** ```json { "code": "too_many_requests", "message": "Rate limit exceeded for API key" } ``` ### Hibakeresési ellenőrzőlista - A kulcs formátuma helyes (64 karakter) - Nincs benne felesleges szóköz vagy rejtett karakter - A kulcsnak megvannak a szükséges jogosultságai - A kulcs aktív (nincs visszavonva) - A kéréskorláton belül vagy - A megfelelő API végpontot használod - A fejlécek formátuma helyes ## Következő lépések - [Ismerd meg az OAuth 2.0-t](https://tajo.io/hu/docs/authentication/oauth/) - Értsd meg a JWT tokeneket - [Nézd meg a kéréskorlátokat](https://tajo.io/hu/docs/rate-limits/) - [Próbáld ki az SDK-kat](https://tajo.io/hu/docs/sdks-libraries/)