Saltar al contenido principal

Spring Security OAuth

Casdoor puede usar el protocolo OIDC como IDP para conectar varias aplicaciones. En esta guía, usaremos Spring Security como ejemplo para mostrarle cómo usar OIDC para conectarse a sus aplicaciones.

Paso 1: Desplegar Casdoor​

Despliegue Casdoor. Consulte Instalación del servidor. Asegúrese de que el servidor esté funcionando y pueda abrir la página de inicio de sesión e iniciar sesión como built-in/admin con la contraseña que configuró. Consulte Iniciar sesión en la consola de administración.

Paso 2. Configurar la aplicación Casdoor​

  1. Cree una nueva aplicación Casdoor o use una existente.
  2. Agregue su URL de redirección (puede encontrar más detalles sobre cómo obtener la URL de redirección en la siguiente sección). Configuración de la aplicación Casdoor
  3. Agregue el proveedor deseado y complete cualquier configuración adicional.

Anote Client ID y Client secret de la página de la aplicación para el siguiente paso. Descubrimiento de OIDC: http://<CASDOOR_HOSTNAME>/.well-known/openid-configuration.

Paso 3. Configurar Spring Security​

Spring Security admite OIDC de forma nativa.

Puede personalizar la configuración del cliente OAuth2 de Spring Security:

precaución

Reemplace los marcadores de posición con su propia instancia de Casdoor (ID de cliente, secreto de cliente, etc.).

spring:
security:
oauth2:
client:
registration:
casdoor:
client-id: <Client ID>
client-secret: <Client Secret>
scope: openid,profile,email
authorization-grant-type: authorization_code
redirect-uri: <Redirect URL>
provider:
casdoor:
issuer-uri: http://CASDOOR_HOSTNAME
user-name-attribute: preferred_username

Con issuer-uri, Spring Boot lee el documento de descubrimiento de Casdoor al iniciar y completa los endpoints de autorización, token, userinfo (/api/userinfo) y JWKS. El valor debe coincidir con el issuer en ese documento. En el userinfo de Casdoor, preferred_username es el nombre de usuario y name es el nombre para mostrar.

precaución

For the default situation of Spring Security, the <Redirect URL> should be like http://<Your Spring Boot Application Endpoint>/<Servlet Prefix if it is configured>/login/oauth2/code/casdoor, where casdoor is the registration ID. For example, in the following demo, the redirect URL should be http://localhost:8080/login/oauth2/code/casdoor.

También debe configurar esto en la aplicación casdoor.

You can also customize the settings using ClientRegistration in your code. You can find the mapping here.

Paso 4: Comience con una demostración​

  1. Podemos crear una aplicación Spring Boot.

  2. We can add a configuration that protects all endpoints except / and /login** for users to log in. Spring Security 6 removed WebSecurityConfigurerAdapter, so declare a SecurityFilterChain bean:

    @Configuration
    @EnableWebSecurity
    public class UiSecurityConfig {

    @Bean
    SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
    http
    .authorizeHttpRequests(auth -> auth
    .requestMatchers("/", "/login**").permitAll()
    .anyRequest().authenticated())
    .oauth2Login(Customizer.withDefaults());
    return http.build();
    }
    }

    Para el mapeo de roles, cierre sesión desde Casdoor, los servidores de recursos y Spring Cloud Gateway; consulte SSO con OpenID Connect en Spring Boot.

  3. Podemos agregar una página sencilla para que el usuario inicie sesión.

    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Spring OAuth Client Thymeleaf - 1</title>
    <link rel="stylesheet"
    href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" />
    </head>
    <body>
    <nav
    class="navbar navbar-expand-lg navbar-light bg-light shadow-sm p-3 mb-5">
    <a class="navbar-brand" th:href="@{/foos/}">Spring OAuth Client
    Thymeleaf - 1</a>
    </nav>
    <div class="container">
    <label>Welcome!</label> <br /> <a th:href="@{/foos/}"
    class="btn btn-primary">Login</a>
    </div>
    </body>
    </html>

    Cuando el usuario hace clic en el botón login, se le redirige a casdoor.

  4. A continuación, podemos definir nuestros recursos protegidos. Podemos exponer un endpoint llamado /foos y una página web para mostrarlo.

    Modelo de datos

    public class FooModel {
    private Long id;
    private String name;

    public FooModel(Long id, String name) {
    super();
    this.id = id;
    this.name = name;
    }
    public Long getId() {
    return id;
    }
    public void setId(Long id) {
    this.id = id;
    }
    public String getName() {
    return name;
    }
    public void setName(String name) {
    this.name = name;
    }
    }

    Controlador

    @Controller
    public class FooClientController {
    @GetMapping("/foos")
    public String getFoos(Model model) {
    List<FooModel> foos = new ArrayList<>();
    foos.add(new FooModel(1L, "a"));
    foos.add(new FooModel(2L, "b"));
    foos.add(new FooModel(3L, "c"));
    model.addAttribute("foos", foos);
    return "foos";
    }
    }

    Página web

    <!DOCTYPE html>
    <html lang="en">
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Spring OAuth Client Thymeleaf - 1</title>
    <link rel="stylesheet"
    href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" />
    </head>
    <body>
    <nav
    class="navbar navbar-expand-lg navbar-light bg-light shadow-sm p-3 mb-5">
    <a class="navbar-brand" th:href="@{/foos/}">Spring OAuth Client
    Thymeleaf -1</a>
    <ul class="navbar-nav ml-auto">
    <li class="navbar-text">Hi, <span sec:authentication="name">preferred_username</span>&nbsp;&nbsp;&nbsp;</li>
    </ul>
    </nav>
    <div class="container">
    <h1>All Foos:</h1>
    <table class="table table-bordered table-striped">
    <thead>
    <tr>
    <td>ID</td>
    <td>Name</td>
    </tr>
    </thead>
    <tbody>
    <tr th:if="${foos.empty}">
    <td colspan="4">No foos</td>
    </tr>
    <tr th:each="foo : ${foos}">
    <td>
    <span th:text="${foo.id}">ID</span>
    </td>
    <td>
    <span th:text="${foo.name}">Name</span>
    </td>
    </tr>
    </tbody>
    </table>
    </div>
    </body>
    </html>
precaución

Todas las plantillas de páginas web deben colocarse bajo resources/templates.

Paso 5: ¡Pruebe la demostración!​

Abra /foos en un navegador; será redirigido a la página de inicio de sesión de Casdoor. Inicie sesión allí o desde la página raíz.

Si visita su página raíz, verá la Configuración de la aplicación de Casdoor. Casdoor Application Setting

Haga clic en el botón login y la página lo redirigirá a la página de inicio de sesión de Casdoor. Casdoor Application Setting

Después de iniciar sesión, la página lo redirigirá a /foos. Casdoor Application Setting