Добавление коннектора — это четыре поля и около минуты, и почти все застревают на одном и том же. Клиент спрашивает, как ему проходить аутентификацию, предлагает OAuth и заголовок запроса, а верный ответ — третий вариант, которого никто не ждёт: никак.
Почему «никак» — правильно
Ключ уже в адресе. Коннектор, направленный на него, направлен на дверь, которая уже открыта для всякого, у кого есть этот URL, поэтому OAuth больше нечего улаживать. Выберите OAuth всё равно — и клиент пойдёт искать сервер авторизации, который никогда не собирался отвечать; добавьте заголовок bearer — и вы отправили второй набор учётных данных серверу, который его не просил.
Это не обход безопасности. Вся безопасность сосредоточена в одном месте — в адресе, — который можно увидеть, скопировать, вставить и отозвать, вместо потока, о котором приходится верить, что три стороны реализовали его правильно.
Куда осторожность уходит вместо этого
- Относитесь к адресу как к учётным данным, потому что он ими и является. Ему место в клиенте и больше нигде — не в общем документе и не на скриншоте ваших настроек.
- Создавайте по одному на клиент, если хотите. Отзыв ключа выключает только коннекторы, построенные на нём.
- Используйте узкие адреса, когда у ассистента одна задача. Коннектор, который умеет только читать ящик, не может по ошибке опубликовать пост в LinkedIn.
- Отзывайте сразу, если адрес утёк. Это мгновенно, а создать другой — секунда.
Вторая половина ответа
Открытый адрес переживаем потому, что то, что за ним, осторожно само по себе. Кампания делает одно действие за ход и считает дневной бюджет по уже совершённым действиям. Всё, что выходит под вашим именем, ждёт вашего «да». На паузу со стороны LinkedIn отвечают паузой, а не повторными попытками, пока не получится ограничение. Ассистент с этим адресом всё равно не заставит ваш аккаунт делать двадцать вещей в минуту, потому что здесь ничто на это не способно.
Если запомнить одну строчку из всего этого: когда клиент спросит, как проходить аутентификацию, скажите «никак» и оставьте заголовки пустыми.
Частые вопросы
Что делать, если клиент не даёт выбрать «никак»?
Тогда ему нужен заголовок, а не вход под учётной записью, и ключ кладут туда: X-API-KEY, а адрес остаётся простым, без ключа в пути. Любой достойный клиент предлагает «никак»; те, что не предлагают, — обычно устаревшие сборки, и обновиться — путь короче.
Один ключ на всё или по одному на каждого?
По одному на каждого, если клиентов больше одного. Они ничего не стоят, панель показывает их списком с временем последнего использования, и тогда отзыв одного выключает один коннектор, а не все сразу.
Что происходит в ту секунду, когда я отзываю ключ?
Всё, что на нём построено, сразу перестаёт отвечать. Коннектор, оставшийся указывать на отозванный ключ, сообщает, что у него нет инструментов, — точно так же, как сообщает коннектор с опечаткой в адресе, — поэтому отзывайте осознанно и создавайте замену раньше, чем начнёте искать, что сломалось.