使用Jakarta EE对RESTful Web服务进行认证保护

webdev@eclipse-foundation.org (Eclipse Foundation) — Fri, 29 Sep 2023 00:00:00 +0000

本指南向您展示如何使用Jakarta Authentication对RESTful服务进行访问认证。

在我们深入探讨如何对RESTful Web服务进行认证之前，让我们首先概述一下本篇文章中的使用场景。

我们构建一个RESTful Web 服务，该服务通过http://localhost:8080/jakartaee-hello-world/rest/hello的HTTP GET方法进行访问，正常情况下请求会得到如下响应：

{
  "hello": "world"
}

在本文中，我们将重点介绍对这个服务进行访问认证保护，这里只是个简单的样例，实际生产中需要进一步增强逻辑以满足更复杂的需求。

通过一个简单样例，我们可以更好地了解如何使用Jakarta EE对RESTful Web 服务进行认证保护所涉及的基本步骤。如果您对RESTful Web 服务还不了解，请阅读我之前的文章如何构建RESTful Web服务。

准备开发环境：

安装Java开发工具包（JDK）。请确保您拥有Java SE 11或更高版本（我们已使用Java SE 11和Java SE 17进行了测试）。您可以选择任何您喜欢的供应商发行版，也可以从Adoptium获取。
安装支持Jakarta EE的应用程序服务器。您可以下载任何与Jakarta EE兼容的产品。
安装Maven 3或更高版本。

我们可以使用SDKMan安装JDK和Maven，可以按照如何操作指南中提到的步骤进行操作。

在本入门指南中，您可以使用Jakarta EE的Eclipse Starter，完成每个步骤，或者跳过您已经知道的基本设置阶段。您还可以使用IDE选择熟悉的Maven原型进行工程构建。

要使用Jakarta EE的Eclipse Starter，我们需要采取以下步骤：

访问https://start.jakarta.ee。该服务将为应用程序设置所有必要的依赖项。当前版本的Starter仅支持Maven。不久会支持Gradle。
从可用选项中选择所需的Jakarta EE版本。目前，选项包括Jakarta EE 8、Jakarta EE 9.1和Jakarta EE 10。此外，您可以选择Jakarta EE Platform或某种Jakarta EE Profile（Web、Core）。
对于此项目，我们选择了Jakarta EE 10 Platform、Java SE 11和WildFly作为运行时。