Zurück zum Blog Konnektivität

Kodierungsintegrität bei A2P-SMS: Leitfaden für Tests und Diagnose

So organisieren Sie kontrollierte Textprüfungen bei A2P-SMS, vergleichen verfügbare Nachweise und kommunizieren klar, was sich nicht verifizieren lässt.

Diagramm eines A2P-SMS-Ablaufs mit Prüfpunkten zum Vergleich von Text und verfügbaren Protokollen

Was die Wahrung der Kodierung bedeutet

In diesem Leitfaden bezeichnet Textintegrität den Vergleich des vorgesehenen Inhalts mit den verfügbaren Kopien und Protokollen während des Versands. Das bedeutet weder, dass alle Abschnitte des Übertragungswegs einsehbar sind, noch, dass der in einem Protokoll angezeigte Text zwangsläufig eine exakte Kopie dessen ist, was das Endgerät empfangen hat.

Es empfiehlt sich, drei Fragen getrennt zu betrachten: Welchen Text hat die Anwendung erstellt? Welcher Inhalt wurde an die Schnittstelle gesendet? Und welche Nachweise gibt es zu seiner Verarbeitung oder seinem Status? Eine Abweichung zwischen zwei Beobachtungen grenzt den Untersuchungsbedarf ein, belegt für sich genommen aber nicht, welche Komponente sie verursacht hat.

  • Erfassen Sie den Eingabetext und jede verfügbare Beobachtung getrennt.
  • Unterscheiden Sie zwischen einer beobachtbaren Abweichung und einer bestätigten Ursache.
  • Behandeln Sie den Inhaltsvergleich und den gemeldeten Status als getrennte Prüfungen.
Was die Wahrung der Kodierung bedeutet

Beobachtungspunkte: von der Anwendung bis zum Ziel

Skizzieren Sie den tatsächlichen Ablauf Ihrer Integration, bevor Sie Prüfungen vornehmen. Berücksichtigen Sie die Anwendung und ihre Vorlagen, die verwendete Schnittstelle, die Komponenten unter Ihrer Kontrolle sowie die Beobachtungspunkte, die der Anbieter möglicherweise bereitstellen kann. Fügen Sie das Ziel als Abschnitt des Ablaufs hinzu, ohne davon auszugehen, dass Sie Einblick in die internen Inhalte anderer Systeme haben.

Bewahren Sie vor dem Versand eine Kopie des Textes auf und erfassen Sie, welche Informationen die einzelnen Komponenten zurückgeben. Implementierungen und verfügbare Felder können variieren. Gehen Sie nicht davon aus, dass ein vereinfachtes Protokoll alle Umwandlungen beschreibt oder den vollständigen Ablauf rekonstruierbar macht.

  • Notieren Sie für jede Prüfung die Version der Anwendung, die Komponenten und die verwendete Konfiguration.
  • Bewahren Sie die von der Schnittstelle zurückgegebene Kennung auf und verknüpfen Sie sie, sofern verfügbar, mit späteren Protokollen.
  • Fragen Sie den Anbieter, wofür die einzelnen Protokolle stehen und welche Einschränkungen sie haben.
Beobachtungspunkte: von der Anwendung bis zum Ziel

Zeichen und Darstellungen: Was zu erfassen ist

Text kann in den Komponenten einer Integration unterschiedlich dargestellt oder verarbeitet werden. Die hier verfügbaren Nachweise erlauben keine Aussage dazu, welche Darstellung ein bestimmter Übertragungsweg verwendet oder welche Verarbeitung die einzelnen Komponenten vornehmen. Leiten Sie solche Einzelheiten daher nicht allein aus dem Erscheinungsbild des Textes in einer Konsole ab.

Erstellen Sie eine Zeichenliste auf Grundlage der Inhalte, die Sie tatsächlich versenden müssen. Erfassen Sie den exakten Text vor dem Versand sowie alle Informationen zu seiner Verarbeitung, die von der Schnittstelle bereitgestellt und dokumentiert werden. Gehen Sie nicht davon aus, dass zwei Systeme die Länge gleich berechnen oder den Inhalt auf dieselbe Weise beschreiben.

  • Speichern Sie vor dem Versand eine Kopie des vorgesehenen Textes.
  • Notieren Sie alle Änderungen, die die Anwendung vor dem Aufruf der Schnittstelle vorgenommen hat.
  • Erfassen Sie zusätzliche Daten nur dann, wenn sie für diese Integration verfügbar und dokumentiert sind.
  • Deuten Sie einen von einem System angezeigten Zähler nicht als Beleg dafür, wie ein anderes System den Text dargestellt hat.

Autorisierte und kontrollierte Prüfungen entwerfen

Verwenden Sie ausschließlich Testziele und Absender, für die Sie eine Genehmigung haben. Halten Sie Konfiguration und Text beim Ergebnisvergleich konstant. Ändern Sie jeweils nur eine Variable, damit sich Abweichungen leichter eingrenzen lassen.

Erstellen Sie kleine, reproduzierbare Testfälle mit Zeichen aus den Inhalten, die Sie tatsächlich verwenden werden. Wiederholen Sie eine Prüfung, wenn das Ergebnis variiert, und notieren Sie Uhrzeit, Testziel, Absender, Kennung und Konfiguration. Die verfügbaren Informationen erlauben keine Festlegung konkreter technischer Kriterien für eine bestimmte Darstellung oder Länge.

  • Vergewissern Sie sich vorab, dass Sie zur Verwendung des Testziels und des Testabsenders berechtigt sind.
  • Senden Sie jeden Testfall einzeln und verwenden Sie eine Testkennzeichnung ohne personenbezogene Daten.
  • Vergleichen Sie Konfigurationen erst, nachdem Sie eine stabile Referenz ermittelt haben.
  • Nutzen Sie die Prüfungen weder zur Kontaktaufnahme mit nicht autorisierten Empfängern noch zur Umgehung von Kontrollen.

Nachweise vergleichen, ohne unnötige Daten zu erfassen

Vergleichen Sie den vorgesehenen Text mit jeder verfügbaren Kopie in Ihrem System und in den Protokollen des Anbieters. Falls der Anbieter den verarbeiteten Inhalt nicht offenlegt, dokumentieren Sie diese Einschränkung und bitten Sie um die Mindestinformationen, die zur Eingrenzung des Problems nötig sind. Leiten Sie den Inhalt nicht aus einer Bestätigung oder einem gemeldeten Status ab.

Verringern Sie die Datenexposition, indem Sie synthetische Nachrichten und autorisierte Testziele verwenden. Beschränken Sie den Zugriff auf Protokolle und vermeiden Sie es, den vollständigen Nachrichtentext zu speichern, wenn eine Fallreferenz oder ein kontrollierter Vergleich ausreicht. Wenn Sie Text aufbewahren müssen, um eine Abweichung reproduzieren zu können, legen Sie Zugriff und Aufbewahrungsfrist gemäß Ihren Richtlinien und den geltenden Pflichten fest.

  • Führen Sie eine Tabelle mit Phase, beobachtetem Wert, Quelle, Uhrzeit und Einschränkungen.
  • Unterscheiden Sie Daten aus Ihrem System von Angaben des Anbieters.
  • Verwenden Sie in Prüfungen keine echten Einmalcodes, sensiblen Informationen oder personenbezogenen Daten.
  • Bewahren Sie genügend Nachweise auf, um den Fall zu reproduzieren, aber keine undifferenzierte Kopie des gesamten Datenverkehrs.

Abweichungen untersuchen, ohne vorschnell Ursachen zuzuschreiben

Ein Zeichen, das anders erscheint, fehlt oder ersetzt wurde, ist ein Anlass zur Untersuchung und keine automatische Ursachenzuschreibung. Prüfen Sie zuerst den von der Anwendung erzeugten Text und vergleichen Sie anschließend die verfügbaren Beobachtungen der einzelnen Schritte. Wenn nur der Eingabetext und ein abschließender Status bekannt sind, lässt sich die verantwortliche Phase möglicherweise nicht bestimmen.

Wenn die Abweichung mit anderen beobachteten Änderungen zusammenfällt, dokumentieren Sie diese, ohne einen ursächlichen Zusammenhang anzunehmen. Unterschiede zwischen den Daten zweier Systeme belegen für sich genommen weder, was in den Zwischenabschnitten geschehen ist, noch, was auf dem Endgerät angezeigt wurde.

  • Reproduzieren Sie den Fall mit einer minimalen Nachricht, die den problematischen Text enthält.
  • Vergleichen Sie eine Kontrollversion und dokumentieren Sie die Beobachtungen zu beiden Versionen.
  • Prüfen Sie, ob die Anwendung den Text geändert hat, bevor Sie die Ursache einer anderen Phase zuschreiben.
  • Kennzeichnen Sie jede Phase ohne direkten Nachweis als nicht bestätigt.

Was Bestätigungen, Protokolle und DLR belegen – und was nicht

Eine Bestätigung oder ein DLR sollte entsprechend der Definition der ausgebenden Quelle interpretiert werden. Die verfügbaren Nachweise erlauben es nicht, einem Status einer Schnittstelle oder eines Anbieters eine konkrete Bedeutung zuzuschreiben. Stellen Sie einen gemeldeten Status nicht automatisch als Beleg dafür dar, dass der Nutzer die Nachricht gelesen hat oder dass der Text unverändert auf dem Bildschirm des Endgeräts angekommen ist.

Fragen Sie nach der Definition des Statuscodes und den bekannten Einschränkungen, bevor Sie einen Status als operatives Kriterium verwenden. Gibt es keine unabhängige Prüfung am Endgerät, beschreiben Sie das Ergebnis als gemeldeten Status und nicht als verifizierten Empfang auf dem Gerät.

  • Dokumentieren Sie die Bedeutung der Statusangaben gemäß der ausgebenden Quelle.
  • Unterscheiden Sie zwischen der Bestätigung einer Anfrage, einem gemeldeten Status und einer unabhängigen Prüfung am Endgerät.
  • Verwenden Sie ein DLR weder als Lesebestätigung noch als Bestätigung der Textintegrität.

Diagnoseablauf und Abnahmekriterien

Wenn Sie eine Abweichung feststellen, bewahren Sie den minimal reproduzierbaren Fall auf und notieren Sie die Konfiguration. Prüfen Sie zuerst den von der Anwendung erzeugten Text. Vergleichen Sie danach den an die Schnittstelle gesendeten Text mit der erhaltenen Antwort. Fragen Sie schließlich den Anbieter nach verfügbaren Protokollen zur entsprechenden Kennung. Fügen Sie bei einer Eskalation Uhrzeit, autorisiertes Ziel, Absender, Testtext und die genauen Beobachtungen hinzu. Bitten Sie um Klärung, für welche Phase die einzelnen Protokolle stehen.

Legen Sie Kriterien fest, die ausschließlich auf dem beruhen, was Sie beobachten und vergleichen können. Sie können beispielsweise verlangen, dass der Text an den zugänglichen Punkten übereinstimmt und Abweichungen reproduzierbar oder eingrenzbar sind. Lässt sich der Inhalt in einer Phase nicht verifizieren, benennen Sie diese Grenze und vereinbaren Sie den Umgang mit Vorfällen, ohne eine Annahme zum Abnahmekriterium zu machen.

  • Erstellen Sie eine Referenz mit synthetischen Nachrichten und autorisierten Absendern und Zielen.
  • Bewerten Sie den Übertragungsweg anhand überprüfbarer Anforderungen und nicht anhand von Annahmen zu unsichtbaren Phasen.
  • Fragen Sie den Anbieter nach Definitionen der Protokolle und Statusangaben sowie nach dokumentierten Informationen, die Ihre Integration betreffen.
  • Wiederholen Sie die Prüfungen nach Änderungen, die den Text oder die verfügbaren Protokolle beeinflussen könnten.
FAQ

Häufige Fragen

Bestätigt ein DLR, dass der Text vollständig auf dem Mobiltelefon angekommen ist?

Das lässt sich allein aus einem DLR nicht schließen. Interpretieren Sie es gemäß der Definition der ausgebenden Quelle. Für sich genommen belegt es weder, welcher Text auf dem Endgerät angezeigt wurde, noch, dass der Nutzer ihn gelesen hat.

Wie kann ich feststellen, wie der Text in meiner Integration verarbeitet wurde?

Vergleichen Sie den vorgesehenen Text mit den verfügbaren Beobachtungen der einzelnen Phasen und konsultieren Sie die Dokumentation des Anbieters. Das Erscheinungsbild in einer Konsole reicht nicht aus, um die interne Verarbeitung zu bestätigen.

Welche Fälle sollte ich in die Prüfungen aufnehmen?

Beginnen Sie mit den Inhalten, die Sie tatsächlich versenden müssen, und testen Sie kleine, reproduzierbare Varianten. Verwenden Sie ausschließlich autorisierte Ziele und Absender.

Beweist eine Abweichung zwischen dem Originaltext und einem Protokoll, dass der Anbieter den Text geändert hat?

Nein. Sie belegt eine Abweichung zwischen zwei Beobachtungen. Um sie einzugrenzen, vergleichen Sie die aufeinanderfolgenden Nachweise und klären Sie, wofür die einzelnen Protokolle stehen und welche Informationen nicht verfügbar sind.

Was sollte ich dem Anbieter bei einer Eskalation schicken?

Einen minimalen reproduzierbaren Fall mit Uhrzeit, Kennung, Konfiguration, autorisiertem Ziel, Absender und einem genauen Vergleich zwischen dem vorgesehenen Text und den verfügbaren Beobachtungen. Vermeiden Sie personenbezogene Daten und echte sensible Nachrichten.

Verwendete Quellen

  1. 3GPP specifications3GPP
  2. ITU-T E.164International Telecommunication Union
  3. GSMA resourcesGSMA
  4. SMPP specificationSMPP Developers Forum
  5. HTTP semanticsIETF