OAuth-Verbindungen

Einige nunq-Integrationen erfordern OAuth-Authentifizierung, um sich sicher mit externen Diensten zu verbinden. Diese Seite beschreibt, wie OAuth-Verbindungen innerhalb der Plattform funktionieren.

Überblick

OAuth ist ein branchenweites Standard-Autorisierungsprotokoll, das es nunq ermöglicht, in deinem Namen auf externe Dienste zuzugreifen, ohne dein Passwort zu speichern. Wenn du eine Integration verbindest, die OAuth nutzt, wirst du zur Anmeldeseite des externen Dienstes weitergeleitet, wo du nunq die erforderlichen Berechtigungen erteilst.

OAuth-Flow starten

So stellst du eine OAuth-Verbindung her:

1. Navigiere zu den Integrations- oder Werkzeugeinstellungen, die OAuth erfordern.
2. Klicke auf die Schaltfläche Verbinden oder Autorisieren.
3. Du wirst zur Anmeldeseite des externen Dienstes weitergeleitet (zum Beispiel Microsofts Anmeldeseite für SharePoint oder Business Central).
4. Melde dich an und erteile die angeforderten Berechtigungen.
5. Du wirst zu nunq zurückgeleitet und die Verbindung ist hergestellt.

Token-Verwaltung

Nach einem erfolgreichen OAuth-Flow speichert nunq die Zugriffs- und Aktualisierungstoken, die für die Kommunikation mit dem externen Dienst benötigt werden.

• Token werden verschlüsselt: Alle OAuth-Token werden verschlüsselt in der Datenbank gespeichert.
• Automatische Aktualisierung: Wenn ein Zugriffstoken abläuft, verwendet nunq das Aktualisierungstoken, um automatisch ein neues zu erhalten. In den meisten Fällen musst du dich nicht erneut authentifizieren.
• Sichere Speicherung: Token werden weder in der Benutzeroberfläche noch in API-Antworten offengelegt.

Erneutes Verbinden bei Token-Ablauf

In manchen Fällen können Aktualisierungstoken ablaufen oder vom externen Dienst widerrufen werden. In diesem Fall:

1. Siehst du eine Benachrichtigung, dass die Verbindung neu hergestellt werden muss.
2. Navigiere zu den Integrationseinstellungen.
3. Klicke auf Erneut verbinden, um einen neuen OAuth-Flow zu starten.
4. Melde dich erneut an und erteile die Berechtigungen.

Das passiert typischerweise, wenn die Sicherheitsrichtlinien eines externen Dienstes eine regelmäßige Neuautorisierung erfordern oder wenn Berechtigungen auf Seiten des externen Dienstes geändert wurden.

Unterstützte OAuth-Anbieter

Die in deiner nunq-Bereitstellung verfügbaren OAuth-Anbieter hängen davon ab, welche MCP-Server und Integrationen konfiguriert wurden. Gängige Anbieter sind:

• Microsoft Entra ID (Azure AD): Wird für SharePoint-, OneDrive- und Business Central-Integrationen verwendet.
• Weitere Anbieter: Jeder MCP-Server, der OAuth-basierte Authentifizierung implementiert, kann über nunq verbunden werden.

Dein Administrator konfiguriert, welche Integrationen und OAuth-Anbieter verfügbar sind. Siehe Model Context Protocol (MCP) für Informationen zum Hinzufügen neuer MCP-Verbindungen.