Amazon Quick Slack Suite-Erweiterung

1. Stellen Sie sicher, dass Sie eine IAM Identity Center-Instance für Ihr AWS Konto aktiviert haben.

2. Verwenden Sie Microsoft Entra ID es als Ihren Identitätsanbieter.

3. Stellen Sie sicher, dass jedem Benutzer in Ihrer Entra ID Anbieterkonfiguration eine E-Mail-Adresse zugeordnet ist.

4. Richten Sie die SCIM-Identitätsweitergabe zwischen der Microsoft Entra ID Instance und dem IAM Identity Center ein. Ausführliche Schritte finden Sie unter SAML und SCIM mit Microsoft Entra ID und IAM Identity Center konfigurieren.

Um einen Azure Mandanten einzurichten

1. Erstellen Sie im Azure Konto eine neue App-Registrierung.

   1. Gehe zu App-Registrierungen.

   2. Wählen Sie auf dem Bildschirm für App-Registrierungen die Option Neue Registrierung aus. Wählen Sie unter der Option Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis (Nur persönlicher Gebrauch — Einzelmandant) aus. Wenn Sie fertig sind, wählen Sie Registrieren aus.

   3. Notieren Sie sich die Client-ID. Sie benötigen sie zu einem späteren Zeitpunkt.

   4. Erstellen Sie ein Client-Geheimnis für die App-Registrierung und notieren Sie es sich. Sie benötigen sie zu einem späteren Zeitpunkt.

2. Fügen Sie URLs für jede Region, in der Ihre Slack Erweiterung installiert wird, einen Rückruf hinzu.

   1. Navigieren Sie zur Registerkarte Authentifizierung der App-Registrierung.

   2. Wählen Sie Plattformkonfigurationen, Plattform hinzufügen aus.

   3. Wählen Sie Web.

   4. Verfassen Sie eine Callback-URL im folgenden Format und your-region ersetzen Sie sie durch Ihre Amazon Quick Suite-Instance-Region. Die Slack Erweiterung unterstützt die folgenden Regionen:ap-southeast-2, eu-west-1us-west-2, undus-east-1.

      qbs-cell001.dp.appintegrations.your-region.prod.plato.ai.aws.dev/auth/idc-tti/callback

   5. Fügen Sie die Callback-URL als Umleitungs-URI ein und wählen Sie Configure, wenn Sie fertig sind.

So konfigurieren Sie einen Trusted Token Issuer

1. Gehen Sie zu Ihrem AWS Konto und navigieren Sie zu Ihrer IAM Identity Center-Instanz.

2. Navigieren Sie zu Einstellungen, Authentifizierung.

3. Wählen Sie Vertrauenswürdigen Token-Aussteller erstellen aus.

4. Fügen Sie die Aussteller-URL hinzu, die dieser Vorlage folgen sollte und sich auf Ihre Entra Mandanten-ID Tenant ID bezieht:

   login.microsoftonline.com/Tenant ID/v2.0

   Anmerkung

   Die Aussteller-URL sollte der OIDC-Erkennungsendpunkt Ihrer Identität ohne den bekannten URI-Pfad des Dokuments sein. Wenn Sie den bekannten URI-Pfad für das Dokument angeben, funktioniert dies nicht. Weitere Informationen finden Sie unter Konfigurationseinstellungen für vertrauenswürdigen Token-Aussteller.

5. Wählen Sie E-Mail als Identity Provider-Attribut und IAM Identity Center-Attribut aus.

So richten Sie Berechtigungen ein

1. Navigieren Sie auf der AWS Konsole zu Secrets Manager.

2. Wählen Sie Store a new secret (Ein neues Secret speichern).

3. Wählen Sie „Anderer Geheimtyp“ und anschließend die Registerkarte „Klartext“.

4. Ihr Geheimnis sollte das folgende Format haben und die Client-ID für die App-Registrierung und den geheimen Schlüssel des App-Registrierungsclients verwenden, die Sie aus den vorherigen Schritten gespeichert haben:

   
   {
       "client_id":"Your app registration client ID",
       "client_secret":"Your app registration client secret"
   }

5. Navigieren Sie zu dem Secret, das Sie gerade erstellt haben, und speichern Sie den ARN für später.

6. Navigieren Sie nun auf der AWS Konsole zu IAM.

7. Wählen Sie in der linken Navigationsleiste Access Management, Roles aus.

8. Wählen Sie Rolle erstellen aus.

9. Wählen Sie Benutzerdefinierte Vertrauensrichtlinie.

10. Konfigurieren Sie die Rolle so, dass sie unserem Service Principal für die entsprechende Region vertraut, die Sie bei der Konfiguration Ihrer Azure App-Registrierung ausgewählt haben, indem Sie die folgende Aussage durch die Region your-region ersetzen, die Sie bei der Erstellung der Azure App-Registrierung ausgewählt haben:

    
    {
        "Version": "2012-10-17", 		 	 	 
        "Statement": [
            {
                "Effect": "Allow",
                "Principal": {
                    "Service": "your-region.prod.appintegrations.plato.aws.internal"
                },
                "Action": "sts:AssumeRole",
                "Condition": {}
            }
        ]
    }

11. Wählen Sie Weiter aus.

12. Geben Sie einen Namen und eine Beschreibung ein und wählen Sie Rolle erstellen aus.

13. Navigieren Sie zu der Rolle, die Sie gerade erstellt haben, und wählen Sie sie aus.

14. Wählen Sie „Berechtigungen hinzufügen“, „Inline-Richtlinie erstellen“.

15. Wählen Sie JSON.

16. Konfigurieren Sie die Rolle mit Berechtigungen zum Lesen von Geheimnissen aus Secrets Manager und Berechtigungen zum Aufrufen, sso:DescribeTrustedTokenIssuer indem Sie die folgende Anweisung hinzufügen:

    
    {
        "Version": "2012-10-17", 		 	 	 
        "Statement": [
            {
                "Sid": "BasePermissions",
                "Effect": "Allow",
                "Action": [
                    "secretsmanager:GetSecretValue",
                    "sso:DescribeTrustedTokenIssuer"
                ],
                "Resource": "*"
            }
        ]
    }

17. Geben Sie einen Richtliniennamen ein und wählen Sie Richtlinie erstellen aus.

18. Kopieren und speichern Sie den ARN der IAM-Rolle, die Sie für später erstellt haben. Sie benötigen ihn in den nächsten Schritten.

Um eine Konfiguration für den Erweiterungszugriff zu erstellen

1. Melden Sie sich bei der Amazon Quick Suite-Konsole an.

2. Wählen Sie oben rechts das Profilbildsymbol aus.

3. Wählen Sie im Drop-down-Menü die Option Konto verwalten aus.

4. Wählen Sie unter Berechtigungen die Option Erweiterungszugriff aus.

5. Wählen Sie oben rechts die Option Neuer Erweiterungszugriff aus.

6. Wähle Slack aus. Wählen Sie anschließend Weiter.

7. Konfigurieren Sie die folgenden Felder:

   • Name — Ein Name für deine Erweiterung ist für dich vorausgefüllt. Sie können dies bearbeiten und einen aussagekräftigen Namen für die Slack Erweiterung eingeben (maximal 512 alphanumerische Zeichen, Bindestriche sind zulässig, aber keine Leerzeichen).

   • Beschreibung (optional) — Eine Beschreibung für Ihre Erweiterung ist bereits für Sie ausgefüllt. Sie können dies bearbeiten und eine neue Beschreibung eingeben, um zusätzlichen Kontext zu dieser Erweiterungskonfiguration bereitzustellen (maximal 1000 Zeichen).

   • Workspace-ID von Slack — Gib deine Workspace-ID für Slack ein. Workspace IDs muss mit 'T' beginnen und zwischen 1 und 256 alphanumerische Zeichen enthalten.

   • Secrets Role ARN — Fügen Sie den ARN der IAM-Rolle ein, die Sie in den vorherigen Schritten erstellt haben.

   • Secrets ARN — Fügen Sie den ARN des Secrets Manager Manager-Geheimnisses ein, das Sie in den vorherigen Schritten erstellt haben.

8. Wählen Sie Hinzufügen, um die neue Zugriffskonfiguration zu speichern.

   Eine Erfolgsmeldung wird oben rechts auf Ihrem Bildschirm geöffnet.

9. Wählen Sie in der Erfolgsmeldung die Option Erweiterungen anzeigen aus, um die Installation Ihrer Erweiterung abzuschließen.

   Anmerkung

   Sie können auch über Verbindungen > Erweiterungen im Amazon Quick Suite-Menü zum Installationsbildschirm navigieren.

1. Melden Sie sich bei der Amazon Quick Suite-Konsole an.

2. Wählen Sie oben rechts das Profilbildsymbol aus.

3. Wählen Sie im Drop-down-Menü die Option Konto verwalten aus.

4. Wählen Sie unter Berechtigungen die Option Erweiterungszugriff aus.

5. Wählen Sie oben rechts die Option Neuer Erweiterungszugriff aus.

6. Wählen Slack Sie dann Weiter aus.

7. Konfigurieren Sie die folgenden Felder:

   • Name — Ein Name für Ihre Erweiterung ist für Sie vorausgefüllt. Sie können dies bearbeiten und einen aussagekräftigen Namen für die Slack Erweiterung eingeben (maximal 512 alphanumerische Zeichen, Bindestriche sind zulässig, aber keine Leerzeichen).

   • Beschreibung (optional) — Eine Beschreibung für Ihre Erweiterung ist bereits für Sie ausgefüllt. Sie können dies bearbeiten und eine neue Beschreibung eingeben, um zusätzlichen Kontext zu dieser Erweiterungskonfiguration bereitzustellen (maximal 1000 Zeichen).

   • Workspace-ID von Slack — Gib deine Slack Workspace-ID ein. Die Workspace-ID muss mit T beginnen und zwischen 1 und 256 alphanumerische Zeichen lang sein.

8. Wählen Sie Hinzufügen aus, um die neue Zugriffskonfiguration zu speichern.

   Eine Erfolgsmeldung wird oben rechts auf Ihrem Bildschirm geöffnet.

9. Wählen Sie in der Erfolgsmeldung die Option Erweiterungen anzeigen aus, um die Installation Ihrer Erweiterung abzuschließen.

   Anmerkung

   Sie können auch über Verbindungen > Erweiterungen im Amazon Quick Suite-Menü zum Installationsbildschirm navigieren.

1. Melden Sie sich bei der Amazon Quick Suite-Konsole an.

2. Wählen Sie oben rechts das Profilbildsymbol aus.

3. Wählen Sie im Drop-down-Menü die Option Konto verwalten aus.

4. Wählen Sie unter Berechtigungen die Option Erweiterungszugriff aus.

5. Wählen Sie das Menüsymbol mit den drei Punkten für die Slack Erweiterung aus, die Sie bearbeiten möchten.

6. Wählen Sie Bearbeiten aus.

7. Bearbeiten Sie die Konfiguration nach Bedarf und wählen Sie Speichern, um die Änderungen zu bestätigen.

1. Melden Sie sich bei der Amazon Quick Suite-Konsole an.

2. Wählen Sie oben rechts das Profilbildsymbol aus.

3. Wählen Sie im Drop-down-Menü die Option Konto verwalten aus.

4. Wählen Sie unter Berechtigungen die Option Erweiterungszugriff aus.

5. Wählen Sie das Menüsymbol mit den drei Punkten für die Slack Erweiterung aus, die Sie löschen möchten.

6. Wählen Sie Löschen aus.

7. Geben Sie das Wort „Bestätigen“ ein und wählen Sie LÖSCHEN.