Amazon S3 Server-seitige Verschlüsselung

Amazon Web Services bietet eine serverseitige Verschlüsselungsfunktion, die Sie beim Hochladen von Vonage Video-Archiven auf ein S3-Ziel verwenden können.

Dabei werden von Amazon S3 verwaltete Schlüssel zur Verschlüsselung verwendet. Für weitere Informationen siehe diese Amazon Web Services-Dokumentation. (Vonage Video unterstützt nur die Verwendung von Amazon S3-verwalteten Verschlüsselungsschlüsseln und nicht von KMS oder vom Kunden bereitgestellten Schlüsseln).

Um diese Funktion zu nutzen, setzen Sie die sse Eigenschaft zu "s3" wenn Sie die Vonage Video REST API aufrufen, um das Archiv-Upload-Ziel festzulegen.

Senden Sie eine HTTP PUT-Anfrage an die folgende URL:

/v2/project/<appId>/archive/storage

Ersetzen Sie <appId> mit Ihrer Vonage Video APP ID.

Authentifizieren Sie die REST-API-Anfrage mit einem HTTP-Autorisierungs-Header (siehe die Vonage Video REST API-Dokumentation):

Authorization: Basic base64(APP_ID:API_SECRET)

Fügen Sie ein JSON-Objekt als POST-Daten ein:

Satz bucket auf den Namen des Amazon S3-Buckets, den Sie für den Archiv-Upload verwenden möchten. Setzen Sie den secretKey und accessKey Eigenschaften auf den geheimen Amazon S3-Schlüssel und den Zugriffsschlüssel für diesen Bucket.

Setzen Sie die endpoint wenn Sie einen anderen S3-kompatiblen Speicheranbieter als Amazon verwenden möchten. Dies ist optional. Setzen Sie dies auf die Basis-URL des Endpunkts, einschließlich des Protokolls (http oder https), wie z.B. "https://s3.cloudianhyperstore.com" oder "https://storage.googleapis.com". Der Standard Endpunkt ist "https://s3.amazonaws.com" (die Amazon S3-Endpunkt-URL).

Setzen Sie die sse Eigenschaft zu "s3" um die serverseitige Verschlüsselung von Amazon S3 zu verwenden. Setzen Sie die sse Eigenschaft zu "none" um Archive in einen unverschlüsselten S3-Bucket hochzuladen.

Setzen Sie die fallback Eigenschaft zu "none" um zu verhindern, dass Archivdateien in der Vonage Cloud gespeichert werden, wenn der Upload fehlschlägt. Setzen Sie die Eigenschaft auf "vonage" um das Archiv im Vonage API-Dashboard verfügbar zu haben, falls der Upload fehlschlägt.

REST-API-Antworten

Eine Antwort mit dem Statuscode 200 zeigt den Erfolg an.

Eine Antwort mit einem 400-Statuscode zeigt an, dass Sie ungültige JSON-Daten eingefügt haben oder dass Sie das Upload-Ziel nicht angegeben haben.

Eine Antwort mit dem Statuscode 403 bedeutet, dass Sie eine ungültige Vonage Video App ID oder einen ungültigen privaten Schlüssel eingegeben haben.

Beispiel

Das folgende Befehlszeilenbeispiel setzt sicher das serverseitige Verschlüsselungsflag für Vonage, das beim Hochladen von Archiven in einen Amazon S3-Bucket verwendet wird:

app_id=12345 data='{"type":"s3","config":{"bucket": "your-s3-bucket","secretKey": "your-s3-secret-key","accessKey": "your-s3-access-key","sse" : "s3"}, "fallback" : "none"}' curl \ -i \ -H "Content-Type: application/json" \ -X PUT \ -H "X-OPENTOK-AUTH:$json_web_token" \ -d "$data" \ https://video.api.vonage.com//v2/partner/$app_id/archive/storage

Legen Sie den Wert für app_id auf Ihre App-ID. Legen Sie den Wert für json_web_token in ein JSON-Web-Token. Legen Sie die Werte für your-s3-bucket und your-s3-access-key auf Anmeldeinformationen, die einen entsprechenden Zugang zu Ihrem Amazon S3 Account haben.

Weitere Informationen finden Sie unter Archivierung mit AWS S3.