CORS/CSP-Konfiguration

Der Webbrowserzugriff auf Amazon- und Azure Storage-Buckets kann aufgrund von CORS- (Cross Origin Resource Sharing) und CSP-Einstellungen (Content Security Policy) eingeschränkt sein.

Dies gilt auch für Orchestrator-Buckets, wenn der Speicher vom Orchestrator für die Verwendung von Azure oder Amazon konfiguriert ist.

Die folgenden Operationen werden beeinträchtigt, wenn über die Orchestrator-Benutzeroberfläche auf Bucket-Inhalte zugegriffen wird:

• Hochladen von Dateien in einen Speicher-Bucket
• Herunterladen von Dateien aus einem Speicher-Bucket.

• Öffnen von Dokumentvalidierungsaktionen oder Formularaktionen, die in Buckets gespeicherte Images verwenden.

  Hinweis: Der Zugriff auf Speicherdateien mithilfe von Aktivitäten wird von CORS- und CSP-Richtlinien nicht beeinflusst, da sie browserspezifisch sind und nur auf Browserebene validiert/erzwungen werden.

Sowohl CORS als auch CSP ermöglichen das Whitelisting von identifizierten Entitäten in der Webanwendung. Details folgen unten.

CORS

CORS ist ein Mechanismus, der den Zugriff auf Ressourcen einer Webseite über Domänengrenzen hinweg ermöglicht.

Der Orchestrator-Webbrowserzugriff auf Amazon- und Azure Storage-Buckets kann aufgrund von Richtlinien zur gleichen Quelle auf der Anbieterseite eingeschränkt sein. Wenn Sie über die Orchestrator-Benutzeroberfläche erfolgreich auf den Inhalt eines solchen Buckets zugreifen möchten, müssen Sie den jeweiligen Anbieter so konfigurieren, dass Anforderungen zwischen verschiedenen Quellen vom Orchestrator zugelassen werden.

Amazon S3

Fügen Sie eine Regel hinzu, die GET- und PUT-Anforderungen vom Orchestrator zulässt. Zum Beispiel:

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "GET",
            "PUT"
        ],
        "AllowedOrigins": [
            "http://your.orchestrator.dns.name"
        ],
        "ExposeHeaders": []
    }
]

Hier finden Sie die offizielle Amazon S3-Dokumentation zu Cross-Origin Resource Sharing.

Azure

Aktivieren Sie GET- und PUT-Operationen für Anforderungen vom Orchestrator. Zum Beispiel:

<Cors>
<CorsRule>
<AllowedOrigins>http://your.orchestrator.dns.name</AllowedOrigins>
<AllowedMethods>PUT,GET</AllowedMethods>
<AllowedHeaders>*</AllowedHeaders>
<ExposedHeaders>*</ExposedHeaders>
</CorsRule>
</Cors>

Hinweis: Stellen Sie sicher, dass die URL nicht mit einem Schrägstrich endet.

Hier finden Sie die offizielle Azure-Dokumentation zu Cross-Origin Resource Sharing.

CSP

Die Inhaltssicherheitsrichtlinie ist eine Webbrowser-Sicherheitsschicht, die verhindert, dass eine Web-App Anforderungen außerhalb einer vertrauenswürdigen Gruppe von Hosts stellt.

Bei der Verwendung von Speicher-Buckets lässt der Orchestrator automatisch Aufrufe bei Azure oder Amazon S3 zu, wenn diese Anbieter aktiviert sind oder wenn der zusammengesetzte Speicher vom Orchestrator zur Verwendung von Azure oder Amazon S3 konfiguriert ist.

Wichtig: Um CSP-Probleme zu vermeiden, verwenden Sie kanonische Azure- oder Amazon-Namen für den Container und vermeiden Sie Vanity-URLs.

Um mögliche CSP-Probleme zu beheben, fügen Sie die App-Einstellung Buckets.ContentSecurityPolicy hinzu und legen Sie ihren Wert auf eine durch Kommas getrennte Liste aller Domänen fest, die zugelassen werden sollen. Dieser Parameter überschreibt die entsprechenden Orchestrator-Einstellungen in Bezug auf Azure und AWS, also stellen Sie sicher, dass Sie bei Bedarf auch Azure und/oder AWS hinzufügen.