Schützen der Dienstremotingkommunikation in einem Java-Dienst
Sicherheit ist einer der wichtigsten Aspekte der Kommunikation. Das Reliable Services-Anwendungsframework stellt einige fertige Kommunikationsstapel und Tools bereit, die Sie verwenden können, um die Sicherheit zu verbessern. In diesem Artikel erfahren Sie, wie Sie die Sicherheit bei Verwendung des Dienstremotings in einem Java-Dienst verbessern können. Der Artikel erläutert anhand eines Beispiels, wie das Remoting für in Java geschriebene Reliable Services eingerichtet wird.
Führen Sie die folgenden Schritte aus, um einen Dienst zu schützen, wenn Sie das Dienstremoting mit Java-Diensten verwenden:
Erstellen Sie eine Schnittstelle,
HelloWorldStateless
, die definiert, welche Methoden für einen Remoteprozeduraufruf Ihres Diensts verfügbar sind. Ihr Dienst verwendetFabricTransportServiceRemotingListener
, der im Paketmicrosoft.serviceFabric.services.remoting.fabricTransport.runtime
deklariert wird. Dies ist eineCommunicationListener
-Implementierung, die Remotingfunktionen bereitstellt.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!"); } }
Fügen Sie Listenereinstellungen und Sicherheitsanmeldeinformationen hinzu.
Stellen Sie sicher, dass das Zertifikat, das Sie zum Schutz Ihrer Dienstkommunikation verwenden möchten, auf allen Knoten im Cluster installiert ist. Bei unter Linux ausgeführten Diensten muss das Zertifikat als Datei im PEM-Format verfügbar sein: Entweder muss eine
.pem
-Datei vorhanden sein, die das Zertifikat und den privaten Schlüssel enthält, oder eine.crt
-Datei mit dem Zertifikat und eine.key
-Datei mit dem privaten Schlüssel. Weitere Informationen finden Sie unter Speicherort und Format von X.509-Zertifikaten auf Linux-Knoten.Es gibt zwei Möglichkeiten, wie Sie Listenereinstellungen und Sicherheitsanmeldeinformationen bereitstellen können:
Bereitstellung mithilfe eines Konfigurationspakets:
Fügen Sie in der Datei „settings.xml“ einen Abschnitt namens
TransportSettings
hinzu.<!--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>
In diesem Fall sieht die
createServiceInstanceListeners
-Methode wie folgt aus:protected List<ServiceInstanceListener> createServiceInstanceListeners() { ArrayList<ServiceInstanceListener> listeners = new ArrayList<>(); listeners.add(new ServiceInstanceListener((context) -> { return new FabricTransportServiceRemotingListener(context,this, FabricTransportRemotingListenerSettings.loadFrom(HelloWorldStatelessTransportSettings)); })); return listeners; }
Wenn Sie in der Datei „settings.xml“ den Abschnitt
TransportSettings
ohne Präfix hinzufügen, lädtFabricTransportListenerSettings
standardmäßig alle Einstellungen aus diesem Abschnitt.<!--"TransportSettings" section without any prefix.--> <Section Name="TransportSettings"> ... </Section>
In diesem Fall sieht die
CreateServiceInstanceListeners
-Methode wie folgt aus:protected List<ServiceInstanceListener> createServiceInstanceListeners() { ArrayList<ServiceInstanceListener> listeners = new ArrayList<>(); listeners.add(new ServiceInstanceListener((context) -> { return new FabricTransportServiceRemotingListener(context,this); })); return listeners; }
Wenn Sie Methoden für einen gesicherten Dienst mit dem Remotingstapel aufrufen, statt mit der
microsoft.serviceFabric.services.remoting.client.ServiceProxyBase
-Klasse einen Dienstproxy zu erstellen, verwenden Siemicrosoft.serviceFabric.services.remoting.client.FabricServiceProxyFactory
.Wenn der Clientcode als Teil eines Diensts ausgeführt wird, können Sie das
FabricTransportSettings
-Element aus der Datei „settings.xml“ laden. Erstellen Sie einen TransportSettings-Abschnitt, der dem obigen Dienstcode ähnelt. Nehmen Sie die folgenden Änderungen am Clientcode vor: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();