src/core/ext/xds/certificate_provider_registry.h

   1 //
   2 //
   3 // Copyright 2020 gRPC authors.
   4 //
   5 // Licensed under the Apache License, Version 2.0 (the "License");
   6 // you may not use this file except in compliance with the License.
   7 // You may obtain a copy of the License at
   8 //
   9 //     http://www.apache.org/licenses/LICENSE-2.0
  10 //
  11 // Unless required by applicable law or agreed to in writing, software
  12 // distributed under the License is distributed on an "AS IS" BASIS,
  13 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 // See the License for the specific language governing permissions and
  15 // limitations under the License.
  16 //
  17 //
  18
  19 #ifndef GRPC_CORE_EXT_XDS_CERTIFICATE_PROVIDER_REGISTRY_H
  20 #define GRPC_CORE_EXT_XDS_CERTIFICATE_PROVIDER_REGISTRY_H
  21
  22 #include <grpc/support/port_platform.h>
  23
  24 #include <string>
  25
  26 #include "src/core/ext/xds/certificate_provider_factory.h"
  27
  28 namespace grpc_core {
  29
  30 // Global registry for all the certificate provider plugins.
  31 class CertificateProviderRegistry {
  32  public:
  33   // Returns the factory for the plugin keyed by name.
  34   static CertificateProviderFactory* LookupCertificateProviderFactory(
  35       absl::string_view name);
  36
  37   // The following methods are used to create and populate the
  38   // CertificateProviderRegistry. NOT THREAD SAFE -- to be used only during
  39   // global gRPC initialization and shutdown.
  40
  41   // Global initialization of the registry.
  42   static void InitRegistry();
  43
  44   // Global shutdown of the registry.
  45   static void ShutdownRegistry();
  46
  47   // Register a provider with the registry. Can only be called after calling
  48   // InitRegistry(). The key of the factory is extracted from factory
  49   // parameter with method CertificateProviderFactory::name. If the same key
  50   // is registered twice, an exception is raised.
  51   static void RegisterCertificateProviderFactory(
  52       std::unique_ptr<CertificateProviderFactory> factory);
  53 };
  54
  55 }  // namespace grpc_core
  56
  57 #endif  // GRPC_CORE_EXT_XDS_CERTIFICATE_PROVIDER_REGISTRY_H