Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Beschränken Sie den Zugriff auf einen AWS Elemental MediaPackage v2-Ursprung
CloudFront bietet *Origin Access Control* (OAC) zur Beschränkung des Zugriffs auf einen MediaPackage v2-Ursprung.
**Anmerkung**
CloudFront OAC unterstützt nur v2. MediaPackage MediaPackage Version 1 wird nicht unterstützt.
**Topics**
+ [Erstellen einer neuen OAC](#create-oac-overview-mediapackage)
+ [Erweiterte Einstellungen für die Ursprungszugriffssteuerung](#oac-advanced-settings-mediapackage)
## Erstellen einer neuen OAC
Führen Sie die in den folgenden Themen beschriebenen Schritte aus, um ein neues OAC in CloudFront einzurichten.
**Topics**
+ [Voraussetzungen](#oac-prerequisites-mediapackage)
+ [Erteilen Sie CloudFront die Erlaubnis, auf den MediaPackage v2-Ursprung zuzugreifen](#oac-permission-to-access-mediapackage)
+ [Erstellen der OAC](#create-oac-mediapackage)
### Voraussetzungen
Bevor Sie OAC erstellen und einrichten, müssen Sie über eine CloudFront Distribution mit MediaPackage v2-Ursprung verfügen. Weitere Informationen finden Sie unter [Verwenden Sie einen MediaStore Container oder einen MediaPackage Channel](DownloadDistS3AndCustomOrigins.md#concept_AWS_Media).
### Erteilen Sie CloudFront die Erlaubnis, auf den MediaPackage v2-Ursprung zuzugreifen
Bevor Sie ein OAC erstellen oder es in einer CloudFront Distribution einrichten, stellen Sie sicher, dass es über die Zugriffsrechte für den MediaPackage v2-Ursprung CloudFront verfügt. Tun Sie dies, nachdem Sie eine CloudFront Distribution erstellt haben, aber bevor Sie das OAC dem MediaPackage v2-Ursprung in der Distributionskonfiguration hinzufügen.
Verwenden Sie eine IAM-Richtlinie, um dem CloudFront Dienstprinzipal (`cloudfront.amazonaws.com`) den Zugriff auf den Ursprung zu ermöglichen. Das `Condition` Element in der Richtlinie ermöglicht den CloudFront Zugriff auf den MediaPackage v2-Ursprung *nur*, wenn die Anfrage im Namen der CloudFront Distribution erfolgt, die den MediaPackage v2-Ursprung enthält. Dies ist die Distribution mit dem MediaPackage v2-Ursprung, zu der Sie OAC hinzufügen möchten.
**Example : IAM-Richtlinie, die nur Lesezugriff für eine CloudFront Distribution mit aktiviertem OAC ermöglicht**
Die folgende Richtlinie ermöglicht der CloudFront Distribution (`{{E1PDK09ESKHJWT}}`) den Zugriff auf den v2-Ursprung. MediaPackage Der Ursprung ist der für das `Resource`-Element angegebene ARN.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowCloudFrontServicePrincipal",
"Effect": "Allow",
"Principal": {"Service": "cloudfront.amazonaws.com"},
"Action": "mediapackagev2:GetObject",
"Resource": "arn:aws:mediapackagev2:us-east-1:123456789012:channelGroup/{{channel-group-name}}/channel/{{channel-name}}/originEndpoint/{{origin_endpoint_name}}",
"Condition": {
"StringEquals": {"AWS:SourceArn": "arn:aws:cloudfront::123456789012:distribution/{{E1PDK09ESKHJWT}}"}
}
}
]
}
```
**Hinweise**
Wenn Sie die MQAR-Funktion und die Ursprungszugriffssteuerung (OAC) aktiviert haben, fügen Sie die Aktion `mediapackagev2:GetHeadObject` der IAM-Richtlinie hinzu. MQAR benötigt diese Berechtigung, um `HEAD` Anfragen an den MediaPackage v2-Ursprung zu senden. Weitere Informationen zu MQAR finden Sie unter [Media Quality-Aware Resiliency](media-quality-score.md).
Wenn Sie eine Distribution erstellen, die keine Berechtigungen für Ihren MediaPackage v2-Ursprung hat, können Sie in der CloudFront Konsole „**Richtlinie kopieren**“ und dann „**Endpunktberechtigungen aktualisieren**“ auswählen. Anschließend können Sie die kopierte Berechtigung an den Endpunkt anhängen. Weitere Informationen finden Sie unter [Endpunktrichtlinienfelder](https://docs.aws.amazon.com/mediapackage/latest/userguide/endpoints-policy.html) im *Benutzerhandbuch für AWS Elemental MediaPackage *.
### Erstellen der OAC
Um ein OAC zu erstellen, können Sie die AWS-Managementkonsole, CloudFormation AWS CLI, oder die CloudFront API verwenden.
------
#### [ Console ]
**So erstellen Sie eine OAC**
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die CloudFront Konsole unter[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Wählen Sie im Navigationsbereich **Origin access** (Ursprungszugriff) aus.
1. Wählen Sie **Create control setting** (Kontrolleinstellung erstellen) aus.
1. Führen Sie im Formular **Neue OAC erstellen** die folgenden Schritte aus:
1. Geben Sie für die OAC einen **Namen** und (optional) eine **Beschreibung** ein.
1. Es empfiehlt sich, unter **Signierverhalten** die Standardeinstellung **Anforderungen signieren (empfohlen)** zu belassen. Weitere Informationen finden Sie unter [Erweiterte Einstellungen für die Ursprungszugriffssteuerung](#oac-advanced-settings-mediapackage).
1. Wählen Sie als **Origin-Typ MediaPackage ** **V2** aus.
1. Wählen Sie **Erstellen** aus.
**Tipp**
Nachdem Sie die OAC erstellt haben, notieren Sie sich den **Namen**. Sie benötigen diesen im folgenden Verfahren.
**Um einem MediaPackage v2-Ursprung in einer Distribution ein OAC hinzuzufügen**
1. Öffnen Sie die CloudFront Konsole unter. [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)
1. Wählen Sie eine Distribution mit einem MediaPackage V2-Ursprung aus, zu der Sie das OAC hinzufügen möchten, und wählen Sie dann den Tab **Origins**.
1. **Wählen Sie den MediaPackage v2-Ursprung aus, zu dem Sie das OAC hinzufügen möchten, und wählen Sie dann Bearbeiten.**
1. Wählen Sie **HTTPS only** (Nur HTTPS) für **Protocol** (Protokoll) Ihres Ursprungs aus.
1. Wählen Sie im Dropdown-Menü **Ursprungszugriffssteuerung** den zu verwendenden OAC-Namen aus.
1. Wählen Sie **Änderungen speichern ** aus.
Die Verteilung beginnt mit der Bereitstellung an allen CloudFront Edge-Standorten. Wenn ein Edge-Standort die neue Konfiguration empfängt, signiert er alle Anfragen, die er an den MediaPackage v2-Ursprung sendet.
------
#### [ CloudFormation ]
Verwenden Sie den `AWS::CloudFront::OriginAccessControl` Ressourcentyp CloudFormation, um ein OAC mit zu erstellen. Das folgende Beispiel zeigt die CloudFormation Vorlagensyntax im YAML-Format für die Erstellung eines OAC.
```
Type: AWS::CloudFront::OriginAccessControl
Properties:
OriginAccessControlConfig:
Description: An optional description for the origin access control
Name: ExampleOAC
OriginAccessControlOriginType: mediapackagev2
SigningBehavior: always
SigningProtocol: sigv4
```
Weitere Informationen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter [AWS::CloudFront::OriginAccessSteuerung](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudfront-originaccesscontrol.html).
------
#### [ CLI ]
Verwenden Sie den **aws cloudfront create-origin-access-control** Befehl, um eine Origin-Zugriffskontrolle mit dem AWS Command Line Interface (AWS CLI) zu erstellen. Sie können eine Eingabedatei verwenden, um die Eingabeparameter für den Befehl bereitzustellen, anstatt jeden einzelnen Parameter als Befehlszeileneingabe anzugeben.
**So erstellen Sie eine Ursprungszugriffssteuerung (CLI mit Eingabedatei)**
1. Verwenden Sie den folgenden Befehl zum Erstellen einer Datei mit dem Namen `origin-access-control.yaml`. Diese Datei enthält alle Eingabeparameter für den Befehl **create-origin-access-control**.
```
aws cloudfront create-origin-access-control --generate-cli-skeleton yaml-input > origin-access-control.yaml
```
1. Öffnen Sie die Datei `origin-access-control.yaml`, die Sie gerade erstellt haben. Bearbeiten Sie die Datei, um einen Namen für die OAC und eine Beschreibung (optional) hinzuzufügen, und ändern Sie `SigningBehavior` zu `always`. Speichern Sie dann die Datei.
Weitere Informationen zu anderen OAC-Einstellungen finden Sie unter [Erweiterte Einstellungen für die Ursprungszugriffssteuerung](#oac-advanced-settings-mediapackage).
1. Verwenden Sie den folgenden Befehl, um die Ursprungszugriffssteuerung mit Eingabeparametern aus der Datei `origin-access-control.yaml` zu erstellen.
```
aws cloudfront create-origin-access-control --cli-input-yaml file://origin-access-control.yaml
```
Notieren Sie den `Id`-Wert in der Befehlsausgabe. Sie benötigen ihn, um das OAC zu einem MediaPackage v2-Ursprung in einer CloudFront Distribution hinzuzufügen.
**Um ein OAC an einen MediaPackage v2-Ursprung in einer vorhandenen Distribution anzuhängen (CLI mit Eingabedatei)**
1. Verwenden Sie den folgenden Befehl, um die Verteilungskonfiguration für die CloudFront Distribution zu speichern, zu der Sie das OAC hinzufügen möchten. Die Distribution muss einen MediaPackage v2-Ursprung haben.
```
aws cloudfront get-distribution-config --id {{}} --output yaml > dist-config.yaml
```
1. Öffnen Sie die Datei mit dem Namen `dist-config.yaml`, die Sie gerade erstellt haben. Bearbeiten Sie die Datei und nehmen Sie die folgenden Änderungen vor:
+ Fügen Sie im Objekt `Origins` die ID der OAC dem Feld namens `OriginAccessControlId` hinzu.
+ Entfernen Sie den Wert aus dem Feld namens `OriginAccessIdentity`, sofern vorhanden.
+ Benennen Sie das Feld `ETag` in `IfMatch` um, ändern Sie jedoch nicht den Wert des Feldes.
Speichern Sie die Datei, wenn Sie fertig sind.
1. Verwenden Sie den folgenden Befehl, um die Distribution zu aktualisieren und die Ursprungszugriffssteuerung zu verwenden.
```
aws cloudfront update-distribution --id {{}} --cli-input-yaml file://dist-config.yaml
```
Die Verteilung beginnt mit der Bereitstellung an allen CloudFront Edge-Standorten. Wenn ein Edge-Standort die neue Konfiguration empfängt, signiert er alle Anfragen, die er an den MediaPackage v2-Ursprung sendet.
------
#### [ API ]
Um ein OAC mit der CloudFront API zu erstellen, verwenden Sie [CreateOriginAccessControl](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateOriginAccessControl.html). Weitere Informationen zu den Feldern, die Sie in diesem API-Aufruf angeben, finden Sie in der API-Referenzdokumentation für Ihr AWS SDK oder einen anderen API-Client.
Nachdem Sie ein OAC erstellt haben, können Sie es mithilfe eines der folgenden API-Aufrufe an einen MediaPackage v2-Ursprung in einer Distribution anhängen:
+ Um es an eine bestehende Distribution anzuhängen, verwenden Sie [UpdateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html).
+ Um es an eine neue Distribution anzuhängen, verwenden Sie [CreateDistribution](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateDistribution.html).
Geben Sie für beide API-Aufrufe die ID der OAC im Feld `OriginAccessControlId` innerhalb eines Ursprungs an. Weitere Informationen zu den anderen Feldern, die Sie in diesen API-Aufrufen angeben, finden Sie unter [Referenz für alle Distributionseinstellungen](distribution-web-values-specify.md) und in der API-Referenzdokumentation für Ihr AWS SDK oder einen anderen API-Client.
------
## Erweiterte Einstellungen für die Ursprungszugriffssteuerung
Die CloudFront OAC-Funktion umfasst erweiterte Einstellungen, die nur für bestimmte Anwendungsfälle vorgesehen sind. Verwenden Sie die empfohlenen Einstellungen, sofern Sie die erweiterten Einstellungen nicht speziell benötigen.
OAC enthält eine Einstellung mit dem Namen **Signaturverhalten** (in der Konsole) oder `SigningBehavior` (in der API, CLI und CloudFormation). Diese Einstellung bietet die folgenden Optionen:
**Ursprungsanforderungen immer signieren (empfohlene Einstellung)**
Wir empfehlen die Verwendung dieser Einstellung mit der Bezeichnung **Sign requests (recommended)** (Anforderungen signieren (empfohlen)) in der Konsole bzw. `always` in der API, CLI und CloudFormation. Mit dieser Einstellung werden CloudFront immer alle Anfragen signiert, die an den MediaPackage v2-Ursprung gesendet werden.
**Ursprungsanforderungen nie signieren**
Diese Einstellung heißt **Do not sign requests** (Anforderungen nicht signieren) in der Konsole bzw. `never` in der API, CLI und CloudFormation. Verwenden Sie diese Einstellung, um die OAC für alle Ursprünge in allen Distributionen zu deaktivieren, die diese OAC verwenden. Auf diese Weise lässt sich im Vergleich zum einzelnen Entfernen einer OAC aus allen Ursprüngen und Distributionen, die diese verwenden, Zeit und Aufwand sparen. Mit dieser Einstellung signiert es CloudFront keine Anfragen, die es an den MediaPackage v2-Ursprung sendet.
Um diese Einstellung verwenden zu können, muss der MediaPackage v2-Ursprung öffentlich zugänglich sein. Wenn Sie diese Einstellung mit einem MediaPackage v2-Ursprung verwenden, der nicht öffentlich zugänglich ist, CloudFront können Sie nicht auf den Ursprung zugreifen. Der MediaPackage v2-Ursprung gibt Fehler an die Zuschauer zurück CloudFront und CloudFront leitet diese Fehler an sie weiter. Weitere Informationen finden Sie im *AWS Elemental MediaPackage Benutzerhandbuch MediaPackage* [im Beispiel für eine MediaPackage v2-Richtlinie für Richtlinien und Berechtigungen](https://docs.aws.amazon.com/mediapackage/latest/userguide/policies-permissions.html).
**Viewer (Client)-`Authorization`-Header nicht überschreiben**
Diese Einstellung heißt **Do not override authorization header** (Autorisierungsheader nicht überschreiben) in der Konsole bzw. `no-override` in der API, CLI und CloudFormation. Verwenden Sie diese Einstellung, wenn Sie Originalanfragen nur signieren CloudFront möchten, wenn die entsprechende Viewer-Anfrage keinen `Authorization` Header enthält. Mit dieser Einstellung wird der `Authorization` Header der Viewer-Anfrage weitergegeben, CloudFront wenn eine vorhanden ist, signiert aber die ursprüngliche Anfrage (fügt einen eigenen `Authorization` Header hinzu), wenn die Viewer-Anfrage keinen `Authorization` Header enthält.
Um den `Authorization` Header aus der Viewer-Anfrage weiterzugeben, *müssen* Sie den `Authorization` Header zu einer [Cache-Richtlinie für alle Cache-Verhaltensweisen](controlling-the-cache-key.md) hinzufügen, die MediaPackage v2-Ursprünge verwenden, die mit dieser ursprünglichen Zugriffskontrolle verknüpft sind.