Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

MARP-795:Add readme de #33

Merged
2 commits merged into from
Aug 6, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 80 additions & 0 deletions a-trust-connector-product/README_DE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
[A-Trust](https://www.a-trust.at) ist ein österreichisches Unternehmen, das elektronische Services, wie digitale Signaturen und Zertifikate, anbietet,
um eine sichere Online-Kommunikation zu gewährleisten. Die **Signaturbox** von A-Trust ist eine Lösung für digitale Signaturen, mit der
Benutzer Dokumente sicher digital signieren können, um Authentizität (**Wer** signiert) und Integrität (**Was** wird signiert) zu gewährleisten.

- Basiert auf REST Web Service Technologien.
- Signiert PDFs.
- Unterstützt dich mit einer Demo-Implementierung, um deinen Integrationsaufwand zu reduzieren.
- Ermöglicht es low code citizen developers bestehende Geschäftsprozesse mit Handy-Signaturfunktionen zu erweitern.

Für die Nutzung von A-Trust benötigst Du einen Account, den Dir https://www.a-trust.at/de/produkte/qualifizierte_signaturservices/xidentity/ erstellt.

## Demo

1. Upload a **PDF** document.

![demo-process](images/atrust-upload-doc.png)

2. Click on **Sign Document** and signers will be forwarded to the **HandySignatur** identification page.

- Log in with your mobile phone signature certificate.

![atrust-signature](images/atrust-handysign-login.png)

- Check notification on your phone, and follow up the **A-Trust** guide to add your signature to doc.

3. After signed, a new document will be added to your case with the prefix ***SIGNED_***

![atrust-signature-finished](images/atrust-handysign-finished.png)

4. You can download and open **Adobe PDF** to see your signature at bottom of doc.

![atrust-doc-signed](images/atrust-doc-signed.png)

The **ATrustDemo** process contains a final service part, where we prepared a signature template on the **A-Trust** server.

![atrust-demo-feature](images/atrust-demo-feature.png)

* You need to upload a **SignatureTemplate** to the **[A-Trust](https://www.a-trust.at)** service. Uses `AddTemplateATrust` start in the `ATrustDemo` process of `a-trust-connector-demo` project.

When uploading successfully, **A-Trust** returns `templateID` and sets it in project Variables - `TemplateId` value in the `Configuration/variables.yaml`.

* An example **SignatureTemplate** in CMS: `cms/Templates/tempsiegel1`.



## Setup

Before any signing interactions between the **Axon Ivy Engine** and the **A-Trust HandySignatur** services can be run, they have to be introduced to each other. This can be done as follows:

1. Register an **A-Trust HandySignatur** account: https://www.a-trust.at/en/handy-signatur/handy-signatur-activation/

2. Create an **A-Trust Signatur-Box** **[here](https://www.a-trust.at/en/handy-signatur/signaturbox)** and then get a new `API key` with the `Endpoint URI` web service.

3. Open the `Configuration/variables.yaml` in your Designer and paste the below code with your `APIKey`, `TemplateId`, `EndpointUri`

```
Variables:
# Custom variables of ATrust Handysignatur API
ATrust:
# API Key for "A-Trust Handysignatur API"
APIKey: 'your API Key'

# The endpoint uri of A-Trust Handysignatur Signatur-box webservice
EndpointUri: 'your Endpoint URI'

# The ID of the signature template to be used.
TemplateId: # your TemplateId with number format, e.g: 1

```

4. Save the changed settings.


### Prerequisites:

* Working **A-TRUST** `API Key` (set in the global variable) - Needed to call **SOAP** services.
* You will also get the correct `ENDPOINT URL` from **A-TRUST** when checking their website!
* You need to upload a **SignatureTemplate** to the **[A-Trust](https://www.a-trust.at)** service before calling **ATrust/StartSignature**.
* **HandySignatur** is only available for people with an Austrian mobile phone number as well as an address in Austria.
* Check the latest API description on the **[A-Trust](https://www.a-trust.at)** webpage.
Loading