Dein Prenly Onboarding

• Google | Ein Google Konto erstellen

  4 Aug 2026

  Ein Google-Konto ist erforderlich, um Dienste wie die Google Play Console nutzen zu können. Wichtig: Erstellen Sie ein Google-Konto und kein Google Workspace-Konto. Für ein Google Workspace-Konto ist ein kostenpflichtiges Abonnement erforderlich. Tipp: Wir empfehlen, eine allgemeine oder gemeinsam genutzte E-Mail-Adresse (z. B. apps@unternehmen.de) zu verwenden, auf die mehrere Personen in Ihrer Organisation Zugriff haben. So bleibt der Zugriff auch bei Urlaub, Krankheit oder einem Personalwechsel gewährleistet.   Option 1: Google-Konto während der Registrierung für die Play Console erstellen Wenn Sie ein Google Play Console-Konto einrichten, können Sie Ihr Google-Konto direkt während der Registrierung erstellen. Klicken Sie hier, um zu beginnen.   Option 2: Google-Konto direkt erstellen Alternativ können Sie Ihr Google-Konto vorab über diesen Link erstellen. Folgen Sie anschließend diesen Schritten: Schritt 1:Klicken Sie auf Konto erstellen. Schritt 2: Wählen Sie Für mich aus. Wenn Sie Für Arbeit oder mein Unternehmen auswählen, wird stattdessen ein Google Workspace-Konto erstellt. Schritt 3:Geben Sie den Vornamen und optional den Nachnamen des Kontoinhabers ein. Hinweis: Google kann später eine Identitätsprüfung mit einem gültigen amtlichen Ausweisdokument verlangen. Das Konto sollte daher auf eine reale Person registriert werden. Geben Sie anschließend Ihr Geburtsdatum ein. Die Angabe des Geschlechts ist optional. Wählen Sie anschließend eine der folgenden Optionen: Verwenden Sie Ihre bestehende E-Mail-Adresse, indem Sie Vorhandene E-Mail-Adresse verwenden auswählen. Oder erstellen Sie eine neue Gmail-Adresse, indem Sie den Anweisungen folgen. Schritt 4:Bestätigen Sie Ihre E-Mail-Adresse (falls Sie eine bestehende E-Mail-Adresse verwenden). Google sendet einen Bestätigungscode, den Sie eingeben müssen, um fortzufahren. Schritt 5: Erstellen Sie ein sicheres Passwort.Aktivieren Sie anschließend die Zwei-Faktor-Authentifizierung (2FA). Dies wird dringend empfohlen und ist für viele Google-Dienste erforderlich.   Nächste Schritte Nach der Erstellung Ihres Google-Kontos können Sie sich damit bei Google-Diensten wie der Google Play Console anmelden. Weitere Informationen finden Sie in der offiziellen Google-Dokumentation:https://support.google.com/accounts/answer/27441

• ID-Token

  30 Mar 2026

  Ein ID-Token kann verwendet werden, um die eindeutige Benutzer-ID zu extrahieren, nachdem sich der Benutzer autorisiert hat. Sie können auch die Verwendung eines Ressourcenservers umgehen, indem Sie einen benutzerdefinierten Anspruch in der Nutzlast des ID-Tokens verwenden.Spezifikationen Um ein ID-Token zu verwenden, müssen Sie überprüfen, dass: Das ID-Token entspricht der JWT-Spezifikation (RFC 7519). Das ID-Token entspricht der OpenID Connect Core-Spezifikation. Das ID-Token enthält die erforderlichen Angaben (siehe OpenID-Spezifikation für weitere Einzelheiten). Die Validierung des ID-Tokens entspricht der Spezifikation. Issuer und Discovery Prenly erfordert die Kenntnis des Ausstellers ("iss" in der ID-Token-Nutzlast), wobei der Aussteller eine gültige URI sein muss. Möglicherweise müssen Sie auch die Discovery-Spezifikation erfüllen. Im Besonderen: OpenID Provider, die Discovery unterstützen, MÜSSEN ein JSON-Dokument unter dem Pfad verfügbar machen, der durch Verkettung der Zeichenkette /.well-known/openid-configuration zum Issuer gebildet wird. - Abschnitt Beziehen von OpenID Provider Konfigurationsinformationen Dieser Pfad wird durch die Verkettung des Issuers gebildet: {issuer}/.well-known/openid-configuration Anmerkungen: Der Issuer darf keinen abschließenden Schrägstrich enthalten. Der Issuer muss eine gültige, funktionale URL sein. Validierung Das ID-Token muss überprüfbar sein, bevor seine Nutzdaten als vertrauenswürdig eingestuft werden können. Erforderlich ist der Zugriff auf das JSON Web Key Set (JWKS), das in der Regel wie folgt referenziert wird: JKU JWKS-URI Dieser ist in der Regel verfügbar über: {issuer}/.well-known/jwks (oder in der OpenID-Konfiguration angegeben) Zusätzliche Anforderungen: Wenn mehrere Signierschlüssel verwendet werden, muss der "kid"-Header-Claim im ID-Token enthalten sein. Wenn nur ein Schlüssel verwendet wird, nimmt Prenly an, dass dieser Schlüssel für die Überprüfung gültig ist. Sie können ID-Token mit folgenden Tools testen und verifizieren: https://jwt.io Testen über JWT.io Rufen Sie https://jwt.io auf. Fügen Sie Ihr ID-Token in das Feld " Encoded" ein Überprüfen Sie die dekodierten Abschnitte: Header Payload Signature Wenn die Überprüfung fehlschlägt: Fügen Sie Ihren JWK (JSON) in das Feld ein: "Öffentlicher Schlüssel im SPKI-, PKCS #1-, X.509-Zertifikat- oder JWK-String-Format". Payload Zusätzlich zu den erforderlichen Angaben verwendet Prenly hauptsächlich: "sub" Optional unterstützte Angaben: "email" "given name" "family name" "name" eine vollständige Liste der Angaben finden Sie in der Spezifikation für erforderliche und optionale Angaben. Wenn Name und E-Mail verfügbar sind: Sie werden nach der Anmeldung in der Benutzeroberfläche angezeigt. Andernfalls: Es wird ein Platzhalter angezeigt Benutzerdefinierte Claims (Abonnements) Unterstützt nur benutzerdefinierte Ansprüche im ID-Token: Muss ein String-Array sein Jeder Wert steht für einen Abonnement-Produktcode Wird verwendet, um Zugriff auf geschützte Inhalte zu gewähren Geltungsbereiche Erforderlicher Bereich: openid Empfohlener Bereich: offline_access (für Details siehe Spezifikation für Offline-Zugriff) Vorteile: Ermöglicht länger andauernde Authentifizierungssitzungen Wichtiges Verhalten: Verwendet zur Bestimmung des Authentifizierungsstatus vornehmlich das Zugriffstoken Sitzungsdauer hängt ab von: Ablauf des Tokens Dauer des Prenly-Cache (Minimum: 20 Minuten)

• Umleitungs-URIs und Fehlerumleitungs-URIs

  30 Mar 2026

  Prenly verwendet derzeit keine URIs für die Weiterleitung. Die folgenden Redirect-URIs können in Ihrem Autorisierungsserver konfiguriert werden, um Attack-in-the-Middle-Angriffe zu verhindern. Prenly verwendet Abfrageparameter, die durch den Autorisierungsfluss definiert sind, aber die Redirect-URI sollte im Autorisierungsserver ohne diese Parameter konfiguriert werden. Wenn Sie weitere Informationen benötigen, wenden Sie sich bitte an den Prenly-Kundensupport unter hello@prenly.com.Einloggen Prenly unterstützt den OAuth2-Autorisierungsfluss mit dem Grant-Autorisierungscode. Prenly verwendet nach erfolgreicher Anmeldung die folgenden Redirect URIs. Android: {Paketname}://auth/oauth2-autorisierungs-code/login-mit-code iOS: {Paket-ID}://auth/oauth2-autorisierung-code/login-mit-code Web: {web app URL}/authorisation/auth-codeZum Beispiel https://your.epaper.url/authorization/auth-code Hinweis: Android entfernt den Unterstrich aus dem Paketnamen. Abmelden Prenly verwendet bei erfolgreichem Logout die folgenden Redirect-URIs, wobei Logout eine Autorisierungsanfrage zum Beenden der aktuellen Benutzersitzung auf dem Autorisierungsserver ist. Android: {Bundle-Name}://auth/oauth2-autorisierungs-code/logout iOS: {Bundle-ID}://auth/oauth2-autorisierungs-code/logout Web: {web app URL}/authorisation/auth-code

• Archiv hochladen

  12 Feb 2026

  Mit einem FTP-Client können Sie ein Archiv (mit Standard-PDF-Dateien) zu uns hochladen. Hier sind einige einfache Anweisungen. Hinweis: Wenn Ihr Archiv größer als 100 GB ist, kontaktieren Sie uns bitte vor dem Hochladen. Benennung der Dateien Alle hochgeladenen PDF-Dateien müssen mit dem Titel (Name oder Abkürzung der Zeitung) und dem Erscheinungsdatum benannt werden, ggf. auch mit dem Teil, zu dem die PDF-Datei gehört, und der Seitenzahl. Wenn eine Ausgabe aus einem zusammengefügten PDF besteht:titel_20190101.pdf Wenn eine Ausgabe aus mehreren PDF-Dateien besteht, fügen Sie die Seitenzahl hinzu:title_20190101_001.pdftitle_20190101_002.pdftitle_20190101_003.pdf Wenn eine Nummer aus verschiedenen Teilen besteht:title_20190101_partA_001.pdftitle_20190101_partA_002.pdftitle_20190101_partA_003.pdftitle_20190101_partB_001.pdftitle_20190101_partB_002.pdftitle_20190101_partB_003.pdf Es ist wichtig, konsistent zu sein Die vorgegebene Namensstruktur ermöglicht es, die Dateien zu importieren. Auch Zeichen wie Unterstriche und Punkte sind wichtig. Wenn eines der Zeichen ersetzt wird, werden die Dateien beim Import nicht gefunden und daher nicht veröffentlicht. Achten Sie daher darauf, dass die Namensstruktur immer gleich aussieht. Benennung von Ausgaben mit Ausgabennummer (optional) Standardmäßig wird eine Ausgabe nach dem Veröffentlichungsdatum benannt, zum Beispiel 2019-01-01.Es ist auch möglich, die Ausgabe stattdessen nach ihrer Ausgabennummer zu benennen, sofern diese Nummer im Dateinamen in strukturierter Form enthalten ist.Damit dies funktioniert, muss jede PDF-Datei einem festen Namensformat folgen, zum Beispiel:title_1_20190101.pdftitle_2_20190201.pdf In diesem Beispiel können wir die Ausgabennummern 1 und 2 sowie das Jahr 2019 aus dem Dateinamen extrahieren. Wenn Sie diese Funktion nutzen möchten, teilen Sie uns bitte Folgendes mit:- dass die Ausgabennummer im Namen verwendet werden soll- an welcher Position im Dateinamen sich die Ausgabennummer befindet- wie der Name formatiert werden soll Beispiele für das Anzeigeformat:- Nr. 1 - 2019- Ausgabe 2 2019

• LOGIN | CSV

  12 Feb 2026

  Eine gängige Methode, Material hinter einem Anmeldeverfahren zu sperren, ist die Verwendung einer CSV-Datei. Wenn ein Leser versucht, sich anzumelden, wird die Registrierung (CSV-Datei) abgefragt, um festzustellen, ob der Zugang gewährt wird oder nicht. Was sollte die Registrierung enthalten? Eine CSV-Datei sieht aus wie eine Excel-Datei und sollte folgende wünschenswerte Informationen enthalten:- Namen- E-Mail-Adressen- Kundennummer/Abonnementnummer/ID-Nummer Wo soll das Register gespeichert werden? Die Datei wird mit Hilfe eines FTP-Clients zu uns hochgeladen. Die Datei wird mit Hilfe eines FTP-Clients zu uns hochgeladen.Wenn Sie keinen FTP-Client haben, müssen Sie einen herunterladen, z. B. FileZilla.- FileZilla für Mac herunterladen- FileZilla für Windows herunterladen Denken Sie daran, die Datei jedes Mal gleich zu benennen, wenn eine neue Datei erstellt wird, damit wir sie beim Importieren immer finden können.

• 

  Datenschutzrichtlinie generieren

  27 Nov 2025

  Wenn Sie noch keine Datenschutzrichtlinie haben, können Sie Ihre Seite mit den Datenschutzrichtlinien direkt in Prenly erstellen und hosten. Klicken Sie in Prenly Workspace im linken Menü auf Anwendungen und wählen Sie die Anwendung aus, der Sie die Datenschutzrichtlinie hinzufügen möchten. Klicken Sie im Anwendungsmenü auf Datenschutzrichtlinie. Hier können Sie mit der Erstellung Ihrer Datenschutzrichtlinie beginnen.   Als Nächstes können Sie entweder vorhandene Inhalte einfügen, oder, falls Sie keine bestehende Datenschutzrichtlinie haben, können Sie unser Tool verwenden, um eine neue Datenschutzrichtlinie zu erstellen: https://privacy.prenly.co/   Wählen Sie in der oberen rechten Ecke die Sprachauswahl, um zu Ihrer bevorzugten Sprache zu wechseln. Dies ist wichtig zu wissen: Sie sind immer der für die Datenverarbeitung Verantwortliche, der die Verantwortung dafür trägt, dass die Richtlinie für Ihr Unternehmen korrekt ist. Bitte beachten Sie, dass die Seite derzeit nichts speichert, so dass ein erneutes Laden der Webseite das Formular leert.

• 

  Google | Konto validieren

  24 Oct 2025

  In der Google Play Console sehen Sie dieses Banner: Bild mit Banner im Google-Entwicklerkonto . Klicken Sie auf "Details anzeigen" und Sie werden die folgende Ansicht sehen: Bild mit Anweisungen für die Website des Unternehmens. Klicken Sie auf "Go to Search Console".Geben Sie in der Google Search Console unter Domain Ihre Unternehmensdomain ein (z. B. prenly.com). Das Bild zeigt die Google Search Console . Sie sehen dann etwa so aus: Das Bild zeigt die Anweisungen für den Domainbesitz über den DNS-Eintrag . ... Google möchte, dass Sie beweisen, dass Sie der Eigentümer der genannten Domain sind, indem Sie einen speziellen Code zu den Einstellungen Ihrer Domain hinzufügen (dies wird DNS-TXT-Eintrag genannt). Und so geht's: Melden Sie sich bei Ihrer Domain-Registrierungsstelle an - Gehen Sie zu der Website, auf der Sie Ihre Domain erworben oder verwaltet haben (z. B. GoDaddy, Namecheap, Cloudflare oder ein ähnlicher Dienst).- Loggen Sie sich mit Ihren Kontoanmeldedaten ein. Gehen Sie zu Ihren DNS-Einstellungen - Sobald Sie eingeloggt sind, suchen Sie die DNS-Einstellungen oder den Zoneneditor für Ihre Domain.- Er befindet sich oft in einem Abschnitt namens Domains verwalten oder DNS-Management.- Suchen Sie nach etwas wie "DNS-Einträge bearbeiten" oder "Zonendatei-Einstellungen". Fügen Sie den TXT-Eintrag hinzu - Eintragstyp: Wählen Sie TXT (wie im Screenshot gezeigt, ist dies der Eintragstyp, nach dem Google fragt).- Host/Name: Bei einigen Registrierstellen müssen Sie ein @ eingeben (dies steht für die Stammdomäne). Andere bitten Sie, das Feld leer zu lassen oder Ihren vollständigen Domainnamen einzugeben.- Wert/Text: Kopieren Sie den genauen TXT-Wert aus dem Screenshot: google-site-verification=xyz und fügen Sie ihn in das Feld Wert oder Text ein. Speichern Sie den Eintrag - Sobald Sie die Details eingegeben haben, klicken Sie auf Speichern oder Aktualisieren.- Der TXT-Eintrag wird nun zu den DNS-Einstellungen Ihrer Domain hinzugefügt. ... Überprüfen in der Google Search Console - Gehen Sie zurück zur Google Search Console.- Klicken Sie auf die Schaltfläche Überprüfen am unteren Rand des Bildschirms.- Tipp: Wenn Sie in der Google Search Console Diagramme und Daten sehen, bedeutet dies, dass der txt-Eintrag erfolgreich war. Überprüfen Sie in der Google Play-Konsole - Klicken Sie in Google Play im Banner mit der Aufschrift "Beenden Sie die Einrichtung Ihres Entwicklerkontos" auf "Details anzeigen". - Klicken Sie auf "Website verifizieren".- Wenn dies zu Ihren Kontodetails führt, scrollen Sie nach unten zur Website Ihres Unternehmens und klicken Sie auf die Schaltfläche "...". - Überprüfen Sie, ob das Banner auf der Startseite der Google Play Console verschwunden ist ... Wichtige Hinweise- Es kann einige Zeit dauern (bis zu 48 Stunden), bis DNS-Änderungen im Internet aktualisiert werden. Wenn die Überprüfung nicht sofort funktioniert, warten Sie ein paar Stunden und versuchen Sie es erneut.- Wenn Sie nicht wissen, wo Ihre Domain registriert ist oder verwaltet wird, wenden Sie sich an die Person oder das Team, das für die Einrichtung Ihrer Website verantwortlich ist.

• Datenschutzbestimmungen

  24 Oct 2025

  Gemäß der schwedischen Datenschutzgesetzgebung und der DSGVO (Datenschutz-Grundverordnung) sind Sie als Verantwortlicher verpflichtet, eine gültige Datenschutzerklärung bereitzustellen. Wenn Sie außerdem eine Android- oder iOS-App anbieten, sind Sie verpflichtet, eine gültige Datenschutzerklärung gemäß den Richtlinien von Google und Apple bereitzustellen. Falls Sie noch keine Datenschutzerklärung haben, können Sie die Seite Datenschutzrichtlinie generieren besuchen. Es ist wichtig zu beachten, dass Ihre Datenschutzerklärung klar darlegen muss, wie Sie als Verantwortlicher Nutzerdaten erheben, verwenden und gegebenenfalls weitergeben. Sie dürfen keine Nutzerdaten verarbeiten, die nicht in Ihrer Datenschutzerklärung aufgeführt sind. Nutzerdaten Personenbezogene und sensible Nutzerdaten umfassen alle Informationen, die direkt oder indirekt mit einer bestimmten natürlichen Person in Verbindung gebracht werden können. Personenkennziffer (z. B. Personennummer) Kontaktdaten wie E-Mail-Adresse und Telefonnummer Zahlungsinformationen oder andere finanzielle Angaben Authentifizierungsdaten (z. B. Anmeldedaten) Berechtigungsdaten (z. B. Abonnementinformationen) Gesundheitsbezogene Informationen, einschließlich der sexuellen Orientierung Mit anderen Worten: sämtliche Informationen, mit denen ein bestimmter Nutzer unter allen Nutzern des Dienstes bzw. Produkts identifiziert werden kann. Anforderungen von Google Ihre Datenschutzerklärung muss... ...beschreiben, auf welche Daten die App zugreifen oder welche Daten sie über den Nutzer erfassen kann. ...erklären, wie die Daten [1] verwendet und/oder weitergegeben werden. ...nicht mit anderen Hinweisen kombiniert werden, die nicht mit der Erhebung personenbezogener und/oder sensibler Nutzerdaten zusammenhängen. ...den Begriff „Privacy Policy“ irgendwo im Text enthalten. Google übersetzt die Informationen ins Englische. Wenn das Übersetzungstool den Ausdruck „Privacy Policy“ nicht finden kann, wird die Datenschutzerklärung abgelehnt. ...über eine URL (Webadresse) direkt zugänglich sein, ohne Bezahlschranke, und die Seite darf nicht bearbeitbar sein. Ein verlinktes PDF-Dokument ist nicht zulässig. ...vollständig sein. Die gesamte Datenschutzerklärung muss über die URL zugänglich sein und darf nicht auf externe Ressourcen wie „Mehr lesen“ verweisen. Quellen https://support.google.com/googleplay/android-developer/answer/10144311?hl=en&sjid=13395122270323995155-EU Häufig gestellte Fragen Benötige ich eine Datenschutzerklärung? Ja, wenn Sie eine E-Paper-Ausgabe anbieten, sind Sie verpflichtet, eine Datenschutzerklärung bereitzustellen. Darf ich meine Datenschutzerklärung hinter einer Anmeldung platzieren? Nein. Die Datenschutzerklärung muss vollständig und öffentlich über eine Website zugänglich sein. Sie darf nicht als herunterladbares Dokument, beispielsweise als PDF- oder MS-Word-Datei, bereitgestellt werden. Kann ich meine Datenschutzerklärung in mein E-Magazin aufnehmen? Ja, das ist möglich. Sie können sie als Artikel in einer offenen digitalen Veröffentlichung über Prenly Workspace veröffentlichen. Der Artikel kann dabei als Webseite für Ihre Datenschutzerklärung dienen.

• Google | Entwicklerkonto erstellen

  24 Oct 2025

  Um eine Android-App im Google Play Store zu veröffentlichen, benötigen Sie ein Google Play Console-Entwicklerkonto. Bevor Sie dieses erstellen können, benötigen Sie ein Google-Konto sowie eine D-U-N-S-Nummer.   Schritt 1 – Google-Konto Das Play Console-Entwicklerkonto ist dauerhaft mit dem Google-Konto verknüpft, das bei der Registrierung verwendet wird. Wählen Sie dieses daher sorgfältig aus, da der Kontoinhaber später nicht mehr geändert werden kann. Falls Sie noch kein Google-Konto besitzen, folgen Sie zunächst dieser Anleitung, bevor Sie fortfahren.   Schritt 2 – D-U-N-S-Nummer Falls Sie bereits über eine D-U-N-S-Nummer verfügen, können Sie direkt mit Schritt 3 fortfahren. Für die Erstellung eines Google Play Console-Entwicklerkontos benötigen Sie eine D-U-N-S-Nummer. Die D-U-N-S-Nummer ist eine internationale Unternehmenskennung. Falls Sie die D-U-N-S-Nummer Ihres Unternehmens nicht kennen, können Sie diese unter dunsnumberlookup.dnb.com nachschlagen und sich zusenden lassen.   Schritt 3 – Play Console-Entwicklerkonto Stellen Sie sicher, dass Sie mit dem richtigen Google-Konto angemeldet sind. Falls erforderlich, wählen Sie Konto wechseln, um den richtigen Kontoinhaber auszuwählen. Erstellen Sie Ihr neues Entwicklerkonto hier. Melden Sie sich mit dem richtigen Google-Konto an. Akzeptieren Sie die Google Developer Distribution Agreement. Google erhebt eine einmalige Registrierungsgebühr von 25 USD. Wählen Sie eine geeignete Zahlungsmethode und schließen Sie die Zahlung ab.   Wichtig: Wählen Sie als Kontotyp Organisation. Diese Einstellung kann nach der Kontoerstellung nicht mehr geändert werden. Tipp: Der von Ihnen gewählte Entwicklername wird öffentlich im Google Play Store angezeigt. Wir empfehlen, den offiziellen Namen Ihrer Organisation zu verwenden.   Schritt 4 – Prenly einladen Melden Sie sich in der Google Play Console an. Klicken Sie im linken Menü auf Nutzer und Berechtigungen. Wählen Sie Neuen Nutzer einladen. Geben Sie dev@prenly.com als E-Mail-Adresse ein und lassen Sie das Feld Ablaufdatum leer. Wählen Sie unter Kontoberechtigungen die Rolle Administrator. Klicken Sie auf Nutzer einladen. Tipp: Ist die Schaltfläche „Nutzer einladen“ ausgegraut, wurde wahrscheinlich ein erforderlicher Schritt vergessen.   Schritt 5 – Kontoverifizierung abschließen Bevor Ihr Entwicklerkonto verwendet werden kann, verlangt Google mehrere Verifizierungsschritte. Stellen Sie sicher, dass alle folgenden Schritte abgeschlossen wurden: Verifizieren Sie Ihre Organisation mithilfe der D-U-N-S-Nummer. Verifizieren Sie die Identität des Kontoinhabers mit einem gültigen amtlichen Ausweisdokument. Verifizieren Sie die Website Ihrer Organisation. Wichtig: Ihr Entwicklerkonto wird erst vollständig aktiviert, wenn alle erforderlichen Verifizierungsschritte erfolgreich abgeschlossen wurden.   Empfehlung Wir empfehlen, die Zahlungsbestätigung von Google nach der Erstellung Ihres Play Console-Entwicklerkontos auszudrucken oder sicher aufzubewahren. Diese E-Mail enthält wichtige Informationen, die benötigt werden können, falls Ihre App später auf ein anderes Play Console-Konto übertragen werden muss, darunter: Die Transaktions-ID Die verwendete Zahlungsmethode Das Kaufdatum Die E-Mail-Adresse des Kontoinhabers

• Apple | Entwickler-Account erstellen

  24 Oct 2025

  Um eine iOS-App im App Store zu veröffentlichen, benötigen Sie ein Unternehmens-Entwicklerkonto, für das eine DUNS-Nummer und ein Apple-Konto erforderlich sind. Wenn Sie dieses noch nicht haben, wird es über Apple erstellt. Wenn Sie eine ausführlichere Anleitung als die unten stehende benötigen, klicken Sie hier und scrollen Sie nach unten zu Anmeldung beim Apple Developer Program als Organisation.   Beginnen Sie hier: Schritt 1 - Apple Account (früher als Apple ID bezeichnet) Das Apple-Konto wird hier erstellt: Apple-Konto Tipp! Geben Sie eine allgemeine E-Mail-Adresse ein, auf die mehrere Personen in Ihrem Unternehmen Zugriff haben. Für den Fall von Krankheit, Urlaub, Stellenwechsel.   Schritt 2 - D-U-N-S Nummer Wenn Sie die D-U-N-S Nummer bereits erhalten haben, gehen Sie direkt zu Schritt 3. Um ein Entwicklerkonto bei Apple zu erstellen, benötigen Sie eine D-U-N-S Nummer. Die D-U-N-S Nummer kann als internationale Organisationsnummer bezeichnet werden. Gehen Sie zu diesem Link, um eine Nummer zu prüfen/erstellen. Sie können auch diese Seite nutzen, um sich Ihre D-U-N-S Nummer zuschicken zu lassen.   Schritt 3 - Entwicklerkonto Klicken Sie auf den Link und folgen Sie den Anweisungen, um ein Konto zu erstellen. Stellen Sie sicher, dass Sie im weiteren Verlauf des Prozesses als Entitätstyp Unternehmen/Organisation angeben. Nachdem der Antrag eingereicht wurde, sendet Apple innerhalb weniger Tage weitere Anweisungen per E-Mail.   Schritt 4 - Prenly zum Entwicklerkonto einladen, nachdem Apple den in Schritt 3 gestellten Antrag genehmigt hat. ▪ Einloggen Unter "Programmressourcen" und "App Store Connect" wählen Sie "Benutzer und Zugang". Hier erscheint eine Tabellenansicht mit Benutzern. Klicken Sie im Menü auf das Pluszeichen, um einen neuen Benutzer hinzuzufügen. Fügen Sie das Entwicklerkonto von Prenly als "Admin" hinzu. Der Name kann beliebig gewählt werden, die E-Mail-Adresse muss jedoch ios-app-manager@textalkmedia.se lauten. Stellen Sie sicher, dass die Optionen unter Entwickler/Zusätzliche Ressourcen aktiviert sind. Speichern Sie, indem Sie auf "Einladen" klicken. Klicken Sie unter "Benutzer und Zugang" auf "Integration" und wählen Sie "Zugang beantragen". Lesen Sie den Antrag durch, markieren Sie das Bestätigungsfeld und klicken Sie auf "Senden".   Schritt 5 - Überprüfen der Händlerdaten Ab April 2024 müssen alle Konten ihre Händlerinformationen verifizieren, um Apps veröffentlichen zu können. Lesen Sie mehr und folgen Sie den Anweisungen hier.  

• LOGIN | OAuth2

  24 Oct 2025

  Prenly unterstützt OAuth2 mit oder ohne OpenID Connect-Erweiterung (OIDC), solange der Autorisierungsserver der OAuth2-Spezifikation RFC 6749 folgt. Sie werden wahrscheinlich einen Autorisierungsserver benötigen, der OIDC unterstützt. Prenly unterstützt nur die Autorisierungserlaubnis Authorization Code. Der Client, den Prenly im OAuth2-Fluss verwendet, ist die Anwendungsautorität des E-Papers (eine technische Implementierung, die entscheidet, wie Authentifizierung und Autorisierung durch die E-Paper-Anwendung innerhalb des Backends von Prenly gehandhabt werden). Prenly muss ein paar Dinge wissen, um als Client für den Autorisierungsfluss agieren zu können: - Optional*. Der gewählte Emittent. Dies ist obligatorisch, wenn Sie die OpenID Connect-Erweiterung ID-Token-Claim verwenden möchten. - Obligatorisch. Die Client-ID, die die Prenly-Autorität verwenden soll. - Obligatorisch. Das Client-Geheimnis, das die Prenly Autorität verwenden soll, wenn sie die bereitgestellte Autorisierungserlaubnis gegen ein Zugriffstoken austauscht, wenn sie die Prenly Autorität (den Client) authentifiziert. - Optional. Umfang. Sie können Prenly dazu veranlassen, eine durch Leerzeichen getrennte Liste von Bereichen zu verwenden, die die Berechtigung des ausgestellten Tokens definieren. Der/die Geltungsbereich(e) wird/werden mit dem Autorisierungsendpunkt verwendet. - Wahlweise. Zustand. Prenly unterstützt die Generierung von Status in der Autorisierungsanfrage. Sie können entweder Prenly einen Status generieren lassen oder die Autorität dazu bringen, ihn zu überspringen. - Obligatorisch. Endpunkt der Autorisierung. Die Prenly Autorität wird den User Agent zu diesem Endpunkt navigieren, um den Autorisierungsfluss mit dem Autorisierungsserver zu initiieren, indem der Benutzer angemeldet wird, um den Autorisierungscode zu erhalten. - Obligatorisch. Token-Endpunkt. Die Prenly-Behörde versucht, den Autorisierungscode des Benutzers gegen ein Zugriffstoken auszutauschen oder, falls Ihr Autorisierungsserver dies unterstützt (was dringend empfohlen wird), das Refresh-Token des Benutzers gegen ein neues Zugriffstoken auszutauschen. Authentifizierungsmethode. Standardmäßig verwendet Prenly die Client-Authentifizierungsmethode client_secret_basic des OIDC , wenn es sich am Token-Endpunkt des Autorisierungsservers authentifiziert. Prenly unterstützt auch die Client-Authentifizierungsmethode client_secret_post. Bitte benachrichtigen Sie Prenly, wenn Sie letztere benötigen, andernfalls wird die Standard-Authentifizierungsmethode verwendet. - Empfohlen. Eine externe URL zum Abmelden des Benutzers. Die Prenly-Behörde verwendet den vom aktuellen Benutzer ausgewählten Benutzer-Agenten, um den Benutzer per Fernzugriff beim Autorisierungsserver abzumelden. Prenly kann bei der Erstellung der Autorisierungsanfrage Platzhalter in der URL verwenden, um den Benutzer abzumelden, indem es die folgenden Angaben macht:   ◦ Die Client-ID; ◦ Die Logout-Rückgabe-URI; ◦ Die Abmeldefehler-URI;   Bitte beachten Sie, dass der Status nicht verwendet werden kann. Ein Beispiel für einen Rückgabe-URI-Abfrageparameter ist "post_logout_redirect_uri". Derzeit wird nur die HTTP-Methode GET für die Abmelde-URI unterstützt. Benutzer-ID Die Prenly-Behörde muss wissen, wie sie die eindeutige Benutzer-ID extrahieren kann, nachdem der Benutzer vom Autorisierungsserver erfolgreich autorisiert wurde. Diese eindeutige Benutzer-ID ist, wenn Sie die API der Prenly Remote-Behörde verwenden, der Anfrageparameter "uid", wenn Sie die Benutzerzusammenfassung anfordern. Sie können eine der folgenden Methoden wählen: - Aus einer Eigenschaft in der JSON-Token-Endpunktantwort. Wenn Sie dies wählen, müssen Sie uns den Namen der Eigenschaft mitteilen, die die Benutzer-ID enthält. - Aus dem OpenID Connect "sub"-Claim im signierten ID-Token (wie von der Token-Antworteigenschaft "id_token" zurückgegeben). Um die Benutzer-ID extrahieren zu können, müssen Sie auch Folgendes angeben:   ◦ Erforderlich. Die externe URL zu öffentlichen Schlüsseln zur Validierung der ID-Token. Diese URL muss ein JSON Web Key Set gemäß JWT-Standards (siehe RFC 7515) enthalten, das entweder als JKU oder JWKS bezeichnet werden kann. ◦ Optional. Der Eigenschaftsname in der Nutzdatenantwort, der eine Kundennummer enthält. ◦ Erforderlich. Muss nur den Aussteller kennen, der bei der Verifizierung des ID-Tokens mit der Angabe "iss" im ID-Token übereinstimmen muss. Für weitere Einzelheiten siehe ID-Token. - Aus der Antwort der Eigenschaft "sub" von einem UserInfo-Endpunkt. Um diese Methode zu verwenden, müssen Sie auch bereitstellen:   ◦ Erforderlich. Die URL des UserInfo-Endpunkts. Der Endpunkt wird verwendet, um grundlegende Informationen über den Benutzer abzurufen, indem das Zugriffstoken des Benutzers verwendet wird, um die Anfrage zu autorisieren. ◦ Optional. Der Eigenschaftsname in der Benutzerdatenantwort, der eine Kundennummer enthält. Ressourcenserver Sie können einen Ressourcenserver wählen, den Prenly unterstützt, oder Sie können uns unter hello@prenly.com kontaktieren, um Prenly zu bitten, Ihren spezifischen Ressourcenserver als Integrationsaufgabe zu unterstützen, die Prenly auf der Grundlage einer bezahlten Entwicklungsaufgabe unterstützen könnte. Prenly unterstützt standardmäßig die Prenly Remote Authority API ab Version 1.4 oder höher als Ressourcenserver. Siehe unsere allgemeinen Informationen über Prenly Remote authority API für das Konzept dieser API. Um Prenly Remote authority API als Ressourcenserver zu implementieren, lesen Sie bitte die API-Spezifikation für den Endpunkt /oauth2/getUser. Die "Ressource", die Prenly vom Ressourcenserver anfordert, ist eine Liste von Abonnementprodukten, die mit dem Benutzer verbunden sind. Die Produkte in Form eines Produktcodes geben den Abonnementstatus des Benutzers an, wobei jeder Code so konfiguriert ist, dass er Lesezugriff auf Publikationen innerhalb Ihrer E-Paper-Anwendung gewährt. Um je nach Abonnementprodukt den richtigen Lesezugriff zu gewähren, müssen Sie Prenly auch mitteilen, zu welchen Publikationen der Produktcode den Lesezugriff erlaubt. Jedes unbekannte Produkt wird ignoriert. Sie brauchen vielleicht keinen dedizierten Ressourcenserver... Prenly kann einen traditionellen Ressourcenserver ganz umgehen, wenn Ihr UserInfo-Endpunkt in der Lage ist, den Abonnementstatus des Ressourceneigentümers - des Benutzers - offenzulegen. Wenn Ihr UserInfo-Endpunkt dazu in der Lage ist, müssen Sie nur den Claim (Eigenschaftsname) in den JSON-Daten der UserInfo-Endpunktantwort bereitstellen. Der Anspruchswert muss eine JSON-Liste (Array) von Strings sein. Jedes Listenelement steht für einen Abonnement-Produktcode. Informationen bereitstellen Wenn Sie alle erforderlichen Informationen haben, wenden Sie sich bitte an den Prenly-Kundendienst unter hello@prenly.com und teilen Sie die Informationen mit. Das Team wird dann die Prenly-Autorität der gewählten E-Paper-Anwendung für die Verwendung von OAuth2 für Sie einrichten.

• Remote API

  24 Oct 2025

  Der Zweck dieses Dokuments ist es zu erklären: 1. ...wie das Prenly-Ökosystem die Benutzerauthentifizierung und -autorisierung durch eine technische Infrastruktur ermöglicht, die dem Herausgeber oder einer dritten Partei gehört. 2. ...wie eine technische Implementierung durch den Aufbau einer bescheidenen Rest-API erfolgen kann, die der "Prenly Remote authority API" Spezifikation folgt. Kontakt Bitte kontaktieren Sie uns per E-Mail unter hello@prenly.com oder per Telefon unter +46-31-3884740 bei Fragen oder Problemen bezüglich dieser API. Definitionen Authentifizierung ist der Prozess, bei dem die Identität einer Person oder einer Sache überprüft wird, d. h. ob sie diejenige ist, die sie vorgibt zu sein, bevor der Zugriff auf geschützte Daten gewährt wird. Normalerweise erfolgt dies durch die Angabe von Anmeldedaten wie Benutzername und Passwort. Wenn die Anmeldedaten mit einem gespeicherten Datensatz übereinstimmen, wird der Benutzer "verifiziert" (authentifiziert), indem der Grundsatz angewendet wird, dass der Benutzer etwas weiß, was nur der "echte" Benutzer wissen kann. Autorisierung ist der Prozess, bei dem entschieden wird, auf welche Ressourcen ein Benutzer Zugriff hat, d.h. auf welche Daten der Benutzer zugreifen darf und auf welche nicht. Für Prenly bedeutet dies, dass festgelegt wird, welche Veröffentlichungen der Benutzer sehen und zum Lesen öffnen kann. Eine API(Application Program Interface) ist eine Reihe von Routinen, Protokollen und Werkzeugen, die die Interaktion zwischen verschiedenen Systemen oder Teilen von Systemen regeln und die Kommunikation von System zu System vorgeben. In Prenly ist eine Autorität eine technische Implementierung, die entscheidet, wie Authentifizierung und Autorisierung durch eine Prenly-Anwendung innerhalb des Prenly-Backends gehandhabt werden. Einführung Die Prenly Remote Authority API bietet die Möglichkeit, Prenlys Autorisierungs- und/oder Authentifizierungshandling zu ersetzen, indem API-Endpunkte implementiert werden, die einer API-Spezifikation folgen, die es einem Prenly-Kunden ermöglicht, sich nach seinem System, seinen Anforderungen und Bedürfnissen zu authentifizieren und zu autorisieren. Im Kern ermöglicht dies der Behörde der Prenly-Anwendung, Benutzer zu autorisieren und/oder zu authentifizieren, wenn sie mit der Prenly-Anwendung interagieren, d.h. wenn sie Publikationen innerhalb einer App lesen, und zwar über die API der Prenly-Fernbehörde. Die Prenly Behörde vermittelt Authentifizierungs- und Autorisierungsanfragen zwischen Nutzern und Prenly, wobei keine direkte Kommunikation zwischen Nutzern und API-Implementierung erlaubt ist. Stattdessen teilt die API-Implementierung der Prenly-Behörde mit, wie sie auf die Authentifizierungs- und Autorisierungsanfragen der Benutzer reagieren soll. Implementieren Sie Ihre API Verstehen, wie der Benutzer die Prenly-Anwendung nutzt Prenly-Anwendungen Prenly stellt dem Endnutzer Anwendungen zur Verfügung, die hauptsächlich zum Lesen von Publikationen und Artikeln verwendet werden. Bei der Anwendung handelt es sich entweder um eine native mobile App auf der Android- oder iOS-Plattform oder um unseren responsiven webbasierten E-Reader. Diese beiden Anwendungstypen bieten ein ähnliches Benutzererlebnis. Die Anwendung kann sowohl veröffentlichte Publikationen enthalten, die für jedermann zugänglich sind, als auch geschützte Inhalte, für deren Nutzung eine bestimmte Art von Genehmigung erforderlich ist. Bei nativen Anwendungen ist es auch möglich, dass jeder nicht angemeldete Benutzer einige Publikationen kostenlos konsumieren kann, bevor eine Anmeldung erforderlich ist. Navigation in der Anwendung Bei der Nutzung der Anwendung sieht der Benutzer normalerweise die Startseite mit den Komponenten, die die veröffentlichten Publikationen anzeigen. Öffentliche Publikationen können durch Auswahl der Publikation geöffnet und gelesen werden. Wenn der Benutzer jedoch versucht, eine geschützte Publikation zu öffnen, fordert die Anwendung den Benutzer auf, sich anzumelden(Authentifizierung). Nach dem Einloggen entscheidet Prenly, ob die angeforderte Publikation für den Benutzer lesbar ist(Autorisierung). Wenn ja, wird die Publikation geöffnet und kann konsumiert werden. Wenn der Nutzer keine Leseberechtigung hat, wird er in der App benachrichtigt. Der geschützte Inhalt wird nicht angezeigt, aber der Benutzer ist weiterhin angemeldet. In manchen Fällen erfordert eine Anwendung, dass der Benutzer sich anmeldet, um bestimmte Veröffentlichungen anzuzeigen, insbesondere wenn nicht alle veröffentlichten Veröffentlichungen von jedermann eingesehen werden können. Dies gilt insbesondere dann, wenn nicht alle veröffentlichten Publikationen für jedermann sichtbar sind, z. B. bei Publikationen, die über ein Abonnement zugänglich sind und bei denen andere, nicht abonnierte Veröffentlichungen ausgeblendet werden sollen. Einrichten einer API-Umgebung Vertrauen in Prenly-Anfragen Prenly sendet einen vordefinierten geheimen Schlüssel in allen Authentifizierungs- und Autorisierungsanfragen. Der Schlüssel ist nur Prenly und Ihrem System bekannt. Sie sollten überprüfen, ob der bereitgestellte Schlüssel mit dem erwarteten Schlüssel für alle API-Anfragen übereinstimmt. Sie können Ihre API-Endpunkte auch nur für bestimmte IP-Adressen öffnen, um zusätzliche Sicherheit zu gewährleisten. Bitte kontaktieren Sie uns, um eine aktuelle Liste der IPs zu erhalten, die Prenly bei Anfragen verwendet, wenn Sie diese zusätzliche Sicherheit wünschen. Verschlüsseln Sie den Datenverkehr Wir empfehlen dringend, jeglichen unverschlüsselten HTTP-Verkehr zu Ihrer API zu verbieten. Verwenden Sie HTTPS! Erlauben Sie ein REST-ähnliches Verhalten Vorläufige Anfragen werden derzeit mit HTTP POST gestellt, aber die API sollte nicht auf die Verwendung beliebiger HTTP-Methoden für zukünftige Endpunkt-Erweiterungen beschränkt sein. Weitere Einzelheiten finden Sie in der aktuellen API-Spezifikation, da diese das letzte Wort hat, wenn es zu Unstimmigkeiten mit dieser Dokumentation kommt. In API-Antworten werden HTTP-Statuscodes verwendet, um Prenly über das Ergebnis zu informieren. Sie müssen in der Lage sein, mit verschiedenen HTTP-Statuscodes zu antworten, sowohl für erfolgreiche Anfragen als auch für Datenfehler, Laufzeitfehler und unerwartete Serverfehler. Anfrageparameter werden derzeit als JSON im Anfragekörper übergeben. Alle Endpunkte antworten derzeit mit JSON im Response-Body. Machen Sie sich mit OpenAPI 3.0 vertraut Die API-Spezifikation ist in einer yaml-Datei gemäß dem OpenAPI 3.0-Standard (ehemals Swagger) dokumentiert, in der die technischen Aspekte und Anforderungen der API und jedes Endpunkts, einschließlich aller Anfrage- und Antwortdatenobjekte, angegeben sind. Die automatisch generierte Dokumentation finden Sie unter https://apidoc.prenly.com/remote-api/ und die Spezifikationsdatei unter https://apidoc.prenly.com/remote-api/spec/v1.3-specification.yaml. Es steht Ihnen frei, eine Kopie der Spezifikationsdatei zu erstellen und sie an Ihre API-Endpunkte (URLs) anzupassen, da die automatisch generierte Spezifikation allgemeine benannte Endpunkte als Referenz enthält. Mit dieser Datei können Sie leicht eine Testumgebung mit vorgefertigten Tools aufbauen, die unter https://openapi.tools/ zur Verfügung stehen (siehe Abschnitt "Testen"). Lesen Sie mehr über OpenAPI, einschließlich der Spezifikation, unter https://www.openapis.org/. Erstellen Sie den Authentifizierungsendpunkt Siehe die API-Spezifikation unter https://apidoc.prenly.com/remote-api/ für den/die Authentifizierungsendpunkt(e). Sie können die Endpunkt-URL genau so wählen, wie Sie möchten; der Endpunkt muss jedoch der API-Spezifikation entsprechen. Anforderungsparameter Die Anforderungsparameter sind Teil des Anforderungskörpers als JSON und werden von Prenly für jede Anforderung gesendet. Antwort bei Erfolg Eine erfolgreiche Anmeldung muss mit dem HTTP-Statuscode 200 und einer JSON-Antwort mit der eindeutigen Kennung des Benutzers, der authentifiziert wurde, beantwortet werden. Antwort im Fehlerfall Bekannte Fehler, die von den gegebenen Anfrageparametern abhängen, müssen mit einem der HTTP-Statuscodes 401, 403 oder 412 antworten, wie in der API-Dokumentation angegeben. Diese Fehler müssen eine JSON-Antwort enthalten, die dem Datenmodell Error folgt, das Sie am Ende von https://apidoc.prenly.com/remote-api/ finden . Sie können wählen, ob Sie einen Fehler oder ein leeres JSON-Objekt bereitstellen möchten. Derzeit ist nur die Eigenschaft "message" erforderlich, wenn Sie einen Fehler übermitteln. Es wird jedoch empfohlen, auch eine "Code"-Eigenschaft anzugeben. Es wird dringend empfohlen, einen Wert für die Eigenschaft "message" in englischer Sprache anzugeben, der den Fehler auf irgendeine Weise darstellt. Wenn Ihre Software über interne Codes verfügt, ist es sinnvoll, diese hier zu verwenden, wenn später eine gegenseitige Fehlersuche erforderlich ist. Geben Sie keine persönlichen Daten an, die nicht benötigt werden, wie z. B. persönliche Namen! Eindeutige IDs sind für die Fehlersuche ausreichend. Diese Informationen werden dem Endbenutzer nie angezeigt, können aber in Prenly protokolliert werden, um die Fehlersuche zu vereinfachen. Erstellen Sie den Autorisierungsendpunkt Siehe die API-Spezifikation unter https://apidoc.prenly.com/remote-api/ für den/die Autorisierungsendpunkt(e). Sie können die Endpunkt-URL genau so wählen, wie Sie es wünschen; der Endpunkt muss jedoch der API-Spezifikation entsprechen. Anforderungsparameter Anforderungsparameter sind Teil des Anforderungskörpers als JSON und werden von Prenly für jede Anforderung gesendet. Antwort bei Erfolg Ein erfolgreicher Abruf der Benutzerinformationen muss mit dem HTTP-Statuscode 200 und einer JSON-Antwort entsprechend dem UserSummary-Datenmodell, wie in der Spezifikation beschrieben, beantwortet werden. Die Felder in diesem Datenobjekt werden am Ende von https://apidoc.prenly.com/remote-api/ erläutert . Welche Eigenschaften werden verwendet, um Die einzige Eigenschaft, die derzeit nicht leer gelassen werden kann, ist "uid". Die anderen Eigenschaften können weggelassen werden, es wird jedoch empfohlen, eine "productCodes"-Eigenschaft anzugeben, um besser kontrollieren zu können, ob Prenly Leserechte für Publikationen gewähren soll oder nicht. Derzeit behandelt Prenly eine fehlende "productCodes"-Eigenschaft als leere Liste. Antwort bei Fehlern Bekannte Fehler, die von den gegebenen Anfrageparametern abhängen, müssen mit einem der HTTP-Statuscodes 403, 404 oder 412 antworten, wie in der API-Dokumentation angegeben. Diese Fehler müssen eine JSON-Antwort enthalten, die dem oben beschriebenen Fehlerdatenmodell entspricht. Testen Es ist wichtig, dass Sie Ihre Implementierung für die Authentifizierungs- und Autorisierungsendpunkte testen. Unter https://docs.google.com/document/d/1UxmvDs7_Z0GwGbwCHXr4Ojpb9HaZif1nJ8YRMmztzeo/ finden Sie weitere Informationen zum Testen Ihrer Endpunkte. Was passiert in Prenly? Wenn sich der Benutzer anmeldet (Authentifizierung + Autorisierung) Wenn der Benutzer die Anmeldung anfordert und das Anmeldeformular abschickt, werden die Anmeldedaten an die Prenly Autorität gesendet (verschlüsselt mit SSL). Von dort aus kümmert sich die Behörde um die Verwendung dieser Anmeldeinformationen zur Authentifizierung des Benutzers. Für die API der entfernten Behörde bedeutet dies, dass die Anmeldeinformationen gemäß der Spezifikation an den entfernten Endpunkt gesendet werden. Prenly verarbeitet die API-Antwort und behandelt sowohl erfolgreiche als auch fehlgeschlagene Authentifizierungsanfragen, bei denen der Benutzer je nach dem HTTP-Statuscode der Fehlermeldung einen Fehler sieht. Siehe unten für weitere Details. Wenn die Authentifizierung erfolgreich war... Eine erfolgreiche Anmeldung löst eine separate Autorisierungsanfrage an den Remote-API-Endpunkt für die Autorisierung aus, um die Informationen des Benutzers abzurufen, die in Prenly für eine begrenzte Zeit zwischengespeichert werden. Die Anwendung zeigt auch an, dass jemand eingeloggt ist, mit Namen oder E-Mail, je nachdem, welche Benutzerdaten in den Benutzerinformationen zurückgegeben wurden. Hinweis: Wenn die unmittelbare Autorisierungsanfrage direkt nach der erfolgreichen Authentifizierungsanfrage mit HTTP 401 antwortet, wertet Prenly dies als Implementierungsfehler, meldet den Benutzer ab und informiert ihn darüber, dass die Anmeldedaten falsch waren. Um dies zu vermeiden, wird empfohlen, das im UserIdentification-Schema vorgesehene Token-Konzept zu verwenden, falls Sie die Möglichkeit zur Fernabmeldung des Benutzers unterstützen möchten. Wenn die Anmeldedaten falsch waren... Wenn die Anfrage technisch erfolgreich war, aber die Anmeldedaten falsch waren, benachrichtigt die Prenly-Behörde die Anwendung und der Benutzer erhält eine Meldung über die falschen Anmeldedaten. Wenn etwas fehlgeschlagen ist... Andere client- oder serverbasierte Fehler oder Netzwerkfehler werden von Prenly abgefangen und protokolliert. Die Anwendung wird mit einer geeigneten Fehlermeldung bedient, die dem Benutzer präsentiert wird. Wenn der Benutzer weiterliest Caching für wiederholte Anfragen Durch das Zwischenspeichern der Antwortdaten auf eine erfolgreiche Autorisierung (die Informationen des Benutzers) werden wiederholte Anfragen an die Remote-API zum Abrufen von Benutzerdaten, die nur selten geändert werden, überflüssig. Jeder Prenly-Kunde kann die Cache-Ablaufzeit wählen, wir empfehlen die Einstellung von 30 Minuten, wobei die minimal zulässige Cache-Ablaufzeit 20 Minuten beträgt. Neu-Autorisierung Prenly verwendet das im Cache gespeicherte Ergebnis für jede Autorisierungsanfrage, solange der Cache noch nicht abgelaufen ist. Wenn der Cache abgelaufen ist, löst Prenly eine neue Autorisierungsanfrage an den Autorisierungsendpunkt in der Remote-API aus. Dadurch werden die Daten des Benutzers, z. B. die Produktverfügbarkeit, sowie die im Cache gespeicherten Daten aktualisiert. Behandlung von Fehlern Tritt beim Auslösen der erneuten Autorisierung ein Serverfehler (5xx HTTP-Code) auf, wird die Cache-Ablaufzeit um fünf Minuten verlängert. Prenly tut dies, um zu vermeiden, dass Benutzer wegen vorübergehender Netzwerk- oder Serverfehler abgemeldet werden; der Benutzer liest weiter, als ob nichts passiert wäre, und nach fünf Minuten wird ein neuer Versuch zur erneuten Autorisierung unternommen. Dieses Verhalten bleibt so lange bestehen, wie das Serverproblem anhält. Prenly wird solche technischen Probleme protokollieren und versuchen, den Kunden zu erreichen, wenn dies geschieht. In Betrieb gehen Wenn Sie der Meinung sind, dass die API bereit ist, live zu gehen (Sie haben Ihre Implementierung fertig entwickelt und getestet), kontaktieren Sie uns, um die letzten Schritte einzuleiten. Prenly wird Informationen von Ihnen benötigen, um Ihre Implementierung in Prenly einzurichten. Die Informationen werden ausgewertet und wenn alles in Ordnung ist, kann Ihre Implementierung in Prenly für die von Ihnen gewählten E-Paper Prenly-Anwendungen verwendet werden. Einrichten von Prenly Bevor Ihre Implementierung der Remote-API in Prenly verwendet werden kann, müssen Sie diese bereitstellen: - den von Ihnen gewählten geheimen Schlüssel für die Authentifizierungs- und Autorisierungsendpunkte - Die von Ihnen gewählten API-Endpunkte - Eine Liste von Produkten, die Leseberechtigungen gewähren sollen und für die Prenly einen Titel hat (nur Prenly-bekannte Produkte innerhalb der Produktcode-Liste des Autorisierungs-Endpunkts können Leseberechtigungen gewähren) - Ihre gewünschte Cache-Ablaufzeit - Eine URL, unter der ein neuer Benutzer ein Konto erstellen kann - Eine URL, unter der ein Benutzer sein Konto löschen kann - Eine URL, unter der ein Benutzer sein Passwort zurücksetzen kann (falls er sein Passwort vergessen hat) - Wir empfehlen, dass Sie auch eine URL angeben, unter der ein autorisierter Benutzer ohne im Voraus bekannte Produktcodes ein Produkt aktivieren kann (d. h. ein Abonnement erwerben kann) - Benutzerdaten (Benutzername und Kennwort) für den Testbenutzer, wobei der Benutzer von Textalk, Apple und Google (wenn Sie native Anwendungen haben) gemeinsam genutzt wird und mindestens ein Produktcode aktiv bleiben muss, solange die Remote-API von der Prenly-Behörde Ihres E-Papers verwendet wird