从零开始搭建微服务：认证服务器

最新推荐文章于 2025-10-16 12:07:46 发布

原创

最新推荐文章于 2025-10-16 12:07:46 发布 · 2.7k 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#微服务 #spring cloud

本文详细介绍了如何使用SpringCloudOAuth2和SpringCloudSecurity搭建一个认证服务器，通过密码模式实现微服务的权限控制。首先讲解了OAuth2协议的四种授权模式，然后逐步构建认证服务器，包括配置文件、安全配置类、授权配置类以及相关服务和控制器。最终，通过PostMan测试验证了令牌获取、资源访问和令牌刷新等功能。

通常的，单体架构，我们会采用Shiro对系统做防护以及权限控制。在搭建微服务系统时，同样也要对资源做保护，只有通过认证的资源才能被访问。下面，我们将借助Spring Cloud OAuth和Spring Cloud Security搭建一个统一给微服务发放访问令牌的认证服务器elsa-auth。

Oauth2协议简介

在微服务架构下，我们通常根据不同的业务来构建不同的微服务子系统，各个子系统对外提供相应的服务。客户端除了浏览器外，还可能是手机App，小程序等。在微服务架构出现之前，我们的系统一般为单体模式，客户端只是单一的浏览器，所以通常情况下都是通过Session进行客户端，服务端通信，Session模式有个弊端，就是在一般存在于应用内，而随着客户端种类越来越多，这种交互方式变得越来越困难（当然可以通过Session缓存化的方式来解决），于是OAuth协议应运而生。

OAuth是一种用来规范令牌（Token）发放的授权机制，目前最新版本为2.0，其主要包含了四种授权模式：授权码模式、简化模式、密码模式和客户端模式。Spring Cloud OAuth对这四种授权模式进行了实现。如有不理解的，可以访问如下阮一峰介绍的Oauth2。

由于我们的前端系统是通过用户名和密码来登录系统的，所以我们选用密码模式。

认证服务器搭建

创建认证服务器子项目

File==>新建==>Other==>搜索Maven，选择Maven Module，然后Next
在这里插入图片描述
填写Module Name：elsa-auth，点击Next

一直Next至FInish为止，创建完成，项目结构如下

右键点击Elsa-Auth项目：点击Java Build Path，在Resouce资源下创建资源目录resources。

Elsa-Auth完整目录结构

认证服务器项目已经创建完成，下面我们做相关依赖和配置。

认证服务器引入依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.elsa</groupId>
        <artifactId>elsa-cloud</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>elas-auth</artifactId>
    <name>Elsa-Auth</name>
    <description>Elsa-Cloud认证服务器</description>

    <dependencies>
        <dependency>
            <groupId>com.elsa</groupId>
            <artifactId>elsa-common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

通用模块引入依赖

在elsa-common模块引入相关依赖

        <!-- redis -->
		<dependency>
		    <groupId>org.springframework.boot</groupId>
		    <artifactId>spring-boot-starter-data-redis</artifactId>
		</dependency>  
		<!-- eureka client -->
		<dependency>
		    <groupId>org.springframework.cloud</groupId>
		    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
		</dependency>

spring-boot-starter-data-redis
-因为后续我们需要将认证服务器生成的Token存储到Redis中，并且Redis依赖可能会被多个微服务使用到
spring-cloud-starter-netflix-eureka-client
-因为每个微服务都可能需要通过Eureka客户端将服务注册到注册中心，所以将依赖添加到通用模块，以方便其他微服务依赖。

认证服务器人口类

@EnableDiscoveryClient
@SpringBootApplication
public class ElsaAuthApp 
{
   
   
    public static void main(String[] args) {
   
   
        SpringApplication.run(ElsaAuthApp.class, args);
    }
}

@EnableDiscoveryClient注解，用于开启服务注册与发现功能

基本配置文件配置

编写配置文件application.yml，Eureka相关配置的含义已通过注解体现，可自行查看。在application.yml如果没有配置Redis相关配置，则采用的是Redis默认配置，但是为了更为直观，建议还是在application.yml中添加Resis配置。

server:
  port: 8101

spring:
  application:
    name: Elsa-Auth
  # redis相关配置
  redis:
    database: 0
    host: 127.0.0.1
    port: 6379
    jedis:
      pool:
        min-idle: 8
        max-idle