🚀 Продолжаю делиться опытом эксплуатации межсервисной авторизации. И теперь от технических особенностей я перейду к продуктовым, а именно расскажу о взаимодействии с пользователями в момент интеграции.
Стоит исходить из того, что у разработчиков полно задач, планов и целей по своим проектам. Если просто прийти к ним и сказать «эй, псс, вот классная кучерявая штука», то не стоит удивляться, что не каждый сразу побежит это внедрять. В этой части нужно оказать максимально возможную помощь. И неплохо себя показал подход с генерацией
auth.toml.
С помощью source graph мы запустили генератор auth.toml на нескольких наиболее значимых сервисах. Source graph для каждого сервиса запускает генерацию файла и создает pull request. В auth.toml зашили мини инструкцию а-ля Quick start. Разработчикам осталось только вмержить (или скорректировать auth.toml под свои пожелания и потом всё равно вмержить). Таким образом, мы снизили трудозатраты пользователей до самого минимума.
Ещё хорошо показало себя версионирование auth.toml на первых этапах жизни проекта. Оно позволяет плавно и точечно внедрять новый функционал, не ломая разом всё. А возможности source graph помогут рассылать обновления на нужные сервисы (или на всех).
В итоге, работу с пользователями я бы вынес на передний план большинства проектов, даже внутренних. В этой части очень легко свести на «нет» все усилия, если неправильно преподнести продукт и не помогать с ним в начале работы.
#avitoteam