kopenssl.h

00001 /* This file is part of the KDE libraries
00002    Copyright (C) 2001-2003 George Staikos <staikos@kde.org>
00003 
00004    This library is free software; you can redistribute it and/or
00005    modify it under the terms of the GNU Library General Public
00006    License version 2 as published by the Free Software Foundation.
00007 
00008    This library is distributed in the hope that it will be useful,
00009    but WITHOUT ANY WARRANTY; without even the implied warranty of
00010    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00011    Library General Public License for more details.
00012 
00013    You should have received a copy of the GNU Library General Public License
00014    along with this library; see the file COPYING.LIB.  If not, write to
00015    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00016    Boston, MA 02110-1301, USA.
00017 */
00018 
00019 
00020 // IF YOU ARE USING THIS CLASS, YOU ARE MAKING A MISTAKE.
00021 
00022 #ifndef __KOPENSSLPROXY_H
00023 #define __KOPENSSLPROXY_H
00024 
00025 #define KOSSL KOpenSSLProxy
00026 class KOpenSSLProxyPrivate;
00027 
00028 #include <klibloader.h>
00029 
00030 #ifdef Q_WS_WIN
00031 #include "ksslconfig_win.h"
00032 #else
00033 #include "ksslconfig.h"
00034 #endif
00035 
00036 #ifdef KSSL_HAVE_SSL
00037 #define crypt _openssl_crypt
00038 #include <openssl/ssl.h>
00039 #include <openssl/x509.h>
00040 #include <openssl/x509v3.h>
00041 #include <openssl/pem.h>
00042 #include <openssl/bio.h>
00043 #include <openssl/rand.h>
00044 #include <openssl/asn1.h>
00045 #include <openssl/pkcs7.h>
00046 #include <openssl/pkcs12.h>
00047 #include <openssl/evp.h>
00048 #include <openssl/stack.h>
00049 #include <openssl/bn.h>
00050 #undef crypt
00051 #endif
00052 
00053 #if OPENSSL_VERSION_NUMBER >= 0x10000000L
00054 #define STACK _STACK
00055 #define OSSL_SKVALUE_RTYPE void
00056 #define OSSL_MORECONST const
00057 #else
00058 #define OSSL_SKVALUE_RTYPE char
00059 #define OSSL_MORECONST
00060 #endif
00061 
00062 #include <kstaticdeleter.h>
00063 
00072 class KIO_EXPORT KOpenSSLProxy {
00073 friend class KStaticDeleter<KOpenSSLProxy>;
00074 public:
00075 
00080    static KOpenSSLProxy *self();
00081 
00085    bool hasLibCrypto() const;
00086 
00090    bool hasLibSSL() const;
00091 
00096    void destroy();
00097 
00098    // Here are the symbols that we need.
00099 #ifdef KSSL_HAVE_SSL
00100 
00101    /*
00102     *   SSL_connect - initiate the TLS/SSL handshake with an TLS/SSL server
00103     */
00104    int SSL_connect(SSL *ssl);
00105 
00106    /*
00107     *   SSL_accept - initiate the TLS/SSL handshake with an TLS/SSL server
00108     */
00109    int SSL_accept(SSL *ssl);
00110 
00111    /*
00112     *   SSL_get_error - get the error code
00113     */
00114    int SSL_get_error(SSL *ssl, int rc);
00115 
00116    /*
00117     *   SSL_read - read bytes from a TLS/SSL connection.
00118     */
00119    int SSL_read(SSL *ssl, void *buf, int num);
00120 
00121    /*
00122     *   SSL_write - write bytes to a TLS/SSL connection.
00123     */
00124    int SSL_write(SSL *ssl, const void *buf, int num);
00125 
00126    /*
00127     *   SSL_new - create a new SSL structure for a connection
00128     */
00129    SSL *SSL_new(SSL_CTX *ctx);
00130 
00131    /*
00132     *   SSL_free - free an allocated SSL structure
00133     */
00134    void SSL_free(SSL *ssl);
00135 
00136    /*
00137     *   SSL_shutdown - shutdown an allocated SSL connection
00138     */
00139    int SSL_shutdown(SSL *ssl);
00140 
00141    /*
00142     *   SSL_CTX_new - create a new SSL_CTX object as framework for TLS/SSL enabled functions
00143     */
00144    SSL_CTX *SSL_CTX_new(SSL_METHOD *method);
00145 
00146    /*
00147     *   SSL_CTX_free - free an allocated SSL_CTX object
00148     */
00149    void SSL_CTX_free(SSL_CTX *ctx);
00150 
00151    /*
00152     *   SSL_set_fd - connect the SSL object with a file descriptor
00153     */
00154    int SSL_set_fd(SSL *ssl, int fd);
00155 
00156    /*
00157     *   SSL_pending - obtain number of readable bytes buffered in an SSL object
00158     */
00159    int SSL_pending(SSL *ssl);
00160 
00161    /*
00162     *   SSL_peek - obtain bytes buffered in an SSL object
00163     */
00164    int SSL_peek(SSL *ssl, void *buf, int num);
00165 
00166    /*
00167     *   SSL_CTX_set_cipher_list - choose list of available SSL_CIPHERs
00168     */
00169    int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str);
00170 
00171    /*
00172     *   SSL_CTX_set_verify - set peer certificate verification parameters
00173     */
00174    void SSL_CTX_set_verify(SSL_CTX *ctx, int mode,
00175                          int (*verify_callback)(int, X509_STORE_CTX *));
00176 
00177    /*
00178     *   SSL_use_certificate - load certificate
00179     */
00180    int SSL_use_certificate(SSL *ssl, X509 *x);
00181 
00182    /*
00183     *   SSL_get_current_cipher - get SSL_CIPHER of a connection
00184     */
00185    SSL_CIPHER *SSL_get_current_cipher(SSL *ssl);
00186 
00187    /*
00188     *   SSL_set_options - manipulate SSL engine options
00189     *   Note: These are all mapped to SSL_ctrl so call them as the comment
00190     *         specifies but know that they use SSL_ctrl.  They are #define
00191     *         so they will map to the one in this class if called as a
00192     *         member function of this class.
00193     */
00194    /* long SSL_set_options(SSL *ssl, long options); */
00195    /*   Returns 0 if not reused, 1 if session id is reused */
00196    /*   int SSL_session_reused(SSL *ssl); */
00197    long    SSL_ctrl(SSL *ssl,int cmd, long larg, char *parg);
00198 
00199    /*
00200     *   RAND_egd - set the path to the EGD
00201     */
00202    int RAND_egd(const char *path);
00203 
00204 
00205    /*
00206     *   RAND_file_name
00207     */
00208    const char *RAND_file_name(char *buf, size_t num);
00209 
00210 
00211    /*
00212     *   RAND_load_file
00213     */
00214    int RAND_load_file(const char *filename, long max_bytes);
00215 
00216 
00217    /*
00218     *   RAND_write_file
00219     */
00220    int RAND_write_file(const char *filename);
00221 
00222 
00223    /*
00224     *   TLSv1_client_method - return a TLSv1 client method object
00225     */
00226    SSL_METHOD *TLSv1_client_method();
00227 
00228 
00229    /*
00230     *   SSLv2_client_method - return a SSLv2 client method object
00231     */
00232    SSL_METHOD *SSLv2_client_method();
00233 
00234 
00235    /*
00236     *   SSLv3_client_method - return a SSLv3 client method object
00237     */
00238    SSL_METHOD *SSLv3_client_method();
00239 
00240 
00241    /*
00242     *   SSLv23_client_method - return a SSLv23 client method object
00243     */
00244    SSL_METHOD *SSLv23_client_method();
00245 
00246 
00247    /*
00248     *   SSL_get_peer_certificate - return the peer's certificate
00249     */
00250    X509 *SSL_get_peer_certificate(SSL *s);
00251 
00252 
00253    /*
00254     *   SSL_get_peer_cert_chain - get the peer's certificate chain
00255     */
00256    STACK_OF(X509) *SSL_get_peer_cert_chain(SSL *s);
00257 
00258    /*
00259     *   SSL_CIPHER_get_bits - get the number of bits in this cipher
00260     */
00261    int SSL_CIPHER_get_bits(SSL_CIPHER *c,int *alg_bits);
00262 
00263 
00264    /*
00265     *   SSL_CIPHER_get_version - get the version of this cipher
00266     */
00267    char *SSL_CIPHER_get_version(SSL_CIPHER *c);
00268 
00269 
00270    /*
00271     *   SSL_CIPHER_get_name - get the name of this cipher
00272     */
00273    const char *SSL_CIPHER_get_name(SSL_CIPHER *c);
00274 
00275 
00276    /*
00277     *   SSL_CIPHER_description - get the description of this cipher
00278     */
00279    char *SSL_CIPHER_description(SSL_CIPHER *,char *buf,int size);
00280 
00281 
00282    /*
00283     *   SSL_CTX_use_PrivateKey - set the private key for the session.
00284     *                          - for use with client certificates
00285     */
00286    int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);
00287 
00288 
00289    /*
00290     *   SSL_CTX_use_certificate - set the client certificate for the session.
00291     */
00292    int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);
00293 
00294 
00295    /*
00296     *   d2i_X509 - Covert a text representation of X509 to an X509 object
00297     */
00298    X509 * d2i_X509(X509 **a,unsigned char **pp,long length);
00299 
00300 
00301    /*
00302     *   i2d_X509 - Covert an X509 object into a text representation
00303     */
00304    int i2d_X509(X509 *a,unsigned char **pp);
00305 
00306 
00307    /*
00308     *   X509_cmp - compare two X509 objects
00309     */
00310    int X509_cmp(X509 *a, X509 *b);
00311 
00312 
00313    /*
00314     *   X509_dup - duplicate an X509 object
00315     */
00316    X509 *X509_dup(X509 *x509);
00317 
00318 
00319    /*
00320     *   X509_STORE_CTX_new - create an X509 store context
00321     */
00322    X509_STORE_CTX *X509_STORE_CTX_new(void);
00323 
00324 
00325    /*
00326     *   X509_STORE_CTX_free - free up an X509 store context
00327     */
00328    void X509_STORE_CTX_free(X509_STORE_CTX *v);
00329 
00330 
00331    /*
00332     *   X509_STORE_CTX_set_chain - set the certificate chain
00333     */
00334    void X509_STORE_CTX_set_chain(X509_STORE_CTX *v, STACK_OF(X509)* x);
00335 
00336    /*
00337     *   X509_STORE_CTX_set_purpose - set the purpose of the certificate
00338     */
00339    void X509_STORE_CTX_set_purpose(X509_STORE_CTX *v, int purpose);
00340 
00341    /*
00342     *   X509_verify_cert - verify the certificate
00343     */
00344    int X509_verify_cert(X509_STORE_CTX *v);
00345 
00346 
00347    /*
00348     *   X509_STORE_new - create an X509 store
00349     */
00350    X509_STORE *X509_STORE_new(void);
00351 
00352 
00353    /*
00354     *   X509_STORE_free - free up an X509 store
00355     */
00356    void X509_STORE_free(X509_STORE *v);
00357 
00358 
00359    /*
00360     *   X509_free - free up an X509
00361     */
00362    void X509_free(X509 *v);
00363 
00364 
00365    /*
00366     *   X509_NAME_oneline - return the X509 data in a string
00367     */
00368    char *X509_NAME_oneline(X509_NAME *a, char *buf, int size);
00369 
00370 
00371    /*
00372     *   X509_get_subject_name - return the X509_NAME for the subject field
00373     */
00374    X509_NAME *X509_get_subject_name(X509 *a);
00375 
00376 
00377    /*
00378     *   X509_get_issuer_name - return the X509_NAME for the issuer field
00379     */
00380    X509_NAME *X509_get_issuer_name(X509 *a);
00381 
00382 
00383    /*
00384     *   X509_STORE_add_lookup - add a lookup file/method to an X509 store
00385     */
00386    X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m);
00387 
00388 
00389    /*
00390     *   X509_LOOKUP_file - Definition of the LOOKUP_file method
00391     */
00392    X509_LOOKUP_METHOD *X509_LOOKUP_file(void);
00393 
00394 
00395    /*
00396     *   X509_LOOKUP_free - Free an X509_LOOKUP
00397     */
00398    void X509_LOOKUP_free(X509_LOOKUP *x);
00399 
00400 
00401    /*
00402     *   X509_LOOKUP_ctrl - This is not normally called directly (use macros)
00403     */
00404    int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc, long argl, char **ret);
00405 
00406 
00407    /*
00408     *   X509_STORE_CTX_init - initialize an X509 STORE context
00409     */
00410    void X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *store, X509 *x509, STACK_OF(X509) *chain);
00411 
00412 
00413    /*
00414     *   CRYPTO_free - free up an internally allocated object
00415     */
00416    void CRYPTO_free(void *x);
00417 
00418    /*
00419     *   BIO_new - create new BIO
00420     */
00421    BIO *BIO_new(BIO_METHOD *type);
00422 
00423    /*
00424     *   BIO methods - only one defined here yet
00425     */
00426    BIO_METHOD *BIO_s_mem(void);
00427 
00428    /*
00429     *   BIO_new_fp - nastiness called BIO - used to create BIO* from FILE*
00430     */
00431    BIO *BIO_new_fp(FILE *stream, int close_flag);
00432 
00433    /*
00434     *   BIO_new_mem_buf - read only BIO from memory region
00435     */
00436    BIO *BIO_new_mem_buf(void *buf, int len);
00437 
00438    /*
00439     *   BIO_free - nastiness called BIO - used to destroy BIO*
00440     */
00441    int BIO_free(BIO *a);
00442 
00443    /*
00444     *   BIO_ctrl - BIO control method
00445     */
00446    long BIO_ctrl(BIO *bp,int cmd,long larg,void *parg);
00447 
00448    /*
00449     *   BIO_write - equivalent to ::write for BIO
00450     */
00451    int BIO_write(BIO *b, const void *data, int len);
00452 
00453    /*
00454     *   PEM_write_bio_X509 - write a PEM encoded cert to a BIO*
00455     */
00456    int PEM_write_bio_X509(BIO *bp, X509 *x);
00457 
00458 
00459    /*
00460     *   ASN1_item_i2d_fp - used for netscape output
00461     */
00462    int ASN1_item_i2d_fp(FILE *out, unsigned char *x);
00463 
00464 
00465    /*
00466     *   ASN1_d2i_fp - read an X509 from a DER encoded file (buf can be NULL)
00467     */
00468    X509 *X509_d2i_fp(FILE *out, X509** buf);
00469 
00470 
00471    /*
00472     *   X509_print - print the text form of an X509
00473     */
00474    int X509_print(FILE *fp, X509 *x);
00475 
00476 
00477    /*
00478     *   Read a PKCS#12 cert from fp
00479     */
00480    PKCS12 *d2i_PKCS12_fp(FILE *fp, PKCS12 **p12);
00481 
00482 
00483    /*
00484     *   Change the password on a PKCS#12 cert
00485     */
00486    int PKCS12_newpass(PKCS12 *p12, char *oldpass, char *newpass);
00487 
00488 
00489    /*
00490     *   Write a PKCS#12 to mem
00491     */
00492    int i2d_PKCS12(PKCS12 *p12, unsigned char **p);
00493 
00494 
00495    /*
00496     *   Write a PKCS#12 to FILE*
00497     */
00498    int i2d_PKCS12_fp(FILE *fp, PKCS12 *p12);
00499 
00500 
00501    /*
00502     *   Create a new PKCS#12 object
00503     */
00504    PKCS12 *PKCS12_new(void);
00505 
00506 
00507    /*
00508     *   Destroy that PKCS#12 that you created!
00509     */
00510    void PKCS12_free(PKCS12 *a);
00511 
00512 
00513    /*
00514     *   Parse the PKCS#12
00515     */
00516    int PKCS12_parse(PKCS12 *p12, const char *pass, EVP_PKEY **pkey,
00517                     X509 **cert, STACK_OF(X509) **ca);
00518 
00519 
00520    /*
00521     *   Free the Private Key
00522     */
00523    void EVP_PKEY_free(EVP_PKEY *x);
00524 
00525 
00526    /*
00527     *   Pop off the stack
00528     */
00529    char *sk_pop(STACK *s);
00530 
00531 
00532    /*
00533     *   Free the stack
00534     */
00535    void sk_free(STACK *s);
00536 
00537 #if OPENSSL_VERSION_NUMBER >= 0x10000000L
00538    void sk_free(void *s) { return sk_free(reinterpret_cast<STACK*>(s)); }
00539 #endif
00540 
00541    /*
00542     *  Number of elements in the stack
00543     */
00544    int sk_num(STACK *s);
00545 
00546 
00547    /*
00548     *  Value of element n in the stack
00549     */
00550    char *sk_value(STACK *s, int n);
00551 
00552 #if OPENSSL_VERSION_NUMBER >= 0x10000000L
00553    char *sk_value(void *s, int n) { return sk_value(reinterpret_cast<STACK*>(s), n); }
00554 #endif
00555 
00556    /*
00557     *  Create a new stack
00558     */
00559    STACK *sk_new(int (*cmp)());
00560 
00561 
00562    /*
00563     *  Add an element to the stack
00564     */
00565    int sk_push(STACK *s, char *d);
00566 
00567 #if OPENSSL_VERSION_NUMBER >= 0x10000000L
00568    int sk_push(void *s, void *d) { return sk_push(reinterpret_cast<STACK*>(s), reinterpret_cast<char*>(d)); }
00569 #endif
00570 
00571 
00572    /*
00573     *  Duplicate the stack
00574     */
00575    STACK *sk_dup(STACK *s);
00576 
00577 
00578    /*
00579     *  Convert an ASN1_INTEGER to its text form
00580     */
00581    char *i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, ASN1_INTEGER *aint);
00582 
00583 
00584    /*
00585     *  Get the certificate's serial number
00586     */
00587    ASN1_INTEGER *X509_get_serialNumber(X509 *x);
00588 
00589 
00590    /*
00591     *  Get the certificate's public key
00592     */
00593    EVP_PKEY *X509_get_pubkey(X509 *x);
00594 
00595 
00596    /*
00597     *  Convert the public key to a decimal form
00598     */
00599    int i2d_PublicKey(EVP_PKEY *a, unsigned char **pp);
00600 
00601 
00602    /*
00603     *  Check the private key of a PKCS bundle against the X509
00604     */
00605    int X509_check_private_key(X509 *x, EVP_PKEY *p);
00606 
00607 
00608    /*
00609     *  Convert a BIGNUM to a hex string
00610     */
00611    char *BN_bn2hex(const BIGNUM *a);
00612 
00613 
00614    /*
00615     *  Compute the digest of an X.509
00616     */
00617    int X509_digest(const X509 *x,const EVP_MD *t, unsigned char *md, unsigned int *len);
00618 
00619 
00620    /*
00621     *  EVP_md5
00622     */
00623    EVP_MD *EVP_md5();
00624 
00625 
00626    /*
00627     *  ASN1_INTEGER free
00628     */
00629    void ASN1_INTEGER_free(ASN1_INTEGER *x);
00630 
00631 
00632    /*
00633     *  ASN1_STRING_data
00634     */
00635    unsigned char *ASN1_STRING_data(ASN1_STRING *x);
00636 
00637    /*
00638     *  ASN1_STRING_length
00639     */
00640    int ASN1_STRING_length(ASN1_STRING *x);
00641 
00642    /*
00643     *
00644     */
00645    int OBJ_obj2nid(ASN1_OBJECT *o);
00646 
00647    /*
00648     *
00649     */
00650    const char * OBJ_nid2ln(int n);
00651 
00652    /*
00653     * get the number of extensions
00654     */
00655    int X509_get_ext_count(X509 *x);
00656 
00657    /*
00658     *
00659     */
00660    int X509_get_ext_by_NID(X509 *x, int nid, int lastpos);
00661 
00662    /*
00663     *
00664     */
00665    int X509_get_ext_by_OBJ(X509 *x,ASN1_OBJECT *obj,int lastpos);
00666 
00667    /*
00668     *
00669     */
00670    X509_EXTENSION *X509_get_ext(X509 *x, int loc);
00671 
00672    /*
00673     *
00674     */
00675    X509_EXTENSION *X509_delete_ext(X509 *x, int loc);
00676 
00677    /*
00678     *
00679     */
00680    int X509_add_ext(X509 *x, X509_EXTENSION *ex, int loc);
00681 
00682    /*
00683     *
00684     */
00685    void *X509_get_ext_d2i(X509 *x, int nid, int *crit, int *idx);
00686 
00687    /*
00688     *
00689     */
00690    char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, ASN1_OCTET_STRING *ia5);
00691 
00692    /*
00693     *
00694     */
00695    int ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n);
00696 
00697    /*
00698     *
00699     */
00700    PKCS7 *PKCS7_new(void);
00701 
00702    /*
00703     *
00704     */
00705    void PKCS7_free(PKCS7 *a);
00706 
00707    /*
00708     *
00709     */
00710    void PKCS7_content_free(PKCS7 *a);
00711 
00712    /*
00713     *
00714     */
00715    int i2d_PKCS7(PKCS7 *a, unsigned char **pp);
00716 
00717    /*
00718     *
00719     */
00720    PKCS7 *d2i_PKCS7(PKCS7 **a, unsigned char **pp,long length);
00721 
00722    /*
00723     *
00724     */
00725    int i2d_PKCS7_fp(FILE *fp,PKCS7 *p7);
00726 
00727    /*
00728     *
00729     */
00730    PKCS7 *d2i_PKCS7_fp(FILE *fp,PKCS7 **p7);
00731 
00732    /*
00733     *
00734     */
00735    int i2d_PKCS7_bio(BIO *bp,PKCS7 *p7);
00736 
00737    /*
00738     *
00739     */
00740    PKCS7 *d2i_PKCS7_bio(BIO *bp,PKCS7 **p7);
00741 
00742    /*
00743     *
00744     */
00745    PKCS7 *PKCS7_dup(PKCS7 *p7);
00746 
00747    /*
00748     *  Create a PKCS7 signature / signed message
00749     */
00750    PKCS7 *PKCS7_sign(X509 *signcert, EVP_PKEY *pkey, STACK_OF(X509) *certs,
00751              BIO *data, int flags);
00752 
00753    /*
00754     *  Verify a PKCS7 signature.
00755     */
00756    int PKCS7_verify(PKCS7 *p7, STACK_OF(X509) *certs, X509_STORE *store,
00757                                               BIO *indata, BIO *out, int flags);
00758 
00759    /*
00760     *  Get signers of a verified PKCS7 signature
00761     */
00762    STACK_OF(X509) *PKCS7_get0_signers(PKCS7 *p7, STACK_OF(X509) *certs, int flags);
00763 
00764    /*
00765     *  PKCS7 encrypt message
00766     */
00767    PKCS7 *PKCS7_encrypt(STACK_OF(X509) *certs, BIO *in, EVP_CIPHER *cipher,
00768             int flags);
00769 
00770    /*
00771     *  decrypt PKCS7 message
00772     */
00773    int PKCS7_decrypt(PKCS7 *p7, EVP_PKEY *pkey, X509 *cert, BIO *data, int flags);
00774 
00775 
00776    /*
00777     * Load a CA list file.
00778     */
00779    STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file);
00780 
00781    /*
00782     * Load a file of PEM encoded objects.
00783     */
00784    STACK_OF(X509_INFO) *PEM_X509_INFO_read(FILE *fp, STACK_OF(X509_INFO) *sk,
00785                    pem_password_cb *cb, void *u);
00786 
00787    /*
00788     * Get the number of purposes available
00789     */
00790    int X509_PURPOSE_get_count();
00791 
00792 
00793    /*
00794     * Get the ID of a purpose
00795     */
00796    int X509_PURPOSE_get_id(X509_PURPOSE *);
00797 
00798 
00799    /*
00800     * Check the existence of purpose id "id" in x.  for CA, set ca = 1, else 0
00801     */
00802    int X509_check_purpose(X509 *x, int id, int ca);
00803 
00804 
00805    /*
00806     * Get the purpose with index #idx
00807     */
00808    X509_PURPOSE * X509_PURPOSE_get0(int idx);
00809 
00810 
00811    /*
00812     * Create a new Private KEY
00813     */
00814    EVP_PKEY* EVP_PKEY_new();
00815 
00816 
00817    /*
00818     * Assign a private key
00819     */
00820    int EVP_PKEY_assign(EVP_PKEY *pkey, int type, char *key);
00821 
00822 
00823    /*
00824     * Generate a RSA key
00825     */
00826    RSA *RSA_generate_key(int bits, unsigned long e, void
00827                         (*callback)(int,int,void *), void *cb_arg);
00828 
00829 
00830    /*
00831     * Create/destroy a certificate request
00832     */
00833    X509_REQ *X509_REQ_new();
00834    void X509_REQ_free(X509_REQ *a);
00835 
00836 
00837    /*
00838     * Set the public key in the REQ object
00839     */
00840    int X509_REQ_set_pubkey(X509_REQ *x, EVP_PKEY *pkey);
00841 
00842    /* for testing */
00843    int i2d_X509_REQ_fp(FILE *fp, X509_REQ *x);
00844 
00845    /* SMime support */
00846    STACK *X509_get1_email(X509 *x);
00847    void X509_email_free(STACK *sk);
00848 
00849    /* Ciphers needed for SMime */
00850    EVP_CIPHER *EVP_des_ede3_cbc();
00851    EVP_CIPHER *EVP_des_cbc();
00852    EVP_CIPHER *EVP_rc2_cbc();
00853    EVP_CIPHER *EVP_rc2_64_cbc();
00854    EVP_CIPHER *EVP_rc2_40_cbc();
00855 
00856    /* clear the current error  - use this often*/
00857    void ERR_clear_error();
00858 
00859    /* retrieve the latest error */
00860    unsigned long ERR_get_error();
00861 
00862    /* Print the errors to this stream */
00863    void ERR_print_errors_fp(FILE *fp);
00864 
00865    /* Get a pointer to the SSL session id (reference counted) */
00866    SSL_SESSION *SSL_get1_session(SSL *ssl);
00867 
00868    /* Frees a pointer to the SSL session id (reference decremented if needed) */
00869    void SSL_SESSION_free(SSL_SESSION *session);
00870 
00871    /* Set the SSL session to reuse. */
00872    int SSL_set_session(SSL *ssl, SSL_SESSION *session);
00873 
00874    /* Decode ASN.1 to SSL_SESSION */
00875    SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, unsigned char **pp, long length);
00876    /* Encode SSL_SESSION to ASN.1 */
00877    int i2d_SSL_SESSION(SSL_SESSION *in, unsigned char **pp);
00878 
00879    /* Write privatekey to FILE stream */
00880    int i2d_PrivateKey_fp(FILE*, EVP_PKEY*);
00881 
00882    /* Write PKCS#8privatekey to FILE stream */
00883    int i2d_PKCS8PrivateKey_fp(FILE*, EVP_PKEY*, const EVP_CIPHER*, char*, int, pem_password_cb*, void*);
00884 
00885    /* Free RSA structure */
00886    void RSA_free(RSA*);
00887 
00888    /* Get a blowfish CBC pointer */
00889    EVP_CIPHER *EVP_bf_cbc();
00890 
00891    /* Sign a CSR */
00892    int X509_REQ_sign(X509_REQ*, EVP_PKEY*, const EVP_MD*);
00893 
00894    /* add a name entry */
00895    int X509_NAME_add_entry_by_txt(X509_NAME*, char*, int, unsigned char*, int, int, int);
00896 
00897    /* Create a name */
00898    X509_NAME *X509_NAME_new();
00899 
00900    /* Set the subject */
00901    int X509_REQ_set_subject_name(X509_REQ*,X509_NAME*);
00902 
00903    /* get list of available SSL_CIPHER's sorted by preference */
00904    STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL* ssl);
00905 
00906 #endif
00907 
00908 private:
00909    KOpenSSLProxy();
00910    ~KOpenSSLProxy();
00911    KOpenSSLProxyPrivate *d;
00912 
00913    KLibrary *_sslLib;
00914    KLibrary *_cryptoLib;
00915    static KOpenSSLProxy *_me;
00916 
00917    bool _ok;
00918 };
00919 
00920 #endif
00921 
KDE Home | KDE Accessibility Home | Description of Access Keys