Onboarding von Drittanbieter-Anwendungen

Voraussetzungen

Wenn Sie benutzerdefinierte IAM Richtlinien verwenden, um den Zugriff auf Drittanbieteranwendungen zu verwalten, benötigen Ihre Benutzer die folgenden IAM Berechtigungen, um eine Drittanbieteranwendung mithilfe der AWS Konsole zu integrieren. Zusätzlich zu AmazonConnect_FullAccess benötigen Benutzer Folgendes:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "app-integrations:CreateApplication",
                "app-integrations:GetApplication",
                "iam:GetRolePolicy",
                "iam:PutRolePolicy",
                "iam:DeleteRolePolicy"
            ],
            "Resource": "arn:aws:app-integrations:<aws-region>:<aws-account-Id>:application/*",
            "Effect": "Allow"
        }
    ]
}                   
                

So integrieren Sie eine Drittanbieter-Anwendung

Anmerkung

Um Drittanbieteranwendungen in Ihre Instances zu integrieren, stellen Sie sicher, dass Ihre Instanz eine serviceverknüpfte Rolle (SLR) verwendet. Wenn Ihre Instanz derzeit keine verwendet, Sie SLR aber Drittanbieteranwendungen integrieren möchten, müssen Sie zu einer SLR migrieren. Anwendungen von Drittanbietern können nur in Instanzen integriert und verwendet werden, die eine verwendenSLR. Weitere Informationen finden Sie unter Für Instances, die vor Oktober 2018 erstellt wurden.

1. Öffnen Sie die Amazon Connect Konsole (https://console.aws.amazon.com/connect/).

2. Klicken Sie im Navigationsbereich links auf Anwendungen von Drittanbietern. Wenn Sie dieses Menü nicht sehen, liegt das daran, dass es in Ihrer Region nicht verfügbar ist. Informationen zu den Regionen, in denen diese Funktion verfügbar ist, finden Sie unter Verfügbarkeit von Amazon Connect Funktionen nach Regionen.

3. Wählen Sie auf der Seite Anwendungen von Drittanbietern die Option Anwendung hinzufügen aus.

   

4. Geben Sie auf der Seite Anwendung hinzufügen Folgendes ein:

   1. Grundlegende Informationen

      1. Anzeigename: Ein benutzerfreundlicher Name für die Anwendung. Dieser Name wird in Sicherheitsprofilen und außerdem Kundendienstmitarbeitern auf der Registerkarte im Arbeitsbereich für Kundendienstmitarbeiter angezeigt. Sie können diesen Namen an dieser Stelle jederzeit ändern.

      2. Namespace: Der offizielle Name, der für Ihre Anwendung eindeutig ist. Wenn Sie nur eine Anwendung pro Zugriff habenURL, empfehlen wir, den Ursprung des Zugriffs zu verwendenURL. Dieser Name kann nicht geändert werden.

      3. Beschreibung (optional): Sie können optional eine Beschreibung für diese Anwendung angeben. Diese Beschreibung wird Kundendienstmitarbeitern nicht angezeigt.

   2. Access

      1. Zugriff URL: URL Hier wird Ihre Anwendung gehostet. Der URL muss sicher sein, beginnend mit https, es sei denn, es handelt sich um einen lokalen Host.

         Anmerkung

         Nicht alle URLs können gerahmt werden. Es gibt zwei Möglichkeiten, um zu überprüfen, ob sie mit einem URL iframe versehen werden können:

         1. Es gibt ein Drittanbieter-Tool, mit dem überprüft werden kann, ob ein URL iframe werden kann. Es heißt Iframe Tester.

            1. Wenn ein URL iframe verwendet werden kann, wird es in einer Vorschau auf dieser Seite gerendert.

            2. Wenn ein Bild URL nicht per iframe dargestellt werden kann, wird in der Vorschau auf dieser Seite ein Fehler angezeigt.

               • Es ist möglich, dass auf dieser Website ein Fehler angezeigt wird und die App trotzdem im Arbeitsbereich für Kundendienstmitarbeiter mit einem iframe versehen werden kann. Das liegt daran, dass der App-Entwickler seine App so sperren kann, dass sie nur in den Arbeitsbereich eingebettet werden kann und sonst nirgends. Wenn Sie diese App von einem App-Entwickler erhalten haben, empfehlen wir, trotzdem zu versuchen, diese App in den Arbeitsbereich für Kundendienstmitarbeiter zu integrieren.

         2. Für technische versierte Benutzer: Prüfen Sie den Inhalt der Sicherheitsrichtlinien der Anwendung, die Sie integrieren möchten.

            1. Firefox: Dreistrich-Menü > Weitere Werkzeuge > Werkzeuge für Web-Entwickler > Netzwerk

            2. Chrome: Dreipunkt-Menü > Weitere Tools > Entwicklertools > Netzwerk

            3. Andere Browser: Suchen Sie in den Entwicklertools nach den Netzwerkeinstellungen.

            4. Die Richtlinie für den Framevorgänger in den Inhaltssicherheitsrichtlinien sollte https://your-instance.my.connect.aws sein.

               1. Wenn die Direktive same origin oder lautetdeny, kann sie URL nicht durch AWS /Amazon Connect umrahmt werden

         Sie haben folgende Möglichkeiten, wenn die App nicht mit einem iframe versehen werden kann:

         • Wenn Sie die App/ kontrollierenURL, können Sie die Inhaltssicherheitsrichtlinie der App aktualisieren. Folgen Sie dabei diesen bewährten Methoden für App-Entwickler und stellen Sie sicher, dass Apps nur in den Arbeitsbereich für Kundendienstmitarbeiter von Connect eingebettet werden können.

         • Wenn Sie die App/ nicht kontrollieren, können Sie versuchenURL, den Entwickler der App zu kontaktieren und ihn zu bitten, die Inhaltssicherheitsrichtlinie der App zu aktualisieren.

      2. Genehmigte Quellen (optional): ZulassungslisteURLs, die zugelassen werden sollte, sofern sie sich vom Zugriff unterscheidet. URL Der URL muss sicher sein und mit https beginnen, es sei denn, es handelt sich um einen lokalen Host.

   3. Fügen Sie Berechtigungen zu Ereignissen und Anforderungen hinzu.

      Im Folgenden finden Sie ein Beispiel dafür, wie Sie mithilfe der AWS -Konsole eine neue Anwendung einbinden und ihr Berechtigungen zuweisen können. In diesem Beispiel werden der Anwendung sechs verschiedene Berechtigungen zugewiesen.

      Bereitstellung grundlegender Informationen und Zugangsdetails

   4. Instance-Zuordnung

      1. Sie können jeder Instance innerhalb dieser Kontoregion Zugriff auf diese Anwendung gewähren.

      2. Die Zuordnung der Anwendung zu einer Instance ist zwar optional, Sie können sie jedoch erst verwenden, nachdem Sie sie mindestens einer Instance zugeordnet haben.

   

   Erteilen von Berechtigungen für die Anwendung zur Workspace-Datenintegration

   

5. Wählen Sie Save (Speichern) aus.

6. Wenn die Anwendung erfolgreich erstellt wurde, werden Sie auf die Seite Anwendungen von Drittanbietern zurückgeleitet. Dort wird ein Banner mit dem Hinweis angezeigt, dass der Vorgang erfolgreich war, und die Anwendung ist in der Liste enthalten.

   

   Sie können bestimmte Attribute einer vorhandenen App bearbeiten, z. B. ihren AnzeigenamenURL, Zugriff und Berechtigungen.

   1. Wenn beim Erstellen der Anwendung oder beim Zuordnen der Anwendung zu einer Instance ein Fehler aufgetreten ist, wird eine Fehlermeldung angezeigt und Sie können die entsprechende Maßnahme ergreifen, um das Problem zu beheben.

Löschen von Anwendungen Dritter

Wenn Sie eine Drittanbieteranwendung in der absehbaren Zukunft nicht benötigen werden, können Sie sie löschen. Wenn Sie sie vorübergehend nicht, sie aber in absehbarer Zeit erneut verwenden möchten, empfehlen wir, die Verbindung zu einer Instance zu trennen, um zu vermeiden, dass Sie sie erneut hinzufügen müssen. Um Drittanbieteranwendungen zu löschen, navigieren Sie zur AWS Konsole, wählen Sie eine Anwendung aus und wählen Sie Löschen.

Fehlersuche

• Der Vorgang schlägt fehl, wenn die Anwendung mit einer Instance verknüpft ist. Sie müssen die Anwendung zunächst von jeder Instance trennen. Dann können Sie zurückkommen und löschen.

Tipp

Wenn Sie eine Anwendung vor dem 15. Dezember 2023 erstellt haben, können Probleme auftreten, wenn Sie die Zuordnung der Anwendung zu (einer) Instanc(es) aktualisieren. Dies liegt daran, dass Sie Ihre IAM Richtlinie aktualisieren müssen.

Ihre IAM Richtlinie muss aktualisiert werden und die folgenden Berechtigungen enthalten:

• app-integrations:CreateApplicationAssociation

• app-integrations:DeleteApplicationAssociation

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "app-integrations:CreateApplication",
                "app-integrations:GetApplication"
            ],
            "Resource": "arn:aws:app-integrations:<aws-region>:<aws-account-Id>:application/*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "app-integrations:CreateApplicationAssociation",
                "app-integrations:DeleteApplicationAssociation"
            ],
            "Resource": "arn:aws:app-integrations:<aws-region>:<aws-account-Id>:application-association/*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "iam:GetRolePolicy",
                "iam:PutRolePolicy",
                "iam:DeleteRolePolicy"
            ],
            "Resource": "arn:aws:iam::<aws-account-Id>:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_*",
            "Effect": "Allow"
        }
    ]
}