Реализация

• Создание нового REST API

  а) В Консоли управления AWS в разделе сервисов приложений выберите Services (Сервисы), а затем – API Gateway.
  б) Выберите Create API (Создать API).
  в) Выберите New API (Новый API) и введите WildRydes в поле API Name (Имя API).
  г) Оставьте выбранным пункт Edge optimized (Оптимизирован для периферийного местоположения) в раскрывающемся списке Endpoint Type (Тип адреса). Примечание. Тип Edge optimized (Оптимизирован для периферийного местоположения) лучше всего подходит для доступа к публичным сервисам через Интернет. Региональные адреса используются, как правило, для API, доступ к которым осуществляется преимущественно из одного и того же региона AWS.
  д) Выберите Create API (Создать API).

• Создание средства авторизации пулов пользователей Cognito

  Amazon API Gateway может использовать токены JWT, возвращенные пулом пользователей Cognito для аутентификации вызовов API. На этом этапе мы настроим средство авторизации для API, чтобы использовать пул пользователей, созданный в модуле 2.

  В консоли Amazon API Gateway создайте новое средство авторизации пула пользователей Cognito для вашего API. Настройте его, используя сведения о пуле пользователей, созданном в предыдущем модуле. Можно протестировать конфигурацию в консоли, скопировав и вставив токен аутентификации после входа в систему на странице /signin.html текущего интернет-сайта.
  

  а) В созданном вами API выберите Authorizers (Средства авторизации).

  б) Выберите Create New Authorizer (Создать новое средство авторизации).

  в) Введите WildRydes в поле Authorizer name (Имя средства авторизации).

  г) В качестве типа выберите Cognito.

  д) Из раскрывающегося списка Region (Регион) в пункте Cognito User Pool (Пул пользователей Cognito) выберите регион, в котором был создан пул пользователей Cognito в модуле 2 (по умолчанию должен быть выбран текущий регион).

  е) Введите WildRydes (или иное имя, присвоенное пулу пользователей) в поле Cognito User Pool (Пул пользователей Cognito).

  ж) Введите Authorization (Авторизация) в поле Token Source (Источник токена).

  з) Нажмите кнопку Create (Создать).

  
  Проверьте конфигурацию средства авторизации

  к) Откройте новую вкладку браузера и перейдите на страницу /ride.html в домене веб-сайта.

  л) Если вы будете перенаправлены на страницу входа, войдите с помощью учетных данных пользователя, созданного при прохождении последнего модуля. После этого вы вернетесь на страницу /ride.html.

  м) Скопируйте токен авторизации из уведомления на странице /ride.html.

  н) Вернитесь на предыдущую вкладку, где только что было создано средство авторизации

  о) Нажмите Test (Тест) в нижней части карточки для средства авторизации.

  п) Вставьте токен авторизации в поле Authorization Token (Токен авторизации) во всплывающем диалоговом окне.

  р) Нажмите кнопку Test (Тест) и убедитесь, что для вашего пользователя возвращается код 200 и отображаются заявки.

• Создание нового ресурса и метода

  Создайте новый ресурс под именем /ride в вашем API. Затем создайте метод POST для этого ресурса и выполните необходимые настройки для использования интеграции прокси Lambda с функцией RequestUnicorn, созданной на первом этапе этого модуля.

  а) В меню навигации слева щелкните Resources (Ресурсы) под API WildRydes.

  б) В раскрывающемся списке Actions (Действия) выберите Create Resource (Создать ресурс).

  в) Введите ride в качестве значения параметра Resource Name (Имя ресурса).

  г) Убедитесь, что для параметра Resource Path (Путь ресурса) установлено значение ride.

  д) Выберите Enable API Gateway CORS (Включить API Gateway CORS) для ресурса.

  е) Нажмите Create Resource (Создать ресурс).

  ж) При выбранном вновь созданном ресурсе /ride из раскрывающегося списка Action (Действие) выберите Create Method (Создать метод).

  з) Выберите POST в появившемся новом раскрывающемся списке, а затем установите флажок.

  и) Выберите значение Lambda Function (Функция Lambda) в качестве типа интеграции.

  к) Установите флажок Use Lambda Proxy integration (Использовать интеграцию прокси Lambda).

  л) Выберите регион, заданный в качестве значения параметра Lambda Region (Регион Lambda).

  м) Введите имя функции, которую вы создали в предыдущем модуле (RequestUnicorn), в качестве значения параметра Lambda Function (Функция Lambda).

  н) Нажмите кнопку Save (Сохранить). Обратите внимание, что при возникновении ошибки, связанной с отсутствием функции, необходимо убедиться, что выбранный регион совпадает с регионом, который использовался в предыдущем модуле.

  о) При появлении запроса на предоставление Amazon API Gateway разрешения на вызов функции нажмите OK (ОК).

  п) Выберите карточку Method Request (Запрос метода).

  р) Нажмите значок карандаша рядом с пунктом Authorization (Авторизация).

  с) Выберите средство авторизации пула пользователей WildRydes Cognito в раскрывающемся списке и установите флажок.

• Развертывание собственного API

  В консоли Amazon API Gateway выберите пункт Actions (Действия), затем Deploy API (Развертывание API). Отобразится запрос создания нового этапа. В качестве имени этапа можно использовать имя prod.

  а) В раскрывающемся списке Actions (Действия) выберите пункт Deploy API (Развертывание API).
  б) Выберите пункт [New Stage] (Новый этап) в раскрывающемся списке Deployment stage (Этап развертывания).
  в) Введите prod в качестве значения параметра Stage Name (Имя этапа).
  г) Выберите Deploy (Развертывание).
  д) Запишите URL вызова. Он пригодится при выполнении задания из следующего раздела.
  

• Обновление конфигурации веб-сайта

  Обновите файл /js/config.js развернутого веб-сайта, добавив URL вызова для только что созданного этапа. Скопируйте URL вызова непосредственно из верхней части страницы редактора этапов в консоли Amazon API Gateway и вставьте его в ключ _config.api.invokeUrl файла веб-сайта /js/config.js. При обновлении файла конфигурации убедитесь, что в нем сохранились обновления для пула пользователей Cognito, внесенные в предыдущем модуле.

  а) Откройте файл config.js в текстовом редакторе.
  б) Обновите параметр invokeUrl ключа api в файле config.js. Задайте значение параметра Invoke URL (URL вызова) для этапа развертывания, созданного при работе над предыдущим разделом.

  Ниже приведен пример полного файла config.js. Не забывайте, что реальные значения в вашем файле будут отличаться от нашего примера.
  

  window._config = {
  
      cognito: {
  
          userPoolId: 'us-west-2_uXboG5pAb', // e.g. us-east-2_uXboG5pAb         
  
          userPoolClientId: '25ddkmj4v6hfsfvruhpfi7n4hv', // e.g. 25ddkmj4v6hfsfvruhpfi7n4hv
  
          region: 'us-west-2' // e.g. us-east-2 
  
      }, 
  
      api: { 
  
          invokeUrl: 'https://rc7nyt4tql.execute-api.us-west-2.amazonaws.com/prod' // e.g. https://rc7nyt4tql.execute-api.us-west-2.amazonaws.com/prod, 
  
      } 
  
  };

  в) Сохраните измененный файл и поместите его в репозиторий Git, чтобы выполнить его автоматическое развертывание на консоли Amplify.
  

  $ git push
  

• Проверка реализации

  Примечание. Возможно, после обновления файла config.js в корзине S3 контент в браузере обновится с некоторой задержкой. Кроме того, необходимо очистить кэш браузера перед выполнением следующих этапов.

  а) Перейдите на страницу /ride.html в домене веб-сайта.
  б) Если вы будете перенаправлены на страницу входа, войдите с помощью учетных данных пользователя, созданного при прохождении предыдущего модуля.
  в) После загрузки карты щелкните в любом месте карты, чтобы задать место подачи единорога.
  г) Нажмите Request Unicorn (Запросить поездку на единороге). На правой боковой панели отобразится уведомление о том, что единорог уже в пути, а затем значок единорога будет перемещаться к месту забора.