Partilhar via


Comunicações remotas de serviço seguro em um serviço Java

A segurança é um dos aspetos mais importantes da comunicação. A estrutura do aplicativo Reliable Services fornece algumas pilhas de comunicação pré-criadas e ferramentas que você pode usar para melhorar a segurança. Este artigo descreve como melhorar a segurança quando você está usando a comunicação remota de serviço em um serviço Java. Ele se baseia em um exemplo existente que explica como configurar a comunicação remota para serviços confiáveis escritos em Java.

Para ajudar a proteger um serviço quando você estiver usando a comunicação remota de serviço com serviços Java, siga estas etapas:

  1. Crie uma interface, HelloWorldStateless, que define os métodos que estarão disponíveis para uma chamada de procedimento remoto no seu serviço. Seu serviço usará FabricTransportServiceRemotingListener, que é declarado no microsoft.serviceFabric.services.remoting.fabricTransport.runtime pacote. Esta é uma CommunicationListener implementação que fornece recursos de comunicação remota.

    public interface HelloWorldStateless extends Service {
        CompletableFuture<String> getHelloWorld();
    }
    
    class HelloWorldStatelessImpl extends StatelessService implements HelloWorldStateless {
        @Override
        protected List<ServiceInstanceListener> createServiceInstanceListeners() {
            ArrayList<ServiceInstanceListener> listeners = new ArrayList<>();
            listeners.add(new ServiceInstanceListener((context) -> {
                return new FabricTransportServiceRemotingListener(context,this);
            }));
        return listeners;
        }
    
        public CompletableFuture<String> getHelloWorld() {
            return CompletableFuture.completedFuture("Hello World!");
        }
    }
    
  2. Adicione configurações de ouvinte e credenciais de segurança.

    Verifique se o certificado que você deseja usar para ajudar a proteger a comunicação de serviço está instalado em todos os nós do cluster. Para serviços executados no Linux, o certificado deve estar disponível como um arquivo formado em PEM; Um .pem arquivo que contém o certificado e a chave privada ou um .crt arquivo que contém o certificado e um .key arquivo que contém a chave privada. Para saber mais, consulte Localização e formato de certificados X.509 em nós Linux.

    Há duas maneiras de fornecer configurações de ouvinte e credenciais de segurança:

    1. Forneça-os usando um pacote de configuração:

      Adicione uma seção nomeada TransportSettings no arquivo settings.xml.

      <!--Section name should always end with "TransportSettings".-->
      <!--Here we are using a prefix "HelloWorldStateless".-->
       <Section Name="HelloWorldStatelessTransportSettings">
           <Parameter Name="MaxMessageSize" Value="10000000" />
           <Parameter Name="SecurityCredentialsType" Value="X509_2" />
           <Parameter Name="CertificatePath" Value="/path/to/cert/BD1C71E248B8C6834C151174DECDBDC02DE1D954.crt" />
           <Parameter Name="CertificateProtectionLevel" Value="EncryptandSign" />
           <Parameter Name="CertificateRemoteThumbprints" Value="BD1C71E248B8C6834C151174DECDBDC02DE1D954" />
       </Section>
      
      

      Nesse caso, o createServiceInstanceListeners método terá esta aparência:

       protected List<ServiceInstanceListener> createServiceInstanceListeners() {
           ArrayList<ServiceInstanceListener> listeners = new ArrayList<>();
           listeners.add(new ServiceInstanceListener((context) -> {
               return new FabricTransportServiceRemotingListener(context,this, FabricTransportRemotingListenerSettings.loadFrom(HelloWorldStatelessTransportSettings));
           }));
           return listeners;
       }
      

      Se você adicionar uma TransportSettings seção no arquivo settings.xml sem qualquer prefixo, FabricTransportListenerSettings carregará todas as configurações dessa seção por padrão.

      <!--"TransportSettings" section without any prefix.-->
      <Section Name="TransportSettings">
          ...
      </Section>
      

      Nesse caso, o CreateServiceInstanceListeners método terá esta aparência:

      protected List<ServiceInstanceListener> createServiceInstanceListeners() {
          ArrayList<ServiceInstanceListener> listeners = new ArrayList<>();
          listeners.add(new ServiceInstanceListener((context) -> {
              return new FabricTransportServiceRemotingListener(context,this);
          }));
          return listeners;
      }
      
  3. Quando você chamar métodos em um serviço seguro usando a pilha de comunicação remota, em vez de usar a microsoft.serviceFabric.services.remoting.client.ServiceProxyBase classe para criar um proxy de serviço, use microsoft.serviceFabric.services.remoting.client.FabricServiceProxyFactory.

    Se o código do cliente estiver sendo executado como parte de um serviço, você poderá carregar FabricTransportSettings a partir do arquivo settings.xml. Crie uma seção TransportSettings semelhante ao código de serviço, conforme mostrado anteriormente. Faça as seguintes alterações no código do cliente:

    
    FabricServiceProxyFactory serviceProxyFactory = new FabricServiceProxyFactory(c -> {
            return new FabricTransportServiceRemotingClientFactory(FabricTransportRemotingSettings.loadFrom("TransportPrefixTransportSettings"), null, null, null, null);
        }, null)
    
    HelloWorldStateless client = serviceProxyFactory.createServiceProxy(HelloWorldStateless.class,
        new URI("fabric:/MyApplication/MyHelloWorldService"));
    
    CompletableFuture<String> message = client.getHelloWorld();