Поделиться через

Устранение неполадок с конфигурацией OAuth

OAuth 2.0 — это безопасный, но сложный шаблон аутентификации. Многие клиенты сообщают о проблемах OAuth с их пользовательскими соединителями, потому что их службы не реализуют его правильно. Устранение этих проблем носит технический характер, и вам может помочь знание того, как работает OAuth.

Подробнее об OAuth 2.0:

Ограничения

  • APIHub поддерживает только метод код авторизации конфигурации OAuth 2.0.
  • Шлюзы не поддерживают Microsoft Entra ID или OAuth.

Признаки

  • Соединение не работает после X количества времени (где X стабильно).
  • 401 ошибка авторизации возвращается, когда пользовательский соединитель использует OAuth.

Устранение неполадок в потоке OAuth

Проблема почти всегда связана с конфигурацией пользовательского соединителя или используемой вами сторонней службы. Первый шаг — пройти через поток OAuth со сторонней службой через Postman:

  1. Вызовите токен конечной точки, используя тот же идентификатор клиента, секрет клиента и URI перенаправления (если он используется), что и пользовательский соединитель.

    • Убедитесь, что конечная точка возвращает маркер доступа.
    • Возвращает ли конечная точка маркер обновления? Если нет, убедитесь, что срок действия маркера доступа не истек.

  2. Вызовите действие API, используя файл маркер доступа.

    • Убедитесь, что маркер находится внутри заголовка Авторизация с префиксом "bearer". Ниже приведен пример от Postman:

      Снимок экрана заголовка Авторизация в Postman.

    • Убедитесь, что ответ успешен и действие выполнено успешно.

  3. Если у вас есть маркер доступа с истекающим сроком действия, вызовите URL-адрес обновления с маркером обновления (или маркером доступа, если у вас нет маркера обновления). Подробнее о токенах обновления можно узнать на платформе удостоверений Microsoft.

    • Убедитесь, что возвращается новый маркер доступа.
    • Если срок действия маркера обновления истек, убедитесь, что возвращается новый маркер обновления.

  4. Вызовите API с новым маркером доступа, как на шаге 2.

    • Проверьте успешность ответа.

  5. Если вы проверили шаги с 1 по 4, проверьте пользовательский соединитель:

    • Убедитесь, что идентификатор клиента совпадает с идентификатором клиента, использованным на шаге 1.
    • Убедитесь, что секрет клиента тот же.
    • Убедитесь, что URL-адрес маркера тот же.
    • Убедитесь, что URL-адрес обновления тот же или, если он не используется, убедитесь, что он совпадает с URL-адресом маркера на этом шаге.

    Предоставление отзыва

    Мы очень ценим отзывы о проблемах с нашей платформой соединителей и новые идеи о функциях. Чтобы оставить отзыв, выберите пункт Сообщить о проблемах или получить помощь с соединителями и выберите тип отзыва.