Введение

Данный проект в основном использует автоматическую конфигурацию Spring Boot для быстрой интеграции Shiro в приложения SpringBoot.

• Исходный код:
  • Github: https://github.com/ArtIsLong/shiro-spring-boot-starter
  • Кодовая облачная платформа: https://gitee.com/ArtIsLong/shiro-spring-boot-starter
• Мой блог: https://artislong.gitee.io

Самодельный инструмент, добро пожаловать в использование и Star. Если у вас возникнут проблемы в процессе использования, вы можете создать Issue, я постараюсь улучшить этот инструмент.

Описание функций

1. Модификация фильтра аутентификации (Authc) по умолчанию в Shiro для добавления функции перехода к пути при разделении интерфейса на передний и задний план в архитектуре проекта. Функция используется для отображения сообщения о том, что пользователь не вошёл в систему.

   Примечание: В Shiro связанные пути перехода по умолчанию используют перенаправление, что приводит к невозможности правильного получения информации о проверке подлинности на переднем плане в архитектуре разделения переднего и заднего плана. Поэтому функция перехода к пути была изменена на переадресацию.

2. Добавление функции конфигурации по умолчанию для 11 фильтров Shiro и их атрибутов.

3. Добавление функции настройки правил фильтрации для 11 видов фильтров.

4. Интеграция с открытым исходным кодом org.crazycake:shiro-redis:3.2.2 по умолчанию.

5. Добавление независимой конфигурации Redis для Shiro, позволяющей настроить отдельный экземпляр Redis для Shiro. Поддерживаются режимы одиночной машины, кластера и Sentinel.

6. По умолчанию интегрируется с spring-boot-starter-data-redis, что позволяет напрямую использовать конфигурацию Redis без необходимости отдельной настройки Redis для Shiro. Кроме того, spring-boot-starter-data-redis можно отключить.

7. Использование открытого исходного кода com.spring4all:swagger-spring-boot-starter:1.7.0.RELEASE для интеграции Swagger. Конфигурация этого открытого исходного кода по умолчанию отключена, и используется настраиваемая конфигурация Swagger.

8. Предоставление основных тестовых интерфейсов Shiro, которые можно протестировать через Swagger, включая тестирование входа и перехвата.

   Примечание: Тестовый интерфейс можно отключить, установив security.shiro.test=false.

Базовая версия

• SpringBoot: 1.5.X
• Shiro: 1.4.0

Как использовать

Добавление зависимостей

pom.xml

<dependency>
    <groupId>com.github.artislong</groupId>
    <artifactId>shiro-spring-boot-starter</artifactId>
    <version>1.0</version>
</dependency>

build.gradle

compile 'com.github.artislong:shiro-spring-boot-starter:1.0'

Включение автоматической конфигурации

В классе конфигурации используйте аннотацию @EnableShiro для включения функции автоматической настройки Shiro, например:

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

Конфигурация подробно

Имя пользователя и пароль по умолчанию

security:
  shiro:
    defaultUserName: admin
    defaultPassword: 123

Можно настроить базовую информацию для проверки подлинности, используя defaultUserName и defaultPassword. В настоящее время не поддерживается настройка получения информации для проверки подлинности из базы данных.

Конфигурация ShiroFilter

security:
  shiro:
    shiroFilter:
      filters:
        authc: com.github.artislong.shiro.DefaultFormAuthenticationFilter
      attributes:
        authc:
          noAccessUrl: /default/noLogin   # URL перехода при отсутствии входа в систему

Используя shiroFilter, можно гибко настраивать фильтры. Правила настройки следующие:

• filters

  Используя filters, можно настроить фильтры. Можно переопределить фильтры по умолчанию в Shiro. Формат данных filters — Map<DefaultFilterType, Class<? extends Filter>>, где Key — это тип фильтра по умолчанию, а Value — класс реализации фильтра.

• attributes

  С помощью attributes можно настроить свойства фильтров. В настоящее время поддерживаются только свойства типа java.lang.String.

Примечание: Поскольку этот инструмент изменяет фильтр аутентификации по умолчанию (authc), необходимо настроить URL перехода при отсутствии входа (noAccessUrl).

Настройка правил фильтрации

security:
  shiro:
    filterPattern:
      anon:   # Не требуется Shiro для перехвата запросов URL
        - /api/v1/**  # Интерфейс документа Swagger
        - /v2/api-docs
        - /swagger-ui.html
        - /webjars/**
        - /swagger-resources/**
      authc:   # Требуется Shiro для перехвата запросов URL
        - /**

С помощью filterPattern можно настроить правила фильтрации для различных типов фильтров в Shiro. Правила фильтрации хранятся в формате данных Map<DefaultFilterType, List<String>>, где Key — тип фильтра по умолчанию, а Value — набор путей фильтрации.