App2App additional service implementation (#39, #40)

* App2App additional service implementation (#39)

* App2App additional service -rest and cli initial implementation

* App2App additional service -soap implementation

* App2App additional service SignatureRequest model enhancements, refactoring and code quality checks

* Potential fix for pull request finding 'Missing catch of NumberFormatException'

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>

* App2App (AS) cont'd with loop on app2app service until expire of transaction

* Version bump up to 1.6.0

Signed-off-by: thomas4v <thomas4v@gmail.com>

* keep services at model package level, correct for license formatting

---------

Signed-off-by: thomas4v <thomas4v@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com>

Author: thomas4v

docs/use-the-client-via-cli.md

@@ -42,6 +42,9 @@ Arguments:
     -receipt                                            - For sign operation. Send a receipt after the signature is acquired successfully
     
     -geofencing                                         - For sign operation. Request additional geofencing data
+    
+    -app2app="myapp://example"                          - For sign operation (async only). Request App2App service which allows an Application Provider to automatically switch from
+                                                          their App to the Mobile ID App (and the Mobile ID App to automatically switch back to the originating App)
 
     -validate                                           - For sign operation. Validate the signature once it is successfully acquired
 
@@ -78,6 +81,7 @@ Use cases:
     - ./bin/mid-client.sh -profile-query -msisdn=41790000000 -soap
     - ./bin/mid-client.sh -sign -receipt -msisdn=41790000000 -lang=en -dtbs="Do you want to login?" -req-timeout=120
     - ./bin/mid-client.sh -sign -sync -receipt -msisdn=41790000000 -lang=en -dtbs="Do you want to login?" -soap -vv
+    - ./bin/mid-client.sh -sign -async -msisdn=41790000000 -lang=en -app2app="myapp://example" -dtbs="Do you want to login?" -rest -vv
     - ./bin/mid-client.sh \
            -config=my-config.properties \
            -sign -sync -receipt -geofencing \
@@ -95,46 +99,64 @@ Use the _-v_, _-vv_ and _-vvv_ arguments for increasingly detailed log levels, i
 exchanged packets.
 
 ## Examples
+
 Start with a fresh set of configuration files:
+
 ```shell
 ./bin/mid-client.sh -init 
 ```
 
 Get the profile information for a particular phone number (MSISDN) that your application provider is controlling:
+
 ```shell
 ./bin/mid-client.sh -profile-query -msisdn 41790000000 
 ```
 
 Get the same profile information using a particular configuration file and the SOAP interface of Mobile ID:
+
 ```shell
 ./bin/mid-client.sh -profile-query -msisdn 41790000000 -config local-config.properties -soap 
 ```
 
 Request a digital signature to a particular phone number (MSISDN), in sync mode:
+
 ```shell
 ./bin/mid-client.sh -sign -msisdn=41790000000 -geofencing -lang=en -dtbs "Do you want to login?" -sync  
 ```
 
 Request a digital signature to a particular phone number (MSISDN), in async mode (this is the default mode) and with signature receipt:
+
 ```shell
 ./bin/mid-client.sh -sign -msisdn=41790000000 -lang=en -dtbs "Do you want to login?" -receipt -req-timeout 120  
 ```
 
+Request a digital signature to a particular phone number (MSISDN), in async mode (this is the default mode) and with app2app service:
+
+```shell
+./bin/mid-client.sh -sign -msisdn=41790000000 -lang=en -app2app="myapp://example" -req-timeout 120  
+```
+
 Request a Mobile ID Serial number based on particular phone number (MSISDN), in async mode:
+
 ```shell
 ./bin/mid-client.sh -get-mid-sn -msisdn=41790000000 -rest
 ```
 
 Note: when working with arguments that have values (such as _-msisdn_) you can pass the value either as the next argument:
+
 ```shell
 ./bin/mid-client.sh -sign -msisdn 41790000000
 ```
+
 or in the form _name=value_:
+
 ```shell
 ./bin/mid-client.sh -sign -msisdn=41790000000
 ```
+
 Please note that the _-dtbs_ argument is a bit more special, as it will most likely contain spaces, so either the entire name=value
 construct is enclosed in double quotes or, if you use the name<space>value form, then the value is enclosed in double quotes:
+
 ```shell
 ./bin/mid-client.sh -sign -msisdn=41790000000 -dtbs "Do you want to login?"
 ./bin/mid-client.sh -sign -msisdn=41790000000 "-dtbs=Do you want to login?"

mid-java-client-core/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>ch.mobileid.mid-java-client</groupId>
         <artifactId>mid-java-client-parent</artifactId>
-        <version>1.5.8</version>
+        <version>1.6.0</version>
     </parent>
 
     <artifactId>mid-java-client-core</artifactId>

mid-java-client-core/src/main/java/ch/swisscom/mid/client/config/DefaultConfiguration.java

@@ -32,6 +32,7 @@ public class DefaultConfiguration {
     public static final String ADDITIONAL_SERVICE_USER_LANG_URI = "http://mss.ficom.fi/TS102204/v1.0.0#userLang";
     public static final String ADDITIONAL_SERVICE_SIGNATURE_VALIDATION_URI = "http://uri.etsi.org/TS102204/v1.1.2#validate";
     public static final String ADDITIONAL_SERVICE_GEOFENCING = "http://mid.swisscom.ch/as#geofencing";
+    public static final String ADDITIONAL_SERVICE_APP2APP = "http://mid.swisscom.ch/as#app2app";
 
     public static final String SIGNATURE_REQUEST_MAJOR_VERSION = "1";
     public static final String SIGNATURE_REQUEST_MINOR_VERSION = "2";

mid-java-client-core/src/main/java/ch/swisscom/mid/client/impl/Loggers.java

@@ -29,6 +29,8 @@ public class Loggers {
     public static final String REQUEST_RESPONSE = "ch.swisscom.mid.client.requestResponse";
     public static final String FULL_REQUEST_RESPONSE = "ch.swisscom.mid.client.fullRequestResponse";
     public static final String SIGNATURE_VALIDATOR = "ch.swisscom.mid.signatureValidator";
+    public static final String STATUS_QUERY_MODEL_UTILS = "ch.swisscom.mid.client.rest.statusQueryModelUtils";
+    public static final String SIGN_REQ_MODEL_UTILS = "ch.swisscom.mid.client.rest.signatureRequestModelUtils";
 
     // ----------------------------------------------------------------------------------------------------
 

mid-java-client-core/src/main/java/ch/swisscom/mid/client/model/AdditionalService.java

@@ -1,45 +1,47 @@
-/*
- * Copyright 2021 Swisscom (Schweiz) AG
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package ch.swisscom.mid.client.model;
-
-/**
- * Base class for requesting additional services via requests to the Mobile ID service. You can either make an instance of this class
- * and set the URI by yourself, or use one of the provided subclasses. There is also a corresponding {@link AdditionalServiceResponse}
- * that contains, as expected, the data that is returned as part of the requested additional service payload.
- *
- * @see UserLangAdditionalService
- * @see SignatureValidationAdditionalService
- * @see GeofencingAdditionalService
- */
-public class AdditionalService {
-
-    private final String uri;
-
-    public AdditionalService(String uri) {
-        this.uri = uri;
-    }
-
-    public String getUri() {
-        return uri;
-    }
-
-    @Override
-    public String toString() {
-        return "AdditionalService{" +
-               "uri='" + uri + '\'' +
-               '}';
-    }
-}
+/*
+ *
+ *  * Copyright 2021-2026 Swisscom (Schweiz) AG
+ *  *
+ *  * Licensed under the Apache License, Version 2.0 (the "License");
+ *  * you may not use this file except in compliance with the License.
+ *  * You may obtain a copy of the License at
+ *  *
+ *  * http://www.apache.org/licenses/LICENSE-2.0
+ *  *
+ *  * Unless required by applicable law or agreed to in writing, software
+ *  * distributed under the License is distributed on an "AS IS" BASIS,
+ *  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  * See the License for the specific language governing permissions and
+ *  * limitations under the License.
+ *
+ */
+package ch.swisscom.mid.client.model;
+
+/**
+ * Base class for requesting additional services via requests to the Mobile ID service. You can either make an instance of this class
+ * and set the URI by yourself, or use one of the provided subclasses. There is also a corresponding {@link AdditionalServiceResponse}
+ * that contains, as expected, the data that is returned as part of the requested additional service payload.
+ *
+ * @see UserLangAdditionalService
+ * @see SignatureValidationAdditionalService
+ * @see GeofencingAdditionalService
+ */
+public class AdditionalService {
+
+    private final String uri;
+
+    public AdditionalService(String uri) {
+        this.uri = uri;
+    }
+
+    public String getUri() {
+        return uri;
+    }
+
+    @Override
+    public String toString() {
+        return "AdditionalService{" +
+                "uri='" + uri + '\'' +
+                '}';
+    }
+}

mid-java-client-core/src/main/java/ch/swisscom/mid/client/model/App2App.java

@@ -0,0 +1,38 @@
+/*
+ *
+ *  * Copyright 2021-2026 Swisscom (Schweiz) AG
+ *  *
+ *  * Licensed under the Apache License, Version 2.0 (the "License");
+ *  * you may not use this file except in compliance with the License.
+ *  * You may obtain a copy of the License at
+ *  *
+ *  * http://www.apache.org/licenses/LICENSE-2.0
+ *  *
+ *  * Unless required by applicable law or agreed to in writing, software
+ *  * distributed under the License is distributed on an "AS IS" BASIS,
+ *  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  * See the License for the specific language governing permissions and
+ *  * limitations under the License.
+ *
+ */
+
+package ch.swisscom.mid.client.model;
+
+public class App2App {
+    private String redirectUri;
+
+    public String getRedirectUri() {
+        return redirectUri;
+    }
+
+    public void setRedirectUri(String redirectUri) {
+        this.redirectUri = redirectUri;
+    }
+
+    @Override
+    public String toString() {
+        return "App2App{" +
+                "redirectUri='" + redirectUri + '\'' +
+                '}';
+    }
+}