/* * X.509 Distinguished Name * (C) 1999-2010,2018 Jack Lloyd * (C) 2017 Fabian Weissberg, Rohde & Schwarz Cybersecurity * * Botan is released under the Simplified BSD License (see license.txt) */ #ifndef BOTAN_X509_DN_H_ #define BOTAN_X509_DN_H_ #include #include #include #include #include #include namespace Botan { /** * Distinguished Name */ class BOTAN_PUBLIC_API(2,0) X509_DN final : public ASN1_Object { public: X509_DN() = default; explicit X509_DN(const std::multimap& args) { for(auto i : args) add_attribute(i.first, i.second); } explicit X509_DN(const std::multimap& args) { for(auto i : args) add_attribute(i.first, i.second); } void encode_into(class DER_Encoder&) const override; void decode_from(class BER_Decoder&) override; bool has_field(const OID& oid) const; ASN1_String get_first_attribute(const OID& oid) const; /* * Return the BER encoded data, if any */ const std::vector& get_bits() const { return m_dn_bits; } bool empty() const { return m_rdn.empty(); } std::string to_string() const; const std::vector>& dn_info() const { return m_rdn; } std::multimap get_attributes() const; std::multimap contents() const; bool has_field(const std::string& attr) const; std::vector get_attribute(const std::string& attr) const; std::string get_first_attribute(const std::string& attr) const; void add_attribute(const std::string& key, const std::string& val); void add_attribute(const OID& oid, const std::string& val) { add_attribute(oid, ASN1_String(val)); } void add_attribute(const OID& oid, const ASN1_String& val); static std::string deref_info_field(const std::string& key); /** * Lookup upper bounds in characters for the length of distinguished name fields * as given in RFC 5280, Appendix A. * * @param oid the oid of the DN to lookup * @return the upper bound, or zero if no ub is known to Botan */ static size_t lookup_ub(const OID& oid); private: std::vector> m_rdn; std::vector m_dn_bits; }; bool BOTAN_PUBLIC_API(2,0) operator==(const X509_DN& dn1, const X509_DN& dn2); bool BOTAN_PUBLIC_API(2,0) operator!=(const X509_DN& dn1, const X509_DN& dn2); /* The ordering here is arbitrary and may change from release to release. It is intended for allowing DNs as keys in std::map and similiar containers */ bool BOTAN_PUBLIC_API(2,0) operator<(const X509_DN& dn1, const X509_DN& dn2); BOTAN_PUBLIC_API(2,0) std::ostream& operator<<(std::ostream& out, const X509_DN& dn); BOTAN_PUBLIC_API(2,0) std::istream& operator>>(std::istream& in, X509_DN& dn); } #endif