xref: /freebsd/crypto/heimdal/lib/kadm5/kadm5-pwcheck.h (revision 6a068746777241722b2b32c5d0bc443a2a64d80b)
1c19800e8SDoug Rabson /*
2*ae771770SStanislav Sedov  * Copyright (c) 2004 Kungliga Tekniska Högskolan
3c19800e8SDoug Rabson  * (Royal Institute of Technology, Stockholm, Sweden).
4c19800e8SDoug Rabson  * All rights reserved.
5c19800e8SDoug Rabson  *
6c19800e8SDoug Rabson  * Redistribution and use in source and binary forms, with or without
7c19800e8SDoug Rabson  * modification, are permitted provided that the following conditions
8c19800e8SDoug Rabson  * are met:
9c19800e8SDoug Rabson  *
10c19800e8SDoug Rabson  * 1. Redistributions of source code must retain the above copyright
11c19800e8SDoug Rabson  *    notice, this list of conditions and the following disclaimer.
12c19800e8SDoug Rabson  *
13c19800e8SDoug Rabson  * 2. Redistributions in binary form must reproduce the above copyright
14c19800e8SDoug Rabson  *    notice, this list of conditions and the following disclaimer in the
15c19800e8SDoug Rabson  *    documentation and/or other materials provided with the distribution.
16c19800e8SDoug Rabson  *
17c19800e8SDoug Rabson  * 3. Neither the name of the Institute nor the names of its contributors
18c19800e8SDoug Rabson  *    may be used to endorse or promote products derived from this software
19c19800e8SDoug Rabson  *    without specific prior written permission.
20c19800e8SDoug Rabson  *
21c19800e8SDoug Rabson  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22c19800e8SDoug Rabson  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23c19800e8SDoug Rabson  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24c19800e8SDoug Rabson  * ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25c19800e8SDoug Rabson  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26c19800e8SDoug Rabson  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27c19800e8SDoug Rabson  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28c19800e8SDoug Rabson  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29c19800e8SDoug Rabson  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30c19800e8SDoug Rabson  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31c19800e8SDoug Rabson  * SUCH DAMAGE.
32c19800e8SDoug Rabson  */
33c19800e8SDoug Rabson 
34*ae771770SStanislav Sedov /* $Id$ */
35c19800e8SDoug Rabson 
36c19800e8SDoug Rabson #ifndef KADM5_PWCHECK_H
37c19800e8SDoug Rabson #define KADM5_PWCHECK_H 1
38c19800e8SDoug Rabson 
39c19800e8SDoug Rabson 
40c19800e8SDoug Rabson #define KADM5_PASSWD_VERSION_V0 0
41c19800e8SDoug Rabson #define KADM5_PASSWD_VERSION_V1 1
42c19800e8SDoug Rabson 
43c19800e8SDoug Rabson typedef const char* (*kadm5_passwd_quality_check_func_v0)(krb5_context,
44c19800e8SDoug Rabson 							  krb5_principal,
45c19800e8SDoug Rabson 							  krb5_data*);
46c19800e8SDoug Rabson 
47c19800e8SDoug Rabson /*
48c19800e8SDoug Rabson  * The 4th argument, is a tuning parameter for the quality check
49c19800e8SDoug Rabson  * function, the lib/caller will providing it for the password quality
50c19800e8SDoug Rabson  * module.
51c19800e8SDoug Rabson  */
52c19800e8SDoug Rabson 
53c19800e8SDoug Rabson typedef int
54c19800e8SDoug Rabson (*kadm5_passwd_quality_check_func)(krb5_context context,
55c19800e8SDoug Rabson 				   krb5_principal principal,
56c19800e8SDoug Rabson 				   krb5_data *password,
57c19800e8SDoug Rabson 				   const char *tuning,
58c19800e8SDoug Rabson 				   char *message,
59c19800e8SDoug Rabson 				   size_t length);
60c19800e8SDoug Rabson 
61c19800e8SDoug Rabson struct kadm5_pw_policy_check_func {
62c19800e8SDoug Rabson     const char *name;
63c19800e8SDoug Rabson     kadm5_passwd_quality_check_func func;
64c19800e8SDoug Rabson };
65c19800e8SDoug Rabson 
66c19800e8SDoug Rabson struct kadm5_pw_policy_verifier {
67c19800e8SDoug Rabson     const char *name;
68c19800e8SDoug Rabson     int version;
69c19800e8SDoug Rabson     const char *vendor;
70c19800e8SDoug Rabson     const struct kadm5_pw_policy_check_func *funcs;
71c19800e8SDoug Rabson };
72c19800e8SDoug Rabson 
73c19800e8SDoug Rabson #endif /* KADM5_PWCHECK_H */
74