Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
Вы можете поручить общим потокам выполнять предварительную обработку стандартных запросов или постобработку ответов с помощью набора API. С помощью перехватчика потока вы подключаете общий поток, чтобы он выполнялся в одном и том же месте для всех прокси-серверов API, развернутых в определенной среде. Это дает вам отдельно реализованную и развернутую последовательность логики, которая не является частью кода реализации прокси.
Поскольку код, прикрепленный к перехватчику потока, находится вне контекста базовой логики прокси-сервера API, некоторые его действия отличаются от прокси-серверов API. Имейте в виду следующее:
- У вас должно быть разрешение на присоединение общего потока к перехватчику потока. Вы должны быть администратором организации.
- К каждому перехватчику потока можно прикрепить только один общий поток.
- Вы можете прикрепить один и тот же общий поток к нескольким перехватчикам потока.
- Если общий поток, прикрепленный к перехватчику потока, вызывает ошибку или возникают ошибки во время выполнения общего потока, сообщение будет отклонено, а ошибка будет отправлена обратно вызывающей стороне.
- Если сообщение будет отклонено во время выполнения перехватчика потока, подробности будут записаны в аналитику в контексте вызываемого прокси-сервера. Общий поток также может выдать ошибку с помощью специального кода и сообщения об ошибке.
В следующем видео показано, как подключить общий поток к перехватчику потока, а затем отследить его в классическом пользовательском интерфейсе Edge.
В следующем видео показано, как подключить общий поток к перехватчику потока, а затем отследить его в пользовательском интерфейсе New Edge.
Общий поток, подключенный к прокси-серверу через перехватчик потока, обеспечивает отличное место для логики, обеспечивающей соблюдение широких требований политики. Например, представьте, что у вас есть одна команда, управляющая одним набором требований безопасности для нескольких команд, представляющих разные направления бизнеса (LOB). Каждая команда бизнес-специалистов может разрабатывать API в соответствии со своими требованиями без необходимости учитывать более широкие требования безопасности. Команда безопасности может реализовать эти требования безопасности в общем потоке, а затем подключить поток к среде Apigee Edge с помощью перехватчика потока. Поскольку общий поток не является частью прокси-кода, группа безопасности может при необходимости вносить в него изменения, не вмешиваясь в LOB-код.
Общие потоки, подключенные через перехватчики потока, выполняются в этой позиции для каждого прокси-сервера API, развернутого в среде перехватчика прокси . По этой причине возможность использовать перехватчики потока доступна только администраторам организации Apigee Edge.
Дополнительные сведения об общих потоках см. в разделе Многоразовые общие потоки .
Вы прикрепляете общий поток к перехватчику потока с помощью консоли управления Apigee Edge. Вы можете прикрепить не более одного общего потока к перехватчику потока в каждом из следующих мест:
- Перехватчик потока перед прокси-сервером для логики, которую необходимо реализовать ДО того, как будет выполнена конечная точка прокси-сервера.
Например, у вас может быть логика для обеспечения безопасности всех API в среде.
- Предварительно целевой Flow Hook для логики, которую необходимо реализовать ДО вызова цели.
Например, вы можете реализовать ведение журнала до того, как запрос достигнет серверной части. Вы также можете обеспечить посредничество, удалив определенные поля из запроса.
- Перехватчик потока после целевого объекта для логики, которую необходимо реализовать ПОСЛЕ выполнения целевого ответа.
Это будет применено сразу после получения ответа от серверной части. Вы можете использовать его для регистрации ответа серверной части или выполнить некоторое посредничество, удалив конфиденциальные поля из ответа серверной части.
- Перехватчик потока пост-прокси для логики, которую необходимо реализовать ПОСЛЕ конечной точки прокси-сервера и непосредственно перед отправкой ответа клиенту.
Это может включать в себя некоторую логику применения CORS, регистрацию ответа или выполнение какого-либо коллажа или форматирования.
Присоединение общего потока к перехватчику потока
Чтобы прикрепить общий поток к перехватчику потока, вы должны быть администратором в организации, содержащей общий поток.
- Откройте страницу Flow Hooks, как описано ниже.
Край
Чтобы получить доступ к странице Flow Hooks с помощью пользовательского интерфейса Edge:
- Войдите на сайт apigee.com/edge .
- Выберите организацию, в которой находится ваш общий поток. См. Переключение между организациями .
Общий поток будет доступен любым прокси-серверам API и общим потокам, развернутым в среде этой организации. Он не будет доступен за пределами этой организации.
- Выберите «Администрирование» > «Среды» > «Flow Hooks» на левой панели навигации.
Классический Edge (частное облако)
Чтобы получить доступ к странице Flow Hooks с помощью классического пользовательского интерфейса Edge:
- Войдите в систему по
http:// ms-ip :9000, где ms-ip — это IP-адрес или DNS-имя узла сервера управления. - Выберите организацию, в которой находится ваш общий поток. См. Переключение между организациями .
Общий поток будет доступен любым прокси-серверам API и общим потокам, развернутым в среде этой организации. Он не будет доступен за пределами этой организации.
- Выберите API > Конфигурация среды > Flow Hooks на верхней панели навигации.
- В списке перехватчиков потока определите перехватчик потока, к которому вы хотите присоединить общий поток, в зависимости от того, где вы хотите, чтобы общий поток выполнялся.
Расположение крюка потока Описание Перехватчик потока перед прокси ПЕРЕД выполнением конечной точки прокси Предварительный целевой крючок потока ПЕРЕД выполнением целевой конечной точки Крючок потока после цели ПОСЛЕ выполнения целевого ответа Перехватчик потока после прокси ПОСЛЕ конечной точки прокси и прямо перед отправкой ответа клиенту - Наведите курсор на перехватчик потока в списке, чтобы отобразить столбец действий.
- Нажмите
. - В диалоговом окне «Общий поток» выберите общий поток, который вы хотите подключить, в раскрывающемся списке «Общий поток» .
- Нажмите ОК .
- При необходимости прикрепите общие потоки к другим перехватчикам потоков.