Додавання конектора — це чотири поля і близько хвилини, і майже всі застрягають на одному й тому самому. Клієнт питає, як йому автентифікуватися, пропонує OAuth і заголовок запиту, а правильна відповідь — третій варіант, якого ніхто не чекає: ніяк.
Чому «ніяк» — правильно
Ключ уже в адресі. Конектор, спрямований на неї, спрямований на двері, що вже відчинені для всякого, хто має цей URL, тож OAuth нема чого владнувати. Оберіть OAuth усе одно — і клієнт піде шукати сервер авторизації, який ніколи не збирався відповідати; додайте заголовок bearer — і ви надіслали другий набір облікових даних серверові, який його не просив.
Це не обхід безпеки. Уся безпека зосереджена в одному місці — в адресі, — яку можна побачити, скопіювати, вставити й відкликати, замість потоку, про який доводиться вірити, що три сторони реалізували його правильно.
Куди натомість іде обережність
- Ставтеся до адреси як до облікових даних, бо вона ними і є. Їй місце в клієнті й більше ніде — не в спільному документі й не на знімку екрана ваших налаштувань.
- Створюйте по одному на клієнт, якщо хочете. Відкликання ключа вимикає лише конектори, збудовані на ньому.
- Користуйтеся вузькими адресами, коли в асистента одне завдання. Конектор, що вміє лише читати скриньку, не може помилково опублікувати допис у LinkedIn.
- Відкликайте одразу, якщо адреса витекла. Це миттєво, а створити іншу — секунда.
Друга половина відповіді
Відкриту адресу можна пережити тому, що те, що за нею, обережне саме по собі. Кампанія робить одну дію за хід і рахує денний бюджет за вже зробленими діями. Усе, що виходить під вашим іменем, чекає вашого «так». На паузу з боку LinkedIn відповідають паузою, а не повторними спробами, доки не вийде обмеження. Асистент із цією адресою все одно не змусить ваш обліковий запис робити двадцять речей за хвилину, бо тут ніщо на це не здатне.
Якщо запам'ятати один рядок із цього: коли клієнт спитає, як автентифікуватися, скажіть «ніяк» і залиште заголовки порожніми.
Часті запитання
Що робити, якщо клієнт не дає обрати «ніяк»?
Тоді йому потрібен заголовок, а не вхід під обліковим записом, і ключ кладуть туди: X-API-KEY, а адреса лишається простою, без ключа в шляху. Будь-який гідний клієнт пропонує «ніяк»; ті, що не пропонують, — зазвичай застарілі збірки, і оновитися — шлях коротший.
Один ключ на все чи по одному на кожного?
По одному на кожного, якщо клієнтів більше одного. Вони нічого не коштують, панель показує їх списком з часом останнього використання, і тоді відкликання одного вимикає один конектор, а не всі одразу.
Що відбувається в ту мить, коли я відкликаю ключ?
Усе, що на ньому збудовано, одразу перестає відповідати. Конектор, що лишився вказувати на відкликаний ключ, повідомляє, що в нього немає інструментів, — так само, як повідомляє конектор з одруківкою в адресі, — тож відкликайте свідомо й створюйте заміну раніше, ніж почнете шукати, що зламалося.