Zum Abspielen fordert Ihre Anwendung zunächst eine kurzlebige Challenge (notch) an. Aus deren Inhalt und dem Anwendungssecret berechnet sie eine Passphrase und fordert damit den Medienlink an. Erforderliche Freigaben: notch und link.
Alle folgenden Kennungen und Antworten sind Platzhalter. Verwenden Sie ein für Ihren Testkontext lizenziertes Medium. Das Secret bleibt auf Ihrem Backend und gehört weder in Browsercode noch in URLs oder Protokolle.
1. Challenge anfordern
<notch type="link" identifier="anbieter-12345" role="L"/>
type="link" und role="L" sind die Standardwerte. Andere Rollen nur nach Vereinbarung verwenden. Vor Ausgabe der Challenge prüft der Server die Lizenz für Medium, Kontext und Rolle.
Schematische Antwort:
<notch id="NOTCH_ID">NONCE</notch>
Speichern Sie die beiden Werte getrennt:
NOTCH_IDist das Attributidund identifiziert die Challenge.NONCEist der Textinhalt und geht in die Hashberechnung ein.
Bei fehlender Berechtigung oder unbekanntem Medium kann stattdessen diese Antwort kommen:
<error>No valid licence or no record for anbieter-12345!</error>
2. Passphrase berechnen
Passphrase = lowercase_hex(MD5(NONCE + ":" + SECRET))
PHP-Beispiel für bereits sicher geladene Werte:
$passphrase = md5($nonce . ':' . $secret);
Der Doppelpunkt gehört zur Eingabe. Weder die Notch-ID noch der Identifier ersetzen die Nonce. Das Secret nicht vorab noch einmal hashen. Keine Zeilenumbrüche anhängen.
MD5 ist hier Bestandteil des bestehenden Protokolls, keine Empfehlung für Passwortspeicherung. HTTPS und ein vertrauliches, eigenes Secret bleiben erforderlich.
3. Link anfordern
<link id="NOTCH_ID" passphrase="HASH"/>
Alternativ kann die Passphrase im Textinhalt stehen:
<link id="NOTCH_ID">HASH</link>
Verwenden Sie dieselbe Zugangskonfiguration, denselben Kontext und dieselbe Rolle über den gesamten Ablauf. Fordern Sie die Challenge unmittelbar vor dem Link an. Der reguläre Prüfer weist Challenges zurück, die älter als 120 Sekunden sind. Diese Frist ist nicht die Laufzeit des späteren Medienlinks. Verwenden Sie pro Operation eine frische Challenge; eine Einmalverwendung erzwingt der gezeigte Ablauf nicht als zugesicherte Eigenschaft.
4. Antwort auswerten
<link size="17 MB">
<a href="https://media.example.org/play/BEISPIEL">direct</a>
<a href="https://media.example.org/download/BEISPIEL">download</a>
</link>
Das Beispiel zeigt die Struktur; die URLs sind nicht nutzbar. Der Text des a-Elements bezeichnet den Linktyp, href enthält die Adresse. Nach Linktyp suchen, nicht nach Reihenfolge.
direct führt zum Abspielen beziehungsweise zur jeweiligen Medienanwendung. download und size sind optional. Für die Rolle S erzeugt der reguläre Linkhandler keinen Downloadlink. Auch Medientyp und Konfiguration beeinflussen Downloads. size kann ein formatierter Größenstring sein und ist nicht verlässlich eine Byteanzahl.
Die alte Liste mit addons, buy und spool ist keine Garantie des aktuellen Standardhandlers. Unbekannte Typen tolerieren, aber nur unterstützte Typen anzeigen. Den Inhalt von href als opake Adresse behandeln; Pfad und Tokenformat nicht selbst zerlegen oder nachbauen.
Medienlinks als Zugangsdaten behandeln und nur an berechtigte Nutzer weiterreichen. Keine dauerhaften Kataloglinks daraus machen. Laufzeit und mögliche Bindungen des Links sind vom Playout abhängig; bei Ablauf einen neuen notch/link-Ablauf starten.
Benutzerlogin als gesonderte Variante
Einige Integrationen verwenden statt eines festen Anwendungssecrets einen temporären Benutzerzugang:
<login user_id="BENUTZER_ID" password="VEREINBARTER_PASSWORTWERT"/>
Der Login muss separat freigeschaltet sein. Die konkrete Benutzerprüfung wird installationsabhängig eingebunden. Die alte Angabe „immer MD5-kodiertes Benutzerpasswort“ ist deshalb ohne Prüfung des Zugangs nicht verbindlich.
Eine mögliche erfolgreiche Antwort lautet:
<login allow="yes" tmpuser="TEMP_ID">TEMP_SECRET</login>
Dann berechnen Sie die Passphrase mit TEMP_SECRET anstelle des Anwendungssecrets und übergeben tmpuser beim Linkaufruf:
<link id="NOTCH_ID" tmpuser="TEMP_ID" passphrase="HASH"/>
Temporärer Zugang und Linkabruf müssen denselben Kontext und dieselbe vom Server erkannte Quell-IP verwenden. Die Gültigkeitsdauer des temporären Zugangs stimmen Sie mit uns ab; setzen Sie keine pauschale Laufzeit von 30 Minuten voraus.
Weitere Loginantworten sind <login allow="no"/> und eine erfolgreiche Antwort mit id statt tmpuser. Letztere enthält kein temporäres Secret für den oben beschriebenen Ablauf. Ein Client darf daher nicht allein anhand von allow="yes" einen tmpuser-Ablauf beginnen.
Zur Übersicht: Einstieg in die ARIX-Schnittstelle