Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

Windsurf-Leitfaden für Enterprise-Admins

Zweck Dieser Leitfaden unterstützt Enterprise-Admins aus den Bereichen Plattform / Developer Experience dabei, Windsurf für Organisationen mit großen Enterprise-Teams zu planen, einzuführen und zu betreiben. Er ist bewusst pointiert formuliert und verweist für jedes Thema auf ausführliche How-to-Dokumentationen. Nutzen Sie ihn sowohl als Leitfaden zum Durchlesen als auch als Checkliste beim Onboarding.

1. Zielgruppe & Voraussetzungen

Details
Wer das lesen solltePlattform-/Dev-Ex-Admins, Unternehmens-IT, zentrale Tooling-Teams
Vorausgesetzte KenntnisseGrundlegende Windsurf-Begriffe (Team, Rolle), Enterprise-IdP-Konzepte (SAML, SCIM), Nutzung der CLI
Nicht im GeltungsbereichTiefgehende Sicherheits-/Compliance-Interna → siehe Security & Compliance-Dokumentation

2. Schnellstart-Checkliste

  1. Prüfen Sie organisationsweite Settings
  2. Richten Sie SSO ein (Okta, Azure AD, Google; siehe SAML-Dokumentation für andere)
  3. Aktivieren Sie SCIM & ordnen Sie IdP-Gruppen Windsurf-Teams zu
  4. Definieren Sie das Rollen- & Berechtigungsmodell (Prinzip der geringsten Rechte)
  5. Konfigurieren Sie das Admin-Portal: Team-Ansicht & Sicherheitskontrollen
  6. Verteilen Sie Windsurf-Clients/Erweiterungen an Endnutzer
  7. Sehen Sie Analytics-Dashboards & API-Zugriffstoken ein
Verwenden Sie diese Liste als Ihren Bereitstellungs-Tracker für „Day 0“.

3. Zentrale Windsurf-Konzepte

  • Team – flache Sammlungen von Mitgliedern; keine verschachtelten Teams. Teams (auch Gruppen genannt) bestimmen die Rollenzuweisung und Gruppierung für Analytics und ermöglichen es Ihnen, Berechtigungen einzugrenzen und Nutzungsmetriken pro Gruppe anzuzeigen.
  • Rollen & Berechtigungen – vordefiniertes RBAC; Admins sind in erster Linie für Team-Management, Windsurf-Feature-Settings und Analytics verantwortlich. Integrierte Rollen decken diese Anforderungen in der Regel ab, aber das Erstellen einer benutzerdefinierten Rolle mit der Berechtigung analytics-view ermöglicht es Teammanagern und Leads, Metriken für ihre eigenen Teams einzusehen. (RBAC-Dokumentation)
  • Admin-Portal – zentrale UI für Nutzer- und Team-Management, Nutzung von Credits, SSO-Konfiguration, Feature-Toggles (Websuche, MCP, Deploys), Analytics-Dashboards/Berichtsexport, Service-Schlüssel für die API-Nutzung und Rollen-/Berechtigungsverwaltung.
  • Agents & Workspaces – Windsurf IDE und JetBrains-Plugins sind agentenbasiert

3.1 Überblick über das Admin-Portal

Das Admin-Portal ermöglicht die zentrale Verwaltung aller Windsurf-Enterprise-Funktionen über eine intuitive Weboberfläche. Zu den Kernfunktionen gehören:

Nutzer- und Teamverwaltung

  • Nutzer in Ihrer Organisation hinzufügen, entfernen und verwalten
  • Teams mit den richtigen Rollenzuweisungen konfigurieren
  • Überwachung von Nutzerstatus und -aktivität

Authentifizierung & Sicherheit

  • SSO-Integration mit gängigen Identity Providern konfigurieren
  • SCIM-Provisioning für die automatisierte Verwaltung des Nutzerlebenszyklus einrichten
  • Rollenbasierte Zugriffssteuerung (RBAC) verwalten
  • Service-Schlüssel für API-Automatisierungen mit auf bestimmte Bereiche beschränkten Berechtigungen erstellen und verwalten

Feature-Toggles & Steuerungen

Wichtig: Diese Feature-Steuerungen wirken sich auf das Verhalten Ihrer gesamten Organisation aus und können nur von Administratoren geändert werden. Neue größere Features mit Auswirkungen auf den Datenschutz werden standardmäßig im Status „Aus“ veröffentlicht, damit Sie die Kontrolle darüber haben, wann und wie sie aktiviert werden.
Das Admin-Portal bietet Ihnen eine granulare Steuerung von Windsurf-Features, die pro Team aktiviert oder deaktiviert werden können. Hinweis zum Datenschutz: Einige Features erfordern, wie unten angegeben, die Speicherung zusätzlicher Daten oder Telemetriedaten: Modellkonfiguration
  • Konfigurieren Sie, auf welche KI-Modelle Ihre Teams in Windsurf zugreifen können
  • Sie können nach Modell filtern (bestimmte Modelle wie SWE-1.5, Claude Opus 4.6 usw. auswählen) oder nach Anbieter filtern (z. B. OpenAI, Anthropic, Google). Es wird jeweils immer nur ein Filtertyp gleichzeitig angewendet.
  • Wählen Sie mehrere Modelle oder Anbieter für verschiedene Anwendungsfälle aus (Cascade, Command, Chat usw.)
Überschreibung des Standardmodells
  • Legen Sie das Standard-Cascade-Modell für Nutzer in Ihrem Team fest
  • Dieses Modell ist jedes Mal vorausgewählt, wenn ein Nutzer Windsurf öffnet (nicht nur beim ersten Mal)
  • Nutzer können ihr Modell während einer Sitzung jederzeit weiterhin ändern
  • Nur in der Modellkonfiguration aktivierte Modelle sind als Standardoptionen verfügbar
Terminalbefehle automatisch ausführen (Beta)
  • Legen Sie die maximale Stufe der automatischen Ausführung für Terminalbefehle in Ihrer gesamten Organisation fest
  • Vier Stufen verfügbar: Disabled (keine automatische Ausführung), Allowlist Only (nur Befehle auf der Allowlist), Auto (von der KI als sicher bewertete Befehle) und Turbo (alle Befehle außer Befehlen auf der Denylist)
  • Nutzer können jede Stufe bis zur von Ihnen konfigurierten Maximalstufe auswählen, sodass sie innerhalb Ihrer Sicherheitsrichtlinie flexibel bleiben
  • Mehr über automatisch ausgeführte Befehle erfahren
MCP Servers (Beta) App-Bereitstellungen (Beta) Teilen von Unterhaltungen
  • Erlauben Sie Teammitgliedern, Cascade-Unterhaltungen mit anderen zu teilen
  • Unterhaltungen werden sicher auf Windsurf-Server hochgeladen
  • Freigabelinks sind nur für angemeldete Teammitglieder verfügbar
  • Mehr über das Teilen von Unterhaltungen erfahren
PR-Reviews (GitHub Integration) Verwaltung der Wissensdatenbank

4. Identitäts- und Zugriffsmanagement

Empfehlung: Verwenden Sie nach Möglichkeit SSO plus SCIM zur automatisierten Provisionierung, Deprovisionierung und Gruppenverwaltung.

4.1 Single Sign-On (SSO)

Empfehlung
Unterstützte IdPsOkta, Azure AD, Google (weitere über generisches SAML)
Empfohlener AnsatzEine Windsurf-spezifische App im IdP erstellen; rollenbasierte Gruppenzuweisungen statt der organisationsweiten Gruppe All Employees verwenden
Häufige FallstrickeNicht übereinstimmende E-Mail-Domänen, doppelte Nutzer-Aliasse
Siehe den SSO- & SCIM-Setup-Leitfaden für die Schritt-für-Schritt-Konfiguration von Okta, Azure AD, Google und generischem SAML.

4.2 SCIM-Provisioning

  • Warum – automatisiertes Nutzer-Lifecycle- und Teammitgliedschaftsmanagement im großen Maßstab
  • Funktionen
    • Nutzer automatisch erstellen / deaktivieren
    • Teams automatisch erstellen (oder manuell verwalten)
    • Nutzer können zu mehreren Teams gehören
    • Benutzerdefinierte Teamerstellung über die SCIM-API (Dokumentation)
  • Mapping-Strategien
    • 1 IdP-Gruppe → 1 Windsurf-Team (einfach, am gebräuchlichsten)
    • Funktionale vs. projektbasierte Gruppenpräfixe (z. B. proj-foo-devs)
  • Zu entscheiden
    • Welche Gruppen ausgeschlossen werden sollen (z. B. Praktikanten, externe Auftragnehmer)
    • Regeln für Umbenennungen, wenn sich IdP-Gruppennamen ändern
  • Achtung: SCIM sollte Ihre Source of Truth bleiben – das Mischen von SCIM mit manuellen / API-Aktualisierungen kann zu Inkonsistenzen führen. Verwenden Sie die API vor allem zum Hinzufügen ergänzender Gruppen.

5. Nutzer- & Teamverwaltung im großen Umfang

  • Flache Team-Struktur → Team-Taxonomie sorgfältig planen (keine Verschachtelung als Ausweichmöglichkeit)
  • Nutzer können mehreren Gruppen angehören. Gruppen werden verwendet, um Analytics anzuzeigen
  • Aktuell unterstützt SCIM keine Rollenzuweisung an Nutzer. SCIM unterstützt nur die Zuweisung von Nutzern zu Gruppen

6. Analytics & API-Zugriff

6.1 Integrierte Analysen

DashboardAnwendungsfall
NutzungsübersichtGesamtzahl aktiver Nutzer, tägliche Nutzung verfolgen
TeamaktivitätNutzung im Team
Analytics zeigt den Anteil des von Windsurf geschriebenen Codes und hilft so, die Auswirkungen zu quantifizieren – deine Dashboards findest du unter Team-Analytics.

6.2 APIs

APITypische Admin-Szenarien
RESTSCIM-Verwaltung, Analysen

7. Betriebliche Hinweise

  • Statusseiten – aktuelle Dienstverfügbarkeit überwachen: Windsurf, Anthropic, OpenAI
  • Supportkanäle – windsurf.com/support

8. Endnutzer erfolgreich zum Start befähigen

  1. Verweisen Sie Endnutzer auf den Windsurf-Installationsleitfaden, damit sie die passende Erweiterung oder den Desktop-Client installieren können.
  2. Veröffentlichen Sie eine interne Seite „Erste Schritte mit Windsurf“ (mit Link zur offiziellen Dokumentation)
  3. Führen Sie Live-Onboarding-Sitzungen durch / zeichnen Sie kurze Demos auf
  4. Stellen Sie Vorlagen für Einstiegsprojekte und Beispiel-Prompts zusammen
  5. Holen Sie nach 2 Wochen per Umfrage Feedback ein; optimieren Sie anschließend

9. Zusätzliche Ressourcen