# 22. Virtuoso Functions Guide - xenc_key_create_cert

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Virtuoso Functions Guide
Administration
Aggregate Functions
Array Manipulation
BPEL APIs
Backup
Compression
Cursor
Date & Time Manipulation
Debug
Dictionary Manipulation
Encoding & Decoding
File Manipulation
Free Text
Hashing / Cryptographic
dsig_template_ext
md5
md5_final
md5_init
md5_update
x509_certificate_ver...
xenc_x509_certificat...
xenc_decrypt_soap
xenc_delete_temp_key...
xenc_encrypt
xenc_get_key_algo
xenc_get_key_identif...
xenc_key_3des_create
xenc_key_3des_rand_c...
xenc_key_3des_read
xenc_key_aes_create
xenc_key_aes_rand_cr...
xenc_key_dsa_create
xenc_key_dsa_read
xenc_key_rsa_read
xenc_key_create_cert
xenc_key_exists
xenc_key_inst_create
xenc_key_remove
xenc_key_serialize
xenc_set_primary_key
LDAP
Locale
Mail
Miscellaneous
Number
Remote SQL Data Source
Replication
SOAP
SQL
String
Transaction
Type Mapping
UDDI
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
XML
XPATH & XQUERY
Functions Index

## xenc_key_create_cert

Import a key from a certificate
xenc_key_create_cert (in name varchar, in cert varchar, in type varchar, in fmt int, in pkey varchar, in pass varchar);
Description

The function is used to import a key (usually an asymmetric key like RSA or DSA) into user's space from a certificate.

Parameters
name – The name of the key to be registered
cert – String containing the certificate
type – 'X.509' is only supported value
fmt – The input format of the certificate: 3 - "DER", 1 - "PEM" or 2 - "PKCS#12".
pkey – When an X.509 certificate is imported, this can be supplied to load the corresponding private key also. This is optional. Note that when the PKCS#12 format is used to import an X.509 certificate, the private key is in the 'cert', hence this parameter in such case must be omitted.
pass – The password to unlock the private key. If not required this can be NULL to indicate no password is needed.
Return Types

Errors

This function can generate the following errors:

.

Examples
Importing a key from X.509 certificate

    	  ...
    	  xenc_key_create_cert ('myRSA', file_to_string ('keys/mycert.pfx'), 'X.509', 2, NULL, 'secret');
    	  xenc_set_primary_key ('myRSA');
    	  ...

See Also

xenc_set_primary_key()

xenc_key_3DES_create

xenc_key_3des_rand_create

xenc_key_aes_create

xenc_key_3DES_read

xenc_key_DSA_read

xenc_key_dsa_create

xenc_key_RSA_read

xenc_key_serialize

xenc_key_remove