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