Entscheidungen decisions

Entscheidungen werden durch die Adobe Pass-Authentifizierung REST API V2 auf der Grundlage der MVPD-Autorisierungs- oder Vorabautorisierungsanfragen des Benutzers generiert, die bestimmen, ob der Zugriff auf geschützte Inhalte gewährt oder verweigert wird.

Je nach aufgerufener API werden zwei Arten von Entscheidungen bereitgestellt:

Entscheidungen vor der Zulassung preauthorization-decisions

Die Entscheidung vor der Autorisierung ist eine informative Entscheidung, mit der die Client-Anwendung darüber informiert werden kann, ob die MVPD den Zugriff des Benutzers auf eine Ressource zulassen oder.

Der Zweck der Vorabautorisierung (PreFlight-Autorisierung) besteht darin, der Anwendung die Anzeige genauer Informationen über den Inhalt zu ermöglichen, den der Benutzer anzeigen darf. Dies wird durch die Erweiterung der Benutzeroberfläche mit Indikatoren wie gesperrten oder entsperrten Symbolen erreicht, die den Zugriffsstatus widerspiegeln.

Die Verwendung der Vorabautorisierungs-API ist nicht obligatorisch. Die Client-Anwendung kann dies überspringen, wenn sie einen Katalog von Ressourcen ohne Filterung präsentieren möchte.

Wenn die Client-Anwendung diese Funktion verwenden möchte, ist es wichtig zu beachten, dass Entscheidungen vor der Autorisierung nur für eine begrenzte Anzahl von Ressourcen pro API-Anfrage, in der Regel bis zu 5, abgerufen werden können.

MVPDs können die Vorautorisierung durch verschiedene Mechanismen unterstützen, die jeweils unterschiedliche Auswirkungen auf die Leistung und die maximale Anzahl von Ressourcen haben, die in einer einzelnen API-Anfrage verarbeitet werden können.

Weitere Informationen zu den bestehenden Mechanismen zur Unterstützung der Vorautorisierung finden Sie in der Dokumentation MVPD Preflight-.

Autorisierungsentscheidungen authorization-decisions

Die Autorisierungsentscheidung ist eine autorisierende Entscheidung, die es der Client-Anwendung ermöglicht, mit der MVPD-Entscheidung konform zu sein, den Zugriff des Benutzers auf eine geschützte Ressource“ zuzulassen oder.

Die Autorisierung dient dazu, der Anwendung zu ermöglichen, die vom Benutzer angeforderten Ressourcen abzuspielen, nachdem die Rechte mit der MVPD validiert und ein Medien-Token von der Adobe Pass-Authentifizierung empfangen wurden.

Die Verwendung der Autorisierungs-API ist obligatorisch. Die Client-Anwendung kann diese Phase nicht überspringen, wenn sie die von der Benutzerin oder dem Benutzer angeforderten Ressourcen wiedergeben möchte, da sie bzw. er bei der MVPD überprüfen muss, ob die Benutzerin oder der Benutzer berechtigt ist, bevor der Stream freigegeben wird.

Beachten Sie, dass Autorisierungsentscheidungen nur für eine begrenzte Anzahl von Ressourcen pro API-Anfrage, normalerweise 1, abgerufen werden können.

Autorisierungs-TTL-Verwaltung (Time-to-Live) authorization-ttl-management

Die Gültigkeitsdauer (Time-to-Live, TTL) für die Autorisierung definiert, wie lange eine Ressource autorisiert bleibt, bevor eine erneute Autorisierung erforderlich wird. Dieser Zeitraum ist begrenzt und muss mit MVPD-Vertretern vereinbart werden. TTL-Werte können je nach folgenden Kriterien variieren:

Die Autorisierungs-(Autorisierungs-)TTL kann über das Adobe Pass TVE-Dashboard von einem Ihrer Organisationsadministratoren oder von einem in Ihrem Namen handelnden Adobe Pass-Authentifizierungsbeauftragten angezeigt und geändert werden.

Weitere Informationen finden Sie in der Dokumentation TVE Dashboard Integrations-Benutzerhandbuch.

Geschützte Ressourcen protected-resources

Geschützte Ressourcen beziehen sich auf streambare Inhalte, die durch eindeutige Werte identifiziert werden, die durch Vereinbarungen zwischen MVPDs und teilnehmenden Programmierern definiert werden.

Geschützte Ressourcen folgen einer hierarchischen Baumstruktur, wobei jede Ebene eine höhere Granularität für die Inhaltsautorisierung bietet:

Ressourcenkennung resource-identifier

Die eindeutige Kennung der Ressource kann zwei Formate aufweisen:

Bei einer einfachen Ressourcenkennung, wie z. B. „REF30“ (angenommen, dass sie einen Kanal darstellt), kann sie wie folgt in eine RSS-Ressourcenkennung übersetzt werden:

    <rss version="2.0">
        <channel>
            <title>REF30</title>
        </channel>
    </rss>

Bei einer komplexeren Ressourcenkennung kann die RSS-Ressourcenkennung zusätzliche Bewertungsinformationen wie folgt enthalten:

    <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
        <channel>
            <title>REF30</title>
            <media:rating scheme="urn:mpaa">pg</media:rating>
        </channel>
    </rss>

Die eindeutigen Kennungen sind für die Adobe Pass-Authentifizierung in erster Linie undurchsichtig. Transformatoren können jedoch je nach den Funktionen und Anforderungen der MVPD angewendet werden. Wenn MVPD eine Ressourcenkennung nicht erkennen oder analysieren kann, wird ein Fehler an die Adobe Pass-Authentifizierung zurückgegeben, die den Fehler anschließend mithilfe eines erweiterten Fehlercodes) anClient-Anwendung weiterleitet.

REST-API V2 rest-api-v2

Die Entscheidungen vor der Autorisierung können mit der folgenden API abgerufen werden:

Die Autorisierungsentscheidungen können mithilfe der folgenden API abgerufen werden:

Weitere Informationen zur Struktur von Entscheidungen vor und finden in den Abschnitten Antwort“ und „Beispiele der obigen APIs.

Weitere Informationen zur Integration der oben genannten APIs finden Sie in den folgenden Dokumenten: