无IDP元数据时，如何手动配置Pac4j SAML的IDP端点？

步骤1：手动构建IDP元数据对象 #

Pac4j的SAML2IdentityProviderMetadata类支持直接设置IDP核心属性，替代从URL或文件加载元数据的方式。你可以将已有的SSO URL、注销URL和X509证书信息填入该对象：

// 1. 创建IDP元数据实例
SAML2IdentityProviderMetadata idpMetadata = new SAML2IdentityProviderMetadata();

// 2. 设置IDP实体ID（可从IDP官方文档获取，或自定义唯一标识）
idpMetadata.setEntityId("https://your-idp-entity-id.example.com");

// 3. 配置单点登录服务（指定HTTP-Redirect绑定）
SAML2Endpoint ssoEndpoint = new SAML2Endpoint();
ssoEndpoint.setLocation("https://your-idp-sso-url.example.com/saml2/sso");
ssoEndpoint.setBinding(SAML2Binding.REDIRECT.getValue());
idpMetadata.setSingleSignOnService(ssoEndpoint);

// 4. 配置单点注销服务（可选，同样指定HTTP-Redirect绑定）
SAML2Endpoint sloEndpoint = new SAML2Endpoint();
sloEndpoint.setLocation("https://your-idp-slo-url.example.com/saml2/slo");
sloEndpoint.setBinding(SAML2Binding.REDIRECT.getValue());
idpMetadata.setSingleLogoutService(sloEndpoint);

// 5. 设置IDP签名验证证书（通过X509指纹匹配对应证书）
X509Certificate idpCert = loadCertificateByFingerprint("your-x509-fingerprint");
idpMetadata.setSignatureVerificationCertificate(idpCert);

步骤2：配置服务提供者（SP）参数 #

创建SAML2Configuration实例，设置你的应用作为SP的核心信息，并关联手动构建的IDP元数据：

// 1. 创建SAML2配置实例
SAML2Configuration samlConfig = new SAML2Configuration();

// 2. 设置SP实体ID（你的应用唯一标识）
samlConfig.setServiceProviderEntityId("https://your-app.example.com/saml2/sp");

// 3. 设置回调URL（IDP认证完成后跳转回应用的地址）
samlConfig.setServiceProviderAssertionConsumerServiceUrl("https://your-app.example.com/callback");

// 4. 设置SP的私钥和证书（用于签名请求、解密断言，需提前生成）
samlConfig.setServiceProviderPrivateKey(PrivateKeyUtils.loadPrivateKeyFromFile("/path/to/sp-private-key.pem", "RSA"));
samlConfig.setServiceProviderCertificate(X509CertificateUtils.loadCertificateFromFile("/path/to/sp-certificate.pem"));

// 5. 关联手动构建的IDP元数据（关键：替代URL/文件加载逻辑）
samlConfig.setIdentityProviderMetadata(idpMetadata);

// 可选：配置额外SAML参数
samlConfig.setSignatureAlgorithm(SAML2SignatureAlgorithm.RSA_SHA256);
samlConfig.setWantAssertionsSigned(true);

步骤3：创建SAML2Client和Config对象 #

将配置好的SAML2Configuration传入SAML2Client，再构建Pac4j的Config对象，用于后续Vertx集成：

// 1. 创建SAML2客户端实例
SAML2Client saml2Client = new SAML2Client(samlConfig);

// 2. 构建Pac4j Config对象
Config config = new Config(saml2Client);

// 3. 集成到Vertx：创建认证提供者用于路由保护等逻辑
Pac4jVertxAuthProvider authProvider = new Pac4jVertxAuthProvider(config);

补充：从X509指纹加载证书 #

如果仅持有X509指纹而非证书文件，需先通过指纹匹配获取对应证书（可从IDP公开端点下载或手动导入本地），示例验证方法：

private X509Certificate loadCertificateByFingerprint(String fingerprint) throws Exception {
    // 清理指纹格式（去除冒号、统一大小写）
    String cleanFingerprint = fingerprint.replaceAll(":", "").toLowerCase();
    
    // 加载本地证书文件
    X509Certificate cert = X509CertificateUtils.loadCertificateFromFile("/path/to/idp-certificate.pem");
    
    // 计算证书指纹并验证匹配
    MessageDigest md = MessageDigest.getInstance("SHA-256");
    byte[] digest = md.digest(cert.getEncoded());
    String calculatedFingerprint = DatatypeConverter.printHexBinary(digest).toLowerCase().replaceAll(" ", "");
    
    if (!calculatedFingerprint.equals(cleanFingerprint)) {
        throw new IllegalArgumentException("Certificate fingerprint mismatch");
    }
    return cert;
}

内容的提问来源于stack exchange，提问作者Appu2506