Die aktuelle technische Dokumentation finden Sie unter: www.postident.de/handbuch
Release Notes 23.0 (12.11.2024) deutsch
POSTIDENT System
Überarbeitung der Bereiche für den Abruf von Identergebnissen und Betrugsverdachtsmeldungen
Mit dem Ziel, die Benutzerfreundlichkeit zu erhöhen, wurden die im Hinblick auf die Bedienoberfläche identischen Bereiche Identergebnisse (sichtbar für Nutzer mit der Rolle Portal Ergebnisdaten) und Betrugsverdachtsmeldungen (sichtbar für Nutzer mit der Rolle Portal Fraudmanager) wie folgt überarbeitet:
- Umgestaltung der Suchmaske
Die Suchmaske, über die nach Identergebnissen gesucht werden kann, wurde wie folgt umgestaltet:
1. Integration der Felder für die erweiterte Suche in die Hauptmaske durch kompaktere Darstellung
Bislang waren mehrere Suchfelder in der Default-Ansicht der Suchmaske ausgeblendet und konnten über den Button "Erweiterte Suche" eingeblendet (und wieder ausgeblendet) werden. Dies diente dazu, die Bedienoberfläche übersichtlich zu halten. Durch eine kompaktere Darstellung unter Nutzung von zwei Spalten konnten die Suchfelder der erweiterten Suche nun in die Hauptmaske übernommen werden, sodass der zusätzliche Klick für die Nutzung dieser Felder entfällt und dem Nutzer alle Suchoptionen direkt ersichtlich sind.
2. Trennung der Suchmaske in zwei Suchmodi
Da eine Vorgangsnummer einen Vorgang direkt identifiziert, macht die parallele Eingabe von Vorgangsnummer und weiteren Suchkriterien keinen Sinn. Die Suchmaske wurde daher in zwei Suchmasken aufgeteilt. Eine einelementige Suchmaske, über die sie unter Eingabe einer Vorgangsnummer ohne weitere Suchkriterien direkt eine Suche starten können und eine Suchmaske, in der Sie die verbleibenden Suchkriterien vorfinden. Letztere ist die Suchmaske, die standardmäßig bei Aufruf der Bereiche Identergebnisse und Betrugsverdachtsmeldungen angezeigt wird. Sie können über die zwei neu eingeführten Buttons Vorgangssuche mit Vorgangsnummer und Vorgangssuche mit Suchkriterien zwischen den beiden Masken hin und her wechseln.
3. Integration der ungefähren Suche als Standard
Seit Release 22.0 können Nutzer eine ungefähre Suche (Wildcard-Suche) durch Nutzung eines Platzhalters durchführen. Mit dem Release 23.0 wird die Suche nach ungefähren Entsprechungen der eingegebenen Suchparameter auch ohne die Eingabe von Platzhaltern zum Standardverhalten. Eine genaue Suche nach exakten Entsprechungen der Suchparameter ist via Auswahl der Checkbox Nur genaue Ergebnisse suchen weiterhin möglich.
4. Ersatz des Bedienelements zur Auswahl der Abrechnungsnummer (ClientID)
Das bisher in der Suchmaske eingesetzte Bedienelement zur Auswahl einer, mehrerer oder aller Abrechnungsnummern (ClientIDs) wurde durch ein alternatives Bedienelement ersetzt, welche Vorteile für Kunden mit einer hohen Anzahl unterschiedlicher Konfigurationen bietet. Die Abrechnungsnummern (ClientIDs) können nun via Checkboxen in einem Dropdown-Menu ausgewählt werden. Die vollständige Liste der Abrechnungsnummern (ClientIDs) kann dabei durch Eingabe von Abrechnungsnummer, ClientID oder Kurzbezeichnung (sowie Teilen davon) effizient durchsucht und eingeschränkt werden. Beim Laden der Seite sind standardmäßig alle Abrechnungsnummern (ClientIDs) ausgewählt.
- Integration der Download-Optionen in die Darstellung der Ergebnisliste
Um unter der Suchmaske möglichst viel Raum zur Anzeige der Suchergebnisse zu ermöglichen, wurden die Formularelemente zur Auswahl der Download-Optionen in ein Pop-Over-Bedienelement, das via Klick ein- und ausgeblendet werden kann, verschoben. Standardmäßig ist hier die Option Ergebnis-PDF ausgewählt. Möchten Sie darüber hinaus Identifikationsdaten und/oder Bilddateien herunterladen und das Format der heruntergeladenen Identifikationsdaten bestimmen, so können Sie dies in dem genannten Pop-Over-Bedienelement tun. Wir planen (voraussichtlich mit Rel. 24.0) die Einführung individueller Nutzerpräferenzen für die Download-Optionen, sodass Sie eine individuell für Sie geltende, vom Systemstandard abweichende Standardeinstellung für die Download-Optionen konfigurieren können.
- Einführung von Filterkriterien zur Einschränkung der Ergebnisliste
Die Ergebnisliste der Suche kann ab Rel. 23.0 mittels den Filterkriterien Verfahren, Identstatus und Identsubstatus weiter eingeschränkt werden. Durch Klick auf Filter zurücksetzen oder Entfernen einzelner Filterkriterien, kann die Ergebnisliste wieder erweitert werden.
POSTIDENT durch AutoID
- Ergänzung neuer Substatusgrund
Wir führen mit Rel. 23.0 den neuen Substatusgrund 124 Digital manipulation ein. Dieser tritt in der Kombination 761 declined / 11 Fraud suspicion / 124 Digital manipulation auf. Der neue Substatusgrund trägt der fortlaufenden Prüfung auf digitale Manipulationen (z.B. Deep Fakes) Rechnung, die nun durch den neuen Substatusgrund differenziert ausgewiesen werden. Die Dokumentation im Standard Connect & Result Ident REST API Guide 2 Result wird mit dem Release 23.0 entsprechend aktualisiert.
- Einführung von Notification-Webhooks bei Review-Bedarf
Wir führen mit Rel. 23.0 den Versand von Webhooks für die Identstatus 710 und 720 (jeweils review pending) ein. Falls für Sie Webhooks zu Status vom Typ Notification konfiguriert sind, erhalten Sie ab dem Release bei Erreichen der Status 710 oder 720 jeweils einen Webhook. Die Dokumentation im Standard Connect & Result Ident REST API Guide 2 Result wird mit dem Release 23.0 entsprechend aktualisiert.
POSTIDENT durch Online-Ausweisfunktion
- Neue Substatus und Substatusgründe
Wie in unserer Kommunikation vom 02.10.2024 an Geschäftskunden, die das Verfahren eID nutzen, angekündigt, werden wir das Statusmodell des Verfahrens eID in zwei Schritten vereinfachen. Vorbereitend für die eigentliche Vereinfachung mit Release 24.0 werden im ersten Schritt mit Release 23.0 zwei neue Substatus und sechs neue Substatusgründe eingeführt:
| Substatus | |
|---|---|
| 65 Problem during eID Phase | 230 incomplete / 65 Problem during eID Phase / 650 - 653 |
| 66 Problem with document | 230 incomplete / 66 Problem with document / 660 |
| Substatusgrund | |
|---|---|
| 650 eID type unknown | 230 incomplete / 65 Problem during eID Phase / 650 eID type unknown |
| 651 eID type not accepted or supported | 230 incomplete / 65 Problem during eID Phase / 651 eID type not accepted or supported |
| 652 problem with attestation request | 230 incomplete / 65 Problem during eID Phase / 652 problem with attestation request |
| 653 certificate does not cover requested attribute set | 230 incomplete / 65 Problem during eID Phase / 653 certificate does not cover requested attribute set |
| 632 eID server internal error | 230 incomplete / 63 eID Problem with eID server / 632 eID server internal error |
| 660 Document authenticity not verifiable (e.g. test ID card, chip corrupted) | 230 incomplete / 66 Problem with document / 660 Document authenticity not verifiable (e.g. test ID card, chip corrupted) |
Weiterhin werden die folgenden Substatusgründe ab voraussichtlich 11.12.24 durch eine Änderung auf Seiten eines Dienstleisters inaktiv:
- 591 ID card with invalid certificate (e.g. test ID card)
- 600 eCardAPI reports unknown error
- 610 Error in eID Client
- 611 Incomplete data from PIN or card
- 612 Authentication failed
- 613 PIN entered incorrectly too often
- 614 PIN deactivated
- 620 Error in communcation between eCard client and card reader
- 621 Error in communication between eID client and card
- 622 Fehler in Chip-Karte
- 623 Card slipped / not readable / removed
- 630 eID server not operational
- 631 eID client cannot communicate with eID server
Die Dokumentation im Standard Connect & Result Ident REST API Guide 2 Result wird mit dem Release 23.0 entsprechend aktualisiert.
POSTIDENT Zustellung
- Einführung neue Substatusgründe
Wir führen mit Rel. 23.0 die neuen Substatusgründe 340 Case declined due to return address data in digital provisioning by business customer that is not expected due to other configuration sowie 341 Delivery not possible: Recipient cannot be determined ein, die in den Kombinationen 309 declined / 25 Problem with digital provisioning (data quality) / 340 Case declined due to return address data in digital provisioning by business customer that is not expected due to other configuration bzw. 309 declined / 26 Delivery of shipment not possible / 341 Delivery not possible: Recipient cannot be determined auftreten. Die Dokumentation im Standard Connect & Result Ident REST API Guide 2 Result wird mit dem Release 23.0 entsprechend aktualisiert.
Der Status 340 wird gesetzt, wenn im Request-XML eine sendungsindividuelle Rücksendeadresse übergeben wird, obwohl für Sie die Nutzung einer zentralen Rücksendeadresse konfiguriert ist. Falls Sie von einer zentralen Rücksendeadresse auf sendungsindividuelle Rücksendeadressen umsteigen möchten, kontaktieren Sie bitte das POSTIDENT Serviceteam für eine Anpassung Ihrer Konfiguration.
POSTIDENT Apps und SDK
SDK:
- Das POSTIDENT SDK wird ergänzend als kompilierte SDK Version (iOS und Android) bereitgestellt. Geschäftskunden haben damit die Möglichkeit eine SDK Version zu integrieren ohne erweiterten Entwicklungsaufwand bereitstellen zu müssen.
- Über die kompilierte SDK Version besteht kein Einblick mehr in den Code, der zur Verfügung gestellt wird (hierfür kann das bisherige SDK genutzt werden)
- Das kompilierte SDK wurde speziell mit erweiterten Sicherheits- und Härtungsmaßnahmen ausgestattet
- Eine Dokumentation zur Integration des kompilierten SDKs wird bereitgestellt
- Der Support für SDK-Version 2.1 wird beendet
Videochat:
- Das Feld "Ausstellungsort" wird Nutzern im Videochat-Prozess nicht mehr angezeigt und somit nicht mehr erfasst.
Online-Ausweisfunktion (eID) mit Foto-Upload:
- Um die Online-Ausweisfunktion (eID) mit Foto-Upload zu nutzen, können nur die POSTIDENT Apps verwendet werden. Daher wird der Absprung zur Nutzung externer Kartenlesegeräte bei aktivierter Foto-Upload-Funktion entfernt.
Übergreifend:
- Verbesserte Unterstützung der Kameralinsen des iPhone 16, iPhone 16 Plus, iPhone 16 Pro, iPhone 16 Pro Max
- Das neue POSTIDENT App-Symbol bietet jetzt eine bessere Ansicht im Dark Mode und passt die Farben des Symbols an die Benutzereinstellungen an
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 10.04.2024 | 10.10.2024 |
SDK allgemein:
|
| iOS | 2.6 | 06.06.2024 | 06.12.2024 |
Mit SDK v2.5 erfüllen wir die Apple Anforderungen hinsichtlich des Privacy Manifest.
|
| iOS | 2.7 | 30.07.2024 | 30.01.2025 |
|
| iOS | 2.8 | 02.10.2024 | 02.04.2025 |
|
| iOS | 2.9 | Vsl. KW 48 2024 |
|
|
| Android | 2.2 | 10.10.2023 | 10.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 |
|
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | 06.06.2024 | 06.12.2024 |
|
| Android | 2.7 | 25.07.2024 | 25.01.2025 |
|
| Android | 2.8 |
02.10.2024 |
02.04.2025 |
|
| Android | 2.8.1 | 16.10.2024 | 16.04.2025 |
|
| Android | 2.9 | vsl. KW 48 2024 |
|
Release 24.0:
Der Rollout von Release 24.0 ist für den 21.01.2025 geplant.
Release Notes 23.0 (12.11.2024) english
POSTIDENT System
Revision of Sections for Retrieving Identity Results and Fraud Suspicion Reports
To enhance user-friendliness, the sections for identity results (visible to users with the Portal Result Data role) and fraud suspicion reports (visible to users with the Portal Fraud Manager role) have been revised as follows:
- Redesign of the Search Mask
The search mask for searching identity results has been redesigned as follows:
1. Integration of Advanced Search Fields into the Main Mask with a More Compact Layout
Previously, several search fields were hidden in the default view of the search mask and could be displayed (and hidden again) via the "Advanced Search" button. This was done to keep the user interface clear. By using a two-column layout, the advanced search fields have now been integrated into the main mask, eliminating the need for an additional click to use these fields, making all search options immediately visible to the user.
2. Separation of the Search Mask into two search modes
Since a process number directly identifies a process, entering a process number alongside other search criteria makes no sense. The search mask has therefore been split into two search masks: a single-element search mask where you can start a search directly by entering a process number without additional search criteria, and a search mask where you can find the remaining search criteria. The latter is the default search mask displayed when accessing the identity results and fraud suspicion reports sections. You can switch between the two masks using the two newly introduced buttons: Process Search with Process Number and Process Search with Search Criteria.
3. Integration of approximate search as standard
Since Release 22.0, users can perform an approximate search (wildcard search) using a placeholder. With Release 23.0, the search for approximate matches of the entered search parameters becomes the standard behavior, without the need to enter placeholders. An exact search for precise matches of the search parameters is still possible by selecting the checkbox "Search Only Exact Results".
4. Replacement of the control element for selecting billing numbers (ClientIDs)
The control element previously used in the search mask to select one, several, or all billing numbers (ClientIDs) has been replaced with an alternative control element, which offers advantages for customers with a high number of different configurations. The billing numbers (ClientIDs) can now be selected via checkboxes in a dropdown menu. The complete list of billing numbers (ClientIDs) can be efficiently searched and restricted by entering the billing number, ClientID, or short name (or parts thereof). By default, all billing numbers (ClientIDs) are selected when the page loads.
- Integration of download options into the Result List display
To maximize the space available for displaying search results under the search mask, the form elements for selecting download options have been moved to a pop-over control element, which can be toggled on and off via a click. By default, the option "Result PDF" is selected. If you wish to download identification data and/or image files and determine the format of the downloaded identification data, you can do so in the mentioned pop-over control element. We plan to introduce individual user preferences for download options with Release 24.0, allowing you to configure a default setting for download options that deviates from the system standard.
- Introduction of filter criteria to restrict the Result List
From Release 23.0, the result list of the search can be further restricted using the filter criteria "Procedure", "Identity Status", and "Identity Substatus". By clicking "Reset Filters" or removing individual filter criteria, the result list can be expanded again.
POSTIDENT by AutoID
- Addition of new Substatus Reason
With Release 23.0, we introduce the new substatus reason 124 "Digital manipulation". This appears in the combination 761 "declined" / 11 "Fraud suspicion" / 124 "Digital manipulation". The new substatus reason accounts for the ongoing examination of digital manipulations (e.g., deep fakes), which are now differentiated by the new substatus reason. The documentation in the Standard Connect & Result Ident REST API Guide 2 Result will be updated accordingly with Release 23.0.
- Introduction of Notification Webhooks for Review Needs
With Release 23.0, we introduce the sending of webhooks for the identity statuses 710 and 720 (both "review pending"). If webhooks for statuses of the type "Notification" are configured for you, you will receive a webhook upon reaching statuses 710 or 720 from the release. The documentation in the Standard Connect & Result Ident REST API Guide 2 Result will be updated accordingly with Release 23.0.
POSTIDENT by Online Identification Function (eID)
- New Substatuses and Substatus Reasons
As announced in our communication on 02.10.2024 to business customers using the eID procedure, we will simplify the status model of the eID procedure in two steps. In preparation for the actual simplification with Release 24.0, two new substatuses and six new substatus reasons will be introduced in the first step with Release 23.0:
| Substatus | |
|---|---|
| 65 Problem during eID Phase | 230 incomplete / 65 Problem during eID Phase / 650 - 653 |
| 66 Problem with document | 230 incomplete / 66 Problem with document / 660 |
| Substatus Reason | |
|---|---|
| 650 eID type unknown | 230 incomplete / 65 Problem during eID Phase / 650 eID type unknown |
| 651 eID type not accepted or supported | 230 incomplete / 65 Problem during eID Phase / 651 eID type not accepted or supported |
| 652 problem with attestation request | 230 incomplete / 65 Problem during eID Phase / 652 problem with attestation request |
| 653 certificate does not cover requested attribute set | 230 incomplete / 65 Problem during eID Phase / 653 certificate does not cover requested attribute set |
| 632 eID server internal error | 230 incomplete / 63 eID Problem with eID server / 632 eID server internal error |
| 660 Document authenticity not verifiable (e.g. test ID card, chip corrupted) | 230 incomplete / 66 Problem with document / 660 Document authenticity not verifiable (e.g. test ID card, chip corrupted) |
Additionally, the following substatus reasons are expected to become inactive from 11.12.24 due to a change on the part of a service provider:
- 591 ID card with invalid certificate (e.g. test ID card)
- 600 eCardAPI reports unknown error
- 610 Error in eID Client
- 611 Incomplete data from PIN or card
- 612 Authentication failed
- 613 PIN entered incorrectly too often
- 614 PIN deactivated
- 620 Error in communcation between eCard client and card reader
- 621 Error in communication between eID client and card
- 622 Fehler in Chip-Karte
- 623 Card slipped / not readable / removed
- 630 eID server not operational
- 631 eID client cannot communicate with eID server
The documentation in the Standard Connect & Result Ident REST API Guide 2 Result will be updated accordingly with Release 23.0.
POSTIDENT Delivery
- Introduction of new Substatus Reasons
With Release 23.0, we introduce the new substatus reasons 340 "Case declined due to return address data in digital provisioning by business customer that is not expected due to other configuration" and 341 "Delivery not possible: Recipient cannot be determined", which appear in the combinations 309 "declined" / 25 "Problem with digital provisioning (data quality)" / 340 "Case declined due to return address data in digital provisioning by business customer that is not expected due to other configuration" and 309 "declined" / 26 "Delivery of shipment not possible" / 341 "Delivery not possible: Recipient cannot be determined". The documentation in the Standard Connect & Result Ident REST API Guide 2 Result will be updated accordingly with Release 23.0.
Status 340 is set when a shipment-specific return address is provided in the request XML, even though the use of a central return address is configured for you. If you wish to switch from a central return address to shipment-specific return addresses, please contact the POSTIDENT service team to adjust your configuration.
POSTIDENT Apps and SDK
SDK:
- The POSTIDENT SDK will additionally be provided as a compiled SDK version (iOS and Android). Business customers can thus integrate an SDK version without having to provide extended development effort.
- The compiled SDK version does not allow insight into the provided code (the previous SDK can be used for this purpose)
- The compiled SDK is specially equipped with enhanced security and hardening measures
- Documentation for integrating the compiled SDK will be provided
- Support for SDK version 2.1 will be discontinued
Video chat:
- The "Place of Issue" field will no longer be displayed to users in the video chat process and thus will no longer be recorded.
Online Identification Function (eID) with Photo Upload:
- To use the online identification function (eID) with photo upload, only the POSTIDENT apps can be used. Therefore, the option to use external card readers when the photo upload function is activated will be removed.
Comprehensive:
- Improved support for the camera lenses of the iPhone 16, iPhone 16 Plus, iPhone 16 Pro, iPhone 16 Pro Max
- The new POSTIDENT app icon now offers a better view in dark mode and adjusts the icon colors to the user settings
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 11.04.2024 | 11.10.2024 |
|
| iOS | 2.6 | 06.06.2024 | 06.12.2024 |
With SDK v2.5 we meet Apple's requirements regarding the Privacy Manifest.
|
| iOS | 2.7 | 30.07.2024 | 30.01.2025 |
|
| iOS | 2.8 | 02.10.2024 | 02.04.2025 |
|
| iOS | 2.9 | exp. CW 48 2024 |
|
|
| Android | 2.0 | 23.06.2023 | 23.12.2023 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | 09.10.2023 | 09.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Correction of an error in the handling of CallBackUrls when using the AutoID method |
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | 06.06.2024 | 06.12.2024 |
|
| Android | 2.7 | 25.07.2024 | 25.01.2025 |
|
| Android | 2.8 | 02.10.2024 | 02.04.2025 |
|
| Android | 2.8.1 | 16.10.2024 | 16.04.2025 |
|
| Android | 2.9 | exp. cw 48 2024 |
|
Release 24.0:
Rollout of Release 24.0 is scheduled for January 21st, 2025.
Release Notes 22.0 (03.09.2024) deutsch
POSTIDENT durch Online-Ausweisfunktion (eID)
-
Ergänzung der FAQs zur Weiterleitung an das Personalausweisportal, damit der Nutzer einen Musterbrief für die Transport-PIN einsehen kann.
POSTIDENT E-Signing
-
Über die SCR-Signing API wird ab Release 22.0. zusätzlich die Info zu der Identifizierungsmethode des jeweiligen Unterzeichners mitgeliefert. Die Information wird in dem Feld "identificationMethod" bereitgestellt, nachdem der Unterzeichner sich identifiziert hat. Mögliche Werte sind "video" und "eid".
POSTIDENT durch Apps und SDK
-
Einstellung des Support für Android 8 (Min. Android Version 9)
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 10.04.2024 | 10.10.2024 |
SDK allgemein:
|
| iOS | 2.6 | 06.06.2024 | 06.12.2024 |
Mit SDK v2.5 erfüllen wir die Apple Anforderungen hinsichtlich des Privacy Manifest.
|
| iOS | 2.7 | 30.07.2024 | 30.01.2025 |
|
| iOS | 2.8 | Vsl. KW 38 2024 |
|
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 |
|
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | 06.06.2024 | 06.12.2024 |
|
| Android | 2.7 | 25.07.2024 | 25.01.2025 |
|
| Android | 2.8 |
vsl. KW 38 2024 |
|
Release 23.0:
Der Rollout von Release 23.0 ist für den 12.11.2024 geplant.
Release Notes 22.0 (03.09.2024) english
POSTIDENT by Online Identification Function (eID)
- Addition to the FAQs for forwarding to the ID card portal, so that the user can view a sample letter for the transport PIN.
POSTIDENT E-Signing
- Starting from Release 22.0, the SCR-Signing API will also provide information about the identification method used by each signer. This information will be provided in the "identificationMethod" field after the signer has been identified. Possible values are "video" and "eid".
POSTIDENT Apps and SDK
- Discontinuation of support for Android 8 (Minimum Android version 9)
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 11.04.2024 | 11.10.2024 |
|
| iOS | 2.6 | 06.06.2024 | 06.12.2024 |
With SDK v2.5 we meet Apple's requirements regarding the Privacy Manifest.
|
| iOS | 2.7 | 30.07.2024 | 30.01.2025 |
|
| iOS | 2.8 | exp cw 38 2024 |
|
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Correction of an error in the handling of CallBackUrls when using the AutoID method |
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | 06.06.2024 | 06.12.2024 |
|
| Android | 2.7 | 25.07.2024 | 25.01.2025 |
|
| Android | 2.8 | exp. cw 38 2024 |
|
Release 23.0:
Rollout of Release 23.0 is scheduled for November 12th, 2024.
Releasenotes 21.0 (09.07.2024) deutsch
POSTIDENT Systems
- Incoming Encryption SCR Schnittstelle
Daten im Request-Body können für Anfragen an die POSTIDENT Standard Connect and Result Schnittstelle (SCR) ab dem Release 21.0 optional mittels symmetrischer Verschlüsselung durch PBES2 verschlüsselt werden. Genauere Informationen zur Nutzung der Verschlüsselung werden mit dem Rollout des Releases 21.0 im Standard Connect & Result Ident REST API Guide 3 Encryption auf unserer Downloadseite ergänzt. - Durch Entkopplung des Parameters includeResultPdf von dem Parameter includeBinaryData in SCR, können die Daten zum Ergebnis-PDFs ohne Ausweisbilder abgerufen werden
Über die Endpunkte GET /{clientId}/cases/{caseId} und GET /{clientId}/cases/{caseId}/full können in der POSTIDENT Standard Connect and Result Schnittstelle (SCR) die Ergebnisdaten einzelner Vorgänge abgerufen werden. Dabei kann über die Parameter includeBinaryData und includeResultPdf gesteuert werden, ob im Response die BASE64-enkodierten Binärdaten von Bildern und des Ergebnis-PDFs enthalten sein sollen.
Bislang mussten sowohl includeBinaryData = true als auch includeResultPdf = true sein, damit die Binärdaten des Ergebnis-PDFs mit ausgeliefert wurden. Mit dem Rollout des Releases 21.0 ändert sich das Verhalten des Parameters includeResultPdf so, dass die Binärdaten des Ergebnis-PDFs im Response unabhängig vom Wert des Parameters includeBinaryData im Response enthalten sind, wenn der Parameter includeResultPdf = true gesetzt wird.
Dies bedeutet:- Setzen Sie das Attribut includeBinaryData = true, wenn Sie Bilder erhalten wollen.
- Setzen Sie das Attribut includeResultPdf = true, wenn Sie das Ergebnis-Pdf erhalten wollen.
An Ihren bisherigen Aufrufen müssen Sie keine Veränderung durchführen.
- Sperrung/Reaktivierung von Accounts durch Benutzer mit der Rolle "Benutzer-Verwaltung" im Auskunftsportal
Benutzer des POSTIDENT Auskunftsportals mit der Rolle Benutzer-Verwaltung erhalten ab dem Rollout des Releases 21.0 die Möglichkeit, Benutzer- und System-Accounts mittels eines Buttons zu deaktivieren oder - falls der Account deaktiviert ist - zu reaktivieren.
Dazu ist im Bereich Benutzerverwaltung (nur für Benutzer mit der Rolle Benutzer-Verwaltung sichtbar) der entsprechende Account anzuwählen (gesperrte Accounts sind mit einem roten "Ban-Icon" gekennzeichnet)
In der Detailansicht des Accounts wird im Bereich "Benutzer-Accounts" bzw. "System-Accounts" der Status des Accounts angezeigt (Deaktiviert: Ja/Nein). Daneben findet sich - in Abhängigkeit des aktuellen Status - der Button zum Deaktivieren bzw. Aktivieren des Accounts.
Account aktiv (nicht deaktiviert) und durch Klick auf gelben Button deaktivierbar:
Account deaktiviert und durch Klick auf gelben Button aktivierbar:
POSTIDENT durch Online-Ausweisfunktion (eID)
- Vereinfachter Ablauf optionales Feature "Ausweisfoto-Upload" für Klasse GwG (App)
Beim Start des Ausweisfoto-Uploads entfällt der Button "Weiter ohne Aufnahme".
POSTIDENT durch Videochat
- Neuer Substatusgrund
Der bereits seit Release 19.0 im Verfahren eID genutzte Substatusgrund "996 Ident/Vorgang bereits beendet.", wird ab dem Rollout von Release 21.0 auch für das Verfahren Video genutzt und tritt dort in der Kombination "430 Incomplete / 99 Abbruch aus sonstigem Grund / 996 Ident/Vorgang bereits beendet." auf.
POSTIDENT E-Signing
- E-Signing jetzt rund um die Uhr mit "Online-Ausweisfunktion" möglich
Nutzer erhalten die Möglichkeit ihre Legitimation, die für eine elektronische Signatur (QES) notwendig ist, zusätzlich mit der Online-Ausweisfunktion (eID) durchzuführen. Es besteht weiterhin die Möglichkeit Videoident für die Legitimation zu nutzen.
Hinweis: Wenden Sie sich für die Nutzung des Features bitte an das Serviceteam POSTIDENT unter serviceteam.postident@deutschepost.de
POSTIDENT Zustellung
- Einführung optionales Feld Empfänger-E-Mail-Adresse für Avisierung der Sendung beim Empfänger
Ab dem Rollout von Release 21.0 kann im Verfahren Zustellung bei Auftragserteilung je Sendung optional die E-Mail-Adresse des Empfängers übergeben werden (IdentityData.ContactData.EmailAddress im DeliveryRequest - für genauere Informationen verweisen wir auf den SFTP XML Delivery Start API Guide und die Schemadefinition (XSD) für Postident Delivery Datenbereitstellung im XML-Format auf unserer Downloadseite; beide Dokumente werden mit dem Release aktualisiert).
Wird eine E-Mail-Adresse übergeben, so wird diese genutzt, um die Sendung beim Empfänger über die DHL Paketankündigung zu avisieren. Durch die Avise steigt die Wahrscheinlichkeit für die Anwesenheit des Empfängers beim Zustellversuch, d.h. eine erfolgreiche Zustellung. Wird keine E-Mail-Adresse übergeben, so erhält der Empfänger (wie bisher) nur dann eine Avise, wenn es sich um einen registrierten DHL Paket Kunden handelt.
Wichtige Hinweise:- Gemäß Art. 4 Nr. 11 DSGVO müssen Sie die Einwilligung des Empfängers einholen, um dessen E-Mail-Adresse an die DHL Group (Deutsche Post AG) weiterzuleiten. Die E-Mail-Adresse wird verwendet, um dem Empfänger eine DHL Paketankündigung zu senden.
- Wir erlauben die Übergabe von E-Mail-Adressen aus dem nach RFC 5322 und RFC 5321 möglichen Spektrum, d.h. mit bis zu 254 Zeichen, sodass Requests, die für einzelne Sendungen sehr lange E-Mail-Adressen enthalten, nicht mit einem Fehler abgewiesen werden. Aufgrund von Restriktionen der DHL Paketankündigung werden jedoch nur E-Mail-Adressen mit einer Länge von bis zu 80 Zeichen für den Versand einer DHL Paketankündigung verwendet. E-Mail-Adressen mit einer Länge >80 und <254 werden ignoriert.
POSTIDENT durch Apps und SDK
- Optimierung der User-Führung zur Positionierung des Personalausweises an einem iPhone bei POSTIDENT durch Online-Ausweisfunktion (eID)
iPhone User sehen zukünftig eine neue Grafik, um den Personalausweis an die korrekte Stelle an einem iPhone zu halten und anschließend per NFC auszulesen.
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 10.04.2024 | 10.10.2024 |
SDK allgemein:
|
| iOS | 2.6 | 06.06.2024 | 06.12.2024 |
Mit SDK v2.5 erfüllen wir die Apple Anforderungen hinsichtlich des Privacy Manifest.
|
| iOS | 2.7 | vsl. KW 30 2024 |
|
|
| Android | 2.2 | 10.10.2023 | 10.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Korrektur eines Fehlers bei der Behandlung von CallBackUrls, wenn das Verfahren AutoID genutzt wird |
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | 06.06.2024 | 06.12.2024 |
|
| Android | 2.7 | vsl. KW 22 2024 |
|
Release 22.0:
Der Rollout von Release 22.0 ist für den 03.09.2024 geplant.
Release Notes 21.0 (09.07.2024) english
POSTIDENT Systems
- Incoming Encryption SCR Interface
Data in the request body can be optionally encrypted using symmetric encryption through PBES2 for requests to the POSTIDENT Standard Connect and Result (SCR) interface starting from Release 21.0. More detailed information on encryption usage will be added with the rollout of Release 21.0 in the Standard Connect & Result Ident REST API Guide 3 Encryption on our download page. - By decoupling the includeResultPdf parameter from the includeBinaryData parameter in SCR, the data for result PDFs can be retrieved without identification images
Through the endpoints GET /{clientId}/cases/{caseId} and GET /{clientId}/cases/{caseId}/full, the result data for individual processes can be retrieved in the POSTIDENT Standard Connect and Result (SCR) interface. The includeBinaryData and includeResultPdf parameters can be used to control whether the BASE64-encoded binary data of images and the result PDF should be included in the response. Previously, both includeBinaryData = true and includeResultPdf = true had to be set in order for the binary data of the result PDF to be delivered. With the rollout of Release 21.0, the behavior of the includeResultPdf parameter changes so that the binary data of the result PDF is included in the response regardless of the value of the includeBinaryData parameter, when the includeResultPdf parameter is set to true.
This means:- Set the includeBinaryData attribute to true if you want to receive images.
- Set the includeResultPdf attribute to true if you want to receive the result PDF.
You do not need to make any changes to your previous calls.
- Blocking/Reactivating accounts by users with the role "User Management" in the information portal
Users of the POSTIDENT Information Portal with the User Management role will have the ability to deactivate or reactivate user and system accounts using a button starting from the rollout of Release 21.0.
To do this, select the corresponding account in the User Management section (visible only to users with the User Management role) (locked accounts are marked with a red "Ban Icon").
In the detailed view of the account, the status of the account is displayed in the "Benutzer-Accounts" or "System-Accounts" section (Deactivated: Yes/No). Next to it, depending on the current status, there is a button to deactivate or activate the account.
Account active (not deactivated) and deactivatable by clicking on the yellow button:
Account deactivated and activatable by clicking on the yellow button:
POSTIDENT by Online Identification Function (eID)
- Simplified process of optional feature "ID document image upload" for class GwG (via app)
The "Continue without taking a photo" button is no longer available when starting the ID photo upload.
POSTIDENT via Video chat
- New substatus reason
The substatus reason "996 Ident/Process already completed.", which has been used for the eID process since Release 19.0, will also be used for the Video process starting from the rollout of Release 21.0, appearing in the combination "430 Incomplete / 99 Termination for other reasons / 996 Ident/Process already completed."
POSTIDENT E-Signing
- E-Signing now available around the clock with "Online ID Function"
- Users have the option to perform their identification, which is necessary for an electronic signature (QES), additionally using the online ID function (eID). The option to use video identification for identification remains available.
Note: For the use of this feature, please contact the POSTIDENT serviceteam at serviceteam.postident@deutschepost.de.
POSTIDENT Delivery
- Introduction of optional recipient email address field for shipment notification to the recipient
Starting from the rollout of Release 21.0, in the delivery process, the recipient's email address can be provided as an optional field for each shipment (IdentityData.ContactData.EmailAddress in DeliveryRequest - for more detailed information, please refer to the SFTP XML Delivery Start API Guide and the schema definition (XSD) for Postident Delivery Data Provision in XML format on our download page; both documents will be updated with the release). If an email address is provided, it will be used to notify the recipient about the shipment through DHL Paketankündigung. The notification increases the likelihood of the recipient being present during the delivery attempt, resulting in successful delivery. If no email address is provided, the recipient (as before) will only receive a notification if they are a registered DHL Paket customer.
Important notes:- According to Art. 4 No. 11 GDPR, you must obtain the recipient's consent to forward their email address to DHL Group (Deutsche Post AG). The email address will be used to send the recipient a DHL shipment notification.
- We allow the transfer of email addresses from the spectrum possible according to RFC 5322 and RFC 5321, i.e., with up to 254 characters, so that requests containing very long email addresses for individual shipments are not rejected with an error. However, due to restrictions of DHL Paketankündigung, only email addresses with a length of up to 80 characters are used for sending a DHL shipment notification. Email addresses with a length >80 and <254 will be ignored.
POSTIDENT Apps and SDK
- Optimization of user guidance for positioning the ID card on an iPhone in POSTIDENT using the online ID function (eID)
iPhone users will see a new graphic in the future to hold the ID card in the correct position on an iPhone and then read it via NFC.
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 11.04.2024 | 11.10.2024 |
|
| iOS | 2.6 | 06.06.2024 | 06.12.2024 |
With SDK v2.5 we meet Apple's requirements regarding the Privacy Manifest.
|
| iOS | 2.7 | exp. CW 30 2024 |
|
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | 09.10.2023 | 09.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Correction of an error in the handling of CallBackUrls when using the AutoID method |
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | 06.06.2024 | 06.12.2024 |
|
| Android | 2.7 | exp. cw 30 2024 |
|
Release 22.0:
Rollout of Release 22.0 is scheduled for September 3, 2024.
Releasenotes 20.0 (14.05.2024) deutsch
POSTIDENT durch AutoID
-
Ausweitung der unterstützten Ausweise
Ab Release 20.0 werden im Verfahren AutoID zusätzlich Ausweise der folgenden 29 Länder unterstützt: Ägypten, Algerien, Argentinien, Äthiopien, Bolivien, Brasilien, Chile, Costa Rica, Dominikanische Republik, Ecuador, Ghana, Kap Verde, Kenia, Kolumbien, Kuba, Libyen, Marokko, Mauritius, Mexiko, Namibia, Nigeria, Panama, Paraguay, Peru, Senegal, Südafrika, Tansania, Tunesien, Uruguay. Ebenfalls aufgenommen wurden kanadische Aufenthaltstitel und der Reisepass von Hongkong (China).
Die Liste aller derzeit akzeptierten Ausweise finden Sie unter www.postident.de/download im Bereich "Handbücher / Release Notes" - diese wird zum Release 20.0 um die hinzugefügten Ausweise ergänzt. -
Hologramm-Animation
Im Rahmen der Identifizierung mittels AutoID wurde nun eine Animation mit einem gekippten Ausweisdokument ergänzt, um dem Nutzer zu verdeutlichen, auf welche Art und Weise das Ausweisdokument zu kippen ist. Dies soll das Verständnis beim Nutzer erhöhen und somit zu einer verbesserten Erfolgsrate beitragen.
POSTIDENT durch Online-Ausweisfunktion (eID)
- Online-Ausweisfunktion (eID) mit Ausweisfoto-Upload für die Klasse GwG (per App)
Das neue Feature "Ausweisfoto-Upload" für das Verfahren POSTIDENT durch Online-Ausweisfunktion (eID) kann ab Release 20 optional für die regulatorische Klasse GwG konfiguriert werden. Dadurch wird der Nutzer während der Identifizierung per App in einem zusätzlichen Prozessschritt dazu aufgefordert, Aufnahmen beider Seiten des verwendeten Ausweisdokuments zu machen. Ist das Feature aktiviert und werden Aufnahmen erstellt, so werden diese im Ergebnis-PDF und als Bilddatei ausgeliefert. Im zugehörigen JSON werden die Metadaten der Bilder analog zu den anderen Verfahren als Records ausgeliefert.
WICHTIGE HINWEISE:- Für das Identifizierungsergebnis ist allein die Online-Ausweisfunktion entscheidend. Auch bei aktiviertem Feature führt das Fehlen von Aufnahmen des Ausweises nicht zu einer Ablehnung der Identifizierung.
- Für die Aufnahmen erfolgt keine Nachbearbeitung
- Wenden Sie sich für die Nutzung des Features bitte an das Serviceteam POSTIDENT unter serviceteam.postident@deutschepost.de
POSTIDENT durch Videochat
- Angabe Servicecenter im Ergebnis-JSON für die Klasse GwG
Bislang wurde im Verfahren Video für die regulatorische Klasse GwG das POSTIDENT Servicecenter, in dem die Identifizierung durchgeführt wurde, nicht im Ergebnis-JSON angegeben. Ab dem Rollout des Releases 20.0 wird das POSTIDENT Servicecenter für diese regulatorische Klasse im JSON-Objekt additionalDataVideo als identificationServiceCenter angegeben. Diese Änderung wurde Kunden, die dem Geldwäschegesetz unterliegen und mindestens eine aktive Konfiguration mit dem Verfahren Video haben, am 19.01.2024 angekündigt (die restlichen regulatorischen Klassen bleiben von der Änderung unberührt). Das Format der Feldwerte kann dem SCR API Guide 2 - Result entnommen werden.
POSTIDENT durch Apps und SDK
- Onlinde-Ausweisfunktion (eID) mit Ausweisfoto-Upload
Anbei finden Sie Screenshots für die iOS App für das neue Feature:
eID-Ausleseprozess
Verfahrens-
auswahl
Verfahrens-
beschreibung
Auszulesende
Ausweisdaten
Eingabe
6-stellige PIN
Scanvorgang
der eID
Prozess "eID mit Ausweisfoto-Upload"
Einstiegsseite
Foto
Kunden-
hinweis
Vorbereitung
Aufnahme
Aufnahme
Vorderseite
Aufnahme
Rückseite
Bestätigungs-
seite
- Unterstützung der Sprachen Französisch, Italienisch, Portugiesisch und Türkisch im POSTIDENT Frontend
Es gibt eine Erweiterung der Sprachunterstützung für die Apps (iOS/Android) um die Sprachen Französisch, Italienisch, Portugiesisch und Türkisch. Bisher wurden bereits die Sprachen Deutsch, Englisch, Polnisch und Spanisch unterstützt. Hat der Nutzer in den Smartphone/Tablet Einstellungen die Sprachen Französisch, Italienisch, Portugiesisch oder Türkisch gewählt, wird die POSTIDENT App die gewählte Sprache übernehmen. Hat der Nutzer eine Sprache eingerichtet welche die POSTIDENT App nicht unterstützt, wird die Default-Sprache Englisch verwendet. Die Unterstützung der neuen Sprachen bezieht sich nur auf den Identifizierungsprozess in der App. E-Mails und SMS werden weiterhin in Deutsch und Englisch angeboten.
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 10.04.2024 | 10.10.2024 |
SDK allgemein:
|
| iOS | 2.6 | vsl. KW 22 2024 |
Mit SDK v2.5 erfüllen wir die Apple Anforderungen hinsichtlich des Privacy Manifest.
|
|
| Android | 2.2 | vsl. KW 38 2023 | vsl. KW 12 2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Korrektur eines Fehlers bei der Behandlung von CallBackUrls, wenn das Verfahren AutoID genutzt wird |
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | vsl. KW 22 2024 |
|
POSTIDENT System ITU
- POSTIDENT TestApp auf Integrations- und Testumgebung (ITU)
Ab sofort bietet die auf der Integrations- und Testumgebung (ITU) verfügbare POSTIDENT TestApp die Möglichkeit, Vorgänge direkt über die Benutzeroberfläche der TestApp zu generieren.
Die alternative Möglichkeit wie bisher Identifikationen für existierende, zuvor über SCR / EasyConnect generierte Vorgänge zu simulieren, bleibt erhalten.
Per Default wird die TestApp im Modus "Existierenden Vorgang suchen" geladen. Die Suchmaske entspricht dabei der bisherigen Suchmaske. Durch Klick auf "Neuen Vorgang erzeugen" kann nun auf eine andere Maske gewechselt werden, die das Erzeugen eines neuen Vorgangs erlaubt. Hier muss zunächst eine konkrete Abrechnungsnummer (ClientID) ausgewählt werden. Die Maske zeigt daraufhin an, welche Verfahren in der jeweiligen Abrechnungsnummer (ClientID) konfiguriert sind und folglich mit einem darin generierten Vorgang simuliert werden können:
Release 21.0:
Der Rollout von Release 21.0 ist für den 09.07.2024 geplant.
Release Notes 20.0 (14.05.2024) english
POSTIDENT by AutoID
- Expansion of supported IDs
As of Release 20.0, the method AutoID will additionally support IDs from the following 29 countries: Algeria, Argentina, Bolivia, Brazil, Cape Verde, Chile, Colombia, Costa Rica, Cuba, Dominican Republic, Ecuador, Egypt, Ethiopia, Ghana, Kenya, Libya, Mauritius, Mexico, Morocco, Namibia, Nigeria, Panama, Paraguay, Peru, Senegal, South Africa, Tanzania, United Republic of, Tunisia, Uruguay. Canadian residence permits and the Hong Kong passport (China) were also included.
The list of all currently accepted IDs can be found at www.postident.de/download in the "Manuals / Release Notes" section - this will be supplemented with the added IDs for Release 20.0. - Hologram Animation
As part of the AutoID identification, an animation with a tilted ID document has been added, to clarify to the user, how the ID document should be tilted. This is intended to increase understanding among users and thus contribute to an improved success rate.
POSTIDENT by Online Identification Function (eID)
- Online Identification Function (eID) with ID document image upload for class GwG (via app)
The new feature "ID document image upload" for the method POSTIDENT by Online Identification Function (eID) can be optionally configured with Release 20.0 for the regulatory class GwG. As a result, the user is asked in an additional process step via app, to take pictures of both sides of the ID document used. If the feature is activated and pictures are taken, these will be delivered in the result PDF and as an image file. In the associated JSON, the metadata of the images are delivered as records, similar to the other ident methods.
IMPORTANT NOTES:- For the identification result, only the online identification function is decisive. Even with the feature activated, the absence of ID document images does not lead to a rejection of the identification.
- No post-processing is done for the images
- Please contact the POSTIDENT service team serviceteam.postident@deutschepost.de to use the feature
POSTIDENT by Video chat
- Indication of service center in the result JSON for class GwG
So far, in the method video for the regulatory class GwG, the POSTIDENT service center, where the identification was performed, was not included in the result JSON. With Release 20.0, the POSTIDENT service center will also be indicated for this regulatory class. It is part of the JSON object additionalDataVideo as identificationServiceCenter. This change was announced to customers, who are subject to the Anti-Money Laundering Act and had at least one active configuration with the method video on 19.01.2024 (other regulatory classes remain unaffected by the change). The format of the field values can be taken from the SCR API Guide 2 - Result.
POSTIDENT Apps and SDK
- Online Identification Function (eID) with ID document image upload
Enclosed you will find screenshots for the iOS app for the new feature:
eID reading process
Method
selection
Method
description
ID data
to be read
Input of
6-digit PIN
Scan process
of the eID
Process "eID with ID document image upload"
Entry page
photo
Customer
notice
Preparation of
doc image upload
Capturing
front side
Capturing
back side
Confirmation
page
- Support of the languages French, Italian, Portuguese and Turkish in the POSTIDENT frontend
There is an extension of language support for the apps (iOS/Android) to include the languages French, Italian, Portuguese and Turkish. So far, the languages German, English, Polish and Spanish have already been supported. If the user has chosen the languages French, Italian, Portuguese or Turkish in the smartphone/tablet settings, the POSTIDENT app will adopt the chosen language. If the user has set a language which the POSTIDENT app does not support, the default language English will be used. The support of the new languages only refers to the identification process in the app. Emails and SMS will continue to be offered in German and English.
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | 11.04.2024 | 11.10.2024 |
|
| iOS | 2.6 | exp. CW 22 2024 |
With SDK v2.5 we meet Apple's requirements regarding the Privacy Manifest.
|
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | 09.10.2023 | 09.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Correction of an error in the handling of CallBackUrls when using the AutoID method |
| Android | 2.5 | 11.04.2024 | 11.10.2024 |
|
| Android | 2.6 | exp. cw 22 2024 |
|
POSTIDENT System ITU
- POSTIDENT TestApp on Integration and Test Environment (ITU)
The POSTIDENT TestApp available on the Integration and Test Environment (ITU) now offers the possibility to generate ident cases directly via the user interface of the TestApp.
The alternative possibility to simulate identifications for existing cases previously generated via SCR / EasyConnect, as before, remains.
By default, the TestApp is loaded in "Existierenden Vorgang suchen" mode. The search mask corresponds to the previous search mask. By clicking on "Neuen Vorgang erzeugen", you can now switch to another mask that allows you to create a new ident case. First, a specific billing number (ClientID) must be selected. The mask then shows which ident methods are configured in the respective billing number (ClientID) and can therefore be simulated with a ident case generated in it.
Release 21.0:
Rollout of Release 21.0 is scheduled for July 9, 2024.
Releasenotes 19.0 (19.03.2024) deutsch
POSTIDENT System
-
Einstellung Ergebnisformat XML
Wie bereits angekündigt, wird das Ergebnisformat XML mit dem Release 19.0 final eingestellt, sodass die Ergebnisformate JSON und CSV verbleiben (wir empfehlen die Verwendung des Ergebnisformats JSON - u.a. aufgrund eines eingeschränkten Datensets bei CSV).
Es bestehen keine aktiven Kundenkonfigurationen für die Bereitstellung im XML-Format über sFTP mehr. Ab dem Rollout dieses Releases ist ein Download des XML-Formats über das Auskunftsportal nicht mehr möglich. -
Anhebung der Minimallänge der Passwörter für Benutzer-Accounts auf 15 Zeichen
Die Minimallänge der Passwörter für Benutzer-Accounts wird von aktuell 12 auf 15 Zeichen angehoben. Die neue Passwort-Policy gilt für alle Passwörter, die ab Release 19.0 neu vergeben werden, d.h. existierende Passwörter müssen nicht unmittelbar geändert werden. Passwörter für neue Accounts oder geänderte Passwörter (z.B. aufgrund des Ablaufs nach 90 Tagen) müssen dagegen die neue Minimallänge von 15 Zeichen erfüllen. -
Benachrichtigung über baldige Deaktivierung eines Benutzer- und System-Accounts
Seit Release 17.0 werden aus sicherheitstechnischen Gründen Benutzer-Accounts nach 120 Tagen Inaktivität und System-Accounts nach 180 Tagen Inaktivität deaktiviert. Neu mit Release 19.0 ist, dass solche Accounts 21 Tage vor Deaktivierung per E-Mail informiert und aufgefordert werden, sich im jeweiligen POSTIDENT System anzumelden. -
E-Mail Benachrichtigungen über neue Identergebnisse im POSTIDENT Auskunftsportal
Nutzer des Auskunftsportals können optional E-Mail Benachrichtigungen mit der Anzahl an abgeschlossenen Identifizierungen für die ihnen zugeordneten Abrechnungsnummern erhalten. Das Feature erlaubt dem Nutzer, sich die E-Mail Benachrichtigungen selbst im Auskunftsportal zu konfigurieren. Die entsprechende Konfiguration findet sich unter dem Menüeintrag "Einstellungen", der über einen Klick auf den Nutzernamen oben rechts erreicht werden kann.
Standardmäßig ist das Feature für alle Nutzer deaktiviert, sodass keine ungewünschten E-Mail Benachrichtigungen versendet werden. Wird das Feature durch den Nutzer aktiviert, so kann er ein Benachrichtigungsintervall von n Stunden konfigurieren und erhält dann alle n Stunden (erstmalig n Stunden nach der Aktivierung) eine Benachrichtigungs-E-Mail an seine Login-E-Mail-Adresse.
Die E-Mail enthält eine Tabelle in der spaltenweise die unterschiedlichen POSTIDENT Verfahren und Zeilenweise die Abrechnungsnummern (ClientIDs), denen der Nutzer zugeordnet ist, aufgeführt sind. In den einzelnen Zellen werden dann die Anzahlen der seit der letzten Benachrichtigung neu bereitgestellten Identergebnisse für die Kombination aus Abrechnungsnummer und Verfahren aufgeführt. Die letzte Zeile und Spalte führt jeweils die Summen über alle Abrechnungsnummern bzw. Verfahren auf:
POSTIDENT durch AutoID
- Ausweitung der unterstützten Ausweise
Ab Release 19.0 werden im Verfahren AutoID zusätzlich Ausweise der folgenden 25 Länder unterstützt: Afghanistan, Andorra, Armenien, Aserbaidschan, Australien, Georgien, Gibraltar, Indien, Indonesien, Irak, Iran, Israel, Jordanien, Libanon, Liechtenstein, Malaysia, Malta, Monaco, Neuseeland, Pakistan, Philippinen, Singapur, Sri Lanka, Vatikan (Stadtstaat), Zypern.
Die Liste aller derzeit akzeptierten Ausweise finden Sie unter www.postident.de/download im Bereich "Handbücher / Release Notes" - diese wird zum Release 19.0 um die hinzugefügten Ausweise ergänzt.
POSTIDENT durch Videochat
- Auslieferung Servicecenter bei GwG im Ergebnis-PDF
Bislang wurde im Verfahren POSTIDENT durch Videochat für die regulatorische Klasse GwG das POSTIDENT Servicecenter, in dem die Identifizierung durchgeführt wurde, nur im Betrugsverdachtsfall im Ergebnis-PDF angegeben. Ab dem Rollout des Releases 19.0 wird das POSTIDENT Servicecenter für diese regulatorische Klasse in jedem Fall, d.h. insbesondere auch dann, wenn kein Betrugsverdacht vorliegt, im Ergebnis-PDF angegeben. Diese Änderung wurde Kunden, die dem Geldwäschegesetz unterliegen und mindestens eine aktive Konfiguration mit dem Verfahren Video haben, am 19.01.2024 angekündigt (die restlichen regulatorischen Klassen bleiben von der Änderung unberührt).
Hinweis: Wir planen die genannte Information in der regulatorischen Klasse GwG ab dem Folgerelease 20.0 auch im JSON-Ergebnisobjekt additionalDataVideo als identificationServiceCenter auszuliefern. - Namensänderung des Standorts Hermannstadt zu Standort Sibiu
In den Ergebnisdaten wird für den Servicecenter-Standort Sibiu/Hermannstadt (Rumänien) vom bisherigen Namen Hermannstadt auf den gebräuchlicheren Namen Sibiu gewechselt. Dies führt dazu, dass in den Fällen, in denen das durchführende Servicecenter im Ergebnis-PDF und/oder im JSON-Ergebnisobjekt im Feld additionalDataVideo.identificationServiceCenter angegeben wird, der Wert "8 Bridge-Integrated Customer Services Srl., Standort Sibiu" anstatt wie bisher "8 Bridge-Integrated Customer Services Srl., Standort Hermannstadt" enthalten sein wird.
POSTIDENT Apps und SDK
- Anhebung der Minimum SDK Version
Um weiterhin den bestmöglichen Support und Sicherheit gewährleisten zu können, werden wir die unterstützte MinimumSDK Version von 1.0 auf 2.0 anheben. Das bedeutet, dass Nutzer von Geschäftskunden Apps, bei denen eine SDK Version von Version 1.6 (oder kleiner) eingesetzt wird, einen Hinweis erhalten, dass die Identifizierung nicht möglich ist und hierfür die POSTIDENT App aus dem AppStore/ PlayStore heruntergeladen werden muss
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | vsl. KW 14 2024 | vsl. KW 30 2024 |
SDK allgemein:
|
| Android | 2.2 | vsl. KW 38 2023 | vsl. KW 12 2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Korrektur eines Fehlers bei der Behandlung von CallBackUrls, wenn das Verfahren AutoID genutzt wird |
| Android | 2.5 | vsl. KW 14 2024 | vsl. KW 30 2024 |
|
Release 20.0:
Der Rollout von Release 20.0 ist für den 14.05.2024 geplant.
Release Notes 19.0 (19.03.2024) english
POSTIDENT System
-
Discontinuation of result format XML
As previously announced, the XML result format will be finally discontinued with release 19.0, leaving the JSON and CSV result formats (we recommend using the JSON result format - among other things, due to a limited dataset with CSV). There are no active customer configurations for provision in XML format via sFTP already. After the rollout of this release, a download of the XML format via the POSTIDENT Information Portal is no longer possible. -
Increase in the minimum length of passwords for user accounts to 15 characters
The minimum length of passwords for user accounts will be increased from currently 12 to 15 characters. The new password policy applies to all passwords that are newly assigned from release 19.0 onwards, i.e. existing passwords do not have to be changed immediately. Passwords for new accounts or changed passwords (e.g. due to expiry after 90 days) must, however, meet the new minimum length of 15 characters. -
Notification of imminent deactivation of a user and system account
Since release 17.0, for security reasons, user accounts are deactivated after 120 days of inactivity and system accounts after 180 days of inactivity. New with release 19.0 is that such accounts are informed by email 21 days before deactivation and are requested to log in to the respective POSTIDENT system. -
Email notifications about new identification results in the POSTIDENT Information Portal
Users of the POSTIDENT Information Portal can optionally receive email notifications with the number of completed identifications for their assigned billing numbers (ClientIDs). The feature allows the user to configure the email notifications themselves in the Information Portal. The corresponding configuration can be found under the menu item "Einstellungen", which can be reached by clicking on the username at the top right. By default, the feature is deactivated for all users, so no unwanted email notifications are sent. If the feature is activated by the user, they can configure a notification interval of n hours and then receive a notification email to their login email address every n hours (initially n hours after activation). The email contains a table in which the different POSTIDENT identification methods are listed in columns and the billing numbers assigned to the user are listed in rows. In the individual cells, the number of new identification results provided since the last notification for the combination of billing number and identification method are listed. The last row and column each show the totals over all billing numbers or identification methods respectively. Currently, this email is only available in German.
POSTIDENT by AutoID
- Expansion of supported ID cards
From release 19.0, the AutoID method also supports identification documents from the following 25 countries: Afghanistan, Andorra, Armenia, Azerbaijan, Australia, Cyprus, Georgia, Gibraltar, India, Indonesia, Iraq, Iran, Israel, Jordan, Lebanon, Liechtenstein, Malaysia, Malta, Monaco, New Zealand, Pakistan, Philippines, Singapore, Sri Lanka, Vatican (city state). - The list of all currently supported ID identification documents can be found at www.postident.de/download in the "Manuals / Release Notes" section - this will be supplemented with the added identification documents for release 19.0.
POSTIDENT Apps and SDK
-
Raising the Minimum SDK Version
In order to continue to provide the best possible support and security, we will raise the supported minimum SDK version from 1.0 to 2.0. This means that users of business customer apps, where an SDK version of version 1.6 (or smaller) is used, will receive a notice that identification is not possible and the POSTIDENT app must be downloaded from the AppStore/ PlayStore for this.
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | 07.02.2024 | 07.08.2024 |
|
| iOS | 2.5 | exp. CW 14 2024 | exp. CW 30 2024 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | 09.10.2023 | 09.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | 05.02.2024 | 05.08.2024 |
|
| Android | 2.4.1 | 14.02.2024 | 14.08.2024 | Correction of an error in the handling of CallBackUrls when using the AutoID method |
| Android | 2.5 | exp. cw 14 2024 | exp. cw 30 2024 |
|
Release 20.0:
Rollout of Release 20.0 is scheduled for May 14th, 2024.
Releasenotes 18.0 (23.01.2024) deutsch
POSTIDENT durch AutoID
- Ausweitung der unterstützten Ausweise
Es wurden weitere Ausweise für die Nationalitäten China, Dänemark, Estland, Finnland, Irland, Island, Japan, Korea, Republik, Lettland, Litauen, Moldau, Norwegen, Russische Föderation, Schweden, Taiwan, Thailand und Weißrussland aufgenommen, die ab Release 18.0 in dem Verfahren AutoID unterstützt werden. Die Liste aller derzeit akzeptierten Ausweise finden Sie unter www.postident.de/download im Bereich "Handbücher / Release Notes" - diese wird zum Release 18.0 um die hinzugefügten Ausweise ergänzt.
POSTIDENT Zustellung
- Neuer Substatus Reason bei sendungsindividuellen Rücksendeadressen
Mit Release 17.0 wurde die Möglichkeit zur Definition sendungsindividueller Rücksendeadressen eingeführt. In diesem Zusammenhang haben sich folgende Neuerungen ergeben:- Für die Einlieferung eines Requests ohne Rücksendeadressen - bei entsprechender Konfiguration sendungsindividueller Rücksendeadressen - wird der neue Substatus Reason 339 in der Kombination 309/25/339 eingeführt (309 declined / 25 Problem mit digitaler Einlieferung (Datenqualität) / 339 Vorgang aufgrund unzureichender Retourenadressdaten bei digitaler Einlieferung durch Geschäftskunde abgelehnt).
- Das Element <ReturnAddress> wird in der Response nur noch ausgegeben, wenn im Request eine sendungsindividuelle Rücksendeadresse übergeben wurde, d.h. ist das Element leer (<ReturnAddress/>), wird es ausgeblendet.
POSTIDENT Apps und SDK
- Einstellung des Supports für Betriebssysteme
Mit dem neuen Release wird der Support für folgenden Betriebssysteme eingestellt:- Android: 5, 6 und 7
- iOS: 13 und 14
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | Vsl. KW 6 2024 | Vsl. KW 32 2024 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | vsl. KW 38 2023 | vsl. KW 12 2024 |
|
| Android | 2.3 | vsl. KW 48 2023 | vsl. KW 22 2024 |
|
| Android | 2.4 | Vsl. KW 6 2024 | Vsl. KW 32 2024 |
|
Release 19.0:
Der Rollout von Release 19.0 ist für den 19.03.2024 geplant.
Release Notes 18.0 (23.01.2024) english
POSTIDENT by AutoID
- Expansion of supported ID cards
Additional ID cards have been added for the nationalities Belarus, China, Denmark, Estonia, Finland, Iceland, Ireland, Japan, Republic of Korea, Latvia, Lithuania, Moldova, Norway, Russian Federation, Sweden, Taiwan, Thailand, which will be supported in the AutoID process with release 18.0.
POSTIDENT delivery
- New substatus reason for shipment-specific return addresses
With Release 17.0, the option to define individual return addresses per shipment was introduced. This resulted in the following features:- For the provision of a request without return addresses - with appropriate configuration of shipment-specific return addresses - the new substatus reason 339 is introduced within the combination 309/25/339 (309 declined / 25 problem with digital provisioning (data quality) / 339 case declined due to insufficient return address data in digital provisioning by business customer).
- The element <ReturnAddress> is only part of the response if a shipment-specific return address has been handed over in the request, i.e. if the element is empty (<ReturnAddress/>), it is hidden.
POSTIDENT Apps and SDK
- End of operating system support
With the new release, support for the following operating systems will be discontinued:- Android: 5, 6 and 7
- iOS: 13 and 14
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | 06.12.2023 | 06.06.2024 |
|
| iOS | 2.4 | exp. KW 6 2024 | exp. KW 32 2024 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | 09.10.2023 | 09.04.2024 |
|
| Android | 2.3 | 07.12.2023 | 07.06.2024 |
|
| Android | 2.4 | exp. KW 6 2024 | exp. KW 32 2024 |
|
Release 19.0:
Rollout of Release 19.0 is scheduled for March 19th, 2024.
Releasenotes 17.0 (14.11.2023) deutsch
POSTIDENT System
- URLs der Schnittstelle Easy Connect
Wie bereits in unserer Kommunikation vom 09.03.2023 an die betroffenen Kunden angekündigt, wurde für die Schnittstelle Easy Connect die für einen Übergangszeitraum bestehende Weiterleitung der alten URLs (postident.deutschepost.de/identportal/wl?an={Abrechnungsnummer}&rn={Referenznummer} bzw. postident.deutschepost.de/identportal/wl?an={Abrechnungsnummer}) abgeschaltet, d.h. diese URLs funktionieren mit dem Rollout von Release 17.0 nicht mehr. Falls Sie bereits die seit 03/2021 bereitstehenden neuen Versionen der URLs für die Schnittstelle Easy Connect nutzen, besteht kein Handlungsbedarf auf Ihrer Seite:
- Aufruf mit Referenznummer: postident.deutschepost.de/user/start/?an={Abrechnungsnummer}&rn={Referenznummer}
- Aufruf ohne Referenznummer: postident.deutschepost.de/user/start/?an={Abrechnungsnummer}
Sollten Sie nach wie vor den alten Link nutzen, stellen Sie bitte auf die neue URL um. Über die alten URLs können ab dem 14.11.2023 keine Idents mehr durchgeführt werden.
- Ausblendung leerer Objekte in SCR JSON-Ergebnisdaten
Gemäß unserer Konvention werden im Ergebnis-JSON nur gefüllte Felder ausgeliefert, während leere Felder (z.B. für Ihre regulatorische Klasse nicht relevant) ausgeblendet werden. Bislang wurde dies jedoch nur für einzelne Felder eingehalten, während Objekte als leere Container enthalten blieben. Mit dem Release 17.0 wird das Verhalten vereinheitlicht und nun auch leere Objekte ausgeblendet.
POSTIDENT Auskunftsportal
- Deaktivierung und Löschung von Benutzer- und Systemaccounts
Aus sicherheitstechnischen Gründen werden Benutzer- und System-Accounts nach 120 Tagen Inaktivität deaktiviert. Falls der Zugang nach der Deaktivierung noch benötigt wird, melden Sie sich bitte bei Ihrem Benutzerverwalter oder beim Serviceteam POSTIDENT um Ihren Zugang wieder aktivieren zu lassen. Für Benutzer-Accounts gilt zudem: Wird der Zugang nicht wieder aktiviert, wird Ihr Account 60 Tage nach der Deaktivierung gelöscht.
POSTIDENT durch AutoID
- Update der Informationen zu POSTIDENT durch AutoID
Das Verfahren POSTIDENT durch AutoID ist das automatisierte Ident-Verfahren zur schnellen und sicheren Identifizierung mit Ausweisen. Ihre Kunden können sich per Smartphone rund um die Uhr mithilfe von Techniken des Maschinellen Lernens nutzerfreundlich identifizieren lassen. Mehr Infos zu POSTIDENT durch AutoID erhalten Sie unter postident.de/autoid. Dort finden Sie auch ein Videotutorial zur Illustration des Prozesses.
Das Verfahren AutoID ist Teil des POSTIDENT Portfolios für Standard- (u.a. „non-GwG“-) Anwendungsfälle und kann neben den POSTIDENT Verfahren Videochat, Filiale und eID genutzt werden.
Bei weiteren Fragen wenden Sie sich bitte an das Serviceteam POSTIDENT.
- Ausweitung der unterstützten Ausweise
Es wurden weitere Ausweise für die Nationalitäten Belgien, Kanada, Spanien, Frankreich, Großbritannien, Luxemburg, Mazedonien, Montenegro, Niederlande, Portugal, Serbien und USA aufgenommen, die ab Release 17.0 in dem Verfahren AutoID unterstützt werden. Die Liste aller derzeit akzeptierten Ausweise finden Sie unter www.postident.de/download im Bereich „Handbücher / Release Notes“ - diese wird zum Release 17.0 um die hinzugefügten Ausweise ergänzt.
POSTIDENT Zustellung
- Individuelle Retourenadressen auf Sendungsebene
Aktuell wird für alle über Ihre Abrechnungsnummer versandten Sendungen global eine Retourenadresse definiert. Alternativ ist es nun möglich, stattdessen eine individuelle Retourenadresse auf Sendungsebene zu definieren. Dazu muss die Nutzung individueller Retourenadressen für Ihre Abrechnungsnummer konfigurativ aktiviert werden (Wenden Sie sich hierfür bitte an das Serviceteam POSTIDENT).
Detaillierte Informationen zur Übergabe individueller Retourenadressen bei Auftragserteilung finden Sie in unserer Dokumentation im SFTP Delivery API Guide Start im Kapitel 3, XML Files als neues Element ReturnAddress unter Structure of Delivery Request (Aktualisierung zum Rollout).
POSTIDENT Apps und SDK
- Anpassungen beim Verfahren POSTIDENT durch Online-Ausweisfunktion
Anpassung von einzelnen Textelementen für das Verfahren "Online-Ausweisfunktion" aufgrund des Rebranding der „AusweisApp2“ auf den neuen Namen "AusweisApp“
- Unterstützung des Users bei POSTIDENT durch Videochat
Um die Interaktion des Users mit dem Agenten zu erleichtern, wird im Vorfeld des Chats eine neue Zwischenseite integriert. Diese enthält Tipps für den User, so dass der Agent die Sicherheitsmerkmale auf dem Ausweis schnell und problemlos erkennen kann.
iOS
Android
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
|
iOS |
2.0 |
14.06.2023 |
14.12.2023 |
|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | vsl. KW 48 2023 | vsl. KW 22 2024 |
|
|
Android |
2.0 |
23.06.2023 |
23.12.2023 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | vsl. KW 38 2023 | vsl. KW 12 2024 |
|
| Android | 2.3 | vsl. KW 48 2023 | vsl. KW 22 2024 |
|
Release 18.0:
Der Rollout von Release 18.0 ist für den 23.01.2024 geplant.
Release Notes 17.0 (14.11.2023) english
POSTIDENT System
- Easy Connect URLs
As already announced in our communication to the affected customers on March 9th, 2023, the redirections of the Easy Connect interface to the old URLs (postident.deutschepost.de/identportal/wl?an={billing number} &rn={reference number} or postident.deutschepost.de/identportal/wl?an={billing number}) will be switched off, which means that these URLs will no longer work after the rollout of Release 17.0. If you are already using the new versions of the URLs for the Easy Connect interface that have been available since March 2021, there is no need for action on your part:
- Call with reference number: postident.deutschepost.de/user/start/?an={billing number}&rn={reference number}
- Call without reference number: postident.deutschepost.de/user/start/?an={billing number}
If you are still using the old link, please switch to the new URL. As of November 14th, 2023, identifications can no longer be carried out using the old URLs.
- Hiding empty objects in SCR JSON result data
According to our convention, only filled fields are delivered in the result JSON, while empty fields (e.g. not relevant for your regulatory class) are hidden. However, until now this rule has only been followed by individual fields, while objects remained as empty containers. With release 17.0, the behavior is standardized and empty objects are now also hidden.
POSTIDENT Information Portal
- Deactivation and deletion of user and system accounts
For security reasons, user and system accounts will be deactivated after 120 days of inactivity. If access is still required after deactivation, please contact your user administrator or the Serviceteam POSTIDENT to have your access reactivated. The following applies to user accounts only: If access is not reactivated, your account will be deleted 60 days after deactivation.
POSTIDENT by AutoID
- Information update of POSTIDENT by AutoID
The procedure POSTIDENT by AutoID is the automated identification process for quick and secure identification with ID cards. Your customers can be identified in a user-friendly manner around the clock via smartphone using machine learning techniques. You can find more information about POSTIDENT by AutoID at postident.de/autoid. You will also find a video tutorial illustrating the process.
The AutoID process is part of the POSTIDENT portfolio for standard (including “non-GwG”) use cases and can be used in addition to POSTIDENT by video chat, POSTIDENT by post office and POSTIDENT by online ID function (eID).
If you have any further questions, please contact the Serviceteam POSTIDENT.
- Expansion of supported ID cards
Additional ID cards have been added for the nationalities Belgium, Canada, Spain, France, Great Britain, Luxembourg, Macedonia, Montenegro, Netherlands, Portugal, Serbia and the USA, which will be supported in the AutoID process with release 17.0.
POSTIDENT delivery
- Individual return addresses per shipment
A return address is currently defined globally for all shipments that are sent with your billing number. Alternatively, it is now possible to define an individual return address for each shipment instead. In order to do this, the use of individual return addresses must be configured for your billing number (please contact the Serviceteam POSTIDENT).
Detailed information on the transfer of individual return addresses when placing an order can be found in our documentation in the SFTP Delivery API Guide Start in Chapter 3, XML files as a new ReturnAddress element can be found under Structure of Delivery Request (will be updated for rollout).
POSTIDENT Apps and SDK
- Adjustments to POSTIDENT by online ID function
Adjustment of individual text elements for POSTIDENT by online ID function process due to the rebranding of “AusweisApp2” to the new name “AusweisApp”
- Supporting the user at POSTIDENT through video chat
In order to make it easier for the user to interact with the agent, a new page is integrated before the chat starts. This page contains tips for the user so that the agent can quickly and easily recognize the security features on the ID card.
iOS
Android
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
|
iOS |
2.0 |
14.06.2023 |
14.12.2023 |
|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | 09.10.2023 | 09.04.2024 |
|
| iOS | 2.3 | exp. CW 48 2023 | exp. CW 22 2024 |
|
|
Android |
2.0 |
23.06.2023 | 23.12.2023 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | 2.2 | 09.10.2023 | 09.04.2024 |
|
| Android | 2.3 | exp. CW 48 2023 | exp. CW 22 2024 |
|
Release 18.0:
Rollout of Release 18.0 is scheduled for January 23rd, 2024.
Releasenotes 16.0 (05.09.2023) deutsch
POSTIDENT durch Videochat
- Einführung eines neuen Substatus bei missbräuchlicher Nutzung des Verfahrens
Wird das Videoident Verfahren von einem Privatkunden missbräuchlich genutzt, hat der Agent ab sofort die Möglichkeit den Ident mit dem Substatus 15 abuse (421 declined/15 abuse) abzulehnen. In diesem Fall ist verfahrensübergreifend keine Identifikation mit der abgelehnten Vorgangsnummer mehr möglich.
POSTIDENT durch Online-Ausweisfunktion (eID)
- Verbesserung des User Verständnisses
Zur Erläuterung der CAN (Zugangsnummer) werden mit dem Release 16.0 die bestehenden FAQ um den Artikel "Was ist die CAN und wofür benötige ich diese?" erweitert. Konkret enthält die FAQ erweiterte Informationen darüber, wann die 6-stellige Zugangsnummer auf der Ausweisvorderseite zu verwenden ist.
POSTIDENT Apps und SDK
Unterstützung der User-Sprachen Spanisch und Polnisch
- Hat der User in den Smartphone/Tablet Einstellungen die Sprachen Spanisch oder Polnisch eingerichtet, wird die POSTIDENT App die gewählte Sprache übernehmen. Hat der User weder Deutsch noch Spanisch oder Polnisch eingerichtet, wird die Default-Sprache Englisch verwendet.
- Die Unterstützung der neuen Sprachen Spanisch und Polnisch bezieht sich nur auf den Ident-Prozess in der App. E-Mails und SMS werden weiterhin in Deutsch und Englisch angeboten.
iOS:
Android:
- UX-Anpassungen bei Verwendung eines iPads (iOS)
- Verbesserte Kompatibilität von älteren iPhones mit einer 720p Frontkamera bei der Verwendung von Fotoident
Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
|
iOS |
2.0 |
14.06.2023 |
14.12.2023 |
|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | vsl. KW 38 2023 | vsl. KW 12 2024 |
|
|
Android |
2.0 |
23.06.2023 |
23.12.2023 |
|
| Android | 2.1 | 27.07.2023 |
27.01.2024 |
|
| Android | 2.2 | vsl. KW 38 2023 | vsl. KW 12 2024 |
|
Release 17.0:
Der Rollout von Release 17.0 ist für den 14.11.2023 geplant.
Release Notes 16.0 (05.09.2023) english
POSTIDENT by video chat
- Introduction of a new sub-status in case of improper use of the procedure
If POSTIDENT by videochat is misused by a private customer, the agent now has the option of rejecting the ident with substatus 15 abuse (421 declined/15 abuse). In this case, identification with the declined caseID is no longer possible across all methods.
POSTIDENT by online ID function (eID)
- Improvement of user understanding
To explain the CAN (access number), the existing FAQ for the article "What is the CAN and what do I need it for?" will be added with Release 16.0. Specifically, the FAQ contains extended information on when to use the 6-digit access number on the front of the ID card.
POSTIDENT Apps and SDK
Support of the user languages Spanish and Polish
- If the user has set up the languages Spanish or Polish in the smartphone/tablet settings, the POSTIDENT app will adopt the selected language. If the user has not set up German, Spanish or Polish, the default language is English.
- The support of the new languages Spanish and Polish only refers to the ident process in the app. E-mails and SMS will continue to be offered in German and English.
iOS:
Android:
- UX adjustments when using an iPad (iOS)
- Improved compatibility of older iPhones with a 720p front camera when using Fotoident
Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
|
iOS |
2.0 |
14.06.2023 |
14.12.2023 |
|
| iOS | 2.1 | 27.07.2023 | 27.01.2024 |
|
| iOS | 2.2 | exp. CW 38 2023 | exp. CW 12 2024 |
|
|
Android |
2.0 |
23.06.2023 | 23.12.2023 |
|
| Android | 2.1 | 27.07.2023 | 27.01.2024 |
|
| Android | exp. CW 38 2023 | exp. CW 12 2024 |
|
Release 17.0:
Rollout of Release 17.0 is scheduled for November 14th, 2023.
Releasenotes 15.0 (11.07.2023) deutsch
POSTIDENT durch Online-Ausweisfunktion (eID)
- Unterstützung der eID-Karte für Bürgerinnen und Bürger der EU und des EWR beim Verfahren "POSTIDENT durch Online-Ausweisfunktion" (eID)
Wie den betroffenen Kunden bereits in unserer Kommunikation vom 17.05.2023 angekündigt, kann ab dem Release 15.0 zusätzlich zum deutschen Personalausweis (eID mit Online-Ausweisfunktion) und dem elektronischen Aufenthaltstitel (eAT) nun auch die eID-Karte für Bürgerinnen und Bürger der EU und des EWR (eID-Karte UB) zur Online-Identifikation verwendet werden. Dies gilt für alle regulatorischen Klassen.
POSTIDENT Apps und SDK
Videochat (iOS und Android)
- Optimierung der Verbindungsqualität
- Verbesserung der Bild- und Videoaufnahmen
- Verbesserung der Performance und Stabilität
Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
|
iOS |
1.6 |
13.02.2023 |
13.08.2023 |
Vereinfachter Wechsel zwischen der ITU- und der PROD-Version: Implementierung einer neuen "PostidentSdk.start()" Methode, um die ITU vereinfacht aufzurufen.
|
|
iOS |
1.6.1 |
23.02.2023 |
23.08.2023 |
Behebung des Problems, dass das Verfahren POSTIDENT durch Foto nicht konfiguriert werden konnte, ohne gleichzeitig POSTIDENT durch Videochat zu konfigurieren. |
|
iOS |
1.7 |
n.v. |
n.v. |
Die iOS SDK Version 1.7 wurde nicht veröffentlicht. Die angekündigten Features sind Teil der SDK Version 2.0. |
|
iOS |
2.0 |
14.06.2023 |
14.12.2023 |
|
| iOS | 2.1 | vsl. KW 30 2023 | vsl. KW 04 2024 |
|
|
Android |
1.6 |
15.02.2023 |
15.08.2023 |
|
|
Android |
1.7 |
n.v |
n.v. |
Die Android SDK Version 1.7 wurde nicht veröffentlicht. Die angekündigten Features sind Teil der SDK Version 2.0. |
|
Android |
2.0 |
23.06.2023 |
23.12.2023 |
|
| Android | 2.1 | vsl. KW 30 2023 |
|
|
Release 16.0:
Der Rollout von Release 16.0 ist für den 05.09.2023 geplant.
Release Notes 15.0 (11.07.2023) english
POSTIDENT by online ID function (eID)
- Support of the eID card for citizens of the EU and the EEA with POSTIDENT by online ID function (eID)
As already announced to the affected customers in our communication of May 17th 2023, starting with Release 15.0 the eID card for citizens of the EU and of the EEA (eID card UB) can be used for online identification in addition to the German identity card (eID with online ID function) and the electronic residence title (eAT). This applies to all regulatory classes.
POSTIDENT Apps and SDK
Videochat (iOS and Android)
- Optimization of connection quality
- Improvement of image and video recordings
- Improvement of performance and stability
Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
|
iOS |
1.6 |
13.02.2023 |
13.08.2023 |
|
|
iOS |
1.6.1 |
23.02.2023 |
23.08.2023 |
Bugfix of the issue that POSTIDENT by photo could not be configured without configuring POSTIDENT by video chat at the same time. |
|
iOS |
1.7 |
n.a. |
n.a. |
The iOS SDK version 1.7 has not been released. The announced features are part of the SDK version 2.0. |
|
iOS |
2.0 |
14.06.202314.12.2023 |
|
|
| iOS | 2.1 | exp. CW 30 2023 | exp. CW 04 2023 |
|
|
Android |
1.6 |
15.02.2023 |
15.08.2023 |
|
|
Android |
1.7 |
n.a. |
n.a. |
The Android SDK version 1.7 has not been released. The announced features are part of the SDK version 2.0.
|
|
Android |
2.0 |
23.06.2023 | 23.12.2023 |
|
| Android | 2.1 | exp. CW 30 2023 |
|
|
Release 16.0:
Rollout of Release 16.0 is scheduled for September 5th, 2023.
Releasenotes 14.0 (16.05.2023) deutsch
POSTIDENT Apps und SDK
- Videochat (iOS und Android):
- Optimierung der Verbindungsqualität
- Verbesserung der Bild- und Videoaufnahmen
- Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
|
iOS |
1.5 |
16.11.2022 |
17.05.2023 |
|
|
iOS |
1.6 |
13.02.2023 |
13.08.2023 |
|
|
iOS |
1.6.1 |
23.02.2023 |
23.08.2023 |
Behebung des Problems, dass das Verfahren POSTIDENT durch Foto nicht konfiguriert werden konnte, ohne gleichzeitig POSTIDENT durch Videochat zu konfigurieren. |
|
iOS |
1.7 |
n.v. |
n.v. |
Die iOS SDK Version 1.7 wurde nicht veröffentlicht. Die angekündigten Features sind Teil der SDK Version 2.0. |
|
iOS |
2.0 |
vsl. KW 18/19 2023 |
vsl. KW 45/46 2023 |
|
|
Android |
1.5 |
17.11.2022 |
17.05.2023 |
|
|
Android |
1.6 |
15.02.2023 |
15.08.2023 |
|
|
Android |
1.7 |
n.v |
n.v. |
Die Android SDK Version 1.7 wurde nicht veröffentlicht. Die angekündigten Features sind Teil der SDK Version 2.0. |
|
Android |
2.0 |
vsl. KW 18/19 2023 |
vsl. KW 45/46 2023 |
|
Release 15.0:
Der Rollout von Release 15.0 ist für den 11.07.2023 geplant.
Release Notes 14.0 (16.05.2023) english
POSTIDENT Apps and SDK
- Video chat (iOS and Android)
- Optimization of connectivity quality
- Improvement of image and video recordings
- Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
|
iOS |
1.5 |
16.11.2022 |
17.05.2023 |
|
|
iOS |
1.6 |
13.02.2023 |
13.08.2023 |
|
|
iOS |
1.6.1 |
23.02.2023 |
23.08.2023 |
Bugfix of the issue that POSTIDENT by photo could not be configured without configuring POSTIDENT by video chat at the same time. |
|
iOS |
1.7 |
n.a. |
n.a. |
The iOS SDK version 1.7 has not been released. The announced features are part of the SDK version 2.0. |
|
iOS |
2.0 |
exp. CW 18/19 2023 |
exp. CW 45/46 2023 |
|
|
Android |
1.5 |
17.11.2022 |
17.05.2023 |
|
|
Android |
1.6 |
15.02.2023 |
15.08.2023 |
|
|
Android |
1.7 |
vsl. CW 13 2023 |
vsl. CW 38 2023 |
|
|
Android |
2.0 |
exp. CW 18/19 2023 |
exp. CW 45/46 2023 |
|
Release 15.0:
Rollout of Release 15.0 is scheduled for July 11, 2023.
Releasenotes 13.0 (21.03.2023) deutsch
POSTIDENT System
- Hinweis für mögliche Probleme beim Aufruf des Auskunftsportals
Nach dem Release 13.0 kann es vorkommen, dass Benutzer beim Aufruf des Auskunftsportals in einen Fehler laufen (Browser zeigt z.B. "Too Many Redirects" oder "Umleitungsfehler" an) oder Lesezeichen nicht mehr funktionieren. In diesem Fall sollten folgende Schritte zur Fehlerbehebung durchgeführt werden:
- Löschen des gesamte Caches des Browsers
- Erneuter Einstieg über die URL postident.deutschepost.de/auskunftsportal/
POSTIDENT durch Online-Ausweisfunktion (eID)
- Unterstützung des elektronischen Aufenthaltstitels beim Verfahren POSTIDENT durch Online-Ausweisfunktion (eID) für GwG und eIDAS Identifizierungen
Ab dem Release 13.0 kann zusätzlich zum deutschen Personalausweis (eID mit Online-Ausweisfunktion) der elektronische Aufenthaltstitel (eAT) nun auch in den Klassen GwG und eIDAS zur Online-Identifikation verwendet werden. Bisher war die Nutzung des eATs nur in den Klassen Telekommunikation und Standard möglich. Die Nutzung des eAT ist grundsätzlich möglich, sofern die eID-Funktion des Chips aktiviert ist. Dabei spielt es keine Rolle, ob es sich um einen eAT mit Ausweisersatzfunktion handelt oder nicht.
POSTIDENT Apps und SDK
- Korrektur des Layouts bei der CAN-Eingabe (Android) bei POSTIDENT durch Online-Ausweisfunktion (eID)
Bei bestimmten Android Geräten war beim Verfahren POSTIDENT durch Online-Ausweisfunktion (eID) bislang der "Weiter" Button im Screen der CAN-Eingabe nicht sichtbar. Dieser Fehler wird mit dem neuen Release behoben. - Korrekte Auswahl der Kamera bei PRO-Modellen (iOS)
Bei PRO-Modellen des iPhones (Modelle mit 3 Kameralinsen) wird zukünftig eine andere Kameralinse angesprochen, so dass Bildqualität und Abbruchrate verbessert werden. - Übersicht aktueller Versionen:
|
SDK |
Version |
Veröffentlichungsdatum |
Ende offizieller Support |
neue Features |
|---|---|---|---|---|
|
iOS |
1.4 |
21.09.2022 |
21.03.2023 |
|
|
iOS |
1.5 |
16.11.2022 |
17.05.2023 |
|
|
iOS |
1.6 |
13.02.2023 |
13.08.2023 |
|
|
iOS |
1.6.1 |
23.02.2023 |
23.08.2023 |
Behebung des Problems, dass das Verfahren POSTIDENT durch Foto nicht konfiguriert werden konnte, ohne gleichzeitig POSTIDENT durch Videochat zu konfigurieren. |
|
iOS |
1.7 |
vsl. KW 13 2023 |
vsl. KW 38 2023 |
|
|
Android |
1.4 |
29.09.2022 |
29.03.2023 |
|
|
Android |
1.5 |
17.11.2022 |
17.05.2023 |
|
|
Android |
1.6 |
15.02.2023 |
15.08.2023 |
|
|
Android |
1.7 |
vsl. KW 13 2023 |
vsl. KW 38 2023 |
|
Release 14.0:
Der Rollout von Release 14.0 ist für den 16.05.2023 geplant.
Release Notes 13.0 (21.03.2023) english
POSTIDENT System
- Notice of possible problems when accessing the information portal
After Release 13.0, users may run into an error when calling up the information portal (e.g. browser displays "Too Many Redirects" or "Redirect Error"), or bookmarks may no longer work. In this case, the following troubleshooting steps should be taken:
- Clearing the browser's entire cache
- Re-entry via the URL postident.deutschepost.de/auskunftsportal/
POSTIDENT by online ID function (eID)
- Support of the electronic residence title with POSTIDENT by online ID function (eID) for GwG and eIDAS identifications
Starting with Release 13.0, in addition to the German identity card (eID with online ID function), the electronic residence title (eAT) can now also be used in the GwG and eIDAS classes for online identification. Up until now the eAT could only be used in the telecommunications and standard classes. The use of the eAT is basically possible as long as the eID function of the chip is activated. Thereby it does not matter whether it is an eAT with an ID card replacement function or not.
POSTIDENT Apps und SDK
- Correction of the layout when inserting the CAN using POSTIDENT by Online ID function (Android)
With certain Android devices, the "Continue" button has previously not been visible on the CAN input screen using POSTIDENT by online ID function (eID). This error is fixed with the new release. - Correct selection of the camera on Pro models (iOS)
With PRO models of the iPhone (models with 3 camera lenses), a different camera lens will be addressed in the future, so that image quality and drop-out rate will be improved. - Overview of current versions:
|
SDK |
Version |
Date of release |
End of official support |
New features |
|---|---|---|---|---|
|
iOS |
1.4 |
21.09.2022 |
21.03.2023 |
|
|
iOS |
1.5 |
16.11.2022 |
17.05.2023 |
|
|
iOS |
1.6 |
13.02.2023 |
13.08.2023 |
|
|
iOS |
1.6.1 |
23.02.2023 |
23.08.2023 |
Bugfix of the issue that POSTIDENT by photo could not be configured without configuring POSTIDENT by video chat at the same time. |
|
iOS |
1.7 |
vsl. CW 13 2023 |
vsl. CW 38 2023 |
|
|
Android |
1.4 |
29.09.2022 |
29.03.2023 |
|
|
Android |
1.5 |
17.11.2022 |
17.05.2023 |
|
|
Android |
1.6 |
15.02.2023 |
15.08.2023 |
|
|
Android |
1.7 |
vsl. CW 13 2023 |
vsl. CW 38 2023 |
|
Release 14.0:
Rollout of Release 14.0 is scheduled for May 16, 2023.
Releasenotes 12.0 (24.01.2023) deutsch
POSTIDENT System
- Wechsel des digitalen Zertifikats (RSAPSS) für die Signatur der Ergebnisdaten und Umstellung auf eine Keylänge von 3072 Bit zum 24.01.2023
Wie in den Release Notes zum Release 11.0 sowie per E-Mail am 27.10.2022 an betroffene Kunden angekündigt, wird das digitale Zertifikat (RSAPSS) der Deutschen Post zur Signierung der Ergebnisdaten am 24.01.2022 um 22 Uhr gewechselt. Dabei wird auf einen längeren Key mit 3072 Bit umgestellt, so dass die bei Postident eingesetzten kryptographischen Verfahren auf dem neusten Stand der Technik gehalten werden. Sofern Sie die abgeholten Ergebnisdaten mit unserem Zertifikat prüfen, prüfen Sie bitte alle nach dem Umstellungszeitpunkt von uns erzeugten Dateien mit dem neuen Zertifikat. Dateien, die bereits vor der Umstellung generiert wurden, müssen mit dem alten Zertifikat geprüft werden, auch wenn sie erst nach der Umstellung abgeholt werden.
- Entfernung der Unterstützung von SHA-1 basierten Algorithmen in der Payload Verschlüsselung der SCR Encryption sowie Erhöhung der minimalen RSA Public Key Länge auf 3072 Bit
Wie bereits im Oktober 2022 per E-Mail angekündigt, werden die beim Abruf von Ident- und Signing-Ergebnissen über die REST-Endpunkte SCR-Ident (/api/scr/v1/) und SCR-Signing (/api/scr-signing/v2/) verwendeten Algorithmen angepasst. Der zu verwendende Algorithmus wird von Ihnen im HTTP Header "x-scr-alg" spezifiziert. Falls Sie diesen nicht gesetzt haben, wird aktuell RSA1_5 verwendet. Der für die Verschlüsselung zu verwendende Public Key wird von Ihnen im HTTP Header "x-scr-key" übergeben. Folgende Änderungen und Handlungsempfehlungen gelten:
- Die Algorithmen RSA1_5 und RSA-OAEP werden nicht mehr unterstützt, es verbleibt der Algorithmus RSA-OAEP-256. Dies wird auch der neue Standard, sofern der HTTP Header "x-scr-alg" nicht gesetzt ist. Bitte wechseln Sie auf den Algorithmus RSA-OAEP-256. Falls Sie den HTTP Header "x-scr-alg" bisher nicht gesetzt haben, setzen Sie diesen explizit auf "RSA-OAEP-256"
- RSA Public Keys mit 2048 Bit werden nicht mehr unterstützt. Die neue minimale Länge ist 3072 Bit. Bitte generieren Sie ein neues Keypair mit mindestens 3072 Bit Länge und übergeben Sie den neuen Public Key im Feld "x-scr-key".
- Entfernung der Unterstützung veralteter SFTP Host Key Algorithmen:
Wie bereits im September 2022 per E-Mail angekündigt, werden die beim Abruf von Ident- und Signing-Ergebnissen sowie Videomitschnitten per SFTP vom Host postident-transfer.deutschepost.de verwendeten Algorithmen ssh-rsa und ecdsa-sha2-nistp521 entfallen. Es verbleiben die Algorithmen ed-25519, rsa-sha2-512 und rsa-sha2-256. Bitte wechseln Sie mit Ihrem SFTP Client auf einen der verbleibenden Algorithmen. Zumeist ist dies konfigurativ möglich. Sofern Ihr SFTP Client keines der Verfahren unterstützt, müssen Sie entweder auf eine neuere Version oder ggf. auf ein anderes Produkt wechseln.
POSTIDENT Apps und SDK
- Erweiterung der Permission-Abfrage (Android 13)
Aufgrund von Änderungen bei Android 13 ist es ab sofort notwendig, zu den bisherigen Berechtigungsabfragen auch die Berechtigung für die Benachrichtigung/Notification beim User abzufragen.
- Verbesserung der Stabilität bei älteren Android OS Versionen (Android 5, 6, 7 und 8)
- Videochat – Ergänzende Information zur Notwendigkeit von Aufnahmen des Ausweisdokuments (iOS und Android)
Bevor der Endkunde mit einem Videoagenten verbunden wird, wird ein zusätzlicher Infotext eingeblendet. Dieser weist den Endkunden darauf hin, dass es aufgrund regulatorischer Vorgaben im nachfolgenden Videochat zu einer erneuten Aufnahme des Ausweisdokuments kommen kann. Diese ergänzende Information gibt dem Endkunden mehr Transparenz über die Notwendigkeit dieses Prozessschrittes und bereitet ihn darauf vor, das Ausweisdokument auch während des Videochats bereit zu halten.
POSTIDENT SDK
- Übersicht aktueller Versionen:
| SDK | Version | Veröffentlichungsdatum | Ende offizieller Support | Neue Features |
|---|---|---|---|---|
| iOS | 1.4 | 21.09.2022 |
21.03.2023 |
|
| Android | 1.4 | 29.09.2022 | 29.03.2023 |
|
| iOS | 1.5 | 16.11.2022 | 17.05.2023 |
|
| Android | 1.5 | 17.11.2023 | 17.05.2023 |
|
| iOS | 1.6 | vsl. KW 6 2023 | vsl. KW 32 2023 |
|
| Android | 1.6 | vsl. KW 6 2023 | vsl. KW 32 2023 |
|
Release 13.0:
Der Rollout von Release 13.0 ist für den 21.03.2023 geplant.
Release Notes 12.0 (24.01.2023) english
POSTIDENT System
- Change of the digital certificate (RSAPSS) used for signing the result data and increase of the key length to 3072 bits (SFTP) on January 24th, 2023
As has been announced in the release notes for Release 11.0 as well as by email to affected customers on October 27th, 2022, Deutsche Post's digital certificate (RSAPSS) for signing the result data will be changed on January 24th, 2022 at 10 pm. A longer key with 3072 bits will be used, so that the cryptographic processes used by Postident are kept up to date with the latest technology. If you check the retrieved result data with our certificate, please check all files generated by us after the change date with the new certificate. Files that have already been generated before the change, must be checked with the old certificate, even if they are picked up after the change.
- Deprecation of SHA-1 based algorithms in the payload encryption of SCR Encryption as well as increasing the minimum RSA public key length to 3072 bits
As has been announced by email in October 2022, the algorithms used for retrieval of ident and signing results via the REST endpoints SCR-Ident (/api/scr/v1/) and SCR-Signing (/api/scr-signing/v2/) will be modified. The algorithm that is used is specified by you in the HTTP header "x-scr-alg". If you do not specify the header then RSA1_5 is currently used. The public key used for encryption is passed by you in the HTTP header "x-scr-key". The following changes and recommendations for action apply:
- The RSA1_5 and RSA-OAEP algorithms are no longer supported, leaving the RSA-OAEP-256 algorithm, which will also be the new default unless the HTTP header "x-scr-alg" is set. Please switch to the algorithm RSA-OAEP-256. If you have not set the HTTP header "x-scr-alg" so far, set it explicitly to "RSA-OAEP-256".
- RSA public keys with 2048 bits are no longer supported. The new minimum length is 3072 bits. Please generate a new keypair with at least 3072 bit length and pass the new public key in the field "x-scr-key".
- Removal of support for outdated SFTP host key algorithms
As has been announced by email in September 2022, the ssh-rsa and ecdsa-sha2-nistp521 algorithms used when retrieving identification and signing results as well as video recordings via SFTP from the host postident-transfer.deutschepost.de will no longer be used. Algorithms ed-25519, rsa-sha2-512 and rsa-sha2-256 remain. Please switch your SFTP client to one of the remaining algorithms. In most cases, this is possible by configuration. If your SFTP client does not support any of the methods, you must either switch to a newer version or, if necessary, to a different product.
POSTIDENT Apps and SDK
- Extension of the permission requests (Android 13)
Due to changes in Android 13, it is now also necessary – in addition to the existing authorization requests – to request the user's authorization for the notification.
- Stability improvement on older Android OS versions (Android 5, 6, 7 and 8)
- Video chat - additional information on the need of taking pictures of the ID document (iOS and Android)
Before the end customer is connected to a video agent, an additional information is displayed which informs the end customer that, due to regulatory requirements, the ID document may be photographed again during the following video chat. The additional information gives the end customer more transparency on the necessity of this process step and prepares them to have the ID document ready during the video chat.
POSTIDENT SDK
- Overview of current versions:
| SDK | Version | Date of release | End of official support (date of release + 6 months) |
New features |
|---|---|---|---|---|
| iOS | 1.4 | 21.09.2022 |
21.03.2023 |
|
| Android | 1.4 | 29.09.2022 | 29.03.2023 |
|
| iOS | 1.5 | 16.11.2022 | 17.05.2023 |
|
| Android | 1.5 | 17.11.2022 | 17.05.2023 |
|
| iOS | 1.6 | expected CW 6 2023 | expected CW 32 2023 |
|
| Android | 1.6 | expected CW 6 2023 | expected CW 32 2023 |
|
Release 13.0:
Rollout of Release 13.0 is scheduled for March 21, 2023.
Sie suchen Informationen zu früheren Releases?
Releasenotes der vorangegangen Jahre finden Sie hier.