globus_gsi_credential  7.7
globus_gsi_credential.h
Go to the documentation of this file.
1 /*
2  * Copyright 1999-2006 University of Chicago
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
23 #ifndef GLOBUS_INCLUDE_GLOBUS_GSI_CREDENTIAL_H
24 #define GLOBUS_INCLUDE_GLOBUS_GSI_CREDENTIAL_H
25 
26 #include "globus_common.h"
27 #include "globus_error_openssl.h"
29 #include "globus_gsi_callback.h"
30 #include "globus_gsi_cert_utils.h"
32 
33 #include "openssl/x509.h"
34 #include "openssl/bio.h"
35 #include "openssl/ssl.h"
36 #include "globus_error_generic.h"
37 #include "globus_error_openssl.h"
38 
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42 
43 #ifndef GLOBUS_GLOBAL_DOCUMENT_SET
44 
48 #endif
49 
97 #define GLOBUS_GSI_CREDENTIAL_MODULE (&globus_i_gsi_credential_module)
98 
99 extern
100 globus_module_descriptor_t globus_i_gsi_credential_module;
101 
102 #define _GCRSL(s) globus_common_i18n_get_string( \
103  GLOBUS_GSI_CREDENTIAL_MODULE, \
104  s)
105 
156 typedef struct globus_l_gsi_cred_handle_s *
158 
168 #if OPENSSL_VERSION_NUMBER >= 0x10000000L
169 #define STACK STACK_OF(OPENSSL_STRING)
170 #endif
171 
172 typedef struct globus_l_gsi_cred_handle_attrs_s *
174 
175 
176 globus_result_t globus_gsi_cred_handle_init(
177  globus_gsi_cred_handle_t * handle,
178  globus_gsi_cred_handle_attrs_t handle_attrs);
179 
180 globus_result_t globus_gsi_cred_handle_destroy(
181  globus_gsi_cred_handle_t handle);
182 
183 globus_result_t globus_gsi_cred_handle_copy(
184  globus_gsi_cred_handle_t source,
185  globus_gsi_cred_handle_t * dest);
186 
187 globus_result_t globus_gsi_cred_handle_attrs_init(
188  globus_gsi_cred_handle_attrs_t * handle_attrs);
189 
191  globus_gsi_cred_handle_attrs_t handle_attrs);
192 
193 globus_result_t globus_gsi_cred_handle_attrs_copy(
194  globus_gsi_cred_handle_attrs_t source,
195  globus_gsi_cred_handle_attrs_t * dest);
196 
197 globus_result_t
198 globus_gsi_cred_handle_init_ssl_context(
199  globus_gsi_cred_handle_t cred_handle);
200 
201 globus_result_t globus_gsi_cred_read(
202  globus_gsi_cred_handle_t handle,
203  X509_NAME * desired_subject);
204 
205 globus_result_t globus_gsi_cred_read_proxy(
206  globus_gsi_cred_handle_t handle,
207  const char * proxy_filename);
208 
209 globus_result_t globus_gsi_cred_read_proxy_bio(
210  globus_gsi_cred_handle_t handle,
211  BIO * bio);
212 
213 globus_result_t globus_gsi_cred_read_key(
214  globus_gsi_cred_handle_t handle,
215  char * key_filename,
216  int (*pw_cb)());
217 
218 globus_result_t globus_gsi_cred_read_cert(
219  globus_gsi_cred_handle_t handle,
220  char * cert_filename);
221 
222 globus_result_t globus_gsi_cred_read_cert_bio(
223  globus_gsi_cred_handle_t handle,
224  BIO * bio);
225 
226 globus_result_t globus_gsi_cred_read_cert_buffer(
227  char * pem_buf,
228  globus_gsi_cred_handle_t * out_handle,
229  X509 ** out_cert,
230  STACK_OF(X509) ** out_cert_chain,
231  char ** out_subject);
232 
233 globus_result_t globus_gsi_cred_read_pkcs12(
234  globus_gsi_cred_handle_t handle,
235  char * pkcs12_filename);
236 
237 globus_result_t globus_gsi_cred_write(
238  globus_gsi_cred_handle_t handle,
239  BIO * bio);
240 
241 globus_result_t globus_gsi_cred_write_proxy(
242  globus_gsi_cred_handle_t handle,
243  char * proxy_filename);
244 
245 globus_result_t
247  globus_gsi_cred_handle_t cred_handle,
248  globus_gsi_callback_data_t callback_data);
249 
250 globus_result_t
252  globus_gsi_cred_handle_t cred_handle,
253  globus_gsi_callback_data_t callback_data,
254  time_t check_time);
255 
256 globus_result_t globus_gsi_cred_verify(
257  globus_gsi_cred_handle_t handle);
258 
260  globus_gsi_cred_handle_t handle,
261  X509_NAME ** subject_name);
262 
263 globus_result_t globus_gsi_cred_get_subject_name(
264  globus_gsi_cred_handle_t handle,
265  char ** subject_name);
266 
267 globus_result_t globus_gsi_cred_get_policies(
268  globus_gsi_cred_handle_t handle,
269  STACK ** policies);
270 
272  globus_gsi_cred_handle_t handle,
273  STACK_OF(ASN1_OBJECT) ** languages);
274 
275 globus_result_t globus_gsi_cred_get_path_lengths(
276  globus_gsi_cred_handle_t handle,
277  STACK_OF(ASN1_INTEGER) * integer);
278 
280  globus_gsi_cred_handle_t handle,
281  X509_NAME ** issuer_name);
282 
283 globus_result_t globus_gsi_cred_get_issuer_name(
284  globus_gsi_cred_handle_t handle,
285  char ** issuer_name);
286 
288  globus_gsi_cred_handle_t handle,
289  X509_NAME ** identity_name);
290 
291 globus_result_t globus_gsi_cred_get_identity_name(
292  globus_gsi_cred_handle_t handle,
293  char ** identity_name);
294 
295 globus_result_t globus_gsi_cred_set_cert(
296  globus_gsi_cred_handle_t handle,
297  X509 * cert);
298 
299 globus_result_t globus_gsi_cred_set_key(
300  globus_gsi_cred_handle_t handle,
301  EVP_PKEY * key);
302 
303 globus_result_t globus_gsi_cred_set_cert_chain(
304  globus_gsi_cred_handle_t handle,
305  STACK_OF(X509) * cert_chain);
306 
307 globus_result_t globus_gsi_cred_get_cert(
308  globus_gsi_cred_handle_t handle,
309  X509 ** cert);
310 
311 globus_result_t globus_gsi_cred_get_key(
312  globus_gsi_cred_handle_t handle,
313  EVP_PKEY ** key);
314 
315 globus_result_t globus_gsi_cred_get_cert_chain(
316  globus_gsi_cred_handle_t handle,
317  STACK_OF(X509) ** cert_chain);
318 
319 globus_result_t globus_gsi_cred_get_handle_attrs(
320  globus_gsi_cred_handle_t handle,
321  globus_gsi_cred_handle_attrs_t * handle_attrs);
322 
323 globus_result_t globus_gsi_cred_get_lifetime(
324  globus_gsi_cred_handle_t handle,
325  time_t * lifetime);
326 
327 globus_result_t globus_gsi_cred_get_goodtill(
328  globus_gsi_cred_handle_t handle,
329  time_t * goodtill);
330 
331 globus_result_t globus_gsi_cred_get_cert_type(
332  globus_gsi_cred_handle_t handle,
333  globus_gsi_cert_utils_cert_type_t * type);
334 
335 globus_result_t globus_gsi_cred_get_key_bits(
336  globus_gsi_cred_handle_t handle,
337  int * key_bits);
338 
340  globus_gsi_cred_handle_attrs_t handle_attrs,
341  char * ca_cert_dir);
342 
344  globus_gsi_cred_handle_attrs_t handle_attrs,
345  char ** ca_cert_dir);
346 
348  globus_gsi_cred_handle_attrs_t handle_attrs,
349  globus_gsi_cred_type_t search_order[]); /*{PROXY,USER,HOST}*/
350 
351 
353  globus_gsi_cred_handle_attrs_t handle_attrs,
354  globus_gsi_cred_type_t * search_order[]);/*{PROXY,USER,HOST}*/
355 
356 #ifdef __cplusplus
357 }
358 #endif
359 
360 #endif /* GLOBUS_INCLUDE_GLOBUS_GSI_CREDENTIAL_H */
globus_result_t globus_gsi_cred_handle_attrs_set_ca_cert_dir(globus_gsi_cred_handle_attrs_t handle_attrs, char *ca_cert_dir)
Set the CA certificate directory.
Definition: globus_gsi_cred_handle_attrs.c:243
globus_result_t globus_gsi_cred_get_subject_name(globus_gsi_cred_handle_t handle, char **subject_name)
Get credential subject name.
Definition: globus_gsi_cred_handle.c:1182
globus_result_t globus_gsi_cred_handle_attrs_copy(globus_gsi_cred_handle_attrs_t source, globus_gsi_cred_handle_attrs_t *dest)
Copy credential handle attributes.
Definition: globus_gsi_cred_handle_attrs.c:165
globus_result_t globus_gsi_cred_get_key_bits(globus_gsi_cred_handle_t handle, int *key_bits)
Get credential strength.
Definition: globus_gsi_cred_handle.c:468
globus_result_t globus_gsi_cred_get_identity_name(globus_gsi_cred_handle_t handle, char **identity_name)
Get identity name.
Definition: globus_gsi_cred_handle.c:1675
globus_result_t globus_gsi_cred_get_policies(globus_gsi_cred_handle_t handle, STACK **policies)
Get certificate chain policies.
Definition: globus_gsi_cred_handle.c:1246
globus_result_t globus_gsi_cred_get_X509_subject_name(globus_gsi_cred_handle_t handle, X509_NAME **subject_name)
Get credential subject name.
Definition: globus_gsi_cred_handle.c:1028
globus_result_t globus_gsi_cred_get_cert_type(globus_gsi_cred_handle_t handle, globus_gsi_cert_utils_cert_type_t *type)
Get the X.509 certificate type.
Definition: globus_gsi_credential.c:2014
globus_result_t globus_gsi_cred_verify(globus_gsi_cred_handle_t handle)
Verify a credential.
Definition: globus_gsi_cred_handle.c:2105
globus_result_t globus_gsi_cred_read_pkcs12(globus_gsi_cred_handle_t handle, char *pkcs12_filename)
Read certificate and key from a PKCS12 file.
Definition: globus_gsi_credential.c:1547
globus_result_t globus_gsi_cred_handle_destroy(globus_gsi_cred_handle_t handle)
Destroy the credential handle.
Definition: globus_gsi_cred_handle.c:146
struct globus_l_gsi_cred_handle_s * globus_gsi_cred_handle_t
Definition: globus_gsi_credential.h:156
globus_result_t globus_gsi_cred_handle_attrs_init(globus_gsi_cred_handle_attrs_t *handle_attrs)
Initialize credential handle attributes.
Definition: globus_gsi_cred_handle_attrs.c:60
globus_result_t globus_gsi_cred_get_X509_issuer_name(globus_gsi_cred_handle_t handle, X509_NAME **issuer_name)
Get credential issuer name object.
Definition: globus_gsi_cred_handle.c:1543
globus_result_t globus_gsi_cred_get_issuer_name(globus_gsi_cred_handle_t handle, char **issuer_name)
Get issuer name.
Definition: globus_gsi_cred_handle.c:1608
globus_result_t globus_gsi_cred_write_proxy(globus_gsi_cred_handle_t handle, char *proxy_filename)
Write a proxy credential.
Definition: globus_gsi_credential.c:1882
globus_result_t globus_gsi_cred_get_lifetime(globus_gsi_cred_handle_t handle, time_t *lifetime)
Get credential lifetime.
Definition: globus_gsi_cred_handle.c:414
globus_result_t globus_gsi_cred_get_goodtill(globus_gsi_cred_handle_t handle, time_t *goodtill)
Get credential expiration.
Definition: globus_gsi_cred_handle.c:367
globus_result_t globus_gsi_cred_set_cert(globus_gsi_cred_handle_t handle, X509 *cert)
Set the credential's certificate.
Definition: globus_gsi_cred_handle.c:556
globus_result_t globus_gsi_cred_handle_attrs_set_search_order(globus_gsi_cred_handle_attrs_t handle_attrs, globus_gsi_cred_type_t search_order[])
Set the search order.
Definition: globus_gsi_cred_handle_attrs.c:355
globus_gsi_cred_type_t
Definition: globus_gsi_cred_constants.h:103
globus_result_t globus_gsi_cred_get_cert_chain(globus_gsi_cred_handle_t handle, STACK_OF(X509)**cert_chain)
Get the certificate chain.
Definition: globus_gsi_cred_handle.c:950
globus_result_t globus_gsi_cred_handle_copy(globus_gsi_cred_handle_t source, globus_gsi_cred_handle_t *dest)
Copy a handle.
Definition: globus_gsi_cred_handle.c:197
globus_result_t globus_gsi_cred_write(globus_gsi_cred_handle_t handle, BIO *bio)
Write Credential.
Definition: globus_gsi_credential.c:1795
globus_result_t globus_gsi_cred_set_cert_chain(globus_gsi_cred_handle_t handle, STACK_OF(X509)*cert_chain)
Set the certificate chain.
Definition: globus_gsi_cred_handle.c:849
globus_result_t globus_gsi_cred_get_policy_languages(globus_gsi_cred_handle_t handle, STACK_OF(ASN1_OBJECT)**languages)
Get certificate chain policy languages.
Definition: globus_gsi_cred_handle.c:1425
globus_result_t globus_gsi_cred_read_cert(globus_gsi_cred_handle_t handle, char *cert_filename)
Read a certificate chain from a file.
Definition: globus_gsi_credential.c:1234
globus_result_t globus_gsi_cred_get_key(globus_gsi_cred_handle_t handle, EVP_PKEY **key)
Get the credential's private key.
Definition: globus_gsi_cred_handle.c:770
globus_result_t globus_gsi_cred_handle_init(globus_gsi_cred_handle_t *handle, globus_gsi_cred_handle_attrs_t handle_attrs)
Initialize a Handle.
Definition: globus_gsi_cred_handle.c:64
globus_result_t globus_gsi_cred_get_cert(globus_gsi_cred_handle_t handle, X509 **cert)
Get the credential's certificate.
Definition: globus_gsi_cred_handle.c:628
globus_result_t globus_gsi_cred_read_cert_bio(globus_gsi_cred_handle_t handle, BIO *bio)
Read a certificate chain from a BIO.
Definition: globus_gsi_credential.c:1293
globus_result_t globus_gsi_cred_read(globus_gsi_cred_handle_t handle, X509_NAME *desired_subject)
Read a credential.
Definition: globus_gsi_credential.c:211
globus_result_t globus_gsi_cred_handle_attrs_get_search_order(globus_gsi_cred_handle_attrs_t handle_attrs, globus_gsi_cred_type_t **search_order)
Get the search order.
Definition: globus_gsi_cred_handle_attrs.c:416
Globus GSI Credential Library.
struct globus_l_gsi_cred_handle_attrs_s * globus_gsi_cred_handle_attrs_t
Definition: globus_gsi_credential.h:172
globus_result_t globus_gsi_cred_get_handle_attrs(globus_gsi_cred_handle_t handle, globus_gsi_cred_handle_attrs_t *handle_attrs)
Get the handle attributes.
Definition: globus_gsi_cred_handle.c:305
globus_result_t globus_gsi_cred_get_X509_identity_name(globus_gsi_cred_handle_t handle, X509_NAME **identity_name)
Get X.509 identity.
Definition: globus_gsi_cred_handle.c:1093
globus_result_t globus_gsi_cred_set_key(globus_gsi_cred_handle_t handle, EVP_PKEY *key)
Set the credential's private key.
Definition: globus_gsi_cred_handle.c:680
globus_result_t globus_gsi_cred_verify_cert_chain_when(globus_gsi_cred_handle_t cred_handle, globus_gsi_callback_data_t callback_data, time_t check_time)
Verify credential at a specific time.
Definition: globus_gsi_cred_handle.c:1905
globus_result_t globus_gsi_cred_read_proxy(globus_gsi_cred_handle_t handle, const char *proxy_filename)
Read proxy credential.
Definition: globus_gsi_credential.c:837
globus_result_t globus_gsi_cred_read_cert_buffer(char *pem_buf, globus_gsi_cred_handle_t *out_handle, X509 **out_cert, STACK_OF(X509)**out_cert_chain, char **out_subject)
Read certificate chain from a buffer.
Definition: globus_gsi_credential.c:1418
globus_result_t globus_gsi_cred_read_key(globus_gsi_cred_handle_t handle, char *key_filename, int(*pw_cb)())
Read a private key.
Definition: globus_gsi_credential.c:1146
globus_result_t globus_gsi_cred_handle_attrs_destroy(globus_gsi_cred_handle_attrs_t handle_attrs)
Destroy credential handle attributes.
Definition: globus_gsi_cred_handle_attrs.c:126
globus_result_t globus_gsi_cred_read_proxy_bio(globus_gsi_cred_handle_t handle, BIO *bio)
Read proxy credential from a BIO.
Definition: globus_gsi_credential.c:911
globus_result_t globus_gsi_cred_verify_cert_chain(globus_gsi_cred_handle_t cred_handle, globus_gsi_callback_data_t callback_data)
Verify credential.
Definition: globus_gsi_cred_handle.c:1757
globus_result_t globus_gsi_cred_handle_attrs_get_ca_cert_dir(globus_gsi_cred_handle_attrs_t handle_attrs, char **ca_cert_dir)
Get the CA certificate directory.
Definition: globus_gsi_cred_handle_attrs.c:291