Konfigurieren der Benutzerauthentifizierung mit Microsoft Entra ID

Wenn Sie Ihrem Agenten eine Authentifizierung hinzufügen, können sich Nutzer anmelden und Ihrem Agenten Zugriff auf eine eingeschränkte Ressource oder Informationen gewähren.

In diesem Artikel wird erläutert, wie Sie Microsoft Entra ID als Dienstanbieter konfigurieren. Informationen zu anderen Dienstanbietern und Benutzerauthentifizierung finden Sie unter Configure-Benutzerauthentifizierung in Copilot Studio.

Wenn Sie über Mandantenverwaltungsrechte verfügen, können Sie API-Berechtigungen konfigurieren. Andernfalls sollten Sie einen Mieteradministrator bitten, diese Berechtigungen zu erteilen.

Anforderungen

Erfahren Sie, wie Sie einem Thema die Benutzerauthentifizierung hinzufügen

Sie führen die ersten Schritte im Azure-Portal aus, und führen Sie die beiden letzten Schritte in Copilot Studio aus.

Erstellen einer App-Registrierung

1. Melden Sie sich beim Azure-Portal an, indem Sie ein Administratorkonto im selben Mandanten wie Ihr Agent verwenden.

2. Wechseln Sie zu App registrations.

3. Wählen Sie Neue Registrierung aus und geben Sie einen Namen für die Registrierung ein. Ändern Sie vorhandenen App-Registrierungen nicht.

   Es kann später hilfreich sein, den Namen Ihres Agent zu verwenden. Wenn Ihr Agent beispielsweise „Contoso-Verkaufshilfe“ heißt, können Sie die App-Registrierung „ContosoSalesReg“ nennen.

4. Wählen Sie unter "Unterstützte Kontotypen" nur "Konten" in diesem Organisationsverzeichnis (nur Contoso – Einzelner Mandant) aus.

5. Lassen Sie den Abschnitt Umleitungs-URI vorerst leer. Geben Sie diese Information in den nächsten Schritten ein.

6. Wählen Sie Registrieren aus.

7. Nach Abschluss der Registrierung gehen Sie zu Übersicht.

8. Kopieren Sie die Anwendungs-ID (Client), und fügen Sie sie in eine temporäre Datei ein. Sie brauchen sie in den weiteren Schritten.

Die Umleitungs-URL hinzufügen

1. Wählen Sie unter Verwalten die Option Authentifizierung aus.

2. Wählen Sie unter PlattformkonfigurationenEine Plattform hinzufügen und dann Web aus.

3. Geben Sie unter Umleitungs-URIshttps://token.botframework.com/.auth/web/redirect oder https://europe.token.botframework.com/.auth/web/redirect für Europa ein. Sie können den URI auch aus dem Textfeld Redirect URL unter Copilot Studio Security Einstellungsseite unter Authenticate manuell kopieren.

   Mit dieser Aktion kehren Sie zur Seite Plattformkonfigurationen zurück.

   Eine Liste der erforderlichen Dienste, mit der Copilot Studio eine Verbindung herstellt, einschließlich token.botframework.com, finden Sie unter Required Services.

4. Wählen Sie sowohl Zugriffstoken (für implizite Flüsse verwendet) als auch ID-Token (für implizite und hybride Flüsse verwendet) aus.

5. Wählen Sie "Konfigurieren" aus.

Manuelle Authentifizierung konfigurieren

Dann konfigurieren Sie manuelle Authentifizierung. Sie können aus mehreren Optionen für Ihren Anbieter auswählen. Verwenden Sie jedoch Microsoft Entra ID V2 mit Verbundanmeldeinformationen. Sie können auch Clientgeheimnisse verwenden, wenn Sie keine Verbundanmeldeinformationen verwenden können.

API-Berechtigungen konfigurieren

1. Gehen Sie zu API-Berechtigungen.

2. Wählen Sie Administratorzustimmung für <Ihren Mandantennamen> erteilen und dann Ja aus. Wenn die Schaltfläche nicht verfügbar ist, müssen Sie möglicherweise einen Mandantenadministrator bitten, sie für Sie einzugeben.

   

   Wichtig

   Um zu vermeiden, dass Benutzende jeder Anwendung zustimmen müssen, muss mindestens eine Fachkraft mit der Rolle für die Anwendungs- oder Cloud-Anwendungsadministration die mandantenweite Einwilligung zu Ihren Anwendungsregistrierungen erteilen.

3. Wählen Sie Hinzufügen einer Berechtigung aus und dann Microsoft Graph.

   

4. Wählen Sie delegierte Berechtigungen aus.

   

5. Erweitern Sie OpenId-Berechtigungen und schalten Sie openid und Profil ein.

   

6. Wählen Sie "Berechtigungen hinzufügen" aus.

Einen benutzerdefinierten Bereich für Ihren Agenten festlegen

Scopes bestimmen Benutzer- und Administratorrollen sowie Zugriffsrechte. Erstellen Sie einen benutzerdefinierten Umfang für die Registrierung der Canvas-App.

1. Gehen Sie zu Eine API verfügbar machen und wählen Sie Einen Bereich hinzufügen aus.

   

2. Legen Sie die folgenden Eigenschaften fest. Sie können die anderen Eigenschaften leer lassen.

   Eigenschaften	Wert
   Bereichsname	Geben Sie einen Namen ein, der in Ihrer Umgebung sinnvoll ist, wie Test.Read
   Wer kann die Einwilligung erteilen?	Wählen Sie Administratoren und Benutzer aus
   Administratorzustimmung Anzeigename	Geben Sie einen Namen ein, der in Ihrer Umgebung sinnvoll ist, wie Test.Read
   Beschreibung der Administratoreinwilligung	Geben Sie Allows the app to sign the user in. ein.
   Bundesstaat	Wählen Sie Aktiviert aus

3. Wählen Sie "Bereich hinzufügen" aus.

Konfigurieren der Authentifizierung in Copilot Studio

1. Wählen Sie in Copilot Studio unter SettingsSecurity>Authentication aus.

2. Wählen Sie Manuell authentifizieren aus.

3. Lassen Sie Benutzer müssen sich anmelden aktiviert.

4. Wählen Sie einen Dienstanbieter aus, und geben Sie die erforderlichen Werte an. Weitere Informationen finden Sie unter Configure manual authentication in Copilot Studio.

5. Wählen Sie Speichern aus.

Ihren Agent testen

1. Veröffentlichen Sie Ihren Agent.

2. Senden Sie im Bereich Agent testen eine Nachricht an Ihren Agent.

3. Wenn der Agent antwortet, wählen Sie Anmelden aus.

   Ein neuer Browser-Tab öffnet sich und fordert dich auf, dich anzumelden.

4. Melden Sie sich an und kopieren Sie dann den angezeigten Validierungscode.

5. Fügen Sie den Code in den Agent-Chat ein, um den Anmeldevorgang abzuschließen.