Zum Hauptinhalt springen

Spring Security OAuth

Casdoor kann das OIDC-Protokoll als IDP nutzen, um verschiedene Anwendungen zu verbinden. In diesem Leitfaden verwenden wir Spring Security als Beispiel, um Ihnen zu zeigen, wie Sie OIDC nutzen können, um sich mit Ihren Anwendungen zu verbinden.

Schritt 1: Casdoor bereitstellen​

Stellen Sie Casdoor bereit. Siehe Server installation. Stellen Sie sicher, dass der Server läuft und Sie die Anmeldeseite öffnen und sich als built-in/admin mit dem von Ihnen festgelegten Passwort anmelden können. Siehe Sign in to the admin console.

Schritt 2. Konfigurieren der Casdoor-Anwendung​

  1. Erstellen Sie eine neue Casdoor-Anwendung oder verwenden Sie eine bestehende.
  2. Fügen Sie Ihre Redirect-URL hinzu (Weitere Details dazu, wie Sie die Redirect-URL erhalten, finden Sie im nächsten Abschnitt). Casdoor Application Settings
  3. Fügen Sie den gewünschten Provider hinzu und füllen Sie alle zusätzlichen Einstellungen aus.

Notieren Sie sich die Client ID und das Client secret von der Anwendungsseite für den nächsten Schritt. OIDC Discovery: http://<CASDOOR_HOSTNAME>/.well-known/openid-configuration.

Schritt 3. Konfigurieren von Spring Security​

Spring Security unterstützt OIDC nativ.

Sie können die Einstellungen des Spring Security OAuth2 Clients anpassen:

Vorsicht

Ersetzen Sie die Platzhalter durch Ihre eigene Casdoor-Instanz (Client ID, Client secret usw.).

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

Mit issuer-uri liest Spring Boot beim Start das Discovery-Dokument von Casdoor und füllt die Endpunkte für Autorisierung, Token, Userinfo (/api/userinfo) und JWKS aus. Der Wert muss mit dem issuer in diesem Dokument übereinstimmen. In der Userinfo von Casdoor ist preferred_username der Benutzername und name der Anzeigename.

Vorsicht

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.

Sie sollten dies auch in der casdoor-Anwendung konfigurieren.

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

Schritt 4: Erste Schritte mit einer Demo​

  1. Wir können eine Spring Boot-Anwendung erstellen.

  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();
    }
    }

    Informationen zum Rollen-Mapping, Abmelden bei Casdoor, Ressourcenservern und Spring Cloud Gateway finden Sie unter Spring Boot SSO with OpenID Connect.

  3. Wir können eine einfache Seite für die Benutzeranmeldung hinzufügen.

    <!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>

    Wenn der Benutzer auf die login-Schaltfläche klickt, wird er zu casdoor weitergeleitet.

  4. Als Nächstes können wir unsere geschützten Ressourcen definieren. Wir können einen Endpunkt namens /foos und eine Web-Seite zur Anzeige bereitstellen.

    Datenmodell

    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;
    }
    }

    Controller

    @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";
    }
    }

    Web-Seite

    <!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>
Vorsicht

Alle Vorlagen für Web-Seiten sollten unter resources/templates abgelegt werden.

Schritt 5: Testen Sie die Demo!​

Öffnen Sie /foos in einem Browser; Sie werden zur Casdoor-Anmeldeseite weitergeleitet. Melden Sie sich dort oder über die Root-Seite an.

Wenn Sie Ihre Root-Seite besuchen, sehen Sie die Casdoor-Anwendungseinstellungen. Casdoor Application Setting

Klicken Sie auf die login-Schaltfläche, und die Seite leitet Sie zur Casdoor-Anmeldeseite weiter. Casdoor Application Setting

Nach der Anmeldung leitet die Seite Sie zu /foos weiter. Casdoor Application Setting