前提
- Java: 21
- Spring Boot: 3.4.2
- Keycloak: 26
開発環境の起動
詳細は docker-compose.yaml を参照。
Spring Initilizr
Keycloak の設定
http://localhost:8080/へ接続し、以下情報でログイン- ユーザー名:
admin - パスワード:
password
- ユーザー名:
- レルムの作成
- レルム名:
myrealm
- レルム名:
- クライアントの作成
Clients>Create clientClient type:SAMLClient ID:saml-spName:SAML Practice
Settingsタブで必要事項を設定Root URL:http://localhost:8081/Valid redirect URIs:http://localhost:8081/*
Keysタブで必要事項を設定Client signature required: Off
- ユーザーの追加
Users>Add userで、必要事項を記入してCreate押下Username:test
CredentialsタブでSet passwordを押下し、必要事項を記入しSavePassword:testPassword confirmation:testTemporary:Off
依存を追加
pom.xml に Shiboleth のリポジトリを追加し、
spring-security-saml2-service-provider の dependency を追加する。
<repositories>
<repository>
<id>shibboleth</id>
<name>Shibboleth Repository</name>
<url>https://build.shibboleth.net/nexus/content/repositories/releases/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
</repositories>
...(snip
<dependency>
<groupId>org.springframework.security</groupId>
<artifactId>spring-security-saml2-service-provider</artifactId>
</dependency>
...(snipSecurity のコンフィギュレーションを作成
package dev.mikoto2000.study.saml.firststep.configuration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.web.SecurityFilterChain;
@Configuration
@EnableWebSecurity
public class SecurityConfiguration {
@Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
http
.authorizeHttpRequests(auth -> auth
.requestMatchers("/", "/public").permitAll()
.anyRequest().authenticated()
)
.saml2Login(saml2 -> saml2
.loginProcessingUrl("/login/saml2/sso/myrealm")
)
.logout(logout -> logout
.logoutSuccessUrl("/")
);
return http.build();
}
}署名に使うファイル群の作成
# 1. 秘密鍵を作成
openssl genpkey -algorithm RSA -out private.key
# 2. 証明書リクエストを作成
openssl req -new -key private.key -out cert.csr \
-subj "/C=JP/ST=Tokyo/L=Shibuya/O=ExampleCorp/OU=IT/CN=localhost"
# 3. 証明書を発行
openssl x509 -req -days 3650 -in cert.csr -signkey private.key -out certificate.crt
# 4. 秘密鍵と証明書をクラスパス直下に移動
mv certificate.crt private.key ./src/main/resources/アプリケーション設定
spring:
security:
saml2:
relyingparty:
registration:
myrealm:
# Keycloak の Client ID と合わせる
entity-id: "saml-sp"
signing:
credentials:
# さっき作った証明書などの情報を入力
- private-key-location: "classpath:private.key"
certificate-location: "classpath:certificate.crt"
private-key-password: "changeit"
private-key-alias: "saml-key"
key-store-password: "changeit"
assertingparty:
metadata-uri: "http://keycloak:8080/realms/myrealm/protocol/saml/descriptor"
# デバッグ出力を有効化
logging:
level:
org:
springframework.web: debug
# Keycloak とポートがかぶるのでこっちを変更
server:
port: 8081表示するページの作成
以下静的ページを src/main/resources/static
下に格納する。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>test</title>
</head>
<body>
Hello, World!
</body>
</html>hosts ファイルの更新
hosts ファイルに以下エントリーを追加。
127.0.0.1 keycloak動作確認
http://localhost:8081/index.htmlへ接続すると、 keycloak へリダイレクトされる- 先ほど作った test ユーザーでログインすると、
index.htmlが表示される
OK.