xref: /freebsd/contrib/openpam/include/security/pam_modules.h (revision 9a14aa017b21c292740c00ee098195cd46642730)
1 /*-
2  * Copyright (c) 2002-2003 Networks Associates Technology, Inc.
3  * Copyright (c) 2004-2011 Dag-Erling Smørgrav
4  * All rights reserved.
5  *
6  * This software was developed for the FreeBSD Project by ThinkSec AS and
7  * Network Associates Laboratories, the Security Research Division of
8  * Network Associates, Inc.  under DARPA/SPAWAR contract N66001-01-C-8035
9  * ("CBOSS"), as part of the DARPA CHATS research program.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  * 3. The name of the author may not be used to endorse or promote
20  *    products derived from this software without specific prior written
21  *    permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33  * SUCH DAMAGE.
34  *
35  * $Id: pam_modules.h 437 2011-09-13 12:00:13Z des $
36  */
37 
38 #ifndef SECURITY_PAM_MODULES_H_INCLUDED
39 #define SECURITY_PAM_MODULES_H_INCLUDED
40 
41 #include <security/pam_types.h>
42 #include <security/pam_constants.h>
43 #include <security/openpam.h>
44 
45 #ifdef __cplusplus
46 extern "C" {
47 #endif
48 
49 /*
50  * XSSO 4.2.2, 6
51  */
52 
53 #if defined(PAM_SM_ACCOUNT)
54 PAM_EXTERN int
55 pam_sm_acct_mgmt(pam_handle_t *_pamh,
56 	int _flags,
57 	int _argc,
58 	const char **_argv);
59 #endif
60 
61 #if defined(PAM_SM_AUTH)
62 PAM_EXTERN int
63 pam_sm_authenticate(pam_handle_t *_pamh,
64 	int _flags,
65 	int _argc,
66 	const char **_argv);
67 #endif
68 
69 #if defined(PAM_SM_PASSWORD)
70 PAM_EXTERN int
71 pam_sm_chauthtok(pam_handle_t *_pamh,
72 	int _flags,
73 	int _argc,
74 	const char **_argv);
75 #endif
76 
77 #if defined(PAM_SM_SESSION)
78 PAM_EXTERN int
79 pam_sm_close_session(pam_handle_t *_pamh,
80 	int _flags,
81 	int _args,
82 	const char **_argv);
83 #endif
84 
85 #if defined(PAM_SM_SESSION)
86 PAM_EXTERN int
87 pam_sm_open_session(pam_handle_t *_pamh,
88 	int _flags,
89 	int _argc,
90 	const char **_argv);
91 #endif
92 
93 #if defined(PAM_SM_AUTH)
94 PAM_EXTERN int
95 pam_sm_setcred(pam_handle_t *_pamh,
96 	int _flags,
97 	int _argc,
98 	const char **_argv);
99 #endif
100 
101 /*
102  * Single Sign-On extensions
103  */
104 #if 0
105 PAM_EXTERN int
106 pam_sm_authenticate_secondary(pam_handle_t *_pamh,
107 	char *_target_username,
108 	char *_target_module_type,
109 	char *_target_authn_domain,
110 	char *_target_supp_data,
111 	unsigned char *_target_module_authtok,
112 	int _flags,
113 	int _argc,
114 	const char **_argv);
115 
116 PAM_EXTERN int
117 pam_sm_get_mapped_authtok(pam_handle_t *_pamh,
118 	char *_target_module_username,
119 	char *_target_module_type,
120 	char *_target_authn_domain,
121 	size_t *_target_authtok_len,
122 	unsigned char **_target_module_authtok,
123 	int _argc,
124 	char *_argv);
125 
126 PAM_EXTERN int
127 pam_sm_get_mapped_username(pam_handle_t *_pamh,
128 	char *_src_username,
129 	char *_src_module_type,
130 	char *_src_authn_domain,
131 	char *_target_module_type,
132 	char *_target_authn_domain,
133 	char **_target_module_username,
134 	int _argc,
135 	const char **_argv);
136 
137 PAM_EXTERN int
138 pam_sm_set_mapped_authtok(pam_handle_t *_pamh,
139 	char *_target_module_username,
140 	size_t _target_authtok_len,
141 	unsigned char *_target_module_authtok,
142 	char *_target_module_type,
143 	char *_target_authn_domain,
144 	int _argc,
145 	const char *_argv);
146 
147 PAM_EXTERN int
148 pam_sm_set_mapped_username(pam_handle_t *_pamh,
149 	char *_target_module_username,
150 	char *_target_module_type,
151 	char *_target_authn_domain,
152 	int _argc,
153 	const char **_argv);
154 
155 #endif /* 0 */
156 
157 #ifdef __cplusplus
158 }
159 #endif
160 
161 #endif /* !SECURITY_PAM_MODULES_H_INCLUDED */
162