Поддержка API в Статические веб-приложения Azure со службой приложение Azure

служба приложение Azure — это управляемая платформа для размещения веб-приложений, которые выполняют код на серверах. служба приложение Azure поддерживает множество сред выполнения и платформ, включая Node.js, ASP.NET Core, PHP, Java и Python.

При связывании веб-приложения службы приложение Azure со статическим веб-приложением все запросы к статическому веб-приложению с маршрутом, начинающимся с /api того же маршрута в приложении службы приложение Azure.

По умолчанию, когда приложение Служба приложений связано со статическим веб-приложением, приложение Служба приложений принимает только запросы, которые используются через связанное статическое веб-приложение. Приложение службы приложение Azure может быть связано только с одним статическим веб-приложением одновременно.

Все планы размещения служб приложение Azure доступны для использования с Статические веб-приложения Azure.

Параметры API для Статические веб-приложения включают следующие службы Azure:

Дополнительные сведения см. в обзоре API.

Примечание.

Для интеграции со службой приложение Azure требуется план Статические веб-приложения Standard.

Интеграция серверной части не поддерживается в средах запросов на вытягивание Статические веб-приложения.

Необходимые компоненты

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

Ресурс Description
Служба приложений Azure Если у вас еще нет приложения, выполните действия, описанные в руководстве по созданию веб-приложения в Azure .
Существующее статическое веб-приложение Если у вас еще нет одного, выполните действия, описанные в руководстве по началу работы , чтобы создать статическое веб-приложение No Framework .

Пример

Рассмотрим существующий экземпляр службы приложение Azure, предоставляющий конечную точку через следующее расположение.

https://my-web-app.azurewebsites.net/api/getProducts

После установки связи вы можете получить доступ к той же конечной точке по пути api из статического веб-приложения, как показано в этом примере URL-адреса.

https://red-sea-123.azurestaticapps.net/api/getProducts

Оба URL-адреса указывают на одну конечную точку API. Конечная точка в Служба приложений должна иметь /api префикс, так как Статические веб-приложения соответствует запросам, сделанным /api и прокси-серверам, весь путь к связанному ресурсу.

Чтобы связать веб-приложение в качестве серверной части API для статического веб-приложения, выполните следующие действия.

  1. В портал Azure перейдите в статическое веб-приложение.

  2. Выберите API в меню навигации.

  3. Найдите среду, с которой нужно связать экземпляр Управление API. Выберите Ссылка.

  4. В типе ресурса серверной части выберите веб-приложение.

  5. В подписке выберите подписку, содержащую приложение службы приложение Azure, которое вы хотите связать.

  6. В имени ресурса выберите приложение службы приложение Azure.

  7. Выберите Ссылка.

По завершении процесса связывания запросы на маршруты, начинающиеся с/api, являются прокси-сервером связанного приложения Служба приложений.

Управление доступом к службе приложение Azure

Приложение Служба приложений настроено с именем Azure Static Web Apps (Linked) поставщика удостоверений, который разрешает только трафик, который осуществляется через статическое веб-приложение. Чтобы сделать приложение Служба приложений доступным для других приложений, обновите его конфигурацию проверки подлинности, чтобы добавить другого поставщика удостоверений или изменить параметры безопасности, чтобы разрешить доступ без проверки подлинности.

Чтобы отменить связь веб-приложения со статического веб-приложения, выполните следующие действия.

  1. В портал Azure перейдите в статическое веб-приложение.

  2. Выберите API в меню навигации.

  3. Найдите среду, которую вы хотите отменить связь, и выберите имя веб-приложения.

  4. Выберите "Отменить связь".

После завершения процесса отмены связи запросы на маршруты, начинающиеся с/api, больше не используются в приложении Служба приложений.

Примечание.

Чтобы предотвратить случайное предоставление приложения Служба приложений анонимному трафику, поставщик удостоверений, созданный процессом связывания, не удаляется автоматически. Вы можете удалить поставщика удостоверений с именем Статические веб-приложения Azure (связанная) из параметров проверки подлинности приложения Служба приложений.

Удаление проверки подлинности из ресурса Служба приложений

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

  1. В портал Azure перейдите к ресурсу Служба приложений.

  2. Выберите проверку подлинности в меню навигации .

  3. В списке поставщиков удостоверений удалите поставщик удостоверений, связанный с ресурсом Статические веб-приложения.

  4. Выберите "Удалить проверку подлинности", чтобы удалить проверку подлинности и разрешить анонимный трафик к ресурсу Служба приложений.

Теперь ресурс Служба приложений может получать анонимный трафик.

Следующие шаги