folly/ssl/OpenSSLCertUtils.h

   1 /*
   2  * Copyright 2017 Facebook, Inc.
   3  *
   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
   7  *
   8  *   http://www.apache.org/licenses/LICENSE-2.0
   9  *
  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.
  15  */
  16 #pragma once
  17
  18 #include <string>
  19 #include <vector>
  20
  21 #include <openssl/x509.h>
  22
  23 #include <folly/Optional.h>
  24
  25 namespace folly {
  26 namespace ssl {
  27
  28 class OpenSSLCertUtils {
  29  public:
  30   // Note: non-const until OpenSSL 1.1.0
  31   static Optional<std::string> getCommonName(X509& x509);
  32
  33   static std::vector<std::string> getSubjectAltNames(X509& x509);
  34
  35   /*
  36    * Return the subject name, if any, from the cert
  37    * @param x509    Reference to an X509
  38    * @return a folly::Optional<std::string>, or folly::none
  39    */
  40   static Optional<std::string> getSubject(X509& x509);
  41
  42   /*
  43    * Return the issuer name, if any, from the cert
  44    * @param x509    Reference to an X509
  45    * @return a folly::Optional<std::string>, or folly::none
  46    */
  47   static Optional<std::string> getIssuer(X509& x509);
  48
  49   /*
  50    * Get a string representation of the not-before time on the certificate
  51    */
  52   static std::string getNotBeforeTime(X509& x509);
  53
  54   /*
  55    * Get a string representation of the not-after (expiration) time
  56    */
  57   static std::string getNotAfterTime(X509& x509);
  58
  59   /*
  60    * Summarize the CN, Subject, Issuer, Validity, and extensions as a string
  61    */
  62   static folly::Optional<std::string> toString(X509& x509);
  63
  64  private:
  65   static std::string getDateTimeStr(const ASN1_TIME* time);
  66 };
  67 }
  68 }