2 * Copyright 2001-2007 Internet2
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
18 * FilesystemCredentialResolver.cpp
20 * Supplies credentials from local files
25 #include "security/BasicX509Credential.h"
26 #include "security/CredentialCriteria.h"
27 #include "security/CredentialResolver.h"
28 #include "security/KeyInfoResolver.h"
29 #include "security/OpenSSLCredential.h"
30 #include "security/OpenSSLCryptoX509CRL.h"
32 #include "util/PathResolver.h"
33 #include "util/XMLHelper.h"
35 #include <sys/types.h>
37 #include <openssl/pkcs12.h>
38 #include <xercesc/util/XMLUniDefs.hpp>
39 #include <xsec/enc/OpenSSL/OpenSSLCryptoX509.hpp>
40 #include <xsec/enc/OpenSSL/OpenSSLCryptoKeyRSA.hpp>
41 #include <xsec/enc/OpenSSL/OpenSSLCryptoKeyDSA.hpp>
43 using namespace xmlsignature;
44 using namespace xmltooling::logging;
45 using namespace xmltooling;
48 // OpenSSL password callback...
49 static int passwd_callback(char* buf, int len, int verify, void* passwd)
53 if(passwd && len > strlen(reinterpret_cast<char*>(passwd)))
55 strcpy(buf,reinterpret_cast<char*>(passwd));
62 namespace xmltooling {
64 #if defined (_MSC_VER)
65 #pragma warning( push )
66 #pragma warning( disable : 4250 )
69 class XMLTOOL_DLLLOCAL FilesystemCredentialResolver;
70 class XMLTOOL_DLLLOCAL FilesystemCredential : public OpenSSLCredential, public BasicX509Credential
74 FilesystemCredentialResolver* resolver, XSECCryptoKey* key, const std::vector<XSECCryptoX509*>& xseccerts, XSECCryptoX509CRL* crl=NULL
75 ) : BasicX509Credential(key, xseccerts, crl), m_resolver(resolver), m_usage(UNSPECIFIED_CREDENTIAL) {
76 if (!m_xseccerts.empty())
77 extractNames(m_xseccerts.front(), m_keyNames);
80 virtual ~FilesystemCredential() {
83 unsigned int getUsage() const {
87 void setUsage(const XMLCh* usage) {
88 if (usage && *usage) {
89 auto_ptr_char u(usage);
90 if (!strcmp(u.get(), "signing"))
91 m_usage = SIGNING_CREDENTIAL | TLS_CREDENTIAL;
92 else if (!strcmp(u.get(), "TLS"))
93 m_usage = TLS_CREDENTIAL;
94 else if (!strcmp(u.get(), "encryption"))
95 m_usage = ENCRYPTION_CREDENTIAL;
99 void addKeyNames(const DOMElement* e);
101 void attach(SSL_CTX* ctx) const;
104 FilesystemCredentialResolver* m_resolver;
105 unsigned int m_usage;
108 #if defined (_MSC_VER)
109 #pragma warning( pop )
112 class XMLTOOL_DLLLOCAL FilesystemCredentialResolver : public CredentialResolver
115 FilesystemCredentialResolver(const DOMElement* e);
116 virtual ~FilesystemCredentialResolver() {
118 for_each(m_certs.begin(),m_certs.end(),X509_free);
121 Lockable* lock() { return this; }
124 const Credential* resolve(const CredentialCriteria* criteria=NULL) const {
125 return (criteria ? (criteria->matches(*m_credential) ? m_credential : NULL) : m_credential);
128 virtual vector<const Credential*>::size_type resolve(
129 vector<const Credential*>& results, const CredentialCriteria* criteria=NULL
131 if (!criteria || criteria->matches(*m_credential)) {
132 results.push_back(m_credential);
138 void attach(SSL_CTX* ctx) const;
141 XSECCryptoKey* loadKey();
142 XSECCryptoX509CRL* loadCRL();
144 enum format_t { PEM=SSL_FILETYPE_PEM, DER=SSL_FILETYPE_ASN1, _PKCS12, UNKNOWN };
146 format_t getEncodingFormat(BIO* in) const;
147 string formatToString(format_t format) const;
148 format_t xmlFormatToFormat(const XMLCh* format_xml) const;
150 format_t m_keyformat,m_crlformat;
151 string m_keypath,m_keypass,m_crlpath;
152 vector<X509*> m_certs;
153 FilesystemCredential* m_credential;
156 CredentialResolver* XMLTOOL_DLLLOCAL FilesystemCredentialResolverFactory(const DOMElement* const & e)
158 return new FilesystemCredentialResolver(e);
161 static const XMLCh _CredentialResolver[] = UNICODE_LITERAL_18(C,r,e,d,e,n,t,i,a,l,R,e,s,o,l,v,e,r);
162 static const XMLCh CAPath[] = UNICODE_LITERAL_6(C,A,P,a,t,h);
163 static const XMLCh Certificate[] = UNICODE_LITERAL_11(C,e,r,t,i,f,i,c,a,t,e);
164 static const XMLCh _certificate[] = UNICODE_LITERAL_11(c,e,r,t,i,f,i,c,a,t,e);
165 static const XMLCh CRL[] = UNICODE_LITERAL_3(C,R,L);
166 static const XMLCh format[] = UNICODE_LITERAL_6(f,o,r,m,a,t);
167 static const XMLCh Key[] = UNICODE_LITERAL_3(K,e,y);
168 static const XMLCh _key[] = UNICODE_LITERAL_3(k,e,y);
169 static const XMLCh keyName[] = UNICODE_LITERAL_7(k,e,y,N,a,m,e);
170 static const XMLCh Name[] = UNICODE_LITERAL_4(N,a,m,e);
171 static const XMLCh password[] = UNICODE_LITERAL_8(p,a,s,s,w,o,r,d);
172 static const XMLCh Path[] = UNICODE_LITERAL_4(P,a,t,h);
173 static const XMLCh _use[] = UNICODE_LITERAL_3(u,s,e);
176 FilesystemCredentialResolver::FilesystemCredentialResolver(const DOMElement* e) : m_credential(NULL)
179 NDC ndc("FilesystemCredentialResolver");
181 Category& log=Category::getInstance(XMLTOOLING_LOGCAT".CredentialResolver."FILESYSTEM_CREDENTIAL_RESOLVER);
183 if (e && (e->hasAttributeNS(NULL,_certificate) || e->hasAttributeNS(NULL,_key))) {
184 // Dummy up a simple file resolver config using these attributes.
185 DOMElement* dummy = e->getOwnerDocument()->createElementNS(NULL,_CredentialResolver);
188 if (e->hasAttributeNS(NULL,_key)) {
189 child = e->getOwnerDocument()->createElementNS(NULL,Key);
190 dummy->appendChild(child);
191 path = e->getOwnerDocument()->createElementNS(NULL,Path);
192 child->appendChild(path);
193 path->appendChild(e->getOwnerDocument()->createTextNode(e->getAttributeNS(NULL,_key)));
194 if (e->hasAttributeNS(NULL,password))
195 child->setAttributeNS(NULL,password,e->getAttributeNS(NULL,password));
196 if (e->hasAttributeNS(NULL,keyName)) {
197 path = e->getOwnerDocument()->createElementNS(NULL,Name);
198 child->appendChild(path);
199 path->appendChild(e->getOwnerDocument()->createTextNode(e->getAttributeNS(NULL,keyName)));
202 if (e->hasAttributeNS(NULL,_certificate)) {
203 child = e->getOwnerDocument()->createElementNS(NULL,Certificate);
204 dummy->appendChild(child);
205 path = e->getOwnerDocument()->createElementNS(NULL,Path);
206 child->appendChild(path);
207 path->appendChild(e->getOwnerDocument()->createTextNode(e->getAttributeNS(NULL,_certificate)));
209 e = dummy; // reset "root" to the dummy config element
212 const DOMElement* root=e;
213 const XMLCh* usage = root->getAttributeNS(NULL,_use);
215 XSECCryptoKey* key=NULL;
216 vector<XSECCryptoX509*> xseccerts;
217 XSECCryptoX509CRL* crl=NULL;
220 const XMLCh* format_xml=NULL;
224 const DOMElement* keynode=XMLHelper::getFirstChildElement(root,Key);
226 // Get raw format attrib value, but defer processing til later since may need to
227 // determine format dynamically, and we need the Path for that.
228 format_xml=keynode->getAttributeNS(NULL,format);
230 const XMLCh* password_xml=keynode->getAttributeNS(NULL,password);
232 auto_ptr_char kp(password_xml);
236 e=XMLHelper::getFirstChildElement(keynode,Path);
237 if (e && e->hasChildNodes()) {
238 const XMLCh* s=e->getFirstChild()->getNodeValue();
239 auto_ptr_char kpath(s);
240 m_keypath = kpath.get();
241 XMLToolingConfig::getConfig().getPathResolver()->resolve(m_keypath, PathResolver::XMLTOOLING_CFG_FILE);
243 struct _stat stat_buf;
244 if (_stat(m_keypath.c_str(), &stat_buf) != 0)
246 struct stat stat_buf;
247 if (stat(m_keypath.c_str(), &stat_buf) != 0)
250 log.error("key file (%s) can't be opened", m_keypath.c_str());
251 throw XMLSecurityException("FilesystemCredentialResolver can't access key file ($1)",params(1,m_keypath.c_str()));
255 log.error("Path element missing inside Key element");
256 throw XMLSecurityException("FilesystemCredentialResolver can't access key file, no Path element specified.");
259 // Determine the key encoding format dynamically, if not explicitly specified
260 if (format_xml && *format_xml) {
261 fformat = xmlFormatToFormat(format_xml);
262 if (fformat != UNKNOWN) {
263 m_keyformat = fformat;
266 auto_ptr_char unknown(format_xml);
267 log.error("configuration specifies unknown key encoding format (%s)", unknown.get());
268 throw XMLSecurityException("FilesystemCredentialResolver configuration contains unknown key encoding format ($1)",params(1,unknown.get()));
272 in=BIO_new(BIO_s_file_internal());
273 if (in && BIO_read_filename(in,m_keypath.c_str())>0) {
274 m_keyformat = getEncodingFormat(in);
275 log.debug("key encoding format for (%s) dynamically resolved as (%s)", m_keypath.c_str(), formatToString(m_keyformat).c_str());
278 log.error("key file (%s) can't be read to determine encoding format", m_keypath.c_str());
279 throw XMLSecurityException("FilesystemCredentialResolver can't read key file ($1) to determine encoding format",params(1,m_keypath.c_str()));
291 const DOMElement* crlnode=XMLHelper::getFirstChildElement(root,CRL);
293 // Get raw format attrib value, but defer processing til later since may need to
294 // determine format dynamically, and we need the Path for that.
295 format_xml=crlnode->getAttributeNS(NULL,format);
297 e=XMLHelper::getFirstChildElement(crlnode,Path);
298 if (e && e->hasChildNodes()) {
299 const XMLCh* s=e->getFirstChild()->getNodeValue();
300 auto_ptr_char kpath(s);
301 m_crlpath=kpath.get();
302 XMLToolingConfig::getConfig().getPathResolver()->resolve(m_crlpath, PathResolver::XMLTOOLING_CFG_FILE);
304 struct _stat stat_buf;
305 if (_stat(m_crlpath.c_str(), &stat_buf) != 0)
307 struct stat stat_buf;
308 if (stat(m_crlpath.c_str(), &stat_buf) != 0)
311 log.error("CRL file (%s) can't be opened", m_crlpath.c_str());
312 throw XMLSecurityException("FilesystemCredentialResolver can't access CRL file ($1)",params(1,m_crlpath.c_str()));
316 log.error("Path element missing inside CRL element");
317 throw XMLSecurityException("FilesystemCredentialResolver can't access CRL file, no Path element specified.");
320 // Determine the CRL encoding format dynamically, if not explicitly specified
321 if (format_xml && *format_xml) {
322 fformat = xmlFormatToFormat(format_xml);
323 if (fformat != UNKNOWN) {
324 m_crlformat = fformat;
327 auto_ptr_char unknown(format_xml);
328 log.error("configuration specifies unknown CRL encoding format (%s)", unknown.get());
329 throw XMLSecurityException("FilesystemCredentialResolver configuration contains unknown CRL encoding format ($1)",params(1,unknown.get()));
333 in=BIO_new(BIO_s_file_internal());
334 if (in && BIO_read_filename(in,m_crlpath.c_str())>0) {
335 m_crlformat = getEncodingFormat(in);
336 log.debug("CRL encoding format for (%s) dynamically resolved as (%s)", m_crlpath.c_str(), formatToString(m_crlformat).c_str());
339 log.error("CRL file (%s) can't be read to determine encoding format", m_crlpath.c_str());
340 throw XMLSecurityException("FilesystemCredentialResolver can't read CRL file ($1) to determine encoding format",params(1,m_crlpath.c_str()));
351 // Check for Certificate
352 e=XMLHelper::getFirstChildElement(root,Certificate);
354 m_credential = new FilesystemCredential(this,key,xseccerts,crl);
355 m_credential->addKeyNames(keynode);
356 m_credential->setUsage(usage);
359 auto_ptr_char certpass(e->getAttributeNS(NULL,password));
361 const DOMElement* ep=XMLHelper::getFirstChildElement(e,Path);
362 if (!ep || !ep->hasChildNodes()) {
363 log.error("Path element missing inside Certificate element or is empty");
366 throw XMLSecurityException("FilesystemCredentialResolver can't access certificate file, missing or empty Path element.");
369 auto_ptr_char certpath2(ep->getFirstChild()->getNodeValue());
370 string certpath(certpath2.get());
371 XMLToolingConfig::getConfig().getPathResolver()->resolve(certpath, PathResolver::XMLTOOLING_CFG_FILE);
373 format_xml=e->getAttributeNS(NULL,format);
374 if (format_xml && *format_xml) {
375 fformat = xmlFormatToFormat(format_xml);
376 if (fformat == UNKNOWN) {
377 auto_ptr_char unknown(format_xml);
378 log.error("configuration specifies unknown certificate encoding format (%s)", unknown.get());
381 throw XMLSecurityException("FilesystemCredentialResolver configuration contains unknown certificate encoding format ($1)",params(1,unknown.get()));
388 in=BIO_new(BIO_s_file_internal());
389 if (in && BIO_read_filename(in,certpath.c_str())>0) {
390 if (!format_xml || !*format_xml) {
391 // Determine the cert encoding format dynamically, if not explicitly specified
392 fformat = getEncodingFormat(in);
393 log.debug("certificate encoding format for (%s) dynamically resolved as (%s)", certpath.c_str(), formatToString(fformat).c_str());
398 while (x=PEM_read_bio_X509(in,NULL,passwd_callback,const_cast<char*>(certpass.get())))
399 m_certs.push_back(x);
403 x=d2i_X509_bio(in,NULL);
405 m_certs.push_back(x);
409 throw XMLSecurityException("FilesystemCredentialResolver unable to load DER certificate from file ($1)",params(1,certpath.c_str()));
414 p12=d2i_PKCS12_bio(in,NULL);
416 PKCS12_parse(p12, certpass.get(), NULL, &x, NULL);
420 m_certs.push_back(x);
425 throw XMLSecurityException("FilesystemCredentialResolver unable to load PKCS12 certificate from file ($1)",params(1,certpath.c_str()));
436 throw XMLSecurityException("FilesystemCredentialResolver unable to load certificate(s) from file ($1)",params(1,certpath.c_str()));
444 throw XMLSecurityException("FilesystemCredentialResolver unable to load any certificate(s)");
446 // Load any extra CA files.
447 const DOMElement* extra=XMLHelper::getFirstChildElement(e,CAPath);
449 if (!extra->hasChildNodes()) {
450 log.warn("skipping empty CAPath element");
451 extra = XMLHelper::getNextSiblingElement(extra,CAPath);
454 auto_ptr_char capath2(extra->getFirstChild()->getNodeValue());
455 string capath(capath2.get());
456 XMLToolingConfig::getConfig().getPathResolver()->resolve(capath, PathResolver::XMLTOOLING_CFG_FILE);
459 in=BIO_new(BIO_s_file_internal());
460 if (in && BIO_read_filename(in,capath.c_str())>0) {
461 if (!format_xml || !*format_xml) {
462 // Determine the cert encoding format dynamically, if not explicitly specified
463 fformat = getEncodingFormat(in);
464 log.debug("CA certificate encoding format for (%s) dynamically resolved as (%s)", capath.c_str(), formatToString(fformat).c_str());
469 while (x=PEM_read_bio_X509(in,NULL,NULL,NULL))
470 m_certs.push_back(x);
474 x=d2i_X509_bio(in,NULL);
476 m_certs.push_back(x);
480 throw XMLSecurityException("FilesystemCredentialResolver unable to load DER CA certificate from file ($1)",params(1,capath.c_str()));
485 p12 = d2i_PKCS12_bio(in, NULL);
487 PKCS12_parse(p12, NULL, NULL, &x, NULL);
491 m_certs.push_back(x);
497 throw XMLSecurityException("FilesystemCredentialResolver unable to load PKCS12 CA certificate from file ($1)",params(1,capath.c_str()));
508 log.error("CA file (%s) can't be opened", capath.c_str());
509 throw XMLSecurityException("FilesystemCredentialResolver can't open CA file ($1)",params(1,capath.c_str()));
512 extra = XMLHelper::getNextSiblingElement(extra,CAPath);
515 catch (XMLToolingException&) {
518 for_each(m_certs.begin(), m_certs.end(), X509_free);
522 // Reflect certs over to XSEC form and wrap with credential object.
523 for (vector<X509*>::iterator j=m_certs.begin(); j!=m_certs.end(); j++)
524 xseccerts.push_back(new OpenSSLCryptoX509(*j));
525 if (!key && !xseccerts.empty())
526 key = xseccerts.front()->clonePublicKey();
527 m_credential = new FilesystemCredential(this, key, xseccerts, crl);
528 m_credential->addKeyNames(keynode);
529 m_credential->setUsage(usage);
532 XSECCryptoKey* FilesystemCredentialResolver::loadKey()
540 BIO* in=BIO_new(BIO_s_file_internal());
541 if (in && BIO_read_filename(in,m_keypath.c_str())>0) {
542 switch (m_keyformat) {
544 pkey=PEM_read_bio_PrivateKey(in, NULL, passwd_callback, const_cast<char*>(m_keypass.c_str()));
548 pkey=d2i_PrivateKey_bio(in, NULL);
552 PKCS12* p12 = d2i_PKCS12_bio(in, NULL);
554 PKCS12_parse(p12, const_cast<char*>(m_keypass.c_str()), &pkey, NULL, NULL);
563 // Now map it to an XSEC wrapper.
565 XSECCryptoKey* ret=NULL;
566 switch (pkey->type) {
568 ret=new OpenSSLCryptoKeyRSA(pkey);
572 ret=new OpenSSLCryptoKeyDSA(pkey);
576 Category::getInstance(XMLTOOLING_LOGCAT".CredentialResolver."FILESYSTEM_CREDENTIAL_RESOLVER).error("unsupported private key type");
584 throw XMLSecurityException("FilesystemCredentialResolver unable to load private key from file.");
587 XSECCryptoX509CRL* FilesystemCredentialResolver::loadCRL()
594 BIO* in=BIO_new(BIO_s_file_internal());
595 if (in && BIO_read_filename(in,m_crlpath.c_str())>0) {
596 switch (m_crlformat) {
598 crl=PEM_read_bio_X509_CRL(in, NULL, NULL, NULL);
602 crl=d2i_X509_CRL_bio(in, NULL);
609 // Now map it to an XSEC wrapper.
611 XSECCryptoX509CRL* ret=new OpenSSLCryptoX509CRL(crl);
617 throw XMLSecurityException("FilesystemCredentialResolver unable to load CRL from file.");
620 // Used to determine the encoding format of credentials files
621 // dynamically. Supports: PEM, DER, PKCS12.
622 FilesystemCredentialResolver::format_t FilesystemCredentialResolver::getEncodingFormat(BIO* in) const
627 const int READSIZE = 1;
633 if ( (mark = BIO_tell(in)) < 0 )
634 throw XMLSecurityException("getEncodingFormat: BIO_tell() can't get the file position");
635 if ( BIO_read(in, buf, READSIZE) <= 0 )
636 throw XMLSecurityException("getEncodingFormat: BIO_read() can't read from the stream");
637 if ( BIO_seek(in, mark) < 0 )
638 throw XMLSecurityException("getEncodingFormat: BIO_seek() can't reset the file position");
647 // This is a slight variation of the Java code by Chad La Joie.
649 // Check the first byte of the file. If it's some kind of
650 // DER-encoded structure (including PKCS12), it will begin with ASCII 048.
651 // Otherwise, assume it's PEM.
655 // Here we know it's DER-encoded, now try to parse it as a PKCS12
656 // ASN.1 structure. If it fails, must be another kind of DER-encoded
657 // key/cert structure. A little inefficient...but it works.
658 if ( (p12=d2i_PKCS12_bio(in,NULL)) == NULL ) {
665 if ( BIO_seek(in, mark) < 0 ) {
667 throw XMLSecurityException("getEncodingFormat: BIO_seek() can't reset the file position");
674 // Convert key/cert format_t types to a human-meaningful string for debug output
675 string FilesystemCredentialResolver::formatToString(format_t format) const
689 // Convert key/cert raw XML format attribute (XMLCh[]) to format_t type
690 FilesystemCredentialResolver::format_t FilesystemCredentialResolver::xmlFormatToFormat(const XMLCh* format_xml) const
692 static const XMLCh cPEM[] = UNICODE_LITERAL_3(P,E,M);
693 static const XMLCh cDER[] = UNICODE_LITERAL_3(D,E,R);
694 static const XMLCh cPKCS12[] = { chLatin_P, chLatin_K, chLatin_C, chLatin_S, chDigit_1, chDigit_2, chNull };
697 if (!XMLString::compareString(format_xml,cPEM))
699 else if (!XMLString::compareString(format_xml,cDER))
701 else if (!XMLString::compareString(format_xml,cPKCS12))
709 void FilesystemCredentialResolver::attach(SSL_CTX* ctx) const
715 if (m_keypath.empty())
716 throw XMLSecurityException("No key available, unable to attach private key to SSL context.");
719 SSL_CTX_set_default_passwd_cb(ctx, passwd_callback);
720 SSL_CTX_set_default_passwd_cb_userdata(ctx, const_cast<char*>(m_keypass.c_str()));
723 switch (m_keyformat) {
725 ret=SSL_CTX_use_PrivateKey_file(ctx, m_keypath.c_str(), m_keyformat);
729 ret=SSL_CTX_use_RSAPrivateKey_file(ctx, m_keypath.c_str(), m_keyformat);
733 BIO* in=BIO_new(BIO_s_file_internal());
734 if (in && BIO_read_filename(in,m_keypath.c_str())>0) {
736 PKCS12* p12 = d2i_PKCS12_bio(in, NULL);
738 PKCS12_parse(p12, const_cast<char*>(m_keypass.c_str()), &pkey, NULL, NULL);
741 ret=SSL_CTX_use_PrivateKey(ctx, pkey);
753 throw XMLSecurityException("Unable to attach private key to SSL context.");
757 for (vector<X509*>::const_iterator i=m_certs.begin(); i!=m_certs.end(); i++) {
758 if (i==m_certs.begin()) {
759 if (SSL_CTX_use_certificate(ctx, *i) != 1) {
761 throw XMLSecurityException("Unable to attach client certificate to SSL context.");
765 // When we add certs, they don't get ref counted, so we need to duplicate them.
766 X509* dup = X509_dup(*i);
767 if (SSL_CTX_add_extra_chain_cert(ctx, dup) != 1) {
770 throw XMLSecurityException("Unable to attach CA certificate to SSL context.");
776 void FilesystemCredential::addKeyNames(const DOMElement* e)
778 e = e ? XMLHelper::getFirstChildElement(e, Name) : NULL;
780 if (e->hasChildNodes()) {
781 auto_ptr_char n(e->getFirstChild()->getNodeValue());
782 if (n.get() && *n.get())
783 m_keyNames.insert(n.get());
785 e = XMLHelper::getNextSiblingElement(e, Name);
789 void FilesystemCredential::attach(SSL_CTX* ctx) const
791 return m_resolver->attach(ctx);