resultReceive=communicationManager.receiveAndDecryptString();
+ if(resultReceive.success) {
+ if(resultReceive.payload.trim().startsWith("java")) {
+ communicationPanel.addLog(resultReceive.payload.trim(), true);
+ } else {
+ communicationPanel.addLog(resultReceive.payload.trim(), false);
+ }
+ } else {
+ communicationPanel.addLog(resultReceive.error.toString(), true);
+ }
+ }
+}
diff --git a/client/src/gui/panel/CommunicationPanel.java b/client/src/gui/panel/CommunicationPanel.java
new file mode 100644
index 0000000..dd32e56
--- /dev/null
+++ b/client/src/gui/panel/CommunicationPanel.java
@@ -0,0 +1,85 @@
+package gui.panel;
+
+import java.awt.GridBagConstraints;
+import java.awt.event.KeyEvent;
+import java.util.Locale;
+import java.util.ResourceBundle;
+
+import javax.swing.JButton;
+import javax.swing.JLabel;
+import javax.swing.JTextField;
+
+import gui.GUI;
+
+/**
+ * Handle the communication with the server
+ * Allow the user to input and send commands and display their results.
+ */
+public class CommunicationPanel extends LogPanel {
+ private static final long serialVersionUID = 1L;
+ private JLabel commandLabel;
+ private JTextField commandText;
+ private JButton executeButton;
+
+ private GUI gui;
+
+ public CommunicationPanel(GUI gui) {
+ super();
+ this.gui=gui;
+ initialize();
+ }
+
+ @Override
+ protected void initialize() {
+ super.initialize();
+ //GridBagLayout gbl_main=new GridBagLayout();
+ //this.setLayout(gbl_main);
+
+ commandLabel=new JLabel("labelCommand");
+ GridBagConstraints gbc_commandLabel=new GridBagConstraints();
+ gbc_commandLabel.gridx=0;
+ gbc_commandLabel.gridy=0;
+ gbc_commandLabel.anchor=GridBagConstraints.WEST;
+ this.add(commandLabel,gbc_commandLabel);
+
+ commandText=new JTextField();
+ commandText.addKeyListener(new java.awt.event.KeyAdapter() {
+ @Override
+ public void keyPressed(java.awt.event.KeyEvent e) {
+ if(e.getKeyCode() == KeyEvent.VK_ENTER){
+ executeButton.doClick();
+ }
+ }
+ });
+ GridBagConstraints gbc_commandText=new GridBagConstraints();
+ gbc_commandText.gridx=0;
+ gbc_commandText.gridy=1;
+ gbc_commandText.weightx=1.0d;
+ gbc_commandText.fill=GridBagConstraints.BOTH;
+ this.add(commandText,gbc_commandText);
+
+ executeButton=new JButton("executeButton");
+ executeButton.addActionListener(new java.awt.event.ActionListener() {
+ @Override
+ public void actionPerformed(java.awt.event.ActionEvent e) {
+ if(commandText.getText().isBlank()==false) {
+ gui.sendCommand(commandText.getText());
+ }
+ }
+ });
+ GridBagConstraints gbc_executeButton=new GridBagConstraints();
+ gbc_executeButton.gridx=3;
+ gbc_executeButton.gridy=1;
+ this.add(executeButton,gbc_executeButton);
+
+ setText();
+ }
+
+ @Override
+ public void setText() {
+ super.setText();
+ ResourceBundle resourceBundle=ResourceBundle.getBundle("bundle/Bundle",Locale.getDefault());
+ commandLabel.setText(resourceBundle.getString("commandToExecute"));
+ executeButton.setText(resourceBundle.getString("execute"));
+ }
+}
\ No newline at end of file
diff --git a/client/src/gui/panel/ConnectionPanel.java b/client/src/gui/panel/ConnectionPanel.java
new file mode 100644
index 0000000..107d79b
--- /dev/null
+++ b/client/src/gui/panel/ConnectionPanel.java
@@ -0,0 +1,145 @@
+package gui.panel;
+
+import java.awt.GridBagConstraints;
+import java.awt.event.KeyEvent;
+import java.util.Locale;
+import java.util.ResourceBundle;
+
+import javax.swing.JLabel;
+import javax.swing.JTextField;
+import javax.swing.JToggleButton;
+import javax.swing.SwingConstants;
+
+import gui.GUI;
+
+/**
+ * Handle connection state, allowing to set up and establish a connection as well as displaying it status.
+ */
+public class ConnectionPanel extends LogPanel {
+ private static final long serialVersionUID = 1L;
+ private JLabel addressLabel;
+ private JTextField addressText;
+ private JLabel portLabel;
+ private JTextField portText;
+ private JLabel addressPortSepartatorLabel;
+ private JToggleButton connectionToggleButton;
+
+ private GUI gui;
+
+ public void setAddress(String address) {
+ if(addressText!=null) addressText.setText(address);
+ }
+ public void setPort(String port) {
+ if(portText!=null) portText.setText(port);
+ }
+
+ public ConnectionPanel(GUI gui) {
+ super();
+ this.gui=gui;
+ initialize();
+ }
+
+ @Override
+ protected void initialize() {
+ super.initialize();
+ /*GridBagLayout gbl_main=new GridBagLayout();
+ this.setLayout(gbl_main);*/
+
+ addressLabel=new JLabel("addressLabel");
+ GridBagConstraints gbc_addressLabel=new GridBagConstraints();
+ gbc_addressLabel.gridx=0;
+ gbc_addressLabel.gridy=0;
+ this.add(addressLabel,gbc_addressLabel);
+
+ addressText=new JTextField();
+ addressText.setHorizontalAlignment(SwingConstants.CENTER);
+ addressText.addKeyListener(new java.awt.event.KeyAdapter() {
+ @Override
+ public void keyPressed(java.awt.event.KeyEvent e) {
+ if(e.getKeyCode() == KeyEvent.VK_ENTER){
+ if(connectionToggleButton.isSelected()==false) {
+ connectionToggleButton.doClick();
+ }
+ }
+ }
+ });
+ GridBagConstraints gbc_addressText=new GridBagConstraints();
+ gbc_addressText.gridx=0;
+ gbc_addressText.gridy=1;
+ gbc_addressText.weightx=0.5d;
+ gbc_addressText.fill=GridBagConstraints.BOTH;
+ this.add(addressText,gbc_addressText);
+
+ addressPortSepartatorLabel=new JLabel(" : ");
+ addressPortSepartatorLabel.setHorizontalAlignment(SwingConstants.CENTER);
+ GridBagConstraints gbc_addressPortSepartatorLabel=new GridBagConstraints();
+ gbc_addressPortSepartatorLabel.gridx=1;
+ gbc_addressPortSepartatorLabel.gridy=1;
+ this.add(addressPortSepartatorLabel,gbc_addressPortSepartatorLabel);
+
+ portLabel=new JLabel("portLabel");
+ GridBagConstraints gbc_portLabel=new GridBagConstraints();
+ gbc_portLabel.gridx=2;
+ gbc_portLabel.gridy=0;
+ this.add(portLabel,gbc_portLabel);
+
+ portText=new JTextField();
+ portText.setHorizontalAlignment(SwingConstants.CENTER);
+ portText.addKeyListener(new java.awt.event.KeyAdapter() {
+ @Override
+ public void keyPressed(java.awt.event.KeyEvent e) {
+ if(e.getKeyCode() == KeyEvent.VK_ENTER){
+ if(connectionToggleButton.isSelected()==false) {
+ connectionToggleButton.doClick();
+ }
+ }
+ }
+ });
+ GridBagConstraints gbc_portText=new GridBagConstraints();
+ gbc_portText.gridx=2;
+ gbc_portText.gridy=1;
+ gbc_portText.weightx=0.5d;
+ gbc_portText.fill=GridBagConstraints.BOTH;
+ this.add(portText,gbc_portText);
+
+ connectionToggleButton=new JToggleButton("connectionToggleButton");
+ connectionToggleButton.addActionListener(new java.awt.event.ActionListener() {
+ @Override
+ public void actionPerformed(java.awt.event.ActionEvent e) {
+ boolean success=gui.changeConnectionStatus(connectionToggleButton.isSelected(),addressText.getText(),portText.getText());
+ if(success==false) {
+ connectionToggleButton.setSelected(false);
+ }
+ setTextConnectionToggleButton();
+ }
+ });
+ GridBagConstraints gbc_connectionToggleButton=new GridBagConstraints();
+ gbc_connectionToggleButton.gridx=3;
+ gbc_connectionToggleButton.gridy=1;
+ gbc_connectionToggleButton.fill=GridBagConstraints.HORIZONTAL;
+ this.add(connectionToggleButton,gbc_connectionToggleButton);
+
+ setText();
+ }
+
+ /**
+ * Set the correct text for toggleButtonConnection regarding the selected language and it's status.
+ */
+ private void setTextConnectionToggleButton() {
+ ResourceBundle resourceBundle=ResourceBundle.getBundle("bundle/Bundle",Locale.getDefault());
+ if(connectionToggleButton.isSelected()) {
+ connectionToggleButton.setText(resourceBundle.getString("connected"));
+ }else {
+ connectionToggleButton.setText(resourceBundle.getString("connection"));
+ }
+ }
+
+ @Override
+ public void setText() {
+ super.setText();
+ ResourceBundle resourceBundle=ResourceBundle.getBundle("bundle/Bundle",Locale.getDefault());
+ addressLabel.setText(resourceBundle.getString("address"));
+ portLabel.setText(resourceBundle.getString("port"));
+ setTextConnectionToggleButton();
+ }
+}
diff --git a/client/src/gui/panel/LogPanel.java b/client/src/gui/panel/LogPanel.java
new file mode 100644
index 0000000..851ca62
--- /dev/null
+++ b/client/src/gui/panel/LogPanel.java
@@ -0,0 +1,97 @@
+package gui.panel;
+
+import java.awt.Color;
+import java.awt.GridBagConstraints;
+import java.awt.GridBagLayout;
+import java.awt.Insets;
+import java.util.Locale;
+import java.util.ResourceBundle;
+
+import javax.swing.JButton;
+import javax.swing.JPanel;
+import javax.swing.JScrollPane;
+import javax.swing.JTextPane;
+import javax.swing.text.BadLocationException;
+import javax.swing.text.SimpleAttributeSet;
+import javax.swing.text.StyleConstants;
+import javax.swing.text.StyledDocument;
+
+public class LogPanel extends JPanel {
+ private static final long serialVersionUID = 1L;
+ private JTextPane logTextPane;
+ private StyledDocument logStyleDocument;
+ private SimpleAttributeSet normalAttributeSet;
+ private SimpleAttributeSet errorAttributeSet;
+ private JScrollPane logScrollPane;
+ private JButton clearLogButton;
+
+ public LogPanel( ) {
+ super();
+ normalAttributeSet=new SimpleAttributeSet();
+ normalAttributeSet.addAttribute(StyleConstants.Foreground,Color.black);
+ errorAttributeSet=new SimpleAttributeSet();
+ errorAttributeSet.addAttribute(StyleConstants.Foreground,Color.red);
+ // initialize();
+ }
+
+ /**
+ * Initialize the default state of the different GUI elements.
+ */
+ protected void initialize() {
+ GridBagLayout gbl_main=new GridBagLayout();
+ this.setLayout(gbl_main);
+
+ logTextPane=new JTextPane();
+ logStyleDocument=logTextPane.getStyledDocument();
+ logScrollPane=new JScrollPane(logTextPane);
+ GridBagConstraints gbc_logScrollPane=new GridBagConstraints();
+ gbc_logScrollPane.gridx=0;
+ gbc_logScrollPane.gridy=2;
+ gbc_logScrollPane.weightx=1.0d;
+ gbc_logScrollPane.weighty=1.0d;
+ gbc_logScrollPane.gridwidth=4;
+ gbc_logScrollPane.fill=GridBagConstraints.BOTH;
+ gbc_logScrollPane.insets=new Insets(5,0,0,0);
+ this.add(logScrollPane,gbc_logScrollPane);
+
+ clearLogButton=new JButton("clearLogButton");
+ clearLogButton.addActionListener(new java.awt.event.ActionListener() {
+ @Override
+ public void actionPerformed(java.awt.event.ActionEvent e) {
+ logTextPane.setText("");
+ }
+ });
+ GridBagConstraints gbc_clearLogButton=new GridBagConstraints();
+ gbc_clearLogButton.gridx=3;
+ gbc_clearLogButton.gridy=3;
+ gbc_clearLogButton.fill=GridBagConstraints.HORIZONTAL;
+ this.add(clearLogButton,gbc_clearLogButton);
+ }
+
+ /**
+ * Set the correct text for all graphical elements according to the default {@link Locale}.
+ * @see java.util.Locale#getDefault()
+ */
+ public void setText() {
+ ResourceBundle resourceBundle=ResourceBundle.getBundle("bundle/Bundle",Locale.getDefault());
+ clearLogButton.setText(resourceBundle.getString("clear"));
+ }
+
+ /**
+ * Append data to the log.
+ * @param data message to append.
+ * @param error indicate if data correspond to an error or not.
+ */
+ public void addLog(String data,Boolean error) {
+ try {
+ if(logStyleDocument.getLength()>0) data="\n"+data;
+ if(error) {
+ logStyleDocument.insertString(logStyleDocument.getLength(), data, errorAttributeSet);
+ }else {
+ logStyleDocument.insertString(logStyleDocument.getLength(), data, normalAttributeSet);
+ }
+ }catch(BadLocationException e) {
+ logTextPane.setText(logTextPane.getText()+"\n"+data.trim().trim());
+ }
+ }
+}
diff --git a/client/src/main/Primary.java b/client/src/main/Primary.java
new file mode 100644
index 0000000..d83ef5c
--- /dev/null
+++ b/client/src/main/Primary.java
@@ -0,0 +1,76 @@
+package main;
+
+import java.util.Locale;
+import java.util.ResourceBundle;
+
+import generic.Status;
+import gui.GUI;
+import network.Client;
+import network.CommunicationManager;
+
+public class Primary {
+
+ public static void main(String[] args) {
+ String serverAddress="127.0.0.1";
+ int serverPort=6200;
+ String command="";
+
+ //Handle user arguments
+ if(args.length>0){
+ for(int i=0;i connectStatus=communicationManager.connect();
+ if(connectStatus.success==false) {
+ connectStatus.error.toString();
+ return;
+ }
+ System.out.println(resourceBundle.getString("connectedTo")+": "+serverAddress+":"+serverPort);
+
+ Status sendStatus=communicationManager.encryptAndSendString(command);
+ if(sendStatus.success) {
+ Status receiveStatus=communicationManager.receiveAndDecryptString();
+ if(receiveStatus.success) {
+ System.out.println(receiveStatus.payload.trim());
+ } else {
+ receiveStatus.error.toString();
+ }
+ } else {
+ sendStatus.error.toString();
+ }
+ communicationManager.disconnect();
+ System.out.println(resourceBundle.getString("connectionEnded"));
+ }
+
+}
diff --git a/client/src/network/Client.java b/client/src/network/Client.java
new file mode 100644
index 0000000..efd9652
--- /dev/null
+++ b/client/src/network/Client.java
@@ -0,0 +1,159 @@
+package network;
+import java.io.BufferedReader;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.io.ObjectInputStream;
+import java.io.ObjectOutputStream;
+import java.io.PrintStream;
+import java.net.Socket;
+
+import generic.Status;
+/**
+ * TCP client allowing to send and receive Objects.
+ */
+public class Client {
+ private int serverPort;
+ private String serverAddress;
+ private Socket socket;
+ private BufferedReader is;
+ private PrintStream os;
+ private ObjectInputStream ois;
+ private ObjectOutputStream oos;
+
+ public Client(){
+ serverPort=8033;
+ serverAddress="127.0.0.1";
+ }
+ public Client(int port){
+ serverPort=port;
+ serverAddress="127.0.0.1";
+ }
+ public Client(int port,String ip){
+ serverPort=port;
+ serverAddress=ip;
+ }
+
+ public int getServerPort() {
+ return serverPort;
+ }
+ public void setServerPort(int serverPort) {
+ this.serverPort = serverPort;
+ }
+ public String getServerAddress() {
+ return serverAddress;
+ }
+ public void setServerAddress(String serverAddress) {
+ this.serverAddress = serverAddress;
+ }
+ public Socket getSocket() {
+ return socket;
+ }
+ public void setSocket(Socket socket) {
+ this.socket = socket;
+ if(socket!=null) {
+ try {
+ setIs(new BufferedReader(new InputStreamReader(socket.getInputStream())));
+ setOs(new PrintStream(socket.getOutputStream()));
+ setOos(new ObjectOutputStream(socket.getOutputStream()));
+ setOis(new ObjectInputStream(socket.getInputStream()));
+ } catch (Exception e) {
+ }
+ }
+ }
+ public BufferedReader getIs() {
+ return is;
+ }
+ public void setIs(BufferedReader is) {
+ this.is = is;
+ }
+ public PrintStream getOs() {
+ return os;
+ }
+ public void setOs(PrintStream os) {
+ this.os = os;
+ }
+ public ObjectInputStream getOis() {
+ return ois;
+ }
+ public void setOis(ObjectInputStream ois) {
+ this.ois = ois;
+ }
+ public ObjectOutputStream getOos() {
+ return oos;
+ }
+ public void setOos(ObjectOutputStream oos) {
+ this.oos = oos;
+ }
+
+ public Status connect(){
+ Status result=new Status(true);
+ try {
+ socket=new Socket(serverAddress,serverPort);
+ is=new BufferedReader(new InputStreamReader(socket.getInputStream()));
+ os=new PrintStream(socket.getOutputStream());
+ ois=new ObjectInputStream(socket.getInputStream());
+ oos=new ObjectOutputStream(socket.getOutputStream());
+ result.message=socket.getInetAddress().toString().substring(1)+":"+socket.getPort();
+ } catch (Exception e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ public Status sendString(String message){
+ Status result=new Status(true);
+ try {
+ os.println(message);
+ } catch (Exception e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ public Status receiveString(){
+ Status result=new Status(true);
+ try {
+ result.payload=is.readLine();
+ } catch (IOException e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ public Status sendObject(Object object){
+ Status result=new Status(true);
+ try {
+ oos.writeObject(object);
+ } catch (IOException e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ public Status receiveObject(){
+ Status result=new Status(true);
+ try {
+ result.payload=ois.readObject();
+ } catch (Exception e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ public Status close(){
+ Status result=new Status(true);
+ if(this.socket==null) return result;
+ try {
+ socket.close();
+ } catch (IOException e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+}
\ No newline at end of file
diff --git a/client/src/network/CommunicationManager.java b/client/src/network/CommunicationManager.java
new file mode 100644
index 0000000..bd8cd7d
--- /dev/null
+++ b/client/src/network/CommunicationManager.java
@@ -0,0 +1,340 @@
+package network;
+
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.security.NoSuchAlgorithmException;
+import java.util.Base64;
+
+import javax.crypto.Cipher;
+import javax.crypto.KeyGenerator;
+import javax.crypto.SecretKey;
+import javax.crypto.spec.SecretKeySpec;
+
+import generic.Status;
+
+public class CommunicationManager {
+ private Client client;
+ /** Key used to initialize the connection. */
+ private SecretKey masterKey;
+ /** Communication key between the client and the server. */
+ private SecretKey communicationKey;
+ /** If true then the message will be send using the communicationKey. Otherwise, the masterKey will be used.*/
+ private boolean useCommunicationKey;
+
+ public CommunicationManager(Client client) {
+ this.client=client;
+ this.masterKey=new SecretKeySpec(new byte[]{-70,-45,-79,-32,-36,108,-117,-7,-97,56,46,-86,-35,-11,-35,-81}, "AES");
+ this.useCommunicationKey=false;
+ }
+
+ public String getAddress() {
+ if(client!=null) return client.getServerAddress();
+ return "";
+ }
+ public int getPort() {
+ if(client!=null) return client.getServerPort();
+ return 0;
+ }
+
+ /**
+ * Establish connection with the server set in the {@link #client}.
+ * If no error, then swap the key from master to communication.
+ * @return response {@link Status} object.
+ */
+ public Status connect() {
+ Status status=new Status(true);
+
+ //Stop immediately if already connected
+ if(client!=null && client.getSocket()!=null && client.getSocket().isConnected()) {
+ return status;
+ }
+
+ //Connect to server
+ status=client.connect();
+ if(status.success==false) {
+ return status;
+ }
+
+ //Change from master key to a communication key
+ Status keyStatus=client.receiveString();
+ if(keyStatus.success==false) {
+ status.success=keyStatus.success;
+ status.error=keyStatus.error;
+ return status;
+ }
+ Status decryptStatus=decryptString(keyStatus.payload, masterKey);
+ if(decryptStatus.success==false) {
+ status.success=decryptStatus.success;
+ status.error=decryptStatus.error;
+ return status;
+ }
+ String[] encodedKeyString=decryptStatus.payload.split(";");
+ byte[] encodedKey=new byte[encodedKeyString.length];
+ for(int i=0;i connect(String address,int port) {
+ if(client.getSocket()!=null && client.getSocket().isConnected()) {
+ disconnect();
+ }
+ this.client=new Client(port, address);
+ return connect();
+ }
+
+ /**
+ * Encrypt and send data.
+ * @param data data to send.
+ * @return response {@link Status} object.
+ */
+ public Status encryptAndSendString(String data) {
+ String encryptedMessage="";
+ if(useCommunicationKey) {
+ encryptedMessage=encryptString(data, communicationKey).payload;
+ }else {
+ encryptedMessage=encryptString(data, masterKey).payload;
+ }
+ return client.sendString(encryptedMessage);
+ }
+
+ /**
+ * Receive and decrypt data.
+ * @return response {@link Status} object.
+ */
+ public Status receiveAndDecryptString() {
+ Status status=client.receiveString();
+ if(status.success==false) {
+ status.success=status.success;
+ status.error=status.error;
+ return status;
+ }
+
+ if(useCommunicationKey) {
+ status=decryptString(status.payload, communicationKey);
+ }else {
+ status=decryptString(status.payload, masterKey);
+ }
+
+ if(status.success==false) {
+ status.success=status.success;
+ status.error=status.error;
+ }
+ return status;
+ }
+
+ /**
+ * Close the communication socket.
+ * Inform the remote client of the deconnection.
+ * @return response {@link Status} object.
+ */
+ public Status disconnect() {
+ encryptAndSendString("STOPstopSTOP");
+ return client.close();
+ }
+
+ /**
+ * Generate and setup a communication key to replace the master key for future communication.
+ * Send the new key to the client.
+ */
+ public void setupCommunicationKey() {
+ communicationKey=generateSecretKey();
+ String encodedKey="";
+ for(int i=0;i encrypt(byte[] data) {
+ if(useCommunicationKey) {
+ return encrypt(data,communicationKey);
+ }else{
+ return encrypt(data,masterKey);
+ }
+ }
+
+ /**
+ * Encrypt a message with the specified key.
+ * @param data message to encrypt.
+ * @param secretKey secret key to use.
+ * @return response {@link Status} object.
+ */
+ private Status encrypt(byte[] data,SecretKey secretKey) {
+ Status result=new Status(true);
+ try {
+ Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
+ cipher.init(Cipher.ENCRYPT_MODE, secretKey);
+
+ byte[] encrypt=cipher.doFinal(data);
+ /*
+ * Base64.getEncoder().encode() is here to
+ * prevent javax.crypto.IllegalBlockSizeException:
+ * Input length must be multiple of 16 when decrypting with padded cipher
+ */
+ result.payload=Base64.getEncoder().encode(encrypt);
+ } catch (Exception e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ /**
+ * Encrypt a message.
+ * @param data message to encrypt.
+ * @return response {@link Status} object.
+ */
+ public Status encryptString(String data) {
+ if(useCommunicationKey) {
+ return encryptString(data,communicationKey);
+ }else{
+ return encryptString(data,masterKey);
+ }
+ }
+
+ /**
+ * Use {@link #encrypt(String, SecretKey)} to encrypt a message.
+ * @param data message to encrypt.
+ * @param secretKey secret key to use.
+ * @return response {@link Status} object.
+ */
+ private Status encryptString(String data,SecretKey secretKey) {
+ Status result=new Status(true);
+ Status encryptResult=encrypt(data.getBytes(StandardCharsets.UTF_8),secretKey);
+
+ result.message=encryptResult.message;
+ result.success=encryptResult.success;
+ result.error=encryptResult.error;
+ if(encryptResult.success) {
+ result.payload=new String(encryptResult.payload,StandardCharsets.UTF_8);
+ }
+ return result;
+ }
+
+ /*private String padStringForCrypto (String data) {
+ //Prevent javax.crypto.IllegalBlockSizeException:
+ //Input length must be multiple of 16 when decrypting with padded cipher
+ if(data.length()%16!=0) {
+ System.out.println("data length="+data.length());
+ double dataLengthNeeded=Math.ceil((double)data.length()/16d)*16;
+ data=String.format("%-"+(int)dataLengthNeeded+"s", data);
+ System.out.println("data length="+data.length());
+ }
+ return data;
+ }*/
+
+ /**
+ * Decrypt a message.
+ * @param data encrypted message.
+ * @return response {@link Status} object.
+ */
+ public Status decrypt(byte[] data){
+ if(useCommunicationKey) {
+ return decrypt(data,communicationKey);
+ }else{
+ return decrypt(data,masterKey);
+ }
+ }
+
+ /**
+ * Decrypt a message with the specified key.
+ * @param data encrypted message.
+ * @param secretKey secret key to use.
+ * @return response {@link Status} object.
+ */
+ private Status decrypt(byte[] data,SecretKey secretKey) {
+ Status result=new Status(true);
+ try {
+ Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding");
+ cipher.init(Cipher.DECRYPT_MODE, secretKey);
+ /*
+ * Base64.getDecoder().decode() is here to
+ * prevent javax.crypto.IllegalBlockSizeException:
+ * Input length must be multiple of 16 when decrypting with padded cipher
+ */
+ result.payload=cipher.doFinal(Base64.getDecoder().decode(data));
+ } catch (Exception e) {
+ result.success=false;
+ result.error=e;
+ }
+ return result;
+ }
+
+ /**
+ * Decrypt a {@link String}.
+ * @param data encrypted message.
+ * @return response {@link Status} object.
+ */
+ public Status decryptString(String data) {
+ if(useCommunicationKey) {
+ return decryptString(data,communicationKey);
+ }else{
+ return decryptString(data,masterKey);
+ }
+ }
+
+ /**
+ * Use {@link #encrypt(String, SecretKey)} to decrypt a message.
+ * @param data encrypted message.
+ * @param secretKey secret key to use.
+ * @return response {@link Status} object.
+ */
+ private Status decryptString(String data,SecretKey secretKey) {
+ Status result=new Status(true);
+
+ byte[] dataByte;
+ try {
+ dataByte=data.getBytes(StandardCharsets.UTF_8);
+ } catch (NullPointerException e) {
+ result.error=e;
+ result.success=false;
+ return result;
+ }
+
+ Status decryptResult=decrypt(dataByte,secretKey);
+ result.message=decryptResult.message;
+ result.success=decryptResult.success;
+ result.error=decryptResult.error;
+ if(decryptResult.success) {
+ result.payload=new String(decryptResult.payload,StandardCharsets.UTF_8);
+ }
+
+ return result;
+ }
+}
diff --git a/img/CommandPC_commandIpconfig.png b/img/CommandPC_commandIpconfig.png
new file mode 100755
index 0000000000000000000000000000000000000000..8201c434bc369954fbaa289493271d747bc3adf4
GIT binary patch
literal 84646
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