Django geschütztes Video

Die drei Orte, die Sie anpassen#

1. Konfigurierensettings.py

   Fügen Sie drmx hinzu und konfigurieren Sie DRMX, einschließlich AUTHORIZE.

2. Autorisieren

   Ihre Anwendung: drmx_access.py

   Implementieren Sie authorize(user, video_id) auf Grundlage Ihres vorhandenen Systems.

3. Routeurls.py

   Fügen Sie drmx.urls hinzu; Verwenden Sie Ihre normale Anmeldung und CSRF Middleware wieder.

1. Das wheel-Paket installieren#

# From the extracted kit root:
python -m pip install packages/python/drmx_django-1.3.0rc13-py3-none-any.whl

Verwenden Sie Python 3.12+ und eine unterstützte Django-Version (5.2–6.0). Füge drmx zu INSTALLED_APPS hinzu. Authentifizierung, Sitzungen und CsrfViewMiddleware beibehalten. Für eine neue Installation ist kein DRM-X-Migrationsbefehl erforderlich; Ihre eigene App benötigt möglicherweise noch ihre normalen Migrationen.

2. Einstellungen und Routen konfigurieren#

# settings.py — keep your existing application settings
DRMX = {
    'SITE_ID': os.environ['DRMX_SITE_ID'],
    'SITE_KEY': os.environ['DRMX_SITE_KEY'],
    'ACCESS_KEY': os.environ['DRMX_ACCESS_KEY'],
    'INSTANCE_ID': 'my-website',
    'POLICY': 'multi-tier-standard',
    'AUTHORIZE': 'myapp.drmx_access.authorize',
}
# urls.py — add to your existing urlpatterns
path('video/', include('drmx.urls'))

Importieren Sie os in Einstellungen und path/include in URLs wie gewohnt. Ersetzen Sie myapp durch Ihr Anwendungsmodul.

3. Rückgabe des autorisierten Inhalts#

Erstellen Sie myapp/drmx_access.py. Der Repository-Aufruf unten ist illustrativ; Verwenden Sie Ihre aktuelle Kauf-, Mitgliedschafts- oder Registrierungsabfrage.

def authorize(user, video_id):
    video = customer_catalog.find_authorized_video(user.id, video_id)
    if video is None:
        return None
    return {'content_id': video.drmx_content_id,
            'content_type': 'vod', 'title': video.title}

Erlauben Sie für den ersten lokalen Test genau einen vorhandenen Testbenutzer und eine Video-ID Ihrer Website und geben Sie Ihre veröffentlichte Content ID zurück. Beschränken Sie diese vorübergehende Regel auf den lokalen Test. Die mitgelieferte Datei examples/sdk/django/authorization.py verweigert jeden Zugriff, bis Sie die Prüfung implementieren.

Fragen Sie in der Produktion bei jedem Aufruf die Datenbank ab. Geben Sie None zurück, wenn die Berechtigung fehlt, abgelaufen ist oder widerrufen wurde. Ohne angegebene Richtlinie wird die konfigurierte Standardrichtlinie verwendet.

4. Anmelden und den Player öffnen#

Öffnen Sie /video/lesson-123/ mit Ihrem eigenen ausgewählten Website-Video ID. String IDs und UUIDs funktionieren. Der SDK liefert die Player-Seite und den Session-Endpunkt und überprüft den Callback für jede Anforderung erneut.

Halten Sie den normalen Django-Schutz#

Behalten Sie die mitgelieferte CSRF-Validierung und den Endpunkt mit demselben Ursprung bei. Der aktuelle Player übergibt ein maskiertes CSRF-Token in der Endpunkt-URL. Schließen Sie deren Abfragezeichenfolge aus den Zugriffsprotokollen aus und behalten Sie no-store/no-referrer bei. Verwenden Sie HTTPS und sichere Sitzungscookies.

Upgrade einer älteren Installation mit DRM-X-Tabellen? Bewahren Sie den Migrationsverlauf auf und lesen Sie legacy/README.md, bevor Sie die alte App entfernen. Das neue SDK löscht diese Tabellen nicht.

Vor dem Produktivbetrieb prüfen#

• Melden Sie sich als erlaubter Benutzer an und spielen Sie ein veröffentlichtes Video in einem unterstützten Browser ab.
• Testen Sie abgemeldete Benutzer und Benutzer ohne Zahlung sowie widerrufene oder abgelaufene Berechtigungen. Neue Sitzungsanfragen müssen abgelehnt werden.
• Ändern Sie die Content ID im Browser oder die Video-ID Ihrer Website. Der Server muss die neue Auswahl prüfen.
• Legen Sie den genauen öffentlichen HTTPS-Ursprung fest, behalten Sie den session/CSRF-Schutz Ihres Frameworks bei und deaktivieren Sie den Demo-Identitätscode.

Bestehende Sitzungen und DRM-Lizenzen haben ihre eigene Lebensdauer. Berechtigungsänderungen werden bei neuen Anfragen überprüft; sie löschen keine bereits ausgestellte Lizenz.