Kalitlarni yangilash

Mijoz sirini va API kalitini yangilash

Panelda kalitlarni yangilashning bitta amali bor va u ikkala kalitni — secret va api_keyni — bir vaqtda almashtiradi. Secret sizib chiqqanda yoki xavfsizlik siyosatingiz talab qilsa, jadval bo'yicha ishlating.

• Ishlab chiquvchi ilovasi: Mening ilovalarim → ilova → Kalitlar bo'limida Kalitlarni qayta chiqarishni bosing va Qayta chiqarish bilan tasdiqlang.
• Oddiy custom integratsiya: integratsiya oynasida O'zgartirishni bosing, Marketplace blokida Secret'ni yangilash → Baribir yangilash.

Yangi secret va API kalit o'sha joyda bir marta ko'rsatiladi — ikkalasini darhol nusxalang (Kalitlar bo'limida so'ng Kalitlarni saqladimni bosing). Sahifani yangilagach yoki oynani yopgach panel ularni qayta ko'rsatmaydi.

Ikkala tugma ham quyidagi so'rovni yuboradi.

Request

POST /admin/settings/integration/custom/regenerate-secret
Authorization: Bearer <your Bito session token>
Content-Type: application/json

{ "_id": "6712f0a9c4d1e87b3a0f1122" }

Response

{
    "code": 0,
    "message": "Success",
    "data": {
        "secret": "b81d47f2c095a6e3801fd2b7c46e9a35107fe2d84bc613905af7e28d1c60b493",
        "api_key": "acme:9f14c0f7a2b34d5e8c7190af2e5b6d3c",
        "secret_rotated_at": "2025-01-15T10:30:00.000Z",
        "api_key_rotated_at": "2025-01-15T10:30:00.000Z"
    },
    "time": "2025-01-15T10:30:00.000Z"
}

Yangi secret bilan birga yangi API kalitni ham saqlang — eski kalit javob qaytishi bilanoq ishlamay qoladi.

WARNING

Secret yangilanishi barcha mijozlarni uzib qo'yadi. Yangi secret berilgan zahoti:

• eski secret bilan berilgan barcha access tokenlar integratsiya o'rnatilgan barcha akkauntlarda ishlamay qoladi — faqat sizning akkauntingizda emas;
• barcha refresh tokenlar ishlamaydi, chunki yangilash uchun joriy secret kerak;
• eski secret bilan imzolangan vidjet tokenlari tekshiruvdan o'tmaydi;
• barcha akkauntlardagi ma'lumot webhooklari va o'rnatish/o'chirish hooklari endi yangi secret bilan imzolanadi. Mijozlar qaytadan ulanishi kerak bo'ladi. Secret yangilashni rejalashtirilgan to'xtash sifatida ko'ring: avval yangi secret'ni serverlaringizga chiqaring, keyin Bito'da yangilang.

Faqat API kalitini yangilash

Panelda faqat API kalitini yangilaydigan tugma yo'q. Buni faqat API orqali qilish mumkin: /admin/settings/integration/custom/update so'roviga regenerate_api_key: true yuboring. Eski kalit darhol ishlamay qoladi, secret esa o'zgarmaydi.

INFO

Kartochka tekshiruvda (pending) turganda custom/update — jumladan regenerate_api_key va IP ro'yxatini o'zgartirish — AlreadyInReview xatosi bilan rad etiladi. Tekshiruv tugashini kuting yoki kartochkani qaytarib oling. regenerate-secret bu cheklovga tushmaydi.