AWS S3-Module
Mit den Adobe Workfront Fusion AWS S3-Modulen können Sie Vorgänge an Ihren S3-Buckets durchführen.
Zugriffsanforderungen
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket |
Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket Workfront Ultimate Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion. |
| Adobe Workfront-Lizenzen |
Standard Work oder höher |
| Adobe Workfront Fusion-Lizenz |
Betriebsbasiert: Verfügbar für Organisationen mit betriebsbasierten Lizenzen Connector-basiert (veraltet): Workfront Fusion for Work Automation and Integration |
| Produkt | Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Ihre Organisation Adobe Workfront Fusion erwerben. |
Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.
Voraussetzungen
Um AWS S3-Module verwenden zu können, müssen Sie über ein Amazon Web Service verfügen.
AWS S3-API-Informationen
Der AWS S3-Connector verwendet Folgendes:
Verbinden von AWS mit Workfront Fusion connect-aws-to-workfront-fusion
Verbinden von AWS mit Workfront Fusion über eine Federated-Verbindung
- Voraussetzungen für das Verbinden von AWS mit Workfront Fusion über eine Federated-Verbindung
- Hinzufügen von Workfront Fusion als Identitätsanbieter in AWS
- Erstellen der IAM-Rolle
- Erstellen der Verbindung in Workfront Fusion
- Fügen Sie die Verbindung zur Vertrauensrichtlinie der Rolle hinzu
- Verbindung überprüfen
- Fehlerbehebung
Über eine Federated Connection kann Workfront Fusion auf Ihr AWS-Konto zugreifen, ohne dass Sie einen IAM-Benutzer erstellen oder einen Zugriffsschlüssel in Fusion speichern müssen.
Sie registrieren Workfront Fusion stattdessen als vertrauenswürdigen Identitätsanbieter in Ihrem AWS-Konto und konfigurieren, welche einzelne Fusion-Verbindung eine bestimmte IAM-Rolle verwenden darf. Wenn die Verbindung ausgeführt wird, stellt Fusion einen kurzlebigen Identitätsnachweis bereit, und AWS gibt temporäre Anmeldeinformationen zurück, die selbstständig ablaufen. Es wird nie ein langlebiger Schlüssel erstellt, gespeichert oder gedreht.
| note |
|---|
| NOTE |
| Das Einrichten dieser Verbindung führt zu zwei Besuchen der AWS-Konsole. Zuerst erstellen Sie die Rolle und dann die Verbindung in Workfront Fusion. Kehren Sie dann zu AWS zurück, um die Vertrauensrichtlinie abzuschließen. Dies liegt daran, dass ein Teil der Vertrauensrichtlinie eine bestimmte Verbindung identifiziert und diese Kennung erst vorhanden ist, wenn die Verbindung erstellt wurde. |
Voraussetzungen für das Verbinden von AWS mit Workfront Fusion über eine Federated-Verbindung
Um diese Verbindung zu erstellen, benötigen Sie Folgendes:
- Berechtigung in AWS IAM zum Erstellen eines Identitätsanbieters und zum Erstellen und Bearbeiten von Rollen. Dies bedeutet in der Regel die Richtlinie oder das Äquivalent. Wenn Sie diesen Zugriff nicht haben, fragen Sie jemanden in Ihrer Cloud oder
Ihr Sicherheits-Team führt die AWS-Schritte für Sie aus. - Die Möglichkeit, Verbindungen in Workfront Fusion zu erstellen.
Hinzufügen von Workfront Fusion als Identitätsanbieter in AWS
Dieser Schritt teilt AWS mit, dass von Workfront Fusion ausgestellte Token vertrauenswürdig sind. Dies erfolgt einmal pro AWS-Konto. Wenn dieser Provider bereits von einer Person in Ihrer Organisation hinzugefügt wurde, fahren Sie mit Erstellen der IAM-Rolle fort.
-
Melden Sie sich bei der AWS-Konsole an und gehen Sie zu IAM > Identitätsanbieter.
-
Wählen Sie Anbieter hinzufügen aus.
-
Wählen Sie für den Provider-Typ OpenID Connect aus.
-
Geben Sie unter der Provider-URL Folgendes ein und wählen Sie dann Miniaturbild abrufen:
code language-none https://oidc.automations.adobe.com -
Geben Sie unter „Zielgruppe“ Folgendes ein:
code language-none sts.amazonaws.com -
Wählen Sie Anbieter hinzufügen aus.
-
Fahren Sie mit Erstellen der IAM-Rolle fort.
Erstellen der IAM-Rolle
Die Rolle definiert, was die Verbindung in Ihrem AWS-Konto tun darf. Pro Verbindung wird eine Rolle erstellt, sodass der Zugriff jeder Verbindung unabhängig gewährt und widerrufen werden kann.
-
Wechseln Sie in IAM zu Rollen und wählen Sie Rolle erstellen aus.
-
Wählen Sie für den Typ „Vertrauenswürdige Entität“ die Option Web-Identität.
-
Wählen Sie unter Identitätsanbieter die Option
oidc.automations.adobe.comaus. -
Wählen Sie unter Zielgruppe die Option
sts.amazonaws.comaus. -
Wählen Sie Weiter aus und fügen Sie dann die für diese Verbindung erforderlichen Berechtigungsrichtlinien hinzu.
Nur die Berechtigungen erteilen, die die Verbindung tatsächlich verwendet. Beispiel: eine Verbindung, die nur aus liest
Ein Behälter benötigt keineAmazonS3FullAccess. -
Geben Sie der Rolle einen klaren, erkennbaren Namen. Beispiel:
WorkfrontFusionFederatedConnection. -
Wählen Sie Rolle erstellen aus.
-
Öffnen Sie die soeben erstellte Rolle und kopieren Sie ihren ARN aus dem Bereich Zusammenfassung . So sieht es aus:
arn:aws:iam::123456789012:role/WorkfrontFusionFederatedConnection -
Fahren Sie Verbindung in Workfront Fusion erstellen fort.
Erstellen der Verbindung in Workfront Fusion
- Wählen Sie im Bildschirm „Verbindungs-Setup“ des Moduls den Verbindungstyp aus.
- Geben Sie die Rolle ARN ein, die Sie in kopiert haben Erstellen der IAM-Rolle.
- Wählen Sie Erstellen aus.
Workfront Fusion zeigt drei Werte an. Sie verwenden sie im nächsten Verfahren.
| table 0-row-2 1-row-2 2-row-2 html-authored no-header | |
|---|---|
| Aussteller | Immer https://oidc.automations.adobe.com. Dies entspricht dem Identitätsanbieter, den Sie in AWS hinzugefügt haben. |
| Betreff | Identifiziert diese Verbindung. Es sieht wie fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964 aus. Es ist für jede Verbindung, die Sie erstellen, anders. |
| Zielgruppe | Immer sts.amazonaws.com. |
-
Lassen Sie dieses Bedienfeld geöffnet und kopieren Sie den Wert des Betreffs.
note NOTE Schließen Sie das Bedienfeld nicht und klicken Sie nicht auf Abbrechen. Die Verbindung wird erst beendet, wenn Sie die verbleibenden Vorgänge abgeschlossen haben. Wenn Sie das Bedienfeld schließen, müssen Sie die Verbindung löschen und erneut beginnen, da eine neue Verbindung einen neuen Betreff erhält. -
Fahren Sie fort Verbindung zur Vertrauensrichtlinie der Rolle hinzufügen.
Fügen Sie die Verbindung zur Vertrauensrichtlinie der Rolle hinzu
Bis zum Abschluss dieses Vorgangs vertraut die Rolle Workfront Fusion im Allgemeinen, lässt jedoch noch nicht zu, dass diese spezifische Verbindung verwendet wird.
-
Kehren Sie in einer neuen Browser-Registerkarte zur AWS-Konsole zurück und öffnen Sie die von Ihnen erstellte Rolle.
-
Wählen Sie die Registerkarte Vertrauensstellungen und dann Vertrauensrichtlinie bearbeiten.
-
Ersetzen Sie die Richtlinie durch Folgendes und ersetzen Sie dabei Ihre eigenen Werte:
123456789012durch Ihre AWS-Konto-ID ersetzen- Ersetzen Sie den
subdurch den Betreff, den Sie aus Workfront Fusion kopiert haben.
code language-none { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Federated": "arn:aws:iam::123456789012:oidc-provider/oidc.automations.adobe.com" }, "Action": "sts:AssumeRoleWithWebIdentity", "Condition": { "StringEquals": { "oidc.automations.adobe.com:sub": "fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964", "oidc.automations.adobe.com:aud": "sts.amazonaws.com" } } } ] } -
Wählen Sie Richtlinie aktualisieren.
-
Fahren Sie Verbindung überprüfen fort.
| note tip | ||
|---|---|---|
| TIP | ||
| Wenn mehr als eine Verbindung dieselbe Rolle verwenden soll, listen Sie die Subjekte als Array auf. AWS ermöglicht die Verwendung der Rolle, wenn das Token mit einem Wert in der Liste übereinstimmt: | ||
|
||
| Ersetzen Sie den Unterwert nicht durch einen Platzhalter. Dadurch kann jede Verbindung in Ihrer Organisation die Rolle verwenden, einschließlich Verbindungen, die später von anderen Personen erstellt wurden |
Verbindung überprüfen
-
Kehren Sie zur Browser-Registerkarte von Workfront Fusion zurück, auf der das Bedienfeld Verbindung noch geöffnet ist.
-
Klicken Sie auf Speichern.
Workfront Fusion kontaktiert AWS, wodurch die Vertrauensrichtlinie überprüft und temporäre Anmeldeinformationen zurückgegeben werden. Wenn alles richtig eingerichtet ist, wird die Verbindung erfolgreich validiert, und Sie können mit dem Einrichten des Moduls fortfahren.
Wenn die Überprüfung fehlschlägt, bleibt das Bedienfeld geöffnet und zeigt den Fehler an. Korrigieren Sie das Problem in AWS und klicken Sie erneut auf Speichern . Sie müssen die Verbindung nicht neu erstellen, und das Betreff ändert sich nicht.
Ab diesem Zeitpunkt erneuert die Verbindung ihre eigenen Anmeldeinformationen. Es gibt keinen Schlüssel zum Drehen und nichts läuft ab, was Sie pflegen müssen.
Fehlerbehebung
| table 0-row-3 1-row-3 2-row-3 3-row-3 html-authored | ||
|---|---|---|
| Fehler | Bedeutung | Was zu überprüfen ist |
| InvalidIdentityToken | AWS konnte das Token nicht mit einem registrierten Identitätsanbieter abgleichen. | Vergewissern Sie sich, dass Sie den unter Workfront Fusion hinzufügen beschriebenen Identitätsanbieter als Identitätsanbieter in AWS hinzugefügt haben und dass die URL exakt https://oidc.automations.adobe.com lautet, ohne abschließenden Schrägstrich. |
| Zugriff verweigert, wenn die Rolle übernommen wird | Der Identitätsanbieter ist registriert, die Vertrauensrichtlinie stimmt jedoch nicht mit dieser Verbindung überein. | Stellen Sie sicher, dass der Unterwert in der Vertrauensrichtlinie zeichenweise mit dem in Workfront Fusion angezeigten Betreff identisch ist und dass die -Hilfe sts.amazonaws.com lautet. Ein aus einer anderen Verbindung kopiertes Subjekt ist die häufigste Ursache. |
| Die Verbindung funktioniert und schlägt später fehl | Überprüfen Sie, ob die Berechtigungsrichtlinien der Rolle geändert wurden oder ob die Rolle gelöscht und neu erstellt wurde. Durch das Neuerstellen einer Rolle ändert sich zwar nicht deren ARN, aber ihre Vertrauensrichtlinie wird zurückgesetzt. |
Verbinden von AWS mit Workfront Fusion mithilfe einer API-Benutzerin oder eines -Benutzers
Um AWS S3 mit Workfront Fusion zu verbinden, müssen Sie Ihr AWS-Konto mit Workfront Fusion verbinden. Dazu müssen Sie zunächst einen API-Benutzer in AWS () .
-
Melden Sie sich bei Ihrem AWS IAM-Konto an.
-
Navigieren Sie Identitäts- und Zugriffsverwaltung > Zugriffsverwaltung > Benutzer.
-
Klicken Sie Benutzer hinzufügen.
-
Geben Sie den Namen des neuen Benutzers ein und wählen Sie die Option Programmgesteuerter Zugriff im Abschnitt Zugriffstyp aus.
-
Klicken Sie Vorhandene Richtlinien direkt anhängen und suchen Sie dann in Suchleiste nach AmazonS3FullAccess. Klicken Sie auf das gewünschte Element und dann auf Weiter.
-
Gehen Sie durch die anderen Dialogfelder und klicken Sie dann auf Benutzer erstellen.
-
Kopieren Sie die bereitgestellten Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel.
-
Wechseln Sie zu Workfront Fusion und öffnen Sie das Dialogfeld Verbindung erstellen des AWS S3.
-
Geben Sie Schritt 7 die Zugriffsschlüssel-ID“ und Geheimer Zugriffsschlüssel in die entsprechenden Felder ein und klicken Sie auf Weiter, um die Verbindung herzustellen.
Die Verbindung wurde hergestellt. Sie können mit der Einrichtung des Moduls fortfahren.
AWS S3-Module und ihre Felder
Beim Konfigurieren von AWS S3-Modulen werden in Workfront Fusion die unten aufgeführten Felder angezeigt. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der Anwendung oder im Service weitere AWS S3-Felder angezeigt werden. Ein fett formatierter Titel in einem Modul kennzeichnet ein Pflichtfeld.
Wenn die Schaltfläche „Zuordnung“ über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen zwischen Modulen.
Aktionen
Bucket erstellen
Dieses Aktionsmodul erstellt einen Bucket in AWS.
Datei abrufen
Dieses Aktionsmodul lädt eine Datei aus einem Bucket herunter.
Erstellen eines API-Aufrufs
Dieses Aktionsmodul führt einen benutzerdefinierten Aufruf an die AWS S3-API durch.
Eine ausführliche Erläuterung der Amazon S3-API finden Sie unter Amazon S3 REST API-Einführung.
https://s3.<selected-region>.amazonaws.com/.Fügen Sie einen Anfrage-Header hinzu. Klicken Sie für jede Kopfzeile, die Sie hinzufügen möchten, auf Element hinzufügen und geben Sie die Kopfzeile ein. Sie können die folgenden allgemeinen Anfragekopfzeilen verwenden. Weitere Informationen zu Anfragekopfzeilen finden Sie in AWS S3 API-.
Workfront Fusion fügt automatisch Autorisierungs-Header hinzu.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto | |
|---|---|
| Header-Name | Beschreibung |
| Inhaltslänge | Länge der Nachricht (ohne Kopfzeilen) gemäß RFC 2616. Dieser Header ist für PUTs und Vorgänge erforderlich, die XML laden, z. B. Protokollierung und ACLs. |
| Content-Type | Der Content-Typ der Ressource, falls sich der Anfrageinhalt im Hauptteil befindet. Beispiel: text/plain. |
| Content-MD5 | Der base64-kodierte MD5-Digest der Nachricht (ohne die Header) mit 128 Bit gemäß RFC 1864. Dieser Header kann als Integritätsprüfung von Nachrichten verwendet werden, um sicherzustellen, dass es sich bei den Daten um dieselben Daten handelt, die ursprünglich gesendet wurden. Obwohl dies optional ist, empfehlen wir, den Content-MD5-Mechanismus als End-to-End-Integritätsprüfung zu verwenden. Weitere Informationen zur Authentifizierung von REST-Anfragen finden Sie unter Signieren und Authentifizieren von REST in der AWS-Dokumentation. |
| Datum | Das aktuelle Datum und die aktuelle Uhrzeit gemäß dem Anforderer. Beispiel: Wed, 01 Mar 2006 12:00:00 GMT. Wenn Sie den Authorization Header“ angeben, müssen Sie entweder den x-amz-date oder den Date Header“ angeben. |
| erwarten |
Wenn Ihre Anwendung 100-continue verwendet, sendet sie den Anfragetext erst, nachdem sie eine Bestätigung erhalten hat. Wenn die Nachricht anhand der Kopfzeilen abgelehnt wird, wird der Nachrichtentext nicht gesendet. Dieser Header kann nur verwendet werden, wenn Sie einen Textkörper senden. Gültige Werte: 100-Continue |
| Host |
Bei Anfragen im Pfadstil ist der Wert Dieser Header ist für HTTP 1.1 erforderlich (die meisten Toolkits fügen diesen Header automatisch hinzu); optional für HTTP/1.0-Anfragen. |
| x-amz-content-sha256 | Wenn Sie die Signaturversion 4 zum Authentifizieren der Anfrage verwenden, liefert dieser Header einen Hash der Anfrage-Payload. Wenn Sie ein -Objekt in Blöcken hochladen, setzen Sie den Wert auf STREAMING-AWS4-HMAC-SHA256-PAYLOAD , um anzugeben, dass die Signatur nur Kopfzeilen abdeckt und keine Payload vorhanden ist. Weitere Informationen finden Sie unter Signaturberechnungen für den Autorisierungs-Header in der Dokumentation zu AWS. |
| x-amz-date | Das aktuelle Datum und die aktuelle Uhrzeit gemäß dem Anforderer. Beispiel: Wed, 01 Mar 2006 12:00:00 GMT. Wenn Sie den Authorization Header“ angeben, müssen Sie entweder den x-amz-date oder den Date Header“ angeben. Wenn Sie beide angeben, hat der für die x-amz-date Kopfzeile angegebene Wert Vorrang. |
| x-amz-security-token |
Dieser Header kann in den folgenden Szenarien verwendet werden:
Dieser Header ist für Anfragen erforderlich, die Amazon DevPay verwenden, und für Anfragen, die mit temporären Sicherheitsberechtigungen signiert sind. |
Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Hinweis:
Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Datei hochladen
Dieses Aktionsmodul lädt eine Datei in einen AWS S3-Bucket hoch.
Suchvorgänge
Dateien auflisten
Gibt eine Liste mit Dateien von einem angegebenen Speicherort zurück.
Ordner auflisten
Gibt eine Liste mit Ordnern von einem angegebenen Speicherort zurück.