Botan::AlternativeName Class Reference

#include <pkix_types.h>

Inheritance diagram for Botan::AlternativeName:

Public Member Functions
void	add_attribute (const std::string &type, const std::string &value)
void	add_othername (const OID &oid, const std::string &value, ASN1_Tag type)
	AlternativeName (const std::string &email_addr="", const std::string &uri="", const std::string &dns="", const std::string &ip_address="")
std::vector< uint8_t >	BER_encode () const
std::multimap< std::string, std::string >	contents () const
void	decode_from (BER_Decoder &) override
X509_DN	dn () const
void	encode_into (DER_Encoder &) const override
std::vector< std::string >	get_attribute (const std::string &attr) const
const std::multimap< std::string, std::string > &	get_attributes () const
std::string	get_first_attribute (const std::string &attr) const
const std::multimap< OID, ASN1_String > &	get_othernames () const
bool	has_field (const std::string &attr) const
bool	has_items () const

Detailed Description

Alternative Name

Definition at line 123 of file pkix_types.h.

Constructor & Destructor Documentation

AlternativeName()

Botan::AlternativeName::AlternativeName	(	const std::string &	email_addr = "",
		const std::string &	uri = "",
		const std::string &	dns = "",
		const std::string &	ip_address = ""
	)

Definition at line 24 of file asn1_alt_name.cpp.

   {
   add_attribute("RFC822", email_addr);
   add_attribute("DNS", dns);
   add_attribute("URI", uri);
   add_attribute("IP", ip);
   }

References add_attribute().

Member Function Documentation

add_attribute()

void Botan::AlternativeName::add_attribute	(	const std::string &	type,
		const std::string &	value
	)

Definition at line 38 of file asn1_alt_name.cpp.

   {
   if(type.empty() || value.empty())
      return;
 
   auto range = m_alt_info.equal_range(type);
   for(auto j = range.first; j != range.second; ++j)
      if(j->second == value)
         return;
 
   multimap_insert(m_alt_info, type, value);
   }

References Botan::multimap_insert(), and type.

Referenced by AlternativeName(), Botan::create_alt_name(), and decode_from().

add_othername()

void Botan::AlternativeName::add_othername	(	const OID &	oid,
		const std::string &	value,
		ASN1_Tag	type
	)

Definition at line 55 of file asn1_alt_name.cpp.

   {
   if(value.empty())
      return;
   multimap_insert(m_othernames, oid, ASN1_String(value, type));
   }

References Botan::multimap_insert(), and type.

Referenced by decode_from().

BER_encode()

std::vector< uint8_t > Botan::ASN1_Object::BER_encode ( ) const

inherited

Return the encoding of this object. This is a convenience method when just one object needs to be serialized. Use DER_Encoder for complicated encodings.

Definition at line 16 of file asn1_obj.cpp.

   {
   std::vector<uint8_t> output;
   DER_Encoder der(output);
   this->encode_into(der);
   return output;
   }

References Botan::ASN1_Object::encode_into().

Referenced by Botan::PSSR::config_for_x509(), Botan::Certificate_Store_In_SQL::find_all_certs(), Botan::Certificate_Store_In_SQL::find_cert(), Botan::X509_Certificate::fingerprint(), Botan::Certificate_Store_In_SQL::insert_cert(), Botan::X509_Object::PEM_encode(), and Botan::Certificate_Store_In_SQL::revoke_cert().

contents()

std::multimap< std::string, std::string > Botan::AlternativeName::contents

(

)

const

Definition at line 66 of file asn1_alt_name.cpp.

   {
   std::multimap<std::string, std::string> names;
 
   for(auto i = m_alt_info.begin(); i != m_alt_info.end(); ++i)
      {
      multimap_insert(names, i->first, i->second);
      }
 
   for(auto i = m_othernames.begin(); i != m_othernames.end(); ++i)
      {
      multimap_insert(names, i->first.to_formatted_string(), i->second.value());
      }
 
   return names;
   }

References Botan::multimap_insert().

decode_from()

void Botan::AlternativeName::decode_from ( BER_Decoder &  from )

overridevirtual

Decode whatever this object is from from

Parameters

from	the BER_Decoder that will be read from

Implements Botan::ASN1_Object.

Definition at line 195 of file asn1_alt_name.cpp.

   {
   BER_Decoder names = source.start_cons(SEQUENCE);
 
   // FIXME this is largely a duplication of GeneralName::decode_from
 
   while(names.more_items())
      {
      BER_Object obj = names.get_next_object();
 
      if(obj.is_a(0, CONTEXT_SPECIFIC))
         {
         BER_Decoder othername(obj);
 
         OID oid;
         othername.decode(oid);
         if(othername.more_items())
            {
            BER_Object othername_value_outer = othername.get_next_object();
            othername.verify_end();
 
            if(othername_value_outer.is_a(0, ASN1_Tag(CONTEXT_SPECIFIC | CONSTRUCTED)) == false)
               throw Decoding_Error("Invalid tags on otherName value");
 
            BER_Decoder othername_value_inner(othername_value_outer);
 
            BER_Object value = othername_value_inner.get_next_object();
            othername_value_inner.verify_end();
 
            if(ASN1_String::is_string_type(value.type()) && value.get_class() == UNIVERSAL)
               {
               add_othername(oid, ASN1::to_string(value), value.type());
               }
            }
         }
      if(obj.is_a(1, CONTEXT_SPECIFIC))
         {
         add_attribute("RFC822", ASN1::to_string(obj));
         }
      else if(obj.is_a(2, CONTEXT_SPECIFIC))
         {
         add_attribute("DNS", ASN1::to_string(obj));
         }
      else if(obj.is_a(6, CONTEXT_SPECIFIC))
         {
         add_attribute("URI", ASN1::to_string(obj));
         }
      else if(obj.is_a(4, ASN1_Tag(CONTEXT_SPECIFIC | CONSTRUCTED)))
         {
         BER_Decoder dec(obj);
         X509_DN dn;
         std::stringstream ss;
 
         dec.decode(dn);
         ss << dn;
 
         add_attribute("DN", ss.str());
         }
      else if(obj.is_a(7, CONTEXT_SPECIFIC))
         {
         if(obj.length() == 4)
            {
            const uint32_t ip = load_be<uint32_t>(obj.bits(), 0);
            add_attribute("IP", ipv4_to_string(ip));
            }
         }
 
      }
   }

References add_attribute(), add_othername(), Botan::BER_Object::bits(), Botan::CONSTRUCTED, Botan::CONTEXT_SPECIFIC, Botan::BER_Decoder::decode(), dn(), Botan::BER_Object::get_class(), Botan::BER_Decoder::get_next_object(), Botan::ipv4_to_string(), Botan::BER_Object::is_a(), Botan::ASN1_String::is_string_type(), Botan::BER_Object::length(), Botan::load_be< uint32_t >(), Botan::BER_Decoder::more_items(), Botan::SEQUENCE, Botan::BER_Decoder::start_cons(), Botan::ASN1::to_string(), Botan::BER_Object::type(), Botan::UNIVERSAL, and Botan::BER_Decoder::verify_end().

dn()

X509_DN Botan::AlternativeName::dn

(

)

const

Definition at line 107 of file asn1_alt_name.cpp.

   {
   X509_DN dn;
   auto range = m_alt_info.equal_range("DN");
 
   for(auto i = range.first; i != range.second; ++i)
      {
      std::istringstream strm(i->second);
      strm >> dn;
      }
 
   return dn;
   }

References dn().

Referenced by decode_from(), dn(), and Botan::GeneralName::matches().

encode_into()

void Botan::AlternativeName::encode_into ( DER_Encoder &  to ) const

overridevirtual

Encode whatever this object is into to

Parameters

to	the DER_Encoder that will be written to

Implements Botan::ASN1_Object.

Definition at line 169 of file asn1_alt_name.cpp.

   {
   der.start_cons(SEQUENCE);
 
   encode_entries(der, m_alt_info, "RFC822", ASN1_Tag(1));
   encode_entries(der, m_alt_info, "DNS", ASN1_Tag(2));
   encode_entries(der, m_alt_info, "DN", ASN1_Tag(4));
   encode_entries(der, m_alt_info, "URI", ASN1_Tag(6));
   encode_entries(der, m_alt_info, "IP", ASN1_Tag(7));
 
   for(auto i = m_othernames.begin(); i != m_othernames.end(); ++i)
      {
      der.start_explicit(0)
         .encode(i->first)
         .start_explicit(0)
            .encode(i->second)
         .end_explicit()
      .end_explicit();
      }
 
   der.end_cons();
   }

References Botan::DER_Encoder::encode(), Botan::DER_Encoder::end_cons(), Botan::DER_Encoder::end_explicit(), Botan::SEQUENCE, Botan::DER_Encoder::start_cons(), and Botan::DER_Encoder::start_explicit().

get_attribute()

std::vector< std::string > Botan::AlternativeName::get_attribute

(

const std::string &

attr

)

const

Definition at line 98 of file asn1_alt_name.cpp.

   {
   std::vector<std::string> results;
   auto range = m_alt_info.equal_range(attr);
   for(auto i = range.first; i != range.second; ++i)
      results.push_back(i->second);
   return results;
   }

Referenced by Botan::X509_Certificate::issuer_info(), Botan::GeneralName::matches(), and Botan::X509_Certificate::subject_info().

get_attributes()

const std::multimap< std::string, std::string > & Botan::AlternativeName::get_attributes ( ) const

inline

Definition at line 139 of file pkix_types.h.

         {
         return m_alt_info;
         }

get_first_attribute()

std::string Botan::AlternativeName::get_first_attribute

(

const std::string &

attr

)

const

Definition at line 89 of file asn1_alt_name.cpp.

   {
   auto i = m_alt_info.lower_bound(attr);
   if(i != m_alt_info.end() && i->first == attr)
      return i->second;
 
   return "";
   }

get_othernames()

const std::multimap< OID, ASN1_String > & Botan::AlternativeName::get_othernames ( ) const

inline

Definition at line 144 of file pkix_types.h.

         {
         return m_othernames;
         }

has_field()

bool Botan::AlternativeName::has_field

(

const std::string &

attr

)

const

Definition at line 83 of file asn1_alt_name.cpp.

   {
   auto range = m_alt_info.equal_range(attr);
   return (range.first != range.second);
   }

has_items()

bool Botan::AlternativeName::has_items

(

)

const

Definition at line 124 of file asn1_alt_name.cpp.

   {
   return (m_alt_info.size() > 0 || m_othernames.size() > 0);
   }

---

The documentation for this class was generated from the following files:

• src/lib/x509/pkix_types.h
• src/lib/x509/asn1_alt_name.cpp