springboot操作ldap全過程

更新時間：2024年05月20日 10:30:40 作者：請君擇日再來

這篇文章主要介紹了springboot操作ldap全過程,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

1. 專有名詞

關(guān)于這一塊涉及到很多專有名詞這里簡單談一下。

dc：表示域名的意思，就是一個域的名稱，可以當成數(shù)據(jù)庫中的庫名來看待。
ou：組織單元，就像一層層的文件夾看待，這個ou可以有多個層級，就是ou下還可以有ou，當成數(shù)據(jù)庫中的表看待
cn：用戶名或服務(wù)器名。就相當于數(shù)據(jù)庫某一行用戶信息的主鍵
dn：相當于絕對路徑，由cn+ou+dc組成。如上圖alice的dn就是 cn=alice,ou=school,dc=demo,dc=com

每個用戶是有多個屬性值的，就好比數(shù)據(jù)庫中的字段，一行用戶有多個字段信息

2. springboot連接

導(dǎo)入依賴

        <!--ldap-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-ldap</artifactId>
        </dependency>

application.properties配置文件。這里連接的賬戶不是ldap目錄下管理的用戶，就是別用上述的alice這種用戶去連接。

#AD認證
spring.ldap.urls=ldap://127.0.0.1:389
spring.ldap.username=cn=admin,dc=demo,dc=com
spring.ldap.password=123456
spring.ldap.base=ou=school,dc=demo,dc=com

自定義配置類

@Configuration
public class LdapConfig {
 
    @Value("${spring.ldap.urls}")
    private String ldapUrl;
    @Value("${spring.ldap.username}")
    private String userName;
    @Value("${spring.ldap.password}")
    private String password;
    
 
    @Bean
    public LdapContextSource ldapContextSource() {
        LdapContextSource source = new LdapContextSource();
        source.setUrl(ldapUrl);
        source.setUserDn(userName);
        source.setPassword(password);
        return source;
    }
 
    @Bean
    public LdapTemplate ldapTemplate() {
        return new LdapTemplate(ldapContextSource());
    }
}

基本上如上配置就可以操作了

測試是否可以連接，直接調(diào)用接口，能成功連接就會輸出數(shù)據(jù)，無法連接會出現(xiàn)認證異常。

3. 按條件查詢

先上案例，查詢cn屬性值為alice的。這里沒有指定返回的屬性有哪些，所以返回的就是所有屬性。稍后再解釋Person和PersonMapper

Person就是一個普通實體類，就像平時查詢數(shù)據(jù)庫數(shù)據(jù)時都是用實體類接收數(shù)據(jù)

@Data
public class Person {
    private String cn;
    private String displayName;
    private String givenName;
    private String eMail;
    private String ou;
}

PersonMapper類就不一樣了，必須繼承AttributesMapper類，實現(xiàn)mapFromAttributes方法。

當ldapTemplate通過條件篩選出數(shù)據(jù)時，一行數(shù)據(jù)就會調(diào)用一次這個方法，attributes帶有查出的屬性值

@Slf4j
public class PersonMapper implements AttributesMapper<Person> {
 
    @Override
    public Person mapFromAttributes(Attributes attributes) throws NamingException {
        log.info(attributes.toString());
        Person result = new Person();
        result.setCn(attributes.get("cn").get().toString());
        return result;
    }
}

篩選方式有很多，必須有篩選條件才能查詢。

加上attributes(new String[]{"cn", "mail"})，就只會查詢出這兩個屬性值

LdapQuery query = LdapQueryBuilder.query()
                .base(base)
                .searchScope(SearchScope.SUBTREE)
                .attributes(new String[]{"cn", "mail"})
                .where("cn")
                .is("alice");

可以用filter篩選，也是cn屬性值為alice的篩選條件。

LdapQuery query = LdapQueryBuilder.query()
                .base(base)
                .searchScope(SearchScope.SUBTREE)
                .filter("(cn=alice)");

base下所有內(nèi)容帶有objectClass屬性，都會被查出來。

如果base自身也帶有，自身也會被查出來

LdapQuery query = LdapQueryBuilder.query()
                .base(base)
                .searchScope(SearchScope.SUBTREE)
                .filter("(objectClass=*)");

多條件篩選，cn為alice并且mail為123@qq.com的內(nèi)容。

LdapQuery query = LdapQueryBuilder.query()
                .base(base)
                .searchScope(SearchScope.SUBTREE)
                .filter("(&(cn=alice)(mail=123@qq.com))");